| name | slide-forge |
| description | 議事録・構成メモから固定座標クロムの提案デッキ(編集可能PPTX/HTML/PDF/PNG)を生成する。「提案資料を作って」「スライドにして」「デッキ生成」「この議事録から資料」で使用。5問(型/シナリオ/トーン/目的/ターゲット)を対話で選び、CLI に渡す。 |
slide-forge — 提案デッキ生成スキル
議事録・構成メモを渡すと、本文図解を gpt-image-2 で生成し、見出し/フッター等の固定 chrome を
後載せした提案デッキ(編集可能 PPTX + HTML/PDF/PNG)を作る。構成生成は Claude Code/Codex、
画像生成のみ OpenAI(課金隔離)。
前提
- リポジトリルートで
.env(OPENAI_API_KEY, LLM_BACKEND)と config.yaml を用意済みであること。
- 未用意なら README の「必要環境」を案内する。
手順
1. 入力素材を確定する
ユーザーから議事録/構成メモを受け取る。ファイル(.md/.txt/.json/.pdf)か直接テキスト。
- 構成案・骨子があれば「骨子優先」=
--outline、議事録・事実ソースは --input。
2. AskUserQuestion で5問を1回で聞く
config.yaml の params の選択肢・説明をそのまま提示する(既定は各先頭)。
- ① 骨子の型: SCQA / PREP / ゴールデンサークル / TAPS / ホールパート
- ② シナリオ: 課題駆動 / ビジョン駆動 / 資本駆動 / 人駆動
- ③ トーン: ライト / コーポレート・ネイビー / シネマ・ダーク / エディトリアル白
- ④ 目的: 承認を得たい(提案)/ 共有して知ってほしい / ビジョンで動かす
- ⑤ ターゲット: 社外・初対面 / 社内・意思決定者 / 既存パートナー
トーンは config.yaml の params.tone.taste_map で palette(lime/navy/dark)に対応する。
3. CLI を実行する
python cli.py generate \
--input <議事録ファイル> [--outline <構成案>] [--input-text "直接テキスト"] \
--type <①> --scenario <②> --tone <③> --goal <④> --target <⑤> \
--formats pptx pdf png html --out ./out/<job名>
生成には数分かかる(画像生成+QAループ)。完了後 JSON の artifacts に各成果物パスが出る。
4. 成果物を提示する
deck.pptx(編集可能)/ deck.pdf / contact_sheet.png の絶対パスを提示。
revise サブコマンドでスレッド的に修正できることを案内:
python cli.py revise --out ./out/<job名> --instruction "p3をもっと強く"
品質原則(この順でレビュー)
- ロジックツリー → ストーリー → 設計 の順で骨子を点検(1スライド1メッセージ・見出しだけで流れが通る)。
- 固定クロム:見出し/eyebrow/フッターは全ページ同一座標・フォント種類は揃える・タイトルは完全な日本語文。
- 図解優先:画面を埋める・余白を作らない・顔写真は見切れ防止・図やカードは十分大きい。
- 図の整合:循環は閉じたリング(中心への矢印禁止)・グラフ注釈と作図の一致・曲線を滑らかに。
- 文脈とコピー:前提知識ゼロでも分かる用語・外部事実に出典・「公式」と「協議中」を区別・数値単位ミス無し。
- 出力:PDF 寸法を正常化・テキストは編集可能レイヤー・
check_deck.py の機械検証を実施。
詳細な27項目チェックリストは docs/qa-checklist.md。
禁止(厳守)
- 入力資料に無い固有名詞・数字・日付・費用・KPI を推測補完しない(無いものは載せない/協議中と明記)。
- 画像内テキストを最終確定テキストにしない。外部送信・git push・deploy・rm はしない。
- 秘密情報・トークンを出力に出さない。