prompt-redundancy-check

prompt-redundancy-check — プロンプト静的解析

skill-analyzer plugin の静的解析 skill。指定パス配下の SKILL.md / CLAUDE.md / instructions/*.md を走査し、各ファイルの metrics と ファイル間の n-gram 重複を検出する。

検出指標

1. per-file metrics: chars / lines / estimated_tokens / language (ja / en / mixed)

   • token 推定: 文字数 / chars-per-token (en=4, ja=2, mixed=3)
   • language: CJK 比率 50% 以上 = ja、5% 未満 = en、それ以外 = mixed

2. n-gram 重複: 連続 N 単語 (default 10) の重複 hash を全 file 横断で集計、 重複 span 合計が --min-bytes (default 100 bytes) 超える file ペアを抽出

実行手順

1. 解析対象決定:

   • 引数なし → 現在 cwd 全走査
   • --target <path> → 指定 path 配下走査
   • 除外: node_modules, .git, .venv, dist, .worktrees

2. 解析実行:

   bash "${CLAUDE_PLUGIN_ROOT}/scripts/prompt-stats.sh" \
     --target /path/to/project \
     --ngram 10 --min-bytes 100
   

3. 出力 JSON を整形:

   • high-token files (token 数降順 top 15)
   • high-overlap pairs (span_bytes 降順)
   • language 分布 (ja / en / mixed の count)

4. 共有用エクスポート:

   bash "${CLAUDE_PLUGIN_ROOT}/scripts/prompt-stats.sh" --target ... \
     | bash "${CLAUDE_PLUGIN_ROOT}/scripts/lib/sanitize.sh" \
     > redundancy-report.json
   

チューニング

env	default	効果
REDUNDANCY_NGRAM	10	小さく → 短い句も検出 (false positive 増)、大きく → 長い段落のみ
REDUNDANCY_MIN_BYTES	100	span 閾値、英語なら ~20 単語、日本語なら ~50 文字相当
TOKEN_CHARS_PER_TOK	言語別自動	全 file 一律で override したい時に明示
ANALYZE_TARGET	$(pwd)	デフォルト解析 root

出力例

## Prompt redundancy check (target: /path/to/project)

### High-token files (top 10)
| file | tokens | language |
|---|---:|---|
| .claude/instructions/core/completion-checklist.md | 2,152 | ja |
| .claude/instructions/core/default-review-layer.md | 1,719 | mixed |
| ...

### Consolidation candidates (n-gram overlap)
| file A | file B | overlap (bytes) |
|---|---|---:|
| .claude/skills/commit/SKILL.md | plugins/dev-workflow/skills/commit/SKILL.md | 2,836 |
| ...

注意

• token 推定は 本物 tokenizer ではない (Anthropic 公式 tokenizer は Anthropic API 経由のみ)。 相対比較用途のみ。
• n-gram 重複は単語レベル (lowercased、非 alphanum 除去後) → 同義語や言い換え重複は検出されない。
• 大規模 repo (10k+ markdown 文書) では数分かかる可能性。 progress 表示なし。

関連 skill

• improvement-proposal: 本 skill 結果を含む統合提案
• cost-monitor plugin の cost-status: 実コスト集計と組み合わせて token 単価ベースの判断