このスキルの機能
デッキをドキュメントではなくビルドとして扱います:
| アーティファクト | 役割 |
|---|---|
template.pptx | ツールチェーン — そのスライドがアーキタイプカタログです。常に必須。 |
deck.mdx | ソース — 誰もが編集する唯一のファイル |
assets/*.svg | 生成されたアート。ソースでもあり、コンテンツのみ、デザインはなし |
deck.pptx | ビルドアーティファクト — 毎回完全に再生成されます |
deck.pdf + ページプレビュー | 人間が実際に見るもの — レイアウトが存在する唯一の場所 |
各出力スライドは、テンプレートスライドのクローンであり、そのコンテンツが入れ替えられるため、テンプレートのデザインはバイト単位でそのまま残ります。何もゼロからレイアウトされることはありません。
エンジン: scripts/deck.py (絶対パスで呼び出します)。
色変更 (任意のpptx。ビルド済みデッキの場合は template.pptx を色変更してリビルド): scripts/ppt_keycolor_changer.py、
手順とプリセットは references/recolor.md にあります — 検出、明度によるマッピング、確認、置換、検証。
常設の指示
- 参照テンプレートなしでビルドしてはいけません。 組み込みのデッキデザインやフォールバックはありません。ユーザーが
.pptxを提供していない場合は、停止してそれを要求してください — 他の方法でスライドを組み立てたり、汎用的なデッキを提供したり、テンプレートをでっち上げたりしないでください。エンジンも拒否しますが、要求はユーザーが作業を始める前にあなたが行うべきものです。 - ソースファイルは
deck.mdxであり、決してdeck.mdではありません。 これはコンパイルされるものであり、読み取られるものではありません。エンジンは他の拡張子を拒否します。 - カタログを先に、作成は後。 テンプレートについての推測から
deck.mdxを作成してはいけません。catalogを実行し、それが出力するスロットIDに対して作成してください。 - 出力されたpptxを手動で編集してはいけません。 次回のビルドで再生成されます。修正は
deck.mdxに行ってください。 buildの前にcheckを実行し、ユーザーに警告を表示してください。 オーバーフロー警告は、詰め込まれたテキストと誰も読めないスライドの違いを生み出します。- 決定基準は見やすさであり、すっきり感ではありません。
| transparentは、画像の内容がスライドに対して読みやすいままである場合に適しています。checkはそれができない場合を報告し、その場合は画像の後ろにパネルを配置する方が良い解決策です。すっきり聞こえるからといって透過性に頼らないでください。 - 断りなしにコンテンツを切り取ってはいけません。
checkは割合を報告します。それをユーザーに伝え、| fitを提案してください。半分が失われる画像は、スライドから落ちるテーブル行と同じ欠陥です。 - 画像スロットのアートをバイナリとして手動で作成してはいけません。 SVGを記述することで、デッキがテキストから再現可能な状態を保てます。貼り付けられたPNGは、再生成、色変更、差分レビューができません。
- デッキは人が読むものなので、実際に見てください。 レンダラーが利用可能な場合は、
buildではなくrenderで終了してください。レイアウト監査とページプレビューだけが、テキストの衝突を確認できる場所です。レンダラーが利用できない場合は、レイアウトがチェックされたと暗示するのではなく、レポートにその旨を明確に記載してください。 - アーキタイプをでっち上げてはいけません。 コンテンツに適合するテンプレートスライドがない場合は、その旨を伝え、コンテンツを再構成するかテンプレートを拡張するかを尋ねてください — 近似してはいけません。
- 無視することを選択した警告も報告してください。 問題ないと判断したオーバーフロー警告でも、最終報告書に含めるべきです — そのスライドを見るのはユーザーです。
- チャートは読み取り専用です。 選択したアーキタイプにチャートがある場合は、これを声に出して伝えてください。ユーザーがPowerPointでチャートを編集しない限り、テンプレートの数値がそのまま出力されます。
プロセス
ステップ0 · 参照テンプレートを入手する
まだ持っていない場合は、何よりも先に .pptx を要求してください:
「レファレンステンプレートのpptxをください。deck-builderはテンプレートスライドを複製する方式なので、テンプレートなしでは作れるスライドがありません。」
テンプレートの説明、類似したデッキ、後で提供するという約束だけで先に進まないでください。
ステップ1 · テンプレートをカタログ化する
python3 /abs/path/scripts/deck.py catalog \
--template "template.pptx" --output "deck.catalog.md"
すべてのアーキタイプを @s1…@sN として、そのスロット、テンプレートが現在表示しているもの、および容量見積もりとともに出力します。何よりも先にこれを読んでください。
ステップ2 · コンテンツをアーキタイプにマッピングする
コンテンツがない場合は、ユーザーに依頼してください。次に、mdを記述する前に、スライドごとに1行の計画を示してください:
1. @s1 表紙 — タイトル + サブタイトル
2. @s3 要約 — 箇条書き3つ + 一行の結論
3. @s7 数字 — 表4行
計画について了承を得てください。誤ったアーキタイプの選択は、間違った文言よりも高くつくミスです。
ステップ3 · deck.mdx を記述する
---
template: template.pptx
template_hash: 5f84440a3521 # カタログから — デッキをテンプレートの構造に固定します
output: deck.pptx
---
## @s3
title: 四半期サマリー
text1:
- 応答 p99 **2.1s → 340ms**
- デプロイ失敗率 12% → 0.4%
table1:
| 指標 | 以前 | 以降 |
| p99 | 2.1s | 340ms |
pic1: assets/arch.svg
notes: 数字の出典を最初に述べること
text5: !drop
画像はフィットモードを取ります — | fit は画像全体を保持し、デフォルトの fill はクロップします —
| transparent はPNGの背景を透過します。省略したスロットはテンプレートのコンテンツを保持します。
完全な構文 — スロット形式、!drop、notes:、インライン強調、アウトラインレベル、
および template_hash が保護するもの — は references/mdx-syntax.md にあります。最初のスライドを記述する前に読んでください。
ステップ3b · デッキに必要なアートを生成する
画像スロットのアートは .svg として、テンプレートの色とフレームの正確なptサイズで記述してください —
どちらも catalog によって出力されます。これはデッキの他の部分と同様にソースとなり、ビルド時にPNGにラスタライズされます。
ルール、根拠、および実例: references/generated-art.md。
ステップ4 · チェック
python3 /abs/path/scripts/deck.py check --deck deck.mdx
エラーは修正する必要があります。警告は判断が必要です — 無視することを決めたものを含め、すべての警告を表面化させてください。
| 測定内容 | 比較対象 |
|---|---|
| テーブルまたはテキストがスライドからはみ出している | スライドの端 — エラー、失われた行を特定 |
| テンプレートが1行に収めているスロットに対してラインが広すぎる | そのスロット自身のフレーム (em単位)。ハングルがラテン文字としてカウントされないように |
| スロットがテンプレートの配置よりもはるかに少ない量を保持している | テンプレート自身のボリューム — フレームはその量のために描かれており、スライドは穴を開ける |
| テキストがデザインの想定位置よりも低く実行されている | テンプレート自身の行数とその下にあるもの |
| クロップロス、実効dpi、パレットからの逸脱、貼り付けボックスの境界線 | フレーム、スクリーン、テンプレートのパレット |
| 画像上のテキスト | 実際に背後にあるピクセル: 大きなタイプでは3:1、本文では4.5:1 |
カバーする単語の後に描画された画像はエラーです — それらはイメージの背後に配置されます。
ここでのすべての見積もりは、絶対値ではなくテンプレート自身のコンテンツに対して較正されています。なぜなら、ほとんどのフレームは既に折り返されるテキストを保持するように描かれているからです。約1行未満のマージンは、静的見積もりで解決できる範囲を超えています: これらを解決できるのはステップ6だけです。
ステップ5 · ビルド
python3 /abs/path/scripts/deck.py build --deck deck.mdx [--output out.pptx] [--strict]
同じ deck.mdx は常にバイト単位で同一のpptxを生成します。
ステップ6 · レンダリングして確認
python3 /abs/path/scripts/deck.py render --deck deck.mdx
ビルドし、LibreOfficeを通じて変換し、すべてのページのPNGプレビューを書き込み、レンダリングされたジオメトリを監査します — overlap (2つのテキストフレームが衝突)、bunched (1つのフレーム内の行がそのフレーム自身の標準よりも近くに配置されているため、テキストがボックスを超えて成長している)、off-slide (レンダラーがそれをカットした)。クリーンはクリーンを意味します: 監査はフレーム間で比較し、各フレームの中央値に対してピッチを測定するため、emボックスが100%行を超えるCJKフォントがトリップすることはありません。
render は最初に、レンダラーが持っていないテンプレートの書体を報告します。置き換えられたフォントはすべての行をリラップするため、それらがインストールされるまでは、プレビューの改行はデッキのものではなく、置き換えられたフォントのものになります — 修正方法はフォントをインストールすることであり、単語を短くすることではありません。pptx自体は常に正しいフォントを指定します。
プレビューはレイアウトのために読み、スペーシングのために読まないでください。LibreOfficeはデフォルトでCJKとラテン文字の間の結合をパディングするため、평균 42분 はプレビューでは 평균 42 분 とレンダリングされますが、pptxは元の文字列を保持します。スペーシングを欠陥として扱う前に、ビルドされたファイル内の <a:t> を確認してください。
レンダラーはPATH上の soffice または DECK_RENDER_DOCKER=<image> です。どちらもない場合、render はレイアウトがチェックされたふりをするのではなく拒否します — その旨を伝え、build にフォールバックしてください。
出力テンプレート
ビルド後のレポート:
ビルド完了 — <出力パス>
スライド <N>個 · テンプレート <名前> · 画像 <M>個挿入
レンダリング検査 — 重なり 0件 (または: 3ページのタイトルが本文と重なっています)
使用したアーキタイプ
@s1 ×1 表紙
@s3 ×4 本文
確認が必要
· 3番スライド title 58文字 (フレーム ~39文字/行) — 2行にまたがります
· 5番スライド chart1 — チャート数値はテンプレート値のままです
次の修正は deck.mdx だけを修正して再度 build してください。出力pptxを手で觸ると失われます。
Claudeの役割 / あなたの役割
| Claude | あなた |
|---|---|
| 参照pptxを要求し、なしでは先に進むことを拒否する | テンプレート(必須)と生のコンテンツを提供する |
catalog を実行し、スロットマップを読む | アーキタイプリストをレビューする |
| スライドごとのアーキタイプ計画を提案する | 計画を承認するか、再構成する |
deck.mdx を記述し、修正する | 好みに応じて直接 deck.mdx を編集する |
check を実行し、すべての警告を報告する | オーバーフロー警告が重要かどうかを判断する |
render を実行し、プレビューを見て、衝突を報告する | pptxを開き、必要に応じてチャートを編集する |
制限事項
約束できることを変更する6つの制限:
| 制限 | 結果 |
|---|---|
| 新しいレイアウトはなし | すべてのスライドはクローンです。アーキタイプがないコンテンツは、PowerPointでテンプレートを拡張する必要があります — 近似するのではなく、その旨を伝えてください。 |
| テンプレートは必須 | 組み込みデザインやフォールバックはありません。 |
| チャートは書き込み不可 | build はテンプレートの数値を残します。画像スロットにSVGを使用してください。 |
| フレームは決して移動しない | 短く書いても隙間は残ります。check がそれを報告しますが、閉じることができるのはテンプレートだけです。 |
| レイアウトの真実にはレンダラーが必要 | check は見積もりであり、1行未満のマージンを解決できません。何が衝突するかを確認できるのは render だけです。 |
| 可読性はPNGのみ | JPEGやSVGの背景の上のタイプはスコアリングされません。継承されたテキストの色はそのまま残されます。 |
完全な表と、各制限がどのステップで捕捉されるか: references/limits.md。
関連スキル
write:plans(ドキュメントの目的) — コンテンツをスライドにマッピングする前に開発するthink:untangle-thoughts— 散らばったメモをステップ2が必要とするスライド単位の構造に変換する