使い方
- インストールコマンドをコピーし、自分の環境へ導入する前にソースを確認します。
- 必要なツール、認証情報、対応環境を原文で確認します。
- 入力と成果物を指定し、出力を資料と照合します。
npx skills add https://github.com/carnot-tech/jinba-consulting-pptx-skill --skill consulting-pptx-skill開始前の確認
- 導入にはモデル契約、API枠、ファイルへのアクセス許可は含まれません。
- スター数や導入数は活動の指標であり、独立した品質・安全性試験ではありません。
見出し、例、コード、表、リンク、参照画像を含む原文を表示しています。
コンサル型スライド作成スキル
規約の正典は references/slide-rules.md。全文は読まず、工程ごとに `scripts/rules.py --phase <工程>` の要点を切らずに読み、根拠が要る項だけ `--sec 4.12` で引く。 成果物は HTML(16:9・1 section = 1スライド)と snapshot.py で印刷した PDF。
| 工程 | 読む・使う |
|---|---|
| 1. 定義 | --phase plan、references/working-practices.md |
| 2. 調べる | 一次情報。確かめた数字は sources.md に控える |
| 3. ストーリーライン | new_deck.py --list |
| 4. 骨組み | new_deck.py --parts ...(作りを見るときだけ --show b09) |
| 5. 中身を書く | --phase build、形に応じて chart / table / process |
| 6. 文章を仕上げる | --phase text、references/ai-smell-lexicon.md |
| 7. 検査と直し | check_all.py、指摘に出た節だけ --sec |
| 8. 最後の確認 | --phase check、snapshot.py の PDF と画像 |
| 9. フレッシュアイ・レビュー | references/content-review-prompt.md |
- 工程1で足して読むもの:
local/(git 管理外)のslide-rules.local.md・forbid.txt・old-colors.txt(local が優先。他社の書式で組むときは check_deck に--brand none)/テーマが AI・業務の自動化ならreferences/jinba-context.md/PPTX にするなら--phase pptx/登壇用ピッチなら--phase pitch。
手順
- 定義する: 目的・成果物の定義・スコープ IN/OUT を3〜5行で決める。誰に・どの会議で・何を判断してもらうかが分からなければ聞く。聞けなければ前提を置いて報告に書き、デッキにせず1枚の論点整理で出す。
- 調べる(必須): 載せる数字・事例・固有名詞は一次情報で確かめ、
sources.mdに1行ずつ控える(数字・何の数字か・出典名・URL・時点)。試算はpython3 -cで計算し、式・入力・結果を貼る。見つからない数字は作らず「要確認」と書く。sources.mdとqa.mdはデッキと同じフォルダに置く。 - ストーリーラインを書く: 1枚1行の主張の列を書き、材料の関係から形を決め(§5.12)、最後に部品を選ぶ。型どおりの並びにせず(§4.103)、薄いページは隣とまとめる(§5.13)。各ページの「タイトル/結論/載せる内容/見せ方」を文章で出し、合意してから組む。
- 骨組みを作る:
python3 scripts/new_deck.py --parts b01,m01,b09:axb,m05,b10 --title "資料名" -o mydeck.html。合う部品が無ければ--list --allを見るか、規約の範囲で自由に組む。 - 中身をまとめて書く: 伏せ字(
Text N・ラベル N・パーツNN|…)を全部実物に置き換えた完成版を1回の Write で書く。数字はsources.mdの値だけを使う。 - 文章を仕上げる: タイトルを上から通し読みし、要るページだけ Edit する。
- 検査して直す:
python3 scripts/check_all.py mydeck.html --sources sources.md(PLAYWRIGHT_MODULE_DIRが無いときだけnpm run setup)。指摘の節を--secで引き、ページごとにまとめて形で直す(直し方はworking-practices.md)。FAIL 0 まで回す。WARN も直すのが既定で、規約の例外に当たるものだけ § を qa.md に書いて残す。 - PDF で全ページを見る:
python3 scripts/snapshot.py mydeck.htmlの PDF と画像を全部見て(pdftoppm は別途入れる)、§8 の目視の基準で確かめた結果をqa.mdにページごとに書く。直したらcheck_all.pyを回し直す。 - フレッシュアイ・レビュー(速度優先と言われたとき以外):
content-review-prompt.mdを作り方を伏せて別エージェントに渡し、採用した指摘を直して検査を回し直す。1ラリーで止めて、続けるかを聞く。
PowerPoint(.pptx)が要るとき
HTML で仕上げ、「PPTX で」と言われたときだけ最後に1回 html_to_pptx.py で変換する。既存の資料へ差し込むページは、その資料のマスターの上で組む(measure_deck.py → deck_pptx.py)。詳しくは --phase pptx。
本スキル使用の注釈
裏表紙(b10)の出典行に「本資料は consulting-pptx-skill(github.com/carnot-tech/consulting-pptx-skill)で作成」が既定で入っている。ツール名を置けるのは最終ページの出典行だけで、他のページに出ると check_deck が FAIL にする。
スキルを育てる
自分の組織の規約は本体を書き換えず local/ に足す。どの組織でも効く指摘・誤検知は、納品後に一度だけ PR を提案する。手順は working-practices.md の「スキルを育てる」、PR に入れないものは CONTRIBUTING.md。