improvement-proposal

improvement-proposal — 統合改善提案

skill-analyzer plugin の最終 skill。skill-usage-report + mcp-usage-report + prompt-redundancy-check の 3 出力を統合し、優先順位付き改善提案 markdown を生成する。

提案 3 カテゴリ

1. 削除候補 (Deletion):

   • Skill ツール経由 0 起動の skill (ただし auto-trigger 経由起動は不可視 = 削除前 dry-run 必須)
   • 0 起動の MCP server (allowlist から外す or settings.json から削除)
   • 各候補に「該当 SKILL.md の token 数 × 月起動見積 = 推定 $ 節約」併記

2. 統合候補 (Consolidation):

   • n-gram 重複が閾値超え (REDUNDANCY_MIN_BYTES) の file ペア
   • 統合提案: 共通部分を 1 file に切り出し、各 file から @import で参照
   • 推定削減: span_bytes / 2 (重複の片方分が削減)

3. 圧縮候補 (Compression):

   • high-token (≥500 推定) かつ low-invocation (≤1 起動) の file
   • 提案: genshijin-compress 等で圧縮、または手動で 50% 削減
   • 推定削減: tokens × 0.5

実行手順

1. 対象期間 + 解析対象決定:

   • 期間 default = 全期間 (--since / --until 省略)
   • 対象 default = $(pwd) 配下

2. 統合提案生成:

   bash "${CLAUDE_PLUGIN_ROOT}/scripts/proposal-generator.sh" \
     --since 2026-05-01 --until 2026-05-08 \
     --target /path/to/project
   

3. price-table 連携 (option、$ 節約額の精度向上):

   bash "${CLAUDE_PLUGIN_ROOT}/scripts/proposal-generator.sh" \
     --since ... --until ... --target ... \
     --price-table $HOME/.claude/plugins/cost-monitor/scripts/price-table.json
   

   または env で:

   export PRICE_TABLE_PATH=$HOME/.claude/plugins/cost-monitor/scripts/price-table.json
   

4. 出力 markdown をユーザーに表示。 ファイル保存推奨:

   bash "${CLAUDE_PLUGIN_ROOT}/scripts/proposal-generator.sh" ... > improvement-proposal.md
   

5. 共有用 (受講者向け、サニタイズ済み):

   bash "${CLAUDE_PLUGIN_ROOT}/scripts/proposal-generator.sh" ... \
     --export ./share/
   

適用ワークフロー (推奨)

提案 markdown は 直接実行スクリプトではなく チェックリスト。 安全に適用するには:

1. 削除候補: settings.json の skillOverrides で 1 週間 off に → 業務影響 0 確認後に物理削除
2. 統合候補: 1 file ずつ手動マージ (semantic な差分確認必要、 機械的統合は危険)
3. 圧縮候補: /genshijin-compress で原始人モード圧縮 → 動作確認 → コミット

自動適用に関する注意: Phase 3 cost-optimizer plugin は settings.json の Bash perms / 壊れた hook / env キー整理のみ を提供 (settings-optimize skill)。skill / MCP の削除候補や圧縮候補の自動適用は 未実装 (削除は手動 dry-run、圧縮は /genshijin-compress skill による手動圧縮)。本提案 markdown は チェックリスト であり、実行スクリプトではない。

出力例 (claude-plugins repo 自身を解析した場合の抜粋)

# skill-analyzer improvement proposal

_period_: 2026-05-06 → 2026-05-08
_blended_price_: $9/M tokens

## 1. Deletion candidates
### Skills with 0 explicit Skill-tool invocations
| skill | est. tokens | est. monthly savings if removed |
|---|---:|---:|
| `<example-skill-A>` | 4,297 | $0.04 |
| `<example-skill-B>` | 3,449 | $0.03 |
| ...

## 2. 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 |
| ...

## 3. Compression candidates
| file | tokens | invocations | est. savings if -50% |
|---|---:|---:|---:|
| `plugins/<your-plugin>/skills/<your-skill>/SKILL.md` | 4,297 | 0 | $0.02 |
| ...

関連 skill / plugin

• cost-monitor (Phase 1): 実 cost 値を提供、 $ 節約額推定の精度向上
• cost-optimizer (Phase 3): settings.json の Bash perms / 壊れた hook / env キー整理 (削除候補・圧縮候補の自動適用は未実装、手動レビュー前提)
• genshijin-compress (genshijin plugin): 圧縮候補の実適用ツール (手動起動)