utility-pm-skill-auditor

PM スキル監査（ディスパッチスキル）

pm-skill-auditor サブエージェント向けの、クライアント横断型ディスパッチラッパーです。実行環境を検出し、Claude Code ではネイティブのサブエージェントにディスパッチします。Claude Code 以外のクライアントでは agents/pm-skill-auditor.md を読み込み、インラインで実行します。

使用する場合

• リポジトリ全体を監査したい場合：すべての強制バリデーター、横断的チェック（スキルに対応するコマンドがない場合、サンプルの不足、ファミリー契約から孤立した要素など）、および CONTEXT.md + AGENTS.md + README.md に記載された値との集計カウンターの再算出を実行します
• ネイティブの pm-skill-auditor サブエージェントに対応していない AI クライアントを使用している場合
• Claude Code を使用しており、スキル呼び出しのセマンティクスを利用したい場合（たとえば、ほかのディスパッチスキルも使用するワークフロー内で連携する場合）

使用しない場合

• 特定の PM 成果物（PRD、OKR、ペルソナ）をレビューしたい場合 → 代わりに utility-pm-critic を使用してください
• CHANGELOG の項目を作成したい場合 → utility-pm-changelog-curator を使用してください（Phase 4 で提供予定）
• リリースを実施したい場合 → utility-pm-release-conductor を使用してください（Phase 5 で提供予定）
• 監査で見つかった問題を修正したい場合 → 監査担当は検出のみを行います。修正はメンテナーの判断、または将来の pm-frontmatter-doctor（v2.17+）に委ねてください
• 作成規約に照らして、単一のスキルを詳細にチェックしたい場合 → utility-pm-skill-validate を使用してください。監査担当はカタログ全体を広く確認しますが、単一のスキルを詳細に確認することはありません。

手順

実行環境の検出ステップ。 このスキルを呼び出している AI クライアントを特定します。

pm-skills プラグインをインストールした Claude Code で実行している場合

リポジトリに対して @agent-pm-skills:pm-skill-auditor を呼び出します。$ARGUMENTS のスコープ引数（例：--scope changed、--since-tag v2.15.0、--severity-floor P1）を渡します。サブエージェントの監査レポートをユーザーに返します。

それ以外の AI クライアントで実行している場合

Codex CLI、Cursor、Windsurf、Copilot、Gemini CLI、またはネイティブの pm-skills プラグインのサブエージェントに対応していないその他のクライアント：

1. サブエージェントの正式な定義である agents/pm-skill-auditor.md を読み込みます
2. そのファイルのシステムプロンプト本文を、このターンの動作指示として実行します
3. 次の 4 ステップの監査フローを実行します：
   • ステップ 1：Bash でバリデーターを呼び出します（正式なエントリーポイントとして bash scripts/pre-tag-validate.sh を優先してください）
   • ステップ 2：docs/internal/release-plans/v2.16.0/spec_pm-skill-auditor.md#cross-cutting-check-catalog のカタログにある横断的チェックを実行します
   • ステップ 3：ファイルシステムから集計カウンターを再算出し、記載された値と比較します
   • ステップ 4：階層化された出力レポートを作成します
4. $ARGUMENTS のスコープと重大度の下限の引数を適用します
5. マスタープラン D26 に従って、階層化された出力（完全なレポート + Status Summary + Status YAML）を返します

クライアント横断に関する注意事項

正式なクライアント横断のステータスについては、サブエージェント互換性マトリックスを参照してください。v2.16.0 時点でのこのスキルの概要：Claude Code + Codex CLI では本番対応（Codex CLI は Bash 経由でバリデータースイートを正常に呼び出し、再算出した集計カウンターを含む階層化された監査レポートを生成しました）。Cursor / Windsurf / Copilot CLI / Gemini CLI では試験運用中です。

「正式なエージェント定義を読み込み、インラインで実行する」パターンは、AI クライアントが次のことに対応している必要があります：

1. 参照されたファイルパスを読み込む
2. Bash を実行してバリデータースクリプトを呼び出す
3. エージェント定義の本文を、現在のターンにおける動作指示として扱う

ほとんどの AI クライアントは、この 3 つすべてに対応しています。特定のクライアントでいずれかが安定して動作しない場合、そのクライアントではバリデーターの手動呼び出しと横断的チェックの手動実行に切り替えます。

参照ファイル

• 正式なサブエージェント定義：agents/pm-skill-auditor.md
• 動作仕様：docs/internal/release-plans/v2.16.0/spec_pm-skill-auditor.md
• ランタイムコンポーネントカタログ：docs/reference/runtime-components.md
• 横断チェックカタログ：docs/internal/release-plans/v2.16.0/spec_pm-skill-auditor.md#cross-cutting-check-catalog
• タグ付け前のバリデーターバンドル：scripts/pre-tag-validate.{sh,ps1}
• 出力テンプレート：references/TEMPLATE.md
• 作業例：references/EXAMPLE.md