Skip to content
Back to search

consulting-pptx-skill

スライド設計規約 slide-rules.md を核に、経営会議品質のスライドを作るスキル。規約は工程ごとに必要な節だけを scripts/rules.py で引き、規約を満たすことを確かめた部品(new_deck.py --list の20種類)で組み、check_deck.py・check_layout.mjs の機械チェック FAIL 0 で仕上げる。既存の PowerPoint 資料を渡され、そこへ差し込むページを PPTX で求められたときだけ、その資料のマスターの上に直接組む(slide-rules §8.7)。トリガー例:「コンサル品質のスライドを作って」「規約に沿ったデッキで」「この pptx に足すページを同じ書式で」。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 13 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/carnot-tech/jinba-consulting-pptx-skill with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/carnot-tech/jinba-consulting-pptx-skill'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/carnot-tech--jinba-consulting-pptx-skill/badge.svg)](/listings/carnot-tech--jinba-consulting-pptx-skill)

HTML

<a href="/listings/carnot-tech--jinba-consulting-pptx-skill"><img src="/api/listings/carnot-tech--jinba-consulting-pptx-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 46 lines
  1. ---
  2. name: consulting-pptx-skill
  3. description: スライド設計規約 slide-rules.md を核に、経営会議品質のスライドを作るスキル。規約は工程ごとに必要な節だけを scripts/rules.py で引き、規約を満たすことを確かめた部品(new_deck.py --list の20種類)で組み、check_deck.py・check_layout.mjs の機械チェック FAIL 0 で仕上げる。既存の PowerPoint 資料を渡され、そこへ差し込むページを PPTX で求められたときだけ、その資料のマスターの上に直接組む(slide-rules §8.7)。トリガー例:「コンサル品質のスライドを作って」「規約に沿ったデッキで」「この pptx に足すページを同じ書式で」。
  4. ---
  5. # コンサル型スライド作成スキル
  6. 規約の正典は `references/slide-rules.md`。全文は読まず、**工程ごとに `scripts/rules.py --phase <工程>` の要点を切らずに読み、根拠が要る項だけ `--sec 4.12` で引く。** 成果物は HTML(16:9・1 section = 1スライド)と `snapshot.py` で印刷した PDF。
  7. | 工程 | 読む・使う |
  8. | --- | --- |
  9. | 1. 定義 | `--phase plan`、`references/working-practices.md` |
  10. | 2. 調べる | 一次情報。確かめた数字は `sources.md` に控える |
  11. | 3. ストーリーライン | `new_deck.py --list` |
  12. | 4. 骨組み | `new_deck.py --parts ...`(作りを見るときだけ `--show b09`) |
  13. | 5. 中身を書く | `--phase build`、形に応じて `chart` / `table` / `process` |
  14. | 6. 文章を仕上げる | `--phase text`、`references/ai-smell-lexicon.md` |
  15. | 7. 検査と直し | `check_all.py`、指摘に出た節だけ `--sec` |
  16. | 8. 最後の確認 | `--phase check`、`snapshot.py` の PDF と画像 |
  17. | 9. フレッシュアイ・レビュー | `references/content-review-prompt.md` |
  18. - 工程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`。
  19. ## 手順
  20. 1. **定義する**: 目的・成果物の定義・スコープ IN/OUT を3〜5行で決める。誰に・どの会議で・何を判断してもらうかが分からなければ聞く。聞けなければ前提を置いて報告に書き、デッキにせず1枚の論点整理で出す。
  21. 2. **調べる(必須)**: 載せる数字・事例・固有名詞は一次情報で確かめ、`sources.md` に1行ずつ控える(数字・何の数字か・出典名・URL・時点)。試算は `python3 -c` で計算し、式・入力・結果を貼る。見つからない数字は作らず「要確認」と書く。`sources.md` と `qa.md` はデッキと同じフォルダに置く。
  22. 3. **ストーリーラインを書く**: 1枚1行の主張の列を書き、材料の関係から形を決め(§5.12)、最後に部品を選ぶ。型どおりの並びにせず(§4.103)、薄いページは隣とまとめる(§5.13)。各ページの「タイトル/結論/載せる内容/見せ方」を文章で出し、合意してから組む。
  23. 4. **骨組みを作る**: `python3 scripts/new_deck.py --parts b01,m01,b09:axb,m05,b10 --title "資料名" -o mydeck.html`。合う部品が無ければ `--list --all` を見るか、規約の範囲で自由に組む。
  24. 5. **中身をまとめて書く**: 伏せ字(`Text N`・`ラベル N`・`パーツNN|…`)を全部実物に置き換えた完成版を1回の Write で書く。数字は `sources.md` の値だけを使う。
  25. 6. **文章を仕上げる**: タイトルを上から通し読みし、要るページだけ Edit する。
  26. 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 に書いて残す。
  27. 8. **PDF で全ページを見る**: `python3 scripts/snapshot.py mydeck.html` の PDF と画像を全部見て(pdftoppm は別途入れる)、§8 の目視の基準で確かめた結果を `qa.md` にページごとに書く。直したら `check_all.py` を回し直す。
  28. 9. **フレッシュアイ・レビュー**(速度優先と言われたとき以外): `content-review-prompt.md` を作り方を伏せて別エージェントに渡し、採用した指摘を直して検査を回し直す。1ラリーで止めて、続けるかを聞く。
  29. ## PowerPoint(.pptx)が要るとき
  30. HTML で仕上げ、「PPTX で」と言われたときだけ最後に1回 `html_to_pptx.py` で変換する。既存の資料へ差し込むページは、その資料のマスターの上で組む(`measure_deck.py` → `deck_pptx.py`)。詳しくは `--phase pptx`。
  31. ## 本スキル使用の注釈
  32. 裏表紙(b10)の出典行に「本資料は consulting-pptx-skill(github.com/carnot-tech/consulting-pptx-skill)で作成」が既定で入っている。ツール名を置けるのは最終ページの出典行だけで、他のページに出ると check_deck が FAIL にする。
  33. ## スキルを育てる
  34. 自分の組織の規約は本体を書き換えず `local/` に足す。どの組織でも効く指摘・誤検知は、納品後に一度だけ PR を提案する。手順は `working-practices.md` の「スキルを育てる」、PR に入れないものは `CONTRIBUTING.md`。
README.md · README · 171 lines
  1. # consulting-pptx-skill
  2. **AIに「まじ」なPowerPointを作らせるためのClaude Codeスキル。**
  3. AIワークフロープラットフォーム [Jinba](https://jinba.io/ja?utm_source=github&utm_medium=readme&utm_campaign=consulting-pptx-skill&utm_content=top_intro) を提供するメンバーにより作成されました。
  4. スライドの設計規約、規約違反を見つける機械チェック、**65型のHTMLパーツ集**(基本30+追加35)、型カタログPDFをまとめたものです。資料は HTML(16:9)で組み、Chrome で PDF に書き出します。
  5. > AI の活用・業務の自動化を扱うデッキでは、実現する手段の一例として Jinba に触れることがあります(書いてよい事実と触れ方は [references/jinba-context.md](references/jinba-context.md))。触れたくないときは `local/slide-rules.local.md` に「Jinba に触れない」と書くか、依頼のときにそう伝えてください。
  6. 進め方は、規約を読む → パーツ集から必要なパーツを取り出して1枚ずつ組む → 機械チェックを通す → 作り方を知らない別のエージェントにレビューさせる、の順です。
  7. A Claude Code skill for generating boardroom-quality decks: a slide-design rulebook, an automated rule checker, a 65-part HTML slide library (16:9, one section per slide, printed to PDF via Chrome), and a visual catalog PDF.
  8. 私たちが実際に毎週の提案書・報告書づくりで使っている仕組みの公開版です。解説記事はこちら → [AIにまじなスライド作らせる(note)](https://note.com/jinbaflow/n/nc8372b84e572)
  9. > **企業でお使いの方へ**
  10. > - Claude Code を使わず、ブラウザのチャットだけで同じ仕組みを使いたい → [Jinba App](https://jinba.io/ja?utm_source=github&utm_medium=readme&utm_campaign=consulting-pptx-skill&utm_content=top_app)
  11. > - 自社の資料規約・ブランドに合わせた専用版を作りたい、社内に展開したい → [ご相談はこちら](https://jinba.io/ja/contact-sales?utm_source=github&utm_medium=readme&utm_campaign=consulting-pptx-skill&utm_content=top_contact)
  12. ## 本質は `references/slide-rules.md`
  13. このリポジトリでいちばん価値があるのは、実はテンプレでもスクリプトでもなく、**[slide-rules.md](references/slide-rules.md)** というテキストファイルです。「結論はタイトルに書く」「角丸禁止」「塗りのあるボックスに枠線を付けない」「1資料1用語」「前提・定義は左、帰結は右」…。
  14. 使い方は3つだけです。**AIに資料を作らせる前に毎回このファイルを読ませる。出力後に `scripts/check_deck.py` で違反を機械検出する。最後に `references/content-review-prompt.md` の指示文で、作り方を知らない別のエージェントにデッキを読ませ、日本語・論理・矛盾の指摘を受けて採用分だけ直す。** AIはセッションごとに記憶がリセットされるので、口頭で注意しても定着しません。ルールをファイルにして毎回読ませるのが定着させる方法です。
  15. 良いスライドを決めるのは型ではなく、**組んだ後の調整**です。表を2枚に割る、右カラムを帰結の形に書き直す、タイトルだけを通して読んでストーリーを繋ぎ直す。型に囚われず直し、そこで受けた指摘を slide-rules.md に1行足す。この繰り返しが品質の源で、型カタログとパーツ集は「たたき台を早く出して、調整に時間を回す」ための道具です。
  16. 自社で使うときは、slide-rules.md に自社の規約・指摘を追記して育ててください。
  17. ## 65型のスライド型カタログ
  18. 見本の PDF(65ページ)は **[Releases の型カタログ](https://github.com/carnot-tech/jinba-consulting-pptx-skill/releases/tag/catalog-2026-11)** に添付しています。P.1〜30 が基本パーツ集、P.31〜65 が追加パーツ集を印刷したものです。番号と型名の一覧は `python3 scripts/new_deck.py --list --all` で出ます(★がよく使う20種類)。
  19. 「65型」は作れる見せ方の上限ではありません。実際のデッキでは、型を組み合わせたり崩したりして規約の範囲で自由に組むので、見せ方のパターンはこれより多くなります。型カタログは「レイアウトの発想帳」として使い、合わなければ捨ててください。
  20. ## パーツ集の使い方
  21. | ファイル | 中身 | 使用頻度 |
  22. | --- | --- | --- |
  23. | `templates/freeform_parts_16x9.html`(基本パーツ集) | 表紙・全体マップ・目次・章扉・矢羽・前提→帰結・軸のある表・主張パネル・評価表・分布図・スイムレーン・表と裏の2段・一問一答など30パーツ | 高い。まずここから |
  24. | `templates/freeform_parts_more_16x9.html`(追加パーツ集) | エグゼクティブサマリー・積み上げ棒・ブリッジ・散布図・比較表・マトリクス・イシューツリー・ロードマップ・ガントなど35パーツ | 低い。基本で足りないとき |
  25. どちらも 16:9・1 section = 1スライドの単体HTMLです。`scripts/new_deck.py --parts b01,m05,...` のようにパーツ番号を並べると、必要なパーツだけを取り出した1本のHTMLができます(2ファイルの見た目の定義は、衝突しないようにスクリプトが結合します)。あとはプレースホルダー(本文 `Text 1`、項目名 `ラベル 1`、見出し `タイトル 1`、数値 `00`、年 `YYYY年`、出典 `出典:Source 1`)を実物に差し替えます。残っていると `check_deck.py` が FAIL にします。
  26. 各 section のタイトル欄には型名だけが入っていて、見本の主張文は置いていません。見本文があると、その文型をなぞった資料になってしまうからです(slide-rules §2.8)。タイトルは必ず自分のストーリーラインから書きます。
  27. **色と書体は両ファイルで同じ既定**です(暖色系: 生成りの地・濃茶の文字・茶のアクセント。見出しは明朝、本文はゴシック)。各ファイルの `<style>` 冒頭にある `:root` の変数で一括管理していて、ネイビー系にする値はコメントで同梱しています。
  28. ## セットアップ
  29. ```bash
  30. # 1. Claude Code のスキルフォルダに clone する(これだけで規約・パーツ集・機械チェックが使える)
  31. git clone https://github.com/carnot-tech/consulting-pptx-skill.git ~/.claude/skills/consulting-pptx-skill
  32. # 2. PDF 化と実レンダリング検査に使う Chromium headless shell を入れる(Node.js が必要。Chromium 本体は入れない。ダウンロード約95MB)
  33. cd ~/.claude/skills/consulting-pptx-skill && npm run setup # Linux(コンテナ・Pod)は npm run setup:linux(依存ライブラリも入れる。日本語フォントは別に入れる)
  34. # PDF を画像化する snapshot.py には poppler(pdftoppm)も別途必要(`npm run setup` / `setup:linux` では入らない)
  35. # macOS: brew install poppler / Ubuntu: sudo apt install poppler-utils / Windows: poppler-windows の Release を展開して Library\bin を PATH に追加(または conda install -c conda-forge poppler)
  36. # 3.(任意)PPTX に変換する・PPTX を check_deck.py で検査する場合(変換には Node.js 22 以上と手順2の headless shell も使う)
  37. pip3 install python-pptx
  38. ```
  39. - `scripts/check_deck.py`(規約の機械チェック)と `scripts/new_deck.py`(たたき台の生成)は Python 標準ライブラリだけで動きます。
  40. - PDF 化は Chromium headless shell の印刷を使います(`scripts/snapshot.py`)。出力は Chrome 本体と画素単位で同じで、Chrome 本体が要りません。`CHROME_PATH` を指定すると Chrome 本体に切り替えられます(探し方は `scripts/find_browser.py`)。PDF を画像化するには poppler(pdftoppm)が別途必要です。
  41. - `package.json` は手順2の playwright と headless shell を入れるためだけのものです。`node_modules/` は .gitignore 済みです。
  42. ## 更新と自分用のカスタマイズ
  43. 規約と機械チェックは使った人の指摘で頻繁に直ります。**週に 1 回を目安に最新を取り込んでください**。
  44. ```bash
  45. cd ~/.claude/skills/consulting-pptx-skill && git pull
  46. ```
  47. 自分の組織の規約・禁止語・テンプレは `local/` に置きます(`local/README.md` 参照。git 管理外なので `git pull` で消えません)。スキルは本体の規約を読んだ後に `local/slide-rules.local.md` を読み、重なる規則はそちらを優先します。本体のファイルを直接書き換えると更新のたびに衝突するので、組織固有の規則は `local/` に、どの組織でも効く規則は PR にしてください。
  48. ## 手動で使う場合
  49. ```bash
  50. python3 scripts/new_deck.py --list # パーツ番号と型名の一覧
  51. python3 scripts/new_deck.py --parts b01,b02,m05,b06,b09,b10 --title "資料名" -o mydeck.html # たたき台を生成
  52. python3 scripts/check_deck.py mydeck.html # 規約の機械チェック(FAIL 0 にする)
  53. python3 scripts/check_deck.py mydeck.html --forbid ~/.config/deck-forbidden-terms.txt # 社外に出す前に顧客名・社内語の残りを検査(リストはリポジトリ外に置く)
  54. node scripts/check_layout.mjs mydeck.html # フッター重なり・はみ出し・空きの多いページの実レンダリング検査
  55. python3 scripts/snapshot.py mydeck.html # PDF と、4ページずつまとめた目視用の画像(headless shell で印刷)
  56. python3 scripts/html_to_pptx.py mydeck.html # PPTX を求められたときだけ: 編集できる PPTX に変換
  57. ```
  58. ## PowerPoint(.pptx)にする流れ
  59. **まず HTML で仕上げ、PPTX にするのはユーザーから明示されたときだけ**にしています。
  60. 1. HTML でデッキを組み、機械チェック・レビュー・PDF での目視まで HTML 上で済ませる(修正の往復が速く、機械チェックもかけやすい)
  61. 2. 「PPTX で欲しい」と言われたら `scripts/html_to_pptx.py` で変換する。Chrome で描画した結果を読み取り、PowerPoint の図形として組み直すので、文字・表・図形はそのまま PowerPoint で編集できる
  62. 3. PPTX を渡した後に修正が来たら、HTML を直して変換し直す(PPTX を手で直すと HTML と中身がずれる)
  63. SVG のチャートや画像は画像として貼られます(中の数値は編集できません)。書体は Yu Gothic / Yu Mincho に置き換わるので、変換後は PowerPoint で開いて折り返しを確認してください。
  64. ### 既にある PowerPoint 資料へページを足すとき
  65. 社内の標準デッキや作りかけの提案書に数ページ足す場合、変換した PPTX は書体・文字の大きさ・表の作りが元の資料と揃いません。このときは変換せず、**その資料のマスターの上に直接組みます**。
  66. ```bash
  67. python3 scripts/measure_deck.py house.pptx # 資料の書式を測る → house.skin.json(目で見て直す)。.potx も可
  68. python3 examples/house_deck_example.py house.pptx pages.pptx # 作例。資料のマスターの上に 2 ページ組む
  69. python3 scripts/check_deck.py pages.pptx --house house.skin.json
  70. ```
  71. タイトルは資料のプレースホルダーに入り、書体・地色・ページ番号は資料のマスターがそのまま決めます。表は資料と同じ「テキストボックス+罫線」で組むので、貼り付けても書式が変わりません。詳しくは slide-rules.md §8.7。
  72. ## 中身
  73. | パス | 内容 |
  74. | --- | --- |
  75. | `SKILL.md` | AIへの指示書(スキルの本体)。考え方と手順だけを書き、詳細は `references/` に置く |
  76. | `templates/freeform_parts_16x9.html` | 基本パーツ集(30パーツ・1パーツ=1スライド・16:9) |
  77. | `templates/freeform_parts_more_16x9.html` | 追加パーツ集(35パーツ。チャート・比較表・マトリクス・計画系) |
  78. | `references/slide-rules.md` | スライド作成ルール正典 |
  79. | `references/pptx.md`・`references/pitch.md` | 正典から分けた、PPTX にする・差し込む作法(§8.6・§8.7)と登壇用ピッチの作法(§9)。番号のまま `rules.py --sec` で引ける |
  80. | `references/slide-examples.md` | 規約を特定の種類のページ(体制表・工程図・会話の図など)に当てはめた例。規則ではない |
  81. | `references/working-practices.md` | 作業の作法(着手時の確認・シリーズ物・レビューの回し方・目視QAの報告・直し方と渡し方) |
  82. | `references/content-review-prompt.md` | フレッシュアイ・レビューの指示文。機械チェックのあと、作り方を伏せた別エージェントにデッキのファイルを渡して日本語・論理・破綻を拾わせ、採否表にして直す |
  83. | `references/ai-smell-lexicon.md` | AI臭ワード・言い回しのリストとセルフチェック |
  84. | `references/rules-digest.md` | 規約の要点版(工程ごと。各行に正典の § 番号)。`scripts/rules.py --phase <工程>` で表示する。`scripts/build_digest.py` が規約から作る(手で直さない) |
  85. | `references/jinba-context.md` | Jinba の公開情報と、AI 活用・業務自動化のデッキでの触れ方(触れないときの条件つき) |
  86. | `scripts/new_deck.py` | パーツ番号を並べて1本のデッキHTMLを生成(両パーツ集のCSSをスコープして結合・ページ番号の振り直し)。`--list` でよく使う20種類と使いどころ、`--show b09` で1部品のHTML |
  87. | `scripts/rules.py` | 規約を工程ごとに引く(`--phase plan` など=要点版、`--sec 4.12` で1項、`--full` で節全体) |
  88. | `scripts/check_all.py` | check_deck・check_layout・出典の照合(`sources.md`)を1回で回し、指摘をページごとにまとめる |
  89. | `scripts/snapshot.py` | PDF と、4ページずつまとめた目視用の画像を1回で作る(`--page N` で1ページを大きく) |
  90. | `scripts/check_deck.py` | 規約の機械チェック(HTML / PPTX 両対応。テンプレ集の検査は `--template`)。タイトルの「N段階」と本文の連番の食い違いも FAIL にする |
  91. | `scripts/html_to_pptx.py` | HTMLデッキを編集できる PPTX に変換(ユーザーが PPTX を求めたときだけ使う)。`scripts/html_dump.mjs` が Chrome で描画した要素を書き出し、python-pptx で組み立てる。追加の npm パッケージは不要(`scripts/lib_cdp.mjs` が Chrome を直接操作する) |
  92. | `scripts/check_layout.mjs` | HTMLデッキの実レンダリング検査(フッターとの重なり・右端/下端のはみ出し・版面の40%超の空き) |
  93. | `scripts/measure_deck.py` | 既存の PowerPoint 資料の書式(レイアウト・タイトルの枠・文字の大きさ・書体の指定の有無・罫線・色)を測り、`skin.json` に書き出す |
  94. | `scripts/deck_pptx.py` | 測った書式で、その資料のマスターの上に編集可能なページを組む部品(タイトル・見出し・罫線の表・強調の面・矢羽・✓✕△)。作例は `examples/house_deck_example.py` |
  95. | `tests/` | 機械チェックの自己テスト(`python3 -m unittest discover -s tests`)。指摘を機械チェックにしたら、直していない版で FAIL が出ることをここで確かめる |
  96. ## カスタマイズ
  97. - 色・書体は両パーツ集の `<style>` 冒頭 `:root` トークンで差し替えます。ブランドに合わせるときは両ファイルを同じ値にします
  98. - 生成した資料の**最終ページの出典行だけ**に「consulting-pptx-skill で作成」の注釈を入れます。他のページにツール名が出ていると `check_deck.py` が FAIL にします
  99. - PowerPoint(.pptx)が要るときは、HTML で仕上げてから `scripts/html_to_pptx.py` で変換します(上の「PowerPoint(.pptx)にする流れ」)。以前あった JSON から編集可能PPTXを書き出す仕組みは外しました(git タグ `pipeline-archived` の時点のリポジトリに残っています)
  100. ## コントリビューション
  101. Issue・Pull Request を歓迎します。出し方(規約と機械チェックをセットで足す、機密を入れない、テストの書き方など)は [CONTRIBUTING.md](CONTRIBUTING.md) にまとめています。
  102. 使っていて「この指摘は当社だけでなく誰にでも効く」と思ったら、それが一番よい PR の種です。スキル自身も、本体の規約の誤検知や新しい指摘に当たったとき「PR で出しませんか」と一度だけ聞くようになっています。`local/` に溜まった規則のうち顧客名の入っていないものを、月に 1 回見直して PR にするのがおすすめです。
  103. ## About
  104. Made by [Carnot AI](https://jinba.io/ja?utm_source=github&utm_medium=readme&utm_campaign=consulting-pptx-skill&utm_content=about) — AIエージェント基盤「Jinba」を開発・提供しています。
  105. - **ブラウザだけで使いたい方へ**:このスキルと同じ仕組みを、チャットだけで使える形([Jinba App](https://jinba.io/ja?utm_source=github&utm_medium=readme&utm_campaign=consulting-pptx-skill&utm_content=about_app))でも提供しています。Claude Code や Python の準備は要りません。
  106. - **自社専用版を作りたい企業へ**:御社の既存資料とレビュー指摘から slide-rules.md とデザインを作り込み、社内のだれもが使える形で展開するご支援をしています。[ご相談はこちら](https://jinba.io/ja/contact-sales?utm_source=github&utm_medium=readme&utm_campaign=consulting-pptx-skill&utm_content=about_contact)
  107. ## Star History
  108. <a href="https://www.star-history.com/?repos=carnot-tech%2Fjinba-consulting-pptx-skill&type=date&legend=top-left">
  109. <picture>
  110. <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=carnot-tech/jinba-consulting-pptx-skill&type=date&theme=dark&legend=top-left" />
  111. <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=carnot-tech/jinba-consulting-pptx-skill&type=date&legend=top-left" />
  112. <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=carnot-tech/jinba-consulting-pptx-skill&type=date&legend=top-left" />
  113. </picture>
  114. </a>
  115. ## License
  116. コード・文書は [MIT License](LICENSE) です。MIT License には商標を使う権利は含まれません。「Carnot」「Carnot AI」「Jinba」とロゴの扱いは [TRADEMARK.md](TRADEMARK.md)(事実としての言及・クレジット行・リンクは自由、製品名・ロゴ・公式を装う表現・改変版への商標使用は要許可)に従ってください。
scripts/measure_deck.py · Bundled script · 358 lines
  1. #!/usr/bin/env python3
  2. """既存の PowerPoint 資料の書式を測り、skin.json に書き出す。
  3. 使い方:
  4. python3 measure_deck.py house.pptx # 要約を表示し、house.skin.json を同じフォルダに出力
  5. python3 measure_deck.py house.pptx -o skin.json
  6. python3 measure_deck.py house.potx # PowerPoint テンプレート(.potx)も測れる
  7. python3 measure_deck.py house.pptx --layout "タイトルとコンテンツ" # 本文ページのレイアウトを名前で指定する
  8. 出力は deck_pptx.py(その資料のマスターの上にページを組む)と check_deck.py --house(書式が合っているかの検査)が読む。
  9. 測るのは、本文ページで最も使われているレイアウトとタイトル・副題の枠、文字の大きさ、書体を run に直指定しているか、
  10. テキストボックスの余白と段組み(lstStyle)、罫線の色と太さ、表オブジェクトの有無、強調と面の色、ページ番号の出どころ。
  11. 色は役割(強調・面・丸)ごとに多い順で 3 つまで候補を残し(color_options)、組む側で選べる。
  12. 資料が HEX で書いた色でも、テーマ色かその明暗(PowerPoint の「明るく 40%」等)と一致すればテーマ色に置き換える。
  13. こうしておくと、差し込んだ先のテーマが変わっても色が付いてくる。
  14. 値は機械的に拾った出発点。資料を目で見て確かめてから使う(slide-rules §8.7)。
  15. 依存: python-pptx。
  16. """
  17. import collections
  18. import colorsys
  19. import json
  20. import re
  21. import sys
  22. import zipfile
  23. from pathlib import Path
  24. EMU = 914400
  25. A = "{http://schemas.openxmlformats.org/drawingml/2006/main}"
  26. P = "{http://schemas.openxmlformats.org/presentationml/2006/main}"
  27. NEUTRAL = {"tx1", "bg1", "dk1", "lt1", "000000", "FFFFFF"}
  28. NG_RED = "FF0000" # ✕ の赤。意味を持つ赤はブランドに寄せない(§5.8)。skin の colors.ng で変えられる
  29. # PowerPoint の色の選択肢に並ぶ明暗(lumMod, lumOff)。HEX の色をテーマ色に読み替えるときに試す
  30. TINTS = [(None, None), (20000, 80000), (40000, 60000), (60000, 40000), (75000, None), (50000, None),
  31. (50000, 50000), (65000, 35000), (75000, 25000), (85000, 15000), (95000, 5000),
  32. (95000, None), (85000, None), (65000, None), (90000, None)]
  33. SLOTS = ("tx1", "bg1", "tx2", "bg2", "accent1", "accent2", "accent3", "accent4", "accent5", "accent6")
  34. def inch(v):
  35. return None if v is None else round(v / EMU, 2)
  36. def color_spec(el):
  37. """<a:solidFill> を持つ要素から "accent2|lumMod=20000|lumOff=80000" の形を作る。無ければ None。"""
  38. fill = el.find(A + "solidFill") if el is not None else None
  39. if fill is None or not len(fill):
  40. return None
  41. c = fill[0]
  42. name = c.get("val")
  43. if name is None:
  44. return None
  45. if c.tag == A + "srgbClr":
  46. name = name.upper()
  47. return "|".join([name] + [f"{ch.tag[len(A):]}={ch.get('val')}" for ch in c if ch.tag[len(A):] != "alpha"])
  48. def theme_colors(theme_xml, master_xml):
  49. """スライドで使う名前(tx1・accent2 等)→ その資料のテーマでの HEX。マスターの clrMap を通して引く。"""
  50. slots = {}
  51. for slot, body in re.findall(r"<a:(dk1|lt1|dk2|lt2|accent\d|hlink|folHlink)>(.*?)</a:\1>", theme_xml, re.S):
  52. m = re.search(r'(?:srgbClr val|lastClr)="([0-9A-Fa-f]{6})"', body)
  53. if m:
  54. slots[slot] = m.group(1).upper()
  55. cmap = dict(re.findall(r'\b(bg1|tx1|bg2|tx2)="(\w+)"', (re.search(r"<p:clrMap[^>]*>", master_xml) or [""])[0]))
  56. cmap = {**{"bg1": "lt1", "tx1": "dk1", "bg2": "lt2", "tx2": "dk2"}, **cmap}
  57. return {name: slots.get(cmap.get(name, name)) for name in SLOTS if slots.get(cmap.get(name, name))}
  58. def _tint(hexv, mod, off):
  59. r, g, b = (int(hexv[i:i + 2], 16) / 255 for i in (0, 2, 4))
  60. h, l, s = colorsys.rgb_to_hls(r, g, b)
  61. l = min(1.0, max(0.0, l * (mod or 100000) / 100000 + (off or 0) / 100000))
  62. return tuple(round(v * 255) for v in colorsys.hls_to_rgb(h, l, s))
  63. def to_theme(spec, theme):
  64. """HEX の色("808080")が、テーマ色かその明暗と一致すればテーマ色の書き方に直す。一致しなければそのまま。"""
  65. if not spec or not re.fullmatch(r"[0-9A-F]{6}", spec):
  66. return spec
  67. want = tuple(int(spec[i:i + 2], 16) for i in (0, 2, 4))
  68. for mod, off in TINTS:
  69. for name, hexv in theme.items():
  70. if max(abs(a - b) for a, b in zip(_tint(hexv, mod, off), want)) <= 2:
  71. return "|".join([name] + ([f"lumMod={mod}"] if mod else []) + ([f"lumOff={off}"] if off else []))
  72. return spec
  73. def top(counter, skip=(), n=1):
  74. items = [k for k, _ in counter.most_common() if k not in skip]
  75. return (items[0] if items else None) if n == 1 else items[:n]
  76. def pick_body_layout(slides, with_title):
  77. """本文ページのレイアウトを選ぶ。使われた回数が多い順。
  78. 表紙・章扉・本文を 1 枚ずつ並べた見本(テンプレート配布物に多い)では回数が同点になり、
  79. 先頭(表紙)が選ばれてしまう。同点のときは
  80. 1. タイトル枠が中央タイトル(ctrTitle=表紙・章扉向け)でないレイアウト
  81. 2. 資料の後ろのほうで使われているレイアウト(表紙は先頭に来る)
  82. の順で本文らしいほうを採る。
  83. """
  84. from pptx.enum.shapes import PP_PLACEHOLDER
  85. use = collections.Counter(s.slide_layout.name for s in slides)
  86. last = {s.slide_layout.name: i for i, s in enumerate(slides)}
  87. def plain_title(name):
  88. return any(ph.placeholder_format.type == PP_PLACEHOLDER.TITLE for ph in with_title[name].placeholders)
  89. cands = [n for n in use if n in with_title]
  90. if not cands:
  91. return None
  92. return max(cands, key=lambda n: (use[n], plain_title(n), last[n]))
  93. def measure(path, layout=None):
  94. """layout: 本文ページのレイアウト名。省くと pick_body_layout で選ぶ。"""
  95. from lxml import etree
  96. from pptx.enum.shapes import PP_PLACEHOLDER
  97. from pptx_open import open_presentation
  98. prs = open_presentation(path) # .potx(テンプレート)もそのまま測れる
  99. sw, sh = prs.slide_width, prs.slide_height
  100. slides = list(prs.slides)
  101. if not slides:
  102. sys.exit("スライドが 1 枚もない資料は測れない(書式は実際のページから読む)")
  103. # ---- 本文ページのレイアウト(タイトル枠のあるもの)。指定が無ければ使われ方から選ぶ
  104. use = collections.Counter(s.slide_layout.name for s in slides)
  105. with_title = {l.name: l for l in prs.slide_layouts
  106. if any(ph.placeholder_format.type in (PP_PLACEHOLDER.TITLE, PP_PLACEHOLDER.CENTER_TITLE)
  107. for ph in l.placeholders)}
  108. if layout is not None:
  109. if layout not in with_title:
  110. sys.exit(f"レイアウト「{layout}」はタイトル枠を持つレイアウトに無い(候補: {', '.join(with_title)})")
  111. layout_name = layout
  112. else:
  113. layout_name = pick_body_layout(slides, with_title)
  114. title, subtitle = None, None
  115. if layout_name:
  116. lay = with_title[layout_name]
  117. master_sz = re.search(r"<p:titleStyle>.*?<a:defRPr[^>]*\bsz=\"(\d+)\"",
  118. etree.tostring(lay.slide_master._element, encoding="unicode"), re.S)
  119. for ph in lay.placeholders:
  120. kind = ph.placeholder_format.type
  121. geo = dict(x=inch(ph.left), y=inch(ph.top), w=inch(ph.width), h=inch(ph.height))
  122. if kind in (PP_PLACEHOLDER.TITLE, PP_PLACEHOLDER.CENTER_TITLE):
  123. title = dict(geo, default_size=int(master_sz.group(1)) / 100 if master_sz else None)
  124. elif kind == PP_PLACEHOLDER.SUBTITLE:
  125. subtitle = geo
  126. sizes, bold_sizes, title_sizes = collections.Counter(), collections.Counter(), collections.Counter()
  127. run_colors, fonts = collections.Counter(), collections.Counter()
  128. runs_total = runs_font = 0
  129. insets, lst_styles = collections.Counter(), collections.Counter()
  130. rule_colors, rule_widths = collections.Counter(), collections.Counter()
  131. panel_fills, small_fills, palette = collections.Counter(), collections.Counter(), collections.Counter()
  132. native_tables = slidenum_slides = 0
  133. tops, bottoms = [], []
  134. for s in slides:
  135. root = s._element
  136. xml = etree.tostring(root, encoding="unicode")
  137. if s.slide_layout.name == layout_name:
  138. native_tables += xml.count("<a:tbl>")
  139. slidenum_slides += 'type="slidenum"' in xml
  140. for v in re.findall(r'<a:srgbClr val="([0-9A-Fa-f]{6})"', xml):
  141. palette[v.upper()] += 1
  142. for v in re.findall(r'<a:schemeClr val="([^"]+)"', xml):
  143. palette[v] += 1
  144. if s.shapes.title is not None and s.slide_layout.name == layout_name:
  145. for para in s.shapes.title.text_frame.paragraphs:
  146. for r in para.runs:
  147. if r.text.strip():
  148. title_sizes[r.font.size.pt if r.font.size else (title or {}).get("default_size")] += 1
  149. floor = (title["y"] + title["h"] - 0.15) * EMU if title else 0
  150. body = [x for x in s.shapes if not x.is_placeholder and x.top is not None and x.height and x.width
  151. and x.top >= floor]
  152. if body and s.slide_layout.name == layout_name:
  153. tops.append(min(x.top for x in body))
  154. bottoms.append(max(x.top + x.height for x in body))
  155. for sp in root.iter(P + "sp"):
  156. is_ph = sp.find(f"{P}nvSpPr/{P}nvPr/{P}ph") is not None
  157. spPr = sp.find(P + "spPr")
  158. txBody = sp.find(P + "txBody")
  159. is_box = sp.find(f"{P}nvSpPr/{P}cNvSpPr").get("txBox") == "1"
  160. if txBody is not None and not is_ph:
  161. for r in txBody.iter(A + "r"):
  162. t = r.findtext(A + "t") or ""
  163. rPr = r.find(A + "rPr")
  164. if not t.strip() or rPr is None:
  165. continue
  166. runs_total += 1
  167. if rPr.get("sz"):
  168. sizes[int(rPr.get("sz")) / 100] += len(t)
  169. if rPr.get("b") == "1":
  170. bold_sizes[int(rPr.get("sz")) / 100] += 1
  171. c = color_spec(rPr)
  172. if c:
  173. run_colors[c] += 1
  174. face = [f.get("typeface") for f in (rPr.find(A + "latin"), rPr.find(A + "ea")) if f is not None]
  175. face = [f for f in face if f and not f.startswith("+")]
  176. if face:
  177. runs_font += 1
  178. fonts[face[0]] += 1
  179. if is_box:
  180. bp = txBody.find(A + "bodyPr")
  181. insets[tuple(int(bp.get(k, d)) for k, d in
  182. (("lIns", 91440), ("tIns", 45720), ("rIns", 91440), ("bIns", 45720)))] += 1
  183. ls = txBody.find(A + "lstStyle")
  184. lst_styles[etree.tostring(ls, encoding="unicode") if ls is not None and len(ls) else ""] += 1
  185. if spPr is not None and not is_ph:
  186. fill = color_spec(spPr)
  187. ext = spPr.find(f"{A}xfrm/{A}ext")
  188. geom = spPr.find(A + "prstGeom")
  189. if fill and ext is not None:
  190. w, h = int(ext.get("cx")), int(ext.get("cy"))
  191. area = w * h / (sw * sh)
  192. if 0.06 <= area < 0.9 and (geom is None or geom.get("prst") == "rect"):
  193. panel_fills[fill] += 1
  194. elif geom is not None and geom.get("prst") == "ellipse" and max(w, h) <= 0.6 * EMU:
  195. small_fills[fill] += 1
  196. for cx in root.iter(P + "cxnSp"):
  197. ln = cx.find(f"{P}spPr/{A}ln")
  198. ext = cx.find(f"{P}spPr/{A}xfrm/{A}ext")
  199. if ln is None or ext is None or int(ext.get("cy")) != 0: # 横の罫線だけ
  200. continue
  201. c = color_spec(ln)
  202. if c:
  203. rule_colors[c] += 1
  204. if ln.get("w"):
  205. rule_widths[round(int(ln.get("w")) / 12700, 2)] += 1
  206. # ---- 文字の大きさ(本文=最も多い。密=その下で 5% 以上ある最大のもの。見出し=本文より大きい太字で最も多いもの)
  207. total = sum(sizes.values()) or 1
  208. body_sz = top(sizes)
  209. smaller = sorted((s for s, n in sizes.items() if body_sz and s < body_sz and n / total >= 0.05), reverse=True)
  210. head_sz = top(collections.Counter({s: n for s, n in bold_sizes.items() if body_sz and body_sz < s <= body_sz * 2}))
  211. # ---- 段組み(テキストボックスの過半が同じ lstStyle を持つなら、それを写す)
  212. lst, bullet_lvl = None, None
  213. best = top(lst_styles, skip=("",))
  214. if best and lst_styles[best] / sum(lst_styles.values()) >= 0.3:
  215. lst = re.sub(r'\s+xmlns:\w+="[^"]+"', "", best)
  216. for i, lv in enumerate(re.findall(r"<a:lvl\dpPr.*?</a:lvl\dpPr>", lst, re.S)):
  217. ch = re.search(r'<a:buChar char="([^"]*)"', lv)
  218. if ch and ch.group(1).strip("​‌‍ "):
  219. bullet_lvl = i
  220. break
  221. theme = ""
  222. with zipfile.ZipFile(path) as z:
  223. names = [n for n in z.namelist() if re.match(r"ppt/theme/theme\d+\.xml$", n)]
  224. theme = z.read(sorted(names)[0]).decode("utf8", "ignore") if names else ""
  225. masters = sorted(n for n in z.namelist() if re.match(r"ppt/slideMasters/slideMaster\d+\.xml$", n))
  226. master = z.read(masters[0]).decode("utf8", "ignore") if masters else ""
  227. layouts_xml = " ".join(z.read(n).decode("utf8", "ignore") for n in z.namelist()
  228. if n.startswith(("ppt/slideLayouts/slideLayout", "ppt/slideMasters/slideMaster")))
  229. major = re.search(r'<a:majorFont><a:latin typeface="([^"]*)"', theme)
  230. minor = re.search(r'<a:minorFont><a:latin typeface="([^"]*)"', theme)
  231. page_number = ("layout" if 'type="slidenum"' in layouts_xml and slidenum_slides < len(slides) / 2
  232. else "slide" if slidenum_slides >= len(slides) / 2 else "none")
  233. row_w = top(rule_widths)
  234. heavier = [w for w, _ in rule_widths.most_common() if row_w and w > row_w]
  235. ins = top(insets) or (91440, 45720, 91440, 45720)
  236. x0 = title["x"] if title else 0.5
  237. x1 = round(title["x"] + title["w"], 2) if title else round(sw / EMU - 0.5, 2)
  238. median = lambda v: sorted(v)[len(v) // 2] if v else None # noqa: E731
  239. tc = theme_colors(theme, master)
  240. def options(counter):
  241. """役割ごとの候補(多い順に 3 つまで・テーマ色に読み替え・重複は 1 つに)"""
  242. out = []
  243. for spec in top(counter, skip=NEUTRAL, n=10):
  244. spec = to_theme(spec, tc)
  245. if spec not in out and spec.split("|")[0] not in NEUTRAL:
  246. out.append(spec)
  247. return out[:3]
  248. opts = {"emphasis": options(run_colors), "panel": options(panel_fills), "accent": options(small_fills)}
  249. rule_color = to_theme(top(rule_colors) or "7F7F7F", tc)
  250. used = {to_theme(v, tc).split("|")[0] for v in palette} | set(palette)
  251. return {
  252. "source": Path(path).name,
  253. "slide": {"w": inch(sw), "h": inch(sh), "emu": [sw, sh]},
  254. "layout": layout_name,
  255. "layouts_used": dict(use.most_common(6)),
  256. "title": dict(title or {}, size=top(title_sizes), sizes_seen=dict(title_sizes.most_common(5))) if title else None,
  257. "subtitle": subtitle,
  258. "margin": {"x0": x0, "x1": x1, "body_top": inch(median(tops)),
  259. "bottom": min(inch(median(bottoms)) or 99, round(sh / EMU - 0.4, 2))},
  260. "sizes": {"head": head_sz or body_sz, "body": body_sz, "dense": smaller[0] if smaller else body_sz,
  261. "seen": {str(k): v for k, v in sizes.most_common(8)}},
  262. "fonts": {"inherit": runs_total == 0 or runs_font / runs_total < 0.5,
  263. "explicit_share": round(runs_font / runs_total, 2) if runs_total else 0.0,
  264. "explicit": top(fonts), "theme_major": major.group(1) if major else None,
  265. "theme_minor": minor.group(1) if minor else None},
  266. "textbox": {"insets": [inch(v) for v in ins], "lst_style": lst, "bullet_level": bullet_lvl},
  267. "rule": {"color": rule_color, "row": row_w or 0.5,
  268. "head": heavier[0] if heavier else (row_w or 0.5) * 2},
  269. "tables": {"native": native_tables, "slides": len(slides)},
  270. "colors": dict({k: (v[0] if v else None) for k, v in opts.items()}, ng=NG_RED),
  271. "color_options": opts,
  272. "theme_colors": tc,
  273. "palette": sorted(used),
  274. "page_number": page_number,
  275. }
  276. def summary(k):
  277. t, f, m = k["title"] or {}, k["fonts"], k["margin"]
  278. lines = [
  279. f"資料: {k['source']}({k['slide']['w']} × {k['slide']['h']} in・{k['tables']['slides']} 枚)",
  280. f"レイアウト: {k['layout']}(使用数 {k['layouts_used']})",
  281. f"タイトル: x {t.get('x')} y {t.get('y')} 幅 {t.get('w')} 高さ {t.get('h')}・{t.get('size')}pt"
  282. f"(既定 {t.get('default_size')}pt、実測 {t.get('sizes_seen')})" if t else "タイトル: 枠のあるレイアウトが見つからない",
  283. f"副題: {'y ' + str(k['subtitle']['y']) if k['subtitle'] else 'なし'}",
  284. f"本文の範囲: x {m['x0']}〜{m['x1']}・上 {m['body_top']}・下 {m['bottom']}",
  285. f"文字: 見出し {k['sizes']['head']}pt・本文 {k['sizes']['body']}pt・密 {k['sizes']['dense']}pt(実測 {k['sizes']['seen']})",
  286. f"書体: {'テーマ任せ(run に書かない)' if f['inherit'] else '直指定 ' + str(f['explicit'])}"
  287. f"(直指定の割合 {f['explicit_share']}・テーマ {f['theme_major']} / {f['theme_minor']})",
  288. f"テキストボックス: 余白 {k['textbox']['insets']}・段組み {'あり(箇条書きは lvl=' + str(k['textbox']['bullet_level']) + ')' if k['textbox']['lst_style'] else 'なし'}",
  289. f"罫線: {k['rule']['color']}・行間 {k['rule']['row']}pt・見出し下 {k['rule']['head']}pt",
  290. f"表: 本文ページの表オブジェクト {k['tables']['native']} 個" + ("(テキストボックス+罫線で組んでいる)" if not k['tables']['native'] else ""),
  291. f"色: 強調 {k['colors']['emphasis']}・面 {k['colors']['panel']}・丸 {k['colors']['accent']}・✕ {k['colors']['ng']}",
  292. f"色の候補(d.c(役割, 番号) で選ぶ): " + "・".join(f"{r} {v}" for r, v in k["color_options"].items()),
  293. f"ページ番号: {dict(layout='レイアウトが出す(スライドに置かない)', slide='スライドごとに置いている', none='なし')[k['page_number']]}",
  294. ]
  295. return "\n".join(lines)
  296. def main():
  297. args = sys.argv[1:]
  298. out = layout = None
  299. if "-o" in args:
  300. i = args.index("-o")
  301. out = args[i + 1]
  302. del args[i:i + 2]
  303. if "--layout" in args:
  304. i = args.index("--layout")
  305. layout = args[i + 1]
  306. del args[i:i + 2]
  307. if not args:
  308. sys.exit(__doc__)
  309. src = Path(args[0])
  310. skin = measure(src, layout=layout)
  311. out = Path(out) if out else src.with_suffix(".skin.json")
  312. out.write_text(json.dumps(skin, ensure_ascii=False, indent=2), encoding="utf8")
  313. print(summary(skin))
  314. print(f"\n→ {out}(目で見て直してから使う)")
  315. if __name__ == "__main__":
  316. main()

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.