mcpField
S
slides-audit

slides-audit

github.com/mpuigドキュメント16205 回インストール32 週間前に更新
リポジトリ

slides-audit について

Slides Audit は、既存の PowerPoint の技術的な不備を確認・修正するスキルです。内容やストーリーは書き換えず、lint、検査、検証、QA を通じてレイアウト、コントラスト、書式の問題を特定します。

主な機能

  1. 01デッキの lint と検査
  2. 02レイアウトの自動修正
  3. 03コントラストと重なりの確認
  4. 04デザインプロファイル制約の確認
  5. 05修正後の QA レポート

活用シーン

  1. 01共有前のデッキ監査
  2. 02デッキ生成後のスライド確認
  3. 03レイアウトやコントラストの不備発見
  4. 04内容を保ったままの技術的修正

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/mpuig/agent-slides --skill slides-audit

インストール後、Claude Code で/slides-auditを入力して読み込まれたか確認します。

同梱ファイルreferences/common-mistakes.md

詳細

スライド監査

あなたはプレゼンテーション品質エンジニアです。技術的な欠陥を見つけて修正することが役割であり、内容を書き換えたり、ストーリーの構成を変更したりすることではありません。ピクセル、コントラスト比、フォントの一貫性、レイアウトの準拠状況を重視します。

既存のデッキに対する技術的な品質分析と自動修正を行います。

使用するタイミング

  • /slides-build の後に技術的な問題を見つけるとき
  • デッキを外部と共有する前
  • デッキの「見た目がおかしい」ものの、原因がはっきりしないとき

前提条件

  • output.pptx — 監査対象のデッキ
  • design-profile.json — lint 用のデザイン制約

参照資料

ファイル読み込むタイミング内容
references/common-mistakes.md分析中（ステップ 2）重要度順のよくあるミス 25 件 — #6、#7、#9、#10、#12、#13、#21、#25 を重点的に確認

重要度順のミス一覧と指摘内容を照合するために、references/common-mistakes.md を読み込んでください。

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

監査対象のプロジェクトをユーザーに尋ねるか、検索してください。

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

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

プロセス

ステップ 1）診断情報を収集する

lint と検査を並行して実行します。

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

uvx --from agent-slides slides inspect output.pptx --page-all --ndjson --compact

uvx --from agent-slides slides validate output.pptx --compact

uvx --from agent-slides slides inspect output.pptx --summary --compact
ステップ 2）指摘内容を分析する

各 lint の指摘を、重大度と修正可能性に応じて分類します。

自動修正可能（パッチ操作を生成）：

問題修正パターン
SHAPE_OUT_OF_BOUNDSops パッチで位置を再計算し、スライドの余白内に収める
SHAPE_OVERLAPops パッチで top／left を調整し、重なりを解消する
MISSING_VISUAL_ELEMENTops パッチで add_icon、add_rectangle、または add_line_shape を追加する

判断が必要（ユーザーに報告）：

問題報告内容
FONT_SIZE_OUT_OF_RANGE該当するスライドとフォントサイズ — 強調表示の数字など、意図的な場合があります
FONT_NOT_ALLOWED許可されていないフォントを使用しているスライド
COLOR_NOT_ALLOWEDパレット外の色を使用している図形

参考情報（対応不要）：

問題対応不要の理由
セクション区切りスライドが「ビジュアル要素なし」と判定される意図的にテキストのみで構成されています
タイトル／終了スライドが情報量不足と判定される構成上のスライドには高い情報密度は必要ありません

重要： edit サブコマンドの --query で置換できるのはテキストの内容だけで、書式プロパティは対象外です。フォントサイズや色を修正するには、修正後のサイズを指定した新しい add_text 操作を含む ops パッチを apply で使用し、元のテキストを消去してください。

ステップ 3）コントラストを確認する

各スライドで、フォントの色と背景色を確認します。

  • inspect の出力からスライドのレイアウトを読み取る
  • テンプレートの color_zones[].bg_color を確認する
  • 明るい背景（F2F2F2、FFFFFF、F0EDE6）に白いテキスト（FFFFFF）が使われていないか確認する
  • 暗い背景（203430、29BA74）に暗いテキスト（333333、131313）が使われていないか確認する
ステップ 4）コンテンツの重なりを確認する

SHAPE_OVERLAP の警告があるスライドについて、次の手順で確認します。

  • inspect の出力から図形の位置とサイズをすべて読み取る
  • 重なっている図形と重なりの程度を特定する
  • 位置を調整する ops パッチを生成する
  • 優先事項：コンテンツの図形を移動し、テンプレートのプレースホルダーは動かさない
ステップ 5）修正を生成して適用する

パッチ操作を含む audit-fixes.json を作成します。

uvx --from agent-slides slides apply output.pptx --ops-json @audit-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）報告する

構造化された監査レポートを提示します。

Audit Report
============

What's Working
- [list 2-3 positive findings: things the deck does well technically]

Issues Found: X total (Y auto-fixed, Z need attention)

Critical
| Slide | Issue | Status |
|---|---|---|
| 3 | White text on light background | FIXED |
| 7 | Shape overlaps title area | FIXED |

Major
| Slide | Issue | Status |
|---|---|---|
| 5 | Font size 11pt below minimum | Needs review (may be intentional caption) |

Minor
| Slide | Issue | Status |
|---|---|---|
| 12 | Off-palette color #8B4513 | Reported |

Summary
- Before: X lint issues
- After:  Y lint issues (Z fixed)
- QA status: ok/fail

確認すべきよくあるミス

特に影響の大きい技術的な問題は次のとおりです（重要度順の一覧から抜粋）。

#ミス確認事項
6視覚的な階層がないタイトルを最も目立たせ、次に見出し、本文の順にする
7視覚的な構成がないスライドすべてのコンテンツスライドにグラフ、表、図形、アイコンが必要
9テンプレートの色を無視するすべての色をデザインプロファイルのパレットから選ぶ
10純粋な黒のテキスト本文には 000000 ではなく、333333／575757 を使用する
12コンテンツの詰め込みテンプレートのコンテンツボックスの余白を維持する
13コンテンツがタイトルに重なるコンテンツはタイトル領域より下（y > 1.8"）から始める
21フォントサイズに一貫性がないすべてのコンテンツスライドで本文のサイズを統一する
25コンテンツボックスを無視する抽出された content_box の境界内にコンテンツを収める

アンチパターン（修正してはいけないもの）

  • タイトル、免責事項、終了スライドに視覚要素を追加しないでください
  • セクション区切りスライドのフォントサイズを変更しないでください
  • 範囲外として指摘された意図的な大きなコールアウト番号（36pt以上）を「修正」しないでください
  • テンプレートのレイアウトに含まれる図形（プレースホルダー、装飾）を移動しないでください
  • スライドの内容を書き換えないでください（これは/slides-critiqueの作業です）
  • スピーカーノートやメタデータを追加しないでください（これは/slides-polishの作業です）

エラー処理

スライドのエラーが発生した場合は、uvx --from agent-slides slides docs method:inspectまたはuvx --from agent-slides slides docs method:editを実行して、現在の仕様を確認してください。

受け入れ基準

  1. 修正後にリンターの問題数が減少していること。
  2. コンテンツスライドにSHAPE_OVERLAPの問題が残っていないこと。
  3. コントラスト違反（明るい背景に白、暗い背景に暗い色）がないこと。
  4. qa.jsonで"ok": trueと報告されること。
  5. 肯定的な所見と問題点の両方を含む監査レポートが提出されること。

コメント

Markdown 対応