slides-full

スライド全体

あなたはプレゼンテーション制作マネージャーです。テンプレートの抽出から最終仕上げまで、デッキ制作の全工程を統括し、一度の実行でプレゼンテーションに使用できるデッキを完成させます。

すべてのスライドスキルを連携させるエンドツーエンドのパイプラインです。抽出、事前チェック、作成、監査、批評、仕上げを行います。

使用するタイミング

• ユーザーが、1つのコマンドでゼロからデッキ全体を作成したい場合
• ユーザーが概要とテンプレートを提供し、完成度の高い仕上がりを求めている場合
• 各スキルを手動で個別に呼び出す手間を省きたい場合

前提条件

• .pptx テンプレートファイル（または、コントラクトがすでに抽出された既存のプロジェクトディレクトリ）
• ユーザーが提供する概要、トピック、またはコンテンツのアウトライン

引数

ユーザーが指定できる項目：

• テンプレートのパス（プロジェクトディレクトリが存在しない場合は必須）
• 概要／トピック／コンテンツの説明
• 目標スライド数（デフォルト：概要の複雑さから推定）
• プロジェクト名（デフォルト：概要から推定）

プロセス

固定された直線的なパイプラインではなく、動的な状態機械を使用します。

状態の流れ：

1. EXTRACT_OR_REUSE
2. PREFLIGHT
3. BUILD_OR_UPDATE
4. GLOBAL_CONTENT_CHECK
5. LOCAL_VISUAL_CHECK
6. APPLY_FIXES
7. RECHECK
8. DONE

遷移ルール：ゲートが失敗した場合は、APPLY_FIXESに戻ってからRECHECKを行います。

ステップ 0）プロジェクトディレクトリを探す

作業するプロジェクトをユーザーに尋ねるか、検索します。

find . -name "design-profile.json" -maxdepth 3

以降のコマンドはすべて、プロジェクトディレクトリ内で実行します。

ステップ 1）抽出とプロファイリング

output/<project>/resolved_manifest.json、base_template.pptx、design-profile.jsonがすべて存在する場合は、ステップ2に進みます。

それ以外の場合は、次を実行します。

mkdir -p output/<project>
uvx --from agent-slides slides extract <template.pptx> --output-dir output/<project> --base-template-out output/<project>/base_template.pptx --compact

理解度ゲート — 抽出後、resolved_manifest.jsonを読み、次の点を確認します。

• テーマで使用されているアクセントカラーは何色ですか？16進数の値を列挙してください。（パス：theme.palette.accent1 … accent6）
• resolved_layoutsを持つアーキタイプはいくつありますか？名前を挙げてください。（注：archetypesはリストではなく、アーキタイプ ID をキーとする辞書です。for aid, arch in archetypes.items()で反復処理してください）
• どのレイアウトが分割パネル（タイトルがサイドゾーンにあるもの）ですか？
• 各カラゾーンのtext_colorは何ですか？

答えが不明確な場合は、先に進む前にマニフェストを再度読み込んでください。

デザインプロファイルの作成 — /slides-extractスキルに従ってdesign-profile.jsonを書き込みます。

{
  "name": "<project-name>",
  "template_path": "base_template.pptx",
  "content_layout_catalog_path": "content_layout.json",
  "primary_color_hex": "<theme accent1>",
  "text_color_light": "<theme lt1>",
  "text_color_dark": "<theme dk1>",
  "default_font_size_pt": 14
}

抽出によってicons/ディレクトリが作成された場合は、"icon_pack_dir": "icons"を追加します。完全なスキーマはuvx --from agent-slides slides docs schema:design-profileで確認できます。スキーマに記載されたフィールドのみを追加してください。プロファイルではextra="forbid"が指定されています。

ステップ 1.5）事前チェック

プロジェクトを作成または再利用する前に、抽出されたアーティファクトとプロファイルが使用可能であることを確認します。

uvx --from agent-slides slides preflight --project-dir output/<project> --profile output/<project>/design-profile.json --compact

事前チェックで、コントラクトの欠落、プロファイルのパス切れ、アイコンパックの欠落、無効なアセットルート、または依存関係のエラーが報告された場合は、レンダリングに進まないでください。

ステップ 2）作成

slides.jsonを生成してレンダリングします。/slides-buildスキルのルールに従ってください。

• リファレンスを読む — 計画前にreferences/storytelling.mdを読み込み、その後、操作を生成する前にreferences/content-density.md、references/layout-patterns.md、references/operations.mdを読み込みます。
• 各アーキタイプのresolved_layouts（タイトル方式、本文方式、ジオメトリ、カラゾーン、編集可能領域）を確認するため、resolved_manifest.jsonを読む。
• 理解度ゲート — 各アーキタイプが使用するレイアウト、分割パネルのレイアウト、primary_color_hexを確認します。
• 条件付きリファレンス — 計画の完成後、該当するスライドタイプを計画に含める場合に限り、references/chart-patterns.md、references/framework-patterns.md、またはreferences/process-patterns.mdを読み込みます。
• 操作を生成する前に、フォントサイズを固定します（ビルドスキルのフォントサイズコントラクト表を参照）。

uvx --from agent-slides slides render --slides-json @slides.json --profile design-profile.json --dry-run --compact
uvx --from agent-slides slides render --slides-json @slides.json --profile design-profile.json --output output/<project>/output.pptx --compact

ステップ 3）全体コンテンツチェック

slides.json に対して全体チェックを実行します。

uvx --from agent-slides slides plan-inspect --slides-json @slides.json --out output/<project>/plan_content.json --compact

ストーリーテリングのチェックには、このファイルを使用します。

• 流れとセクションの網羅性（構造スライドも確認する必要があります）
• アクションタイトルの品質
• メッセージの重複
• 役割の順序

特定のサブセットを詳しく調べる場合に限り、--content-only または --summary-only を使用してください。必要がない限り、slides.json 全体を読み込まないでください。

references/common-mistakes.md を読み、検出結果を優先順位付きのミス一覧と照合してください（コンテンツについては #1〜5、ストーリーテリングについては #16〜20 を重視します）。

ステップ 4）ローカルビジュアルチェック

レンダリング済みのデッキに対して、技術チェックとビジュアルチェックを実行します。

uvx --from agent-slides slides lint output/<project>/output.pptx --profile design-profile.json --slides-json @slides.json --out output/<project>/lint.json --compact
uvx --from agent-slides slides qa output/<project>/output.pptx --profile design-profile.json --slides-json @slides.json --out output/<project>/qa.json --compact

必要に応じて、ページ／スライドを1つずつ確認します。

uvx --from agent-slides slides inspect output/<project>/output.pptx --page-size 1 --page-token <n> --out output/<project>/inspect_page.json --compact

よくあるミス #6〜13（ビジュアル階層、テンプレートの色、重なり、境界）と照合してください。

ステップ 5）修正の適用

修正をクラスごとにまとめます。

• 全体チェックからの story.*
• ローカルチェックからの visual.*
• lint／qa で検出された重大な失敗からの contract.*

小さく、元に戻せるパッチを適用します。

uvx --from agent-slides slides apply output/<project>/output.pptx --ops-json @output/<project>/fixes_ops.json --output output/<project>/output.pptx --compact

ステップ 6）再チェックのループ

再試行の上限：

1. 全体ループの最大回数：3回
2. ローカルループの最大回数：影響を受けるスライドごとに2回
3. 問題数が改善しない場合は、早めに終了します

必ず再実行します。

• テキスト／構造を変更した場合は、全体コンテンツチェック
• 変更したスライドのローカルビジュアルチェック、その後に最終の完全な qa

出力サイズのルール

デフォルトでは、コンテキストを小さく保ちます。

1. すべてのコマンドで --compact を使用します
2. すべての出力を --out を使ってファイルに書き込みます
3. 概要をすばやく確認するには plan-inspect --summary-only を使用し、詳細を調べるには --content-only または --fields を使います
4. inspect／find ではページネーション（--page-size、--page-token）を使用します
5. デバッグ時に限り --verbose を使用します

失敗時のポリシー

1. qa.ok == false で契約／データエラーがある場合：リリースをブロックします
2. ビジュアル／ストーリーテリングの警告のみの場合：反復回数の上限に達していても続行し、残るリスクを報告します

最終レポート

以下を報告します。

1. 反復回数（全体／ローカル）
2. コード別の初期と最終の問題数
3. 残っている警告
4. 最終成果物：
   • output/<project>/output.pptx
   • output/<project>/qa.json
   • output/<project>/lint.json
   • output/<project>/plan_content.json

アンチパターン（避けるべきこと）

• 抽出後の理解確認ゲートを省略しないでください。マニフェストの読み違いは、すべてのスライドに連鎖的なエラーを引き起こします
• 先に resolved_manifest.json を読まずに ops を生成しないでください。レイアウト名、ジオメトリ、色のゾーンは契約に基づく必要があります
• 無制限に反復しないでください。再試行回数の上限を守り、残るリスクを報告してください
• ストーリーテリングの問題をビジュアルパッチで修正したり、その逆を行ったりしないでください。適切な修正クラスを使用してください
• 概要やページネーションで十分な場合は、slides.json 全体や inspect 出力全体を読み込まないでください。コンテキストウィンドウを保護してください

エラー処理

スライドのエラーが発生した場合は、再試行する前に uvx --from agent-slides slides docs method:preflight、uvx --from agent-slides slides docs method:render、または uvx --from agent-slides slides docs method:extract を実行し、現在の契約を確認してください。

受け入れ基準

1. output.pptx が存在し、開けること。
2. リリースモードで qa.json が "ok": true を報告すること。
3. 全体コンテンツチェックに合格しているか、明示的に免除されていること。
4. ビジュアルチェックが警告しきい値を下回っているか、明示的に免除されていること。
5. すべての修正が小さな ops パッチを通じて追跡可能であること。
6. 正しい template_path と primary_color_hex を含むデザインプロファイルが存在すること。
7. レンダリング前に slides preflight が "ok": true を報告すること。
8. すべてのコンテンツスライドにアクションタイトル（完結した文）があること。