carnot-tech/jinba-consulting-pptx-skill

consulting-pptx-skill

スライド設計規約 slide-rules.md を核に、経営会議品質のスライドを作るスキル。規約は工程ごとに必要な節だけを scripts/rules.py で引き、規約を満たすことを確かめた部品(newdeck.py --list の20種類)で組み、checkdeck.py・checklayout.mjs の機械チェック FAIL 0 で仕上げる。既存の PowerPoint 資料を渡され、そこへ差し込むページを PPTX で求められたときだけ、その資料のマスターの上に直接組む(slide-rules §…

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/carnot-tech/jinba-consulting-pptx-skill --skill consulting-pptx-skill

Before you start

  • Installation does not include a model subscription, API allowance or permission to access your files.
  • Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

コンサル型スライド作成スキル

規約の正典は 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。

手順

  1. 定義する: 目的・成果物の定義・スコープ IN/OUT を3〜5行で決める。誰に・どの会議で・何を判断してもらうかが分からなければ聞く。聞けなければ前提を置いて報告に書き、デッキにせず1枚の論点整理で出す。
  2. 調べる(必須): 載せる数字・事例・固有名詞は一次情報で確かめ、sources.md に1行ずつ控える(数字・何の数字か・出典名・URL・時点)。試算は python3 -c で計算し、式・入力・結果を貼る。見つからない数字は作らず「要確認」と書く。sources.md と qa.md はデッキと同じフォルダに置く。
  3. ストーリーラインを書く: 1枚1行の主張の列を書き、材料の関係から形を決め(§5.12)、最後に部品を選ぶ。型どおりの並びにせず(§4.103)、薄いページは隣とまとめる(§5.13)。各ページの「タイトル/結論/載せる内容/見せ方」を文章で出し、合意してから組む。
  4. 骨組みを作る: python3 scripts/new_deck.py --parts b01,m01,b09:axb,m05,b10 --title "資料名" -o mydeck.html。合う部品が無ければ --list --all を見るか、規約の範囲で自由に組む。
  5. 中身をまとめて書く: 伏せ字(Text N・ラベル N・パーツNN|…)を全部実物に置き換えた完成版を1回の Write で書く。数字は sources.md の値だけを使う。
  6. 文章を仕上げる: タイトルを上から通し読みし、要るページだけ Edit する。
  7. 検査して直す: 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 に書いて残す。
  8. PDF で全ページを見る: python3 scripts/snapshot.py mydeck.html の PDF と画像を全部見て(pdftoppm は別途入れる)、§8 の目視の基準で確かめた結果を qa.md にページごとに書く。直したら check_all.py を回し直す。
  9. フレッシュアイ・レビュー(速度優先と言われたとき以外): 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。