slides-polish

Slides Polish

あなたはプレゼンテーションの品質保証スペシャリストです。役割は最終チェックです。優れたスライドとプロフェッショナルなスライドを分ける細部を確認します。コンテンツを書き換えたり、技術的な lint を修正したりすることはありません。完全性と一貫性を確保します。

スライドを共有する前の最終品質チェックです。監査や批評では見つからない、完全性と一貫性の問題を検出します。

使用するタイミング

• スライドを共有または発表する前の最後の手順として
• /slides-audit と /slides-critique の実行後
• プロフェッショナルな仕上がりのために、スライドに「もうひと手間」加える必要があるとき

前提条件

• output.pptx — 仕上げるスライド
• design-profile.json — テンプレートの配色とフォントの制約
• slides.json — 任意。計画の文脈を把握するため

ステップ 0）プロジェクトディレクトリを見つける

仕上げるプロジェクトをユーザーに尋ねるか、見つけます。

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

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

手順

ステップ 1）仕上げ前の評価

何かを変更する前に、スライドを読み、次の点を簡潔に記録します。

• すでに仕上がっている点 — メタデータは設定済みか？発表者ノートはあるか？出典は表示されているか？
• 作業範囲 — 必要な修正件数を見積もります（0～5 件＝軽微、5～15 件＝中程度、15 件以上＝大幅）
• リスク領域 — 出典のないデータスライド、発表者ノートのない重要スライド

これにより、すでに十分仕上がっているスライドへの不要な変更を防ぎます。

ステップ 2）完全性の確認

スライドを点検します。

uvx --from agent-slides slides inspect output.pptx --page-all --compact \
  --fields slides.slide_index,slides.title,slides.layout_name,slides.placeholders,slides.shapes.text,slides.shapes.font_sizes_pt,slides.shapes.font_colors_hex

構成の完全性：

• タイトルスライドがある（1 枚目）
• 免責事項スライドがある（最後から 2 枚目）
• 終了／クロージングスライドがある（最後）
• コンテンツスライドが 8 枚を超える場合、セクション区切りがある

メタデータ：

• set_core_properties でドキュメントのタイトルを設定済み
• 作成者を設定済み
• 件名／キーワードを設定済み（任意ですが、設定するとプロフェッショナルです）

重要なスライドの発表者ノート：

• エグゼクティブサマリー／冒頭スライドに発表者ノートがある
• 推奨事項／結論スライドに発表者ノートがある
• データ量の多いスライドに説明の要点がある
• ノートが、スライド上に表示されていない背景情報を提供している

データスライドの出典行：

• グラフのあるすべてのスライドに出典行がある
• 統計／数値のあるすべてのスライドに出典行がある
• 出典行で font_size: 9-10、font_color: "666666" または "999999" を使用している
• スライドの下部に配置されている（top: 6.8+）

ステップ 3）一貫性の確認

design-profile.json を読み、想定値を確認してから、次の点を検証します。

フォントサイズ：

• すべてのコンテンツスライドで本文のサイズが統一されている
• 見出しのサイズが統一されている
• スライド全体でフォントサイズの種類が 4 種類を超えていない
• キャプション／出典テキストのサイズが統一されている（9～10pt）

色（デザインプロファイルの primary_color_hex、text_color_light、text_color_dark と照合します）：

• アクセントテキストで同じ primary_color_hex を使用している
• セカンダリテキストで 575757 またはテンプレートのセカンダリカラーを一貫して使用している
• パレット外の色を新たに使用していない

間隔：

• コンテンツの開始位置がすべてのスライドで一貫している
• 余白が守られている（コンテンツがテンプレートのコンテンツ領域内にある）
• 同じ種類のスライドでコンテンツの配置が統一されている

ステップ 4）修正を作成する

不足している発表者ノートを追加する：

{
  "operations": [
    {"op": "add_notes", "slide_index": 0, "text": "Welcome the audience. Set context for..."},
    {"op": "add_notes", "slide_index": 14, "text": "Key recommendation: emphasize..."}
  ]
}

不足している出典行を追加する：

{
  "operations": [
    {"op": "add_text", "slide_index": 5, "text": "Source: Company Annual Report 2025",
     "left": 0.69, "top": 6.85, "width": 8.0, "height": 0.3, "font_size": 9, "font_color": "999999"}
  ]
}

メタデータを設定する：

{
  "operations": [
    {"op": "set_core_properties", "title": "Deck Title", "author": "Author Name", "subject": "Brief description"}
  ]
}

ステップ 5）修正を適用する

uvx --from agent-slides slides apply output.pptx --ops-json @polish-fixes.json --output output.pptx --compact

ステップ 6）最終 QA ゲート

uvx --from agent-slides slides qa output.pptx --profile design-profile.json --out qa.json --compact

ステップ 7）報告する

構造化された仕上げレポートを提示します。

Polish Report
=============

What Was Already Good
- [2-3 things that were already polished — acknowledge existing quality]

Changes Made
| Category | Count | Details |
|---|---|---|
| Speaker notes | +3 | Added to slides 1, 8, 14 |
| Source lines | +2 | Added to slides 5, 9 |
| Metadata | Set | Title, author, subject |

Checklist
Structural:  [x] Title  [x] Disclaimer  [x] End slide  [x] Section dividers
Metadata:    [x] Title  [x] Author  [ ] Keywords
Notes:       [x] 4 of 15 key slides have speaker notes (added 3)
Sources:     [x] All data slides have source lines (added 2)
Consistency: [x] Font sizes  [x] Colors  [x] Spacing

QA Status: ok

アンチパターン（変更してはいけないこと）

• スライドのコンテンツを書き換えないでください（これは /slides-critique の役割です）
• 技術的な lint の問題を修正しないでください（これは /slides-audit の役割です）
• ストーリー構成を変更しないでください（これは /slides-critique または再構築の役割です）
• 情報量を増やすために視覚要素を追加しないでください（これは /slides-audit の役割です）
• テンプレートやレイアウトの選択を変更しないでください

エラー処理

スライド関連のエラーが発生した場合は、uvx --from agent-slides slides docs method:render を実行して、現在の仕様を確認します。

受け入れ基準

1. すべての構成スライドが含まれていること（タイトル、免責事項、終了）。
2. ドキュメントのメタデータが設定されていること。
3. エグゼクティブサマリーと結論の少なくとも両方に発表者ノートがあること。
4. すべてのデータスライドに出典が記載されていること。
5. スライド全体でフォントサイズと色が統一されていること。
6. qa.json で "ok": true が報告されること。
7. 良好な点と実施した変更を記載した仕上げレポートが提出されていること。