enhance-cross-file

enhance-cross-file

エージェント、スキル、ワークフロー間の意味的な一貫性を分析します。

引数の解析

const args = '$ARGUMENTS'.split(' ').filter(Boolean);
const targetPath = args.find(a => !a.startsWith('--')) || '.';

目的

複数のファイルにまたがる問題を検出します。単一ファイルの分析では見落とされる問題です。

• プロンプト本文で使用されているが、フロントマターで宣言されていないツール
• 存在しないエージェントへの参照
• ファイル間での指示の重複（保守の負担）
• 矛盾するルール（ALWAYS と NEVER の競合）
• どのワークフローからも参照されていない孤立したエージェント
• スキルのツールの不一致（allowed-tools と実際の使用状況）

ワークフロー

1. アナライザーを実行 - JavaScript アナライザーを実行して検出結果を取得します。

   node -e "const a = require('./lib/enhance/cross-file-analyzer.js'); console.log(JSON.stringify(a.analyze('.'), null, 2));"
   

   特定のパスを指定する場合：a.analyze('./plugins/enhance')

2. 結果を解析 - アナライザーは summary と findings を含む JSON を返します。

3. 報告 - 検出結果をカテゴリ別にまとめて返します。

JavaScript アナライザー（lib/enhance/cross-file-analyzer.js）は、すべてのファイル横断検出を実装しています。以下のパターンは参考資料です。

検出パターン

1. ツールの一貫性（確度：中）

tool_not_in_allowed_list：プロンプト本文で使用されているが、フロントマターの tools: リストに含まれていないツール

# Frontmatter declares:
tools: Read, Grep

# But body uses:
Use Write({ file_path: "/out" })  # <- Not declared!

skill_tool_mismatch：スキルの allowed-tools が、スキル本文での実際のツール使用状況と一致しない

2. ワークフローの一貫性（確度：中）

missing_workflow_agent：subagent_type: "plugin:agent-name" が存在しないエージェントを参照している

orphaned_prompt：エージェントのファイルは存在するが、どのワークフローからも参照されていない（エントリーポイントの可能性があります。手動で確認してください）

incomplete_phase_transition：ワークフローのフェーズで「Phase N」に言及しているが、対応するセクションがない

3. 指示の一貫性（確度：中）

duplicate_instructions：同じ MUST/NEVER 指示が3つ以上のファイルに存在する（共有場所に移動してください）

contradictory_rules：あるファイルで「ALWAYS X」と記述され、別のファイルで「NEVER X」と記述されている

出力形式

## Cross-File Analysis

**Files Analyzed**: {agents} agents, {skills} skills, {commands} commands

### Tool Consistency ({n})
| Agent | Issue | Fix |
|-------|-------|-----|
| exploration-agent | Uses Write but not in tools list | Add Write to frontmatter |

### Workflow Issues ({n})
| Source | Issue | Fix |
|--------|-------|-----|
| workflow.md | References nonexistent agent | Check spelling or create agent |

### Instruction Consistency ({n})
| Instruction | Files | Fix |
|-------------|-------|-----|
| "NEVER push --force" | 4 files | Extract to CLAUDE.md |

制約

• すべてのパターンの確度は中です（文脈の確認が必要です）
• 自動修正はありません（ファイル横断の変更には人によるレビューが必要です）
• <bad-example>、<bad_example>、<badexample> タグ内の内容はスキップします
• info string に "bad" が含まれるコードブロック内の内容はスキップします
• エントリーポイントとなるエージェント（orchestrator、validator、discoverer）は孤立しているとは見なされません

パターンの統計

カテゴリ	パターン数	自動修正可能
ツールの一貫性	2	0
ワークフロー	3	0
一貫性	3	0
合計	8	0