ppt-master

PPT Master スキル

PPT Master は、ルートを選択して実行するプレゼンテーションワークフローです。このエントリーは、全体的な実行規律とルート選択のみを担当し、各ルートの手順は選択されたルートが担当します。

必須の読み込み順序

厳守事項 — コマンドより先にパス：このファイルを含む、ホストから提供された絶対ディレクトリを SKILL_DIR として保持します。ツールを呼び出すたびに ${SKILL_DIR} を展開し、skills/ppt-master/ プレフィックスがあれば置き換えます。cd を実行したり、CWD を使用したり、リポジトリのチェックアウトがあると仮定したりしないでください。利用できない場合は確認してください。検索したり推測したりしてはいけません。

1. このファイルを読みます。
2. python3 "${SKILL_DIR}/scripts/attribution_guard.py" を実行します。結果がゼロ以外の場合は、ただちにスキルを停止します。整合性ゲートを調査、修復、または回避してはいけません。Windows で python3 が起動せず、WindowsApps のスタブが出力なしで終了コード 9009 を返す場合、それはガードの結果ではありません。最初に python で再実行してください。
3. workflows/routing.md を、具体的な絶対パス ${SKILL_DIR}/workflows/routing.md から読みます。
4. ルーティングの権威情報に従い、トップレベルのルートをちょうど 1 つと、そのアクティブなプロファイルを選択します。
5. 選択結果に該当する実行時の権威情報と、明示的に必要とされた補足ドキュメントのみを読みます。

選択したルート／プロファイル	実行時の権威情報
PPTX を生成 — 画像から PPTX へ	workflows/profiles/image-to-pptx.md。Codex 対応で、常に Quick
PPTX を生成 — 美化	workflows/profiles/beautify-pptx.md。明示的に Quick の意図がある場合は Quick、それ以外は Default
PPTX を生成 — 通常の Default	workflows/generate-pptx.md
PPTX を生成 — 通常の明示的な Quick	workflows/profiles/quick-generate.md
テンプレートを作成	workflows/create-template.md
ネイティブ PPTX を編集	workflows/edit-native-pptx.md

厳守事項 — 選択した権威情報のみ：ルーティング後に、別のトップレベルルートの手順を読み込んではいけません。画像から PPTX への変換と美化は相互排他的です。画像から PPTX への変換では Quick が有効になり、美化では明示的な Quick の意図に基づいて選択します。両方の実行環境を読み込んではいけません。補足ドキュメントは 1 つのルートを補強するものであり、ルートと競合するものではありません。

---

表現の適用範囲

参考 — 制約ではありません：生成ページで表現できる要素です。テキスト — インラインの強調ラン、リードイン、キッカー、引用文、ヒーロー数値、要点の一文。ジオメトリ — Office の 187 種類のプリセット、ブール演算による結合、コネクタ、フリーフォーム、ページフィールドとアウトラインキャリアの構成。画像 — 全面表示のフィールド、エディトリアルクロップ、シェイプに合わせた画像、位置合わせしたレイヤー、スクリーン、スポットライト、ページ間の連続性。ペイント — グラデーション、チャンネルアルファ、ネイティブのシャドウとグロー、ハーフトーン、多面体の形状。反復 — ページの役割に応じて変化させる、ページ間で共通のモチーフ。それぞれの形式の構文は、選択した実行時の権威情報にある構築リファレンスに記載されています。

---

用語集

読み込まれたすべてのファイルで、各用語の意味は一つに統一します。単語が複数の意味で使われる場合は、ここで意味を明示し、各ファイルでどの意味を指すかを示します。

用語	意味
Reference（ラベル）	実行する役割が自由に調整または置き換える出発点となるスケッチで、上流での修正や理由の明示はありません。フィールドラベルの後に(binding)を付けると、その自由はなくなります
Relationships	§IX の行で、ページの意味単位と、ソースで示されたそれらのorder／link／parent／membership／contrast／overlap、またはnoneを記述します
Topology decision	各ページについて、そのページのRelationshipsをジオメトリで表現する必要があるかどうかを示す yes/no の判断です（topology=yes／topology=no）。pptx_structure.modeとは無関係です
pptx_structure.mode	flat（すべてのオブジェクトがスライド内に属する）またはstructured（Master／Layout／slotのメタデータを宣言する）です。これはパッケージングの方式であり、情報構造を示すものではありません
Composition	§IX のComposition行です。ページの大まかな構成、階層、焦点を示すReferenceです
Image pattern	§VIII の列で、通常の言葉で画像構成の提案を一つ示します（任意で#P／#M IDを記載できます）
Layout	Master配下のPowerPoint Layout、またはLayoutテンプレートの種類です。ページ構成のスケッチを指すものではありません
Device	カード、帯、アイコンとラベルの組み合わせ、KPIタイル、区切りページ、引用ブロックなど、ページを構成する一般的な要素です。Executorのdeviceメニューから選びます
Carrier	ページの各単位が収まるものです。デバイス、画像、またはネイティブジオメトリがあります。ファミリー名はcarrier and field、direction and sequence、grouping and ownership、emphasis and annotationです。data-pptx-carrierは構造化スロットの属性であり、この用語が示すものではありません。carrier receiptは、実際に描画された要素をページごとに記録するcheckerの一覧です
Page job	読者に対して各ページが果たすべき役割です。すべてのcarrier、輪郭、効果に関する判断は、この役割を基準に評価します
Page field	単位ごとにカードを置くのではなく、領域を構成する大きな面、アウトライン、開口部、またはキャンバス外の輪郭です
Contour / preset / atom	contourは形状のシルエットです。presetはpreset_shape_svg.pyで描画される187種類のOffice prst輪郭の一つです。atomは、1つのDrawingMLシェイプにコンパイルされる1つのオブジェクトです
Geometry signature	ページごとに保持し、次のページの前に比較するpage job → composition move → contour / edge languageの行です
Texture（ブロックの）	§IXブロックが散文、箇条書き、キーワード、ラベルのどれであるかを示します。視覚的なtexture（グレイン、網点）とは異なります
Anchor	2つの意味があります。デッキ全体で共通する色、書体、または間隔の値を固定するlock anchorと、構造ページ向けのpage_rhythmタグanchorです
Sheet / slice / plate	sheetはクロマキー上に複数の要素を含む生成画像です。sliceはそこから切り出した1つの要素です。plateは、重なり合わない複数のオブジェクトを含む、位置合わせされたキャンバス全体のレイヤーです
Module line	各ページの前に記述するP<NN> modules: …行です。そのページで使用する、適用対象となったモジュールを列挙します
Mode	修飾語とともに使います。communication mode（デッキの主張の伝え方）、reading mode（consumption_mode）、generation_mode（continuous／split）、pptx_structure.mode、replication_mode（テンプレートの作成方法）があります

フェーズの枠組み

どのルートも、Plan → Do·Check·Actのサイクルです。Planは、すべてのオーサリング入力がファイルまたは保持された判断としてそろった時点で終了します。Doではページを作成し、Checkではルートのゲートを実行し、Actでは所有するレイヤーで修正します（規律7）。サイクルはエクスポート時に終了します。ステップ番号は記載どおりに保ちます。

フェーズ	デフォルト	クイック	ネイティブ編集	テンプレート作成
Plan	Steps 1–5	§2	§1–4	Steps 1–3
Do·Check·Act	Steps 6–7	§3–4	§5–7	Steps 4–8

全体的な実行規律

1. 逐次実行 — 選択した権限者の手順に従って順番に進めます。完了した非ブロッキングのステップは、次に実行可能なステップへそのまま進められます。
2. ブロッキング時は停止 — ⛔ BLOCKING のゲートでは、必ずユーザーから明示的な確認を得てから進めます。ユーザーに代わって判断してはいけません。
3. フェーズをまたいで作業をまとめない — 閉じていないゲートをまたいで作業をまとめてはいけません。ルートの最後のユーザーゲートが閉じた後は、後続の非ブロッキングのステップを自動的に進められます。
4. 着手前にゲートを通過する — ステップに着手する前に、記載されている前提条件をすべて確認します。
5. 先回りして実行しない — 担当するステップに着手する前に、後続フェーズの成果物を準備してはいけません。
6. 決定的なルーティング — routing.md で依頼への対応が決まる場合、ルート選択についてユーザーに質問してはいけません。ルートの前提条件が不足している場合は、その旨を伝えて、そのルートでの作業を停止します。
7. 不具合を担当レイヤーで修正する — 障害が発生したら、その不具合を担当する最も上流のレイヤーで修正します。ページ内の問題はページで、名簿・仕様・リソースの問題は Plan 成果物で、ツールの障害は担当するソース成果物で修正します。その後、ルートで指定された位置から再開します。必須の成果物を黙って格下げしてはいけません。

全体的なコミュニケーション規則

• ユーザーが明示的に別の言語を指定しない限り、ユーザーの言語と原文の言語に合わせます。
• ユーザー向けの選択肢ラベルと説明をローカライズします。固定メッセージのテンプレート（役割切り替えバナー、完了レポート）は、テンプレートの言語と異なる場合、ユーザーのチャット言語で表示します。正確さのために必要な場合は、列挙型の ID やフィールド名をそのまま保持します。
• design_spec.md のセクション見出しとフィールド名はテンプレートの英語のままにし、内容の値はユーザーの言語で記述できます。
• 役割を切り替える前に、対応する役割リファレンスを読み、次を出力します。

## [Role Switch: <Role Name>]
📖 Reading role definition: references/<filename>.md
📋 Current task: <brief description>

---

リポジトリとの互換性

• このパッケージはワークフロー／スキルであり、汎用アプリケーションのひな型ではありません。既定では .worktrees/、tests/、ブランチのワークフロー、汎用的なエンジニアリング構成を作成しないでください。
• 必須のワークフロー、リファレンス、スクリプト、テンプレートのドキュメントは、この Skill ディレクトリ内に保管します。
• リポジトリレベルのドキュメントからパッケージ内を参照してもかまいませんが、パッケージの実行時ファイルがリポジトリレベルの指示に依存してはいけません。
• Windows で、記載された python3 ... コマンドが使用できない場合は、同じコマンドを python に置き換えて再実行します。
• スポンサー情報は任意の参考資料です。ユーザーがモデル、AI 画像モデル、API／プロバイダー、ホステッドサービスの推奨を明示的に求めた場合に限り、該当する SPONSORS.md または SPONSORS_CN.md を読みます。通常の生成、トラブルシューティング、品質レビューで、スポンサーやモデルの推奨を先回りして提示してはいけません。