consulting-pptx-skill
スライド設計規約 slide-rules.md を核に、経営会議品質のスライドを作るスキル。作成前に規約を読み、HTMLパーツ集(基本27+追加35の62型)から該当パーツをコピーして組み、規約の範囲で型に囚われず調整し、check_deck.py の機械チェック FAIL 0 で仕上げる。型カタログはレイアウトの発想帳であり、合わせる対象ではない。既存の PowerPoint 資料を渡され、そこへ差し込むページを PPTX で求められたときだけ、その資料のマスターの上に直接組む(slide-rules §8.7)。トリガー例:「コンサル品質のスライドを作って」「規約に沿ったデッキで」「型カタログから選んで」「この pptx に足すページを同じ書式で」。
インストール方法を見る含まれるファイル(25)
- SKILL.md12.7 KB
- .gitignore295 B
- assets/SlideCatalog_16x9.pdf2.0 MB
- assets/SuperTemplate_62type.pptx280.1 KB
- examples/house_deck_example.py4.4 KB
- LICENSE1.0 KB
- package.json388 B
- README.md14.2 KB
- references/ai-smell-lexicon.md5.8 KB
- references/archetype-catalog.md9.6 KB
- references/content-review-prompt.md6.8 KB
- references/slide-rules.md80.4 KB
- scripts/check_deck.py33.9 KB
- scripts/check_layout.mjs5.9 KB
- scripts/deck_pptx.py22.1 KB
- scripts/html_dump.mjs22.2 KB
- scripts/html_to_pptx.py13.9 KB
- scripts/lib_cdp.mjs3.8 KB
- scripts/measure_deck.py17.3 KB
- scripts/new_deck.py9.6 KB
- templates/freeform_parts_16x9.html60.1 KB
- templates/freeform_parts_more_16x9.html108.9 KB
- tests/fixtures/good_deck.html75.8 KB
- tests/test_checks.py5.4 KB
- tests/test_house_pptx.py9.4 KB
SKILL.md(原文)
インストールする前に、エージェントに与えられる指示の中身を確認できます。
コンサル型スライド作成スキル
主軸は references/slide-rules.md。作成前に全文を読み、HTMLパーツ集でたたき台を組み、規約の範囲で調整し、機械チェック FAIL 0 と目視で仕上げる。パーツ集と型カタログは規約を効率よく満たす道具であり、スライドを型に合わせるのではなく、型をストーリーに合わせて選び、合わなければ捨てて自由に組む。
成果物は HTML(16:9・1 section = 1スライド)と、Chrome で印刷した PDF。
ファイルと読むタイミング
| ファイル | 中身 | 読む・使うタイミング |
|---|---|---|
references/slide-rules.md | 規約の正典 | 必読。作成前に全文 |
references/archetype-catalog.md | 62型の一覧(型ID・型名・使いどころ・どのパーツ集の何番か) | ストーリーラインの各行に見せ方を書くとき |
references/content-review-prompt.md | フレッシュアイ・レビューの指示文 | 機械チェック通過後、納品前 |
references/ai-smell-lexicon.md | AI臭ワード・言い回しのリスト | 文章の仕上げ時 |
templates/freeform_parts_16x9.html | 基本パーツ集 27(表紙・全体マップ・矢羽・前提→帰結・軸のある表・主張パネル・評価表・分布図など)。まずここから | 手順3 |
templates/freeform_parts_more_16x9.html | 追加パーツ集 35(エグゼクティブサマリー・積み上げ棒・ブリッジ・散布図・比較表・マトリクス・ロードマップ・ガントなど)。基本で足りないとき | 手順3 |
assets/SlideCatalog_16x9.pdf | 両パーツ集を印刷した62ページ(P.1〜27 基本、P.28〜62 追加) | 型を目で探すとき |
scripts/new_deck.py | パーツ番号を並べて1本のHTMLを生成 | 手順3 |
scripts/check_deck.py | 規約の機械チェック(HTML は標準ライブラリのみ) | 手順6 |
scripts/check_layout.mjs | 重なり・はみ出し・空きの多いページの実レンダリング検査(npm run setup で playwright を入れる) | 手順7 |
tests/test_checks.py | 機械チェックの自己テスト(直していない版で発火し、直した版で通ることを確認) | 機械チェックを足した・直したとき |
scripts/html_to_pptx.py | 仕上げた HTML を編集できる PPTX に変換(html_dump.mjs・lib_cdp.mjs を使う) | ユーザーが PPTX を明示したときだけ |
assets/SuperTemplate_62type.pptx | 62型のPPTX見本帳(全スライド編集可能) | PPTX を手で組むとき |
scripts/measure_deck.py | 既存の PowerPoint 資料の書式を測って skin.json に書き出す | 既存の資料へ差し込むページを作るとき(最初に) |
scripts/deck_pptx.py | その資料のマスターの上に、同じ書式のページを組む部品(作例は examples/house_deck_example.py) | 同上 |
規約の要点(入口。全文は必ず読む)
- タイトル: 結論を書く。1行が基本、長ければ意味の切れ目で2行(縮小して詰めない)。です/ます禁止。タイトルだけ通し読みして1本のストーリーになること
- レイアウト: 1スライド=1メッセージ。左=事実・図、右=意味合い。下部の「POINT」帯禁止
- 表: 行=項目・列=観点の「軸のある表」。ヘッダーは本文より大きく太字・塗りなし。最終行の下に罫線なし
- 装飾: 角丸禁止。塗りボックスに枠線なし。色分けするなら同一スライドに凡例
- 図: 推移・構成比・分布はグラフで描く。表に流し込んで済ませない(§5.11)
- 数: タイトルに書いた数と本文の連番を一致させる(§2.9)。ページの中身の個数はタイトルに書かない(§2.4)
- 文章: 1資料1用語。略語は初出でフル表記。ブレット語尾は階層内で統一
手順
- 作る前に定義する: 目的・成果物の定義・スコープ IN/OUT を3〜5行で先に合意する。
- ストーリーライン(1枚1行のタイトル列)を書き、各行に見せ方を併記する(図/表/矢羽/2カラム/数値カード)。推移・構成比・分布・相関は必ず図。見せ方に迷う行は
references/archetype-catalog.mdを見る。- 章扉は b27(アジェンダ再掲型)。section は
s chapでページ番号に数えない(§4.45)。10枚前後なら章扉は要らない。 - 表の列幅: 列の内容が同種(時点・案・部門)なら
<table class="eq">で等幅にし、最後の列だけに余白を吸わせない。説明・ブレットの列があるときだけ、その列に余白を渡す。 - 枚数に上限があるときの削る順: 章扉・目次 → 全体マップと重複する本文 → 補足・付録。表紙・全体マップ・結論ページ・裏表紙は残す。リスクの列挙は対応策と同じ1枚にする(§4.29)。
- 章扉は b27(アジェンダ再掲型)。section は
- たたき台を生成する:
両パーツ集のCSS結合・見出し様式の統一・ページ番号の振り直しはスクリプトが行う。手でコピーして組まない。生成後、プレースホルダー(python3 scripts/new_deck.py --list # 番号と型名(b01〜b27 基本/m01〜m35 追加) python3 scripts/new_deck.py --parts b01,b02,m05,b06,b09,b10 --title "資料名" -o mydeck.htmlText N/ラベル N/YYYY)を実物に差し替える。 - グラフが要るページは、表パーツに流し込まず自分で描く。
- 調整: 表を2枚に割る、右カラムを帰結形に書き直す、粒度の揃わない並列を書き直す。1枚ごとに「この型のままでよいか」を疑う。受けた指摘は slide-rules.md に1行追記し、測れる指摘は機械チェックにもする(slide-rules §8「指摘は規約1行と機械チェックの両方にする」)。
python3 scripts/check_deck.py mydeck.html→ FAIL 0(表紙・裏表紙・章扉の「タイトル空」WARN は許容)。出力されるタイトル一覧を通し読みする。本文に残ったプレースホルダー、型名のままのタイトル、2文以上詰めた文章塊も FAIL になる。- 社外に出すデッキは、顧客名・社内語・案件コードを1行1語で書いたリスト(リポジトリの外に置く)を当てる:
python3 scripts/check_deck.py mydeck.html --forbid ~/.config/deck-forbidden-terms.txt。HTMLコメントや属性に残った語も拾い、語そのものは出力に出さない。
- 社外に出すデッキは、顧客名・社内語・案件コードを1行1語で書いたリスト(リポジトリの外に置く)を当てる:
node scripts/check_layout.mjs mydeck.html→ OK(playwright が別の場所にあるならPLAYWRIGHT_MODULE_DIRで指す)。版面の40%超が空いたページも FAIL になる。- フレッシュアイ・レビュー:
references/content-review-prompt.mdの指示文を、作り方を伏せた別のエージェントに渡してデッキのファイルを読ませる。指摘を採否表(採用/不採用/保留+理由)にし、採用分だけ直して手順6・7を再実行する。 - PDF 化して全ページ目視する。 機械チェックは重なり・はみ出し・規約違反しか見ない。棒が潰れる、図が空になる、下半分が空く、泣き別れ、左右の下端不揃いは目視でしか分からない。パーツのCSSは自分のデッキ側で直してよい(直したら templates/ にも反映する)。
"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" --headless --disable-gpu \ --no-pdf-header-footer --print-to-pdf=mydeck.pdf mydeck.html
PowerPoint(.pptx)が要るとき
資料は HTML で仕上げる。PPTX にするのは、ユーザーが「PPTX で」「パワポにして」と明示したときだけ。 修正・レビューの往復はすべて HTML 上で回し、変換は最後に1回だけにする。HTML のほうが直すのも機械チェックも速く、PPTX で直すと HTML と中身がずれる。PPTX を渡した後に修正が来たら、HTML を直して変換し直す。明示が無ければ PDF で渡す。
- HTML で手順6〜9(機械チェック FAIL 0・フレッシュアイ・レビュー・PDF 目視)まで済ませる
- 変換:
python3 scripts/html_to_pptx.py mydeck.html→ 同じフォルダに mydeck.pptx(Node 22+・Chrome・pip3 install python-pptxが必要) python3 scripts/check_deck.py mydeck.pptxを FAIL 0 に。PowerPoint で開いて(または PDF に書き出して)文字の折り返しと重なりを目視する- 社外に送るなら、ファイルのプロパティ(作成者・会社名など)を消す
変換の中身と限界(詳細は slide-rules.md §8.6):
- 編集できる形で再現: 文字(書体・大きさ・色・行間・折り返し幅・箇条書き書式)、塗りと枠(角丸・clip-path の多角形・CSS の三角形)、罫線、表(結合セル・セルの塗り・罫線・余白・縦書き)
- 画像になる(中の文字や数値は編集できない): SVG のチャート・図、img、背景画像
- 書体は和文ゴシック=Yu Gothic、明朝=Yu Mincho に置き換える。字幅の差で行末が1字ずれることがあるので目視は省かない
- 再現しない: 回転・変形(CSS の transform)、
::before/::afterで描いた装飾(背景付きの丸数字など。行頭記号の文字は箇条書き書式として再現する)。これらはパーツ側で使わないか、変換後に PowerPoint で直す
PPTX を一から手で組むときの見本として assets/SuperTemplate_62type.pptx(62型・全スライド編集可能)も置いてある。
既存の資料へ差し込むページ
入れる先の PowerPoint 資料(社内の標準デッキ・作りかけの提案書)を渡されたときは、変換せずに その資料のマスターの上で直接組む。変換した PPTX は書体と版面が自前なので、差し込むと浮く(slide-rules §8.7)。文章・表の軸・1枚1メッセージの規約はそのまま。
- 測る:
python3 scripts/measure_deck.py house.pptx→house.skin.json。要約を読み、資料を目で見て値を直す - 組む:
examples/house_deck_example.pyを手本にscripts/deck_pptx.pyで組む。書体・地色・ページ番号をスライドに書かない/タイトルはプレースホルダー/表はテキストボックス+罫線(table())/色は資料のテーマ色 python3 scripts/check_deck.py pages.pptx --house house.skin.json→ FAIL 0。PowerPoint で開く前に必ず通す(不正なファイルを開かせると、ユーザーの PowerPoint に修復のダイアログが残る)- 全ページを目視する(手段は slide-rules §8 の目視QAと同じ)
- 渡すのは差し込むページだけのファイル。資料へ入れるのはユーザー(「貼り付け先のテーマを使用」)
本スキル使用の注釈
「本資料は consulting-pptx-skill(github.com/carnot-tech/consulting-pptx-skill)で作成」の一文は裏表紙(b10)の左下に既定で入っている。他のページには入れない。裏表紙を使わないデッキでは最終ページの出典行に足す。
色と書体
両パーツ集の既定は同じ暖色系(生成りの地・濃茶の文字・茶のアクセント。本文ゴシック・見出し明朝)。トークンは各ファイルの <style> 冒頭 :root。片方を変えたらもう片方も揃える。ネイビー系の値はコメントで同梱。意味を持つ色(✕の赤など)は変えない。2系列の区別はメインカラー×グレーの2色に抑える。製品UIのスクリーンショットは無加工。
レビュー
まだレビューはありません。使ってみた感想をお寄せください。