health-agentic-audit

/health:agentic-audit

すべてのプラグインのスキル、コマンド、エージェントをスキャンし、CLI 出力の最適化の機会を特定します。Agentic Optimizations テーブルの欠落、コンパクトフラグのない CLI コマンド、古いレビュー日をチェックします。

基準の参照先：.claude/rules/agentic-optimization.md および .claude/rules/skill-quality.md。

このスキルを使う場合

次の場合にこのスキルを使います…	次の場合は別の方法を使います…
エージェント最適化への準拠状況をスキルについて監査するとき	プラグイン全般を監査するとき（/health:audit を使います）
Agentic Optimizations テーブルの欠落を見つけるとき	環境を包括的にチェックするとき（/health:check を使います）
スキル内の CLI コマンドパターンをレビューするとき	プラグインレジストリの問題を扱うとき（/health:plugins を使います）
スキルのドキュメントを品質チェックするとき	スキルを手動でレビューしたいとき
スキルの品質基準を一括更新するとき	単一のスキルを更新するとき

コンテキスト

• プラグインのルート：!pwd
• スキルファイル：!find . -name 'SKILL.md' -o -name 'skill.md'
• スキルファイル（すべて）：!find . \( -name 'SKILL.md' -o -name 'skill.md' \)
• エージェントファイル：!find . -path '*/agents/*.md' -not -name 'README.md'

パラメーター

パラメーター	説明
--fix	指摘されたスキルに Agentic Optimizations テーブルのひな形を追加し、modified の日付を更新します
--verbose	スキャンしたすべてのファイルと、詳細なパターンマッチング結果を表示します

実行

このエージェント出力監査を実行します。

ステップ 1：すべてのプラグインコンテンツファイルを検出する

コードベース内のすべてのスキル、コマンド、エージェントを探します。

1. スキルをスキャンします：find . -name 'SKILL.md' -o -name 'skill.md'
2. すべてのスキルのバリエーションをスキャンします：find . \( -name 'SKILL.md' -o -name 'skill.md' \)
3. エージェントをスキャンします：find . -path '*/agents/*.md' -not -name 'README.md'

レポート用に、各ファイルをタイプ（スキル、コマンド、エージェント）別に分類します。

ステップ 2：各スキルに Agentic Optimizations テーブルがあるか確認する

各スキルファイルについて、次を行います。

1. ## Agentic Optimization に一致する見出しを検索します（末尾に「s」がある場合も含みます）。
2. bash／shell コードブロック（```bash または ```sh）を検索します。
3. bash コードブロックがあるものの、Agentic Optimizations テーブルがないスキルを指摘します。

bash コードブロックがないスキル（情報提供を目的とするスキル）はスキップします。詳細モードでは、その旨を記録します。

ステップ 3：コンパクトフラグのない CLI コマンドをスキャンする

すべてのファイルの実行セクションとコンテキストセクションを読みます。REFERENCE.md にある、フラグのない CLI コマンドのパターンと照合します。

フェンス付きコードブロックと、バッククォートのコンテキストコマンド（! バッククォート構文）の中から、次のパターンを検索します。

ステップ 4：フロントマターの日付が古いか確認する

各ファイルの YAML フロントマターから modified の日付を取得します。

1. 最初の 20 行から modified: YYYY-MM-DD を解析します。
2. 最終更新からの日数を計算します。
3. modified が 90 日より前のファイルを古いファイルとして指摘します。

ステップ 5：監査レポートを生成する

次のセクションを含む、構造化された Markdown レポートを出力します。

1. Agentic Optimizations テーブルの欠落 — bash ブロックがあるもののテーブルがないスキルを列挙します。
2. フラグのない CLI コマンド — 最適化フラグが欠落しているコマンドについて、ファイル、行、コマンド、推奨する修正を列挙します。
3. コンテキストセクションの問題 — cat または冗長な出力を使うコンテキストコマンドを列挙します。
4. 古いレビュー（90 日超） — modified の日付が古いファイルを列挙します。
5. 概要 — スキャンしたスキル／コマンド／エージェントの合計数と、見つかった問題の件数を示します。

--verbose が指定された場合は、ステータス（チェックごとの合格／不合格）とともに、スキャンしたすべてのファイルも列挙します。

ステップ 6：修正を適用する（--fix が指定された場合）

--fix が指定された場合は、次を行います。

1. 指摘されたスキルに Agentic Optimizations テーブルのひな形を追加します（最後の見出しの前、またはファイルの末尾に挿入します）。REFERENCE.md のひな形を使います。ユーザーが記入できるよう、TODO の項目はそのまま残します。
2. 変更した各ファイルのフロントマターにある modified の日付を今日の日付に更新します。
3. 変更したファイルと追加した内容を報告します。

実際に最適化したコマンドで TODO の項目を埋めるよう、ユーザーに促します。

パターン検出の詳細

コードブロックの検出

フェンス付きコードブロックを照合して、CLI ツールを特定します。

```bash
<command>

And inline backtick commands in context sections:

• ラベル：!<command>

### Frontmatter Extraction

Use the standard extraction pattern:
```bash
head -20 "$file" | grep -m1 "^modified:" | sed 's/^[^:]*:[[:space:]]*//'

エージェント向けの最適化

コンテキスト	コマンド
エージェント向け監査スキャン	/health:agentic-audit
自動修正付き監査	/health:agentic-audit --fix
詳細な出力	/health:agentic-audit --verbose
すべてのスキルファイルを検索	find . \( -name 'SKILL.md' -o -name 'skill.md' \) 2>/dev/null
エージェント向け最適化の表を確認	grep -l "## Agentic Optimizations" $(find . -name 'SKILL.md') 2>/dev/null

関連項目

• /health:check - 全体診断スキャン
• /health:audit - プラグインの関連性監査
• .claude/rules/agentic-optimization.md - 最適化の基準
• .claude/rules/skill-quality.md - 必須のスキルセクション