slide-forge

# 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` の選択肢・説明をそのまま提示する（既定は各先頭）。 1. **① 骨子の型**: SCQA / PREP / ゴールデンサークル / TAPS / ホールパート 2. **② シナリオ**: 課題駆動 / ビジョン駆動 / 資本駆動 / 人駆動 3. **③ トーン**: ライト / コーポレート・ネイビー / シネマ・ダーク / エディトリアル白 4. **④ 目的**: 承認を得たい（提案）/ 共有して知ってほしい / ビジョンで動かす 5. **⑤ ターゲット**: 社外・初対面 / 社内・意思決定者 / 既存パートナー > トーンは `config.yaml` の `params.tone.taste_map` で palette（lime/navy/dark）に対応する。 ### 3. CLI を実行する ```bash 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` サブコマンドでスレッド的に修正できることを案内: ```bash python cli.py revise --out ./out/<job名> --instruction "p3をもっと強く" ``` ## 品質原則（この順でレビュー） 1. **ロジックツリー → ストーリー → 設計** の順で骨子を点検（1スライド1メッセージ・見出しだけで流れが通る）。 2. **固定クロム**：見出し/eyebrow/フッターは全ページ同一座標・フォント種類は揃える・タイトルは完全な日本語文。 3. **図解優先**：画面を埋める・余白を作らない・顔写真は見切れ防止・図やカードは十分大きい。 4. **図の整合**：循環は閉じたリング（中心への矢印禁止）・グラフ注釈と作図の一致・曲線を滑らかに。 5. **文脈とコピー**：前提知識ゼロでも分かる用語・外部事実に出典・「公式」と「協議中」を区別・数値単位ミス無し。 6. **出力**：PDF 寸法を正常化・テキストは編集可能レイヤー・`check_deck.py` の機械検証を実施。 詳細な27項目チェックリストは `docs/qa-checklist.md`。 ## 禁止（厳守） - 入力資料に無い固有名詞・数字・日付・費用・KPI を推測補完しない（無いものは載せない／協議中と明記）。 - 画像内テキストを最終確定テキストにしない。外部送信・git push・deploy・rm はしない。 - 秘密情報・トークンを出力に出さない。