cost-saver

cost-saver — コスト最適化統合 orchestrator

cost-saver-trio (cost-monitor / skill-analyzer / cost-optimizer) + genshijin + core-instructions を統合し、利用者を 「何ができるか不明」から「設定完了 + 機能把握済」 へ能動的に案内する skill。推奨止まりではなく 設定実装まで踏み込む (ユーザー同意取得後)。

Phase 構成

Phase 1: 診断 (必須実行)

bash "${CLAUDE_PLUGIN_ROOT}/scripts/diagnose.sh" --format json --scope user

出力 JSON から以下を確認:

• 5 plugin (cost-monitor / skill-analyzer / cost-optimizer / genshijin / core-instructions) の install 状況
• settings.json の statusLine / hooks 設定状態
• CLAUDE.md の subagent-policy.md @import 状況
• COST_OPTIMIZER_HINTS env 値

診断結果を ユーザーに表形式で提示。

Phase 2: 適用レベル選択 (AskUserQuestion 必須)

診断結果に基づき AskUserQuestion で以下 4 つから単一選択させる:

• Level 1: 案内のみ (read-only、推奨手順 markdown 表示) — 未 install plugin の /plugin install コマンド案内、未設定項目の手動設定手順案内
• Level 2: CLAUDE.md @import 追記 (4 段防御書換) — subagent-policy.md @import を CLAUDE.md に追記 (core-instructions install 済前提)
• Level 3: settings.json 書換 (4 段防御書換) — statusLine 設定 + env.COST_OPTIMIZER_HINTS=on を settings.json に追加
• Level 4: 全実装 (Level 1+2+3 統合) — 案内 + CLAUDE.md @import + settings.json 全部、本 plugin 自身の SessionStart hook 状態確認込み

Phase 3: 選択レベル適用 (必ず dry-run → ユーザー再確認 → --apply の順)

Level 1 適用

bash "${CLAUDE_PLUGIN_ROOT}/scripts/apply-level1.sh" --scope user

出力 markdown をそのまま提示。書き換えなし。

Level 2 適用 (4 段防御)

# 1. dry-run preview (default)
bash "${CLAUDE_PLUGIN_ROOT}/scripts/apply-level2.sh" --scope user

# 2. ユーザーに diff 提示 → 「OK / NG」確認 (AskUserQuestion)

# 3. OK なら --apply
bash "${CLAUDE_PLUGIN_ROOT}/scripts/apply-level2.sh" --apply --scope user

Level 3 適用 (4 段防御)

# 1. dry-run preview
bash "${CLAUDE_PLUGIN_ROOT}/scripts/apply-level3.sh" --scope user

# 2. unified diff 提示 → ユーザー確認 (AskUserQuestion)
#    --only で項目選択可: statusLine / hints / 両方 (default)

# 3. OK なら --apply
bash "${CLAUDE_PLUGIN_ROOT}/scripts/apply-level3.sh" --apply --scope user --only statusLine,hints

Level 4 適用 (Level 2 + 3 を 個別に dry-run → 確認 → apply の 3 step 反復、直 --apply 禁止)

重要: Level 4 は「Level 2 と Level 3 を一括で書き換える」ものではない。各 Level 個別に「dry-run → AskUserQuestion で確認 → --apply」の 3 step を 2 サイクル 実行する。Level 選択 1 回の同意で書換 2 件を独断適用するのは制御フロー破綻。

# === Cycle 1: CLAUDE.md (Level 2) ===
# 1-1. dry-run preview
bash "${CLAUDE_PLUGIN_ROOT}/scripts/apply-level2.sh" --scope user

# 1-2. AskUserQuestion で「この CLAUDE.md 書換を適用しますか?」確認
#      → OK のみ次へ、NG なら Cycle 1 中止

# 1-3. --apply
bash "${CLAUDE_PLUGIN_ROOT}/scripts/apply-level2.sh" --apply --scope user

# === Cycle 2: settings.json (Level 3) ===
# 2-1. dry-run preview
bash "${CLAUDE_PLUGIN_ROOT}/scripts/apply-level3.sh" --scope user

# 2-2. AskUserQuestion で「この settings.json 書換を適用しますか?」確認
#      → OK のみ次へ、NG なら Cycle 2 中止

# 2-3. --apply
bash "${CLAUDE_PLUGIN_ROOT}/scripts/apply-level3.sh" --apply --scope user --only statusLine,hints

# === Cycle 3: 本 plugin hook 状態案内 (Level 4) ===
bash "${CLAUDE_PLUGIN_ROOT}/scripts/apply-level4.sh" --scope user

Phase 4: 結果サマリ + 教育案内 (必須)

ユーザーに以下を伝える:

1. 適用したレベル名 + 変更箇所一覧
2. backup file 場所 (Level 2/3 で書換した場合)
3. 各 plugin の主要 skill 案内:
   • cost-monitor: /cost-status (即時) / /cost-report (期間別 dashboard)
   • skill-analyzer: /improvement-proposal (skill / MCP / prompt 改善提案)
   • cost-optimizer: /model-recommend /agent-recommend /genshijin-suggest /settings-optimize
   • genshijin: /genshijin (圧縮モード) / /genshijin-compress <filepath> (メモリファイル圧縮)
4. 次のアクション提案 (未 install plugin 残ってる場合、/plugin install コマンド提示)

Hard rules (絶対遵守)

• 必ず AskUserQuestion で適用レベル確認: 独断で Level 2 以上を適用するのは禁止
• 書換系 (Level 2/3) は必ず dry-run → ユーザー確認 → --apply の 3 step: dry-run スキップ禁止
• diagnose 結果を歪曲しない: install 済の plugin を未 install と報告する等の hallucination 禁止、diagnose.sh の JSON 出力を一次根拠とする
• scope 確認: --scope user (default) と --scope project の使い分け、ユーザー意図不明時は user (個人設定) 優先、ただし AskUserQuestion で確認

連携 plugin / skill

• cost-monitor — 観測 (statusLine / dashboard)
• skill-analyzer — 静的解析 (改善提案)
• cost-optimizer — 推奨 hint inject (OPT-IN) + settings 整理
• genshijin — 応答圧縮モード
• core-instructions — subagent-policy.md 等の強制 instruction 文書配布

Read-only / Side-effect 明示

Phase	影響
Phase 1 (diagnose)	Read-only
Phase 2 (AskUserQuestion)	副作用なし、ユーザー判断
Phase 3 Level 1	Read-only (案内 markdown 出力のみ)
Phase 3 Level 2/3	書換あり (4 段防御: dry-run → backup → atomic → auto-restore)
Phase 3 Level 4	Level 2+3 統合