---
name: token-saver
description: ClaudeCodeのトークン消費量を抑えるスキル。セッション引き継ぎサマリーの生成・CLAUDE.mdの肥大化監査・モデル選択アドバイス・コスト効率化チェックリストの表示を行う。ユーザーが「コストを節約したい」「セッションをリセットしたい」「CLAUDE.mdを見直したい」「トークン消費が気になる」「モデルを選びたい」「どのモデルがいい？」「/token-saver」と言ったときに使用する。
---

# /token-saver — トークン消費最適化スキル

ClaudeCodeのコスト増加の根本原因は「コンテキストの肥大化」。3つのモードで構造的に防ぐ。

---

## Step 1：モードを判断する

引数またはユーザーの発言からモードを判断する。

| モード | トリガーワード |
|--------|--------------|
| **handoff** | 「リセット」「引き継ぎ」「まとめて」`/token-saver handoff` |
| **audit** | 「監査」「見直し」「CLAUDE.md」`/token-saver audit` |
| **model** | 「モデル」「どのモデル」「選択」`/token-saver model` |
| **check** | 引数なし・「節約」「チェック」 |

判断できない場合は **check** モードで動作する。

---

## モード A：handoff（セッション引き継ぎ）

現在の会話コンテキストを要約し、次のセッションにそのまま貼れる引き継ぎドキュメントを生成する。

### 出力フォーマット

```
## セッション引き継ぎ（{日付}）

### 現在取り組んでいるタスク
- （今やっていること）

### 完了済み
- （完了したこと）

### 次にやること
- （次のステップ）

### 重要な決定事項
- （このセッションで決まったこと）

### 関連ファイル・パス
- （作業中のファイルパスなど）

### 引き継ぎメモ
（注意点・文脈・前提など）
```

生成後、以下の確認を行う：

```
このサマリーを新しいセッションの最初に貼り付けて再開できます。
修正・追記が必要な箇所はありますか？（なければ「OK」と入力してください）
```

---

## モード B：audit（CLAUDE.md監査）

グローバルおよびプロジェクトの `CLAUDE.md` を読み込み、肥大化リスクを診断する。

### 手順

1. グローバルの `CLAUDE.md` を読み込む（Windows: `%USERPROFILE%\.claude\CLAUDE.md`）
2. カレントディレクトリの `CLAUDE.md`（プロジェクト）があれば読み込む
   - **存在しない場合 → モード B2（新規作成サポート）に分岐する**
3. 以下の観点で診断する

### 診断観点

| カテゴリ | 効率化推奨の内容 |
|----------|--------------|
| AIが既知の情報 | 一般的なベストプラクティス・コーディング規約 |
| 歴史・経緯 | 「以前は〜だったが」「〜という経緯で」 |
| 過剰な説明 | 1行で書けるルールに3行以上かけている箇所 |
| 重複 | 同じルールが複数箇所に書かれている |

### 出力フォーマット

```
## CLAUDE.md 監査結果

### グローバル CLAUDE.md
- 行数: XX行（推定 XXXトークン）
- 効率化推奨箇所:
  - [行XX-XX] 「〜」→ AIが既知のため効率化可
  - [行XX-XX] 「〜」→ 1行に圧縮可能

### 推定効率化効果
現在: 約XXXトークン → 効率化後: 約XXXトークン（XX%軽量化）
```

診断後、以下のステップでユーザーに確認する：

**Step 1 — 全体確認**
```
上記の診断結果を確認しました。
効率化を進めますか？（はい / いいえ）
```

**Step 2 — 対象箇所の選択**（Step 1 で「はい」の場合のみ）
```
どの箇所を効率化しますか？
対象の番号を教えてください（例: 1 3 / 全部: all / やめる: skip）
```

**Step 3 — 内容確認**（対象が確定したら）
```
以下の内容で効率化します。よろしいですか？（OK / 修正あり）

[効率化前 → 効率化後の差分を表示]
```

「OK」を受けてから実際にファイルを書き換える。

---

## モード B2：audit / 新規作成（プロジェクトCLAUDE.md不在時）

カレントディレクトリに `CLAUDE.md` が存在しない場合に自動分岐する。

### 手順

1. カレントディレクトリのファイル・フォルダ構成を確認する（Glob/Bash）
2. 言語・フレームワーク・用途を推定する
3. 以下のステップでユーザーにヒアリングする

**Step 1 — 作成意向の確認**
```
プロジェクトの CLAUDE.md が見つかりません。
推定プロジェクト種別: （例: Python CLI / Node.js API / Flutter アプリ）

CLAUDE.md を新規作成しますか？（はい / いいえ）
```

**Step 2 — スタイルの選択**（Step 1 で「はい」の場合のみ）
```
どのスタイルで作成しますか？

  1. テンプレートから作成（推奨）
     → Webのベストプラクティスを参照して最適な構成を提案します
  2. 最小構成（3行以内）
     → コマンドと制約のみ記載します

番号を入力してください：
```

**Step 3 — ドラフト生成**（Step 2 の回答を受けてから実行）

- 選択肢 **1** の場合：WebSearch で「CLAUDE.md best practices site:anthropic.com OR site:docs.anthropic.com OR github.com」などを検索し、最新のベストプラクティスを参照した上でドラフトを生成する
- 選択肢 **2** の場合：最小構成テンプレートを使ってドラフトを生成する

**Step 4 — ドラフト確認**
```
以下のドラフトを生成しました。

[生成したドラフトをコードブロックで表示]

このドラフトでよければ「OK」と入力してください。
修正したい箇所があれば教えてください。
```

「OK」を受けたらカレントディレクトリに `CLAUDE.md` を書き出す。

### テンプレート（選択肢 1 の参考ベース）

```markdown
# CLAUDE.md

## プロジェクト概要
（1〜2行でプロジェクトの目的・用途を記述）

## 技術スタック
- （言語・フレームワーク・主要ライブラリ）

## よく使うコマンド
```bash
# ビルド
# テスト
# 起動
```

## 重要なルール・制約
- （禁止事項・命名規則・フォルダ構成など）

## 参考リソース
- （関連ドキュメント・ URL など）
```

### 最小構成（選択肢 2）

```markdown
# CLAUDE.md

## コマンド
（ビルド・テスト・起動コマンドのみ）
```

---

## モード C：check（コスト効率化チェックリスト）

即行動できる3つの対策を表示する。

```
## ClaudeCode コスト効率化チェックリスト

1. セッションリセット（今すぐできる）
   → 30〜45分以上使ったセッションはコンテキスト肥大化の主因。
     `/token-saver handoff` で引き継ぎサマリーを生成できます。

2. CLAUDE.mdをスリムに保つ（今すぐできる）
   → ビルドコマンド・制約・禁止事項だけ残す。
     `/token-saver audit` で肥大化箇所を診断できます。

3. タスクに合ったモデルを選ぶ（コスト最大化）
   → 用途でモデルを使い分けるだけでコストが大幅に変わる。
     `/token-saver model` でモデル選択ガイドを表示します。
```

チェックリスト表示後、以下のステップで確認する：

**Step 1 — 実行項目の選択**
```
どの対策を今すぐ実行しますか？
番号を教えてください（例: 1 / 複数: 1 2 / やめる: skip）
```

**Step 2 — 実行確認**（番号が入力されたら）
```
「[選択した対策名]」を実行します。よろしいですか？（OK / やめる）
```

「OK」を受けてから対応するモードを実行するか、具体的な手順を案内する。

---

## モード D：model（モデル選択アドバイス）

タスクの種類に応じた最適モデルをガイドする。

### Claude Codeで利用できるモデル

| モデル | 特徴 | コスト感 |
|--------|------|----------|
| **Haiku 4.5** | 高速・軽量。単純なタスク向け | 最安 |
| **Sonnet 4.6** | バランス型。デフォルト推奨 | 中 |
| **Opus 4.6** | 最高精度。複雑な推論向け | 最高 |

### タスク別おすすめモデル

以下の表を出力する：

```
## タスク別モデル選択ガイド

### Haiku 4.5 を使うとき（コスト優先）
✅ 短いコードの補完・修正
✅ ファイルのフォーマット・整形
✅ 繰り返し作業の自動化（ループ処理など）
✅ 単純なQ&A・コマンド確認
✅ ログやエラーメッセージの要約

### Sonnet 4.6 を使うとき（デフォルト・バランス）
✅ 中規模の機能実装
✅ バグ調査・デバッグ
✅ コードレビュー・リファクタリング
✅ ドキュメント・コメント生成
✅ テストコード作成

### Opus 4.6 を使うとき（品質優先）
✅ 複雑なアーキテクチャ設計・技術選定
✅ 難解なバグの根本原因分析
✅ 複数ファイルにまたがる大規模リファクタリング
✅ セキュリティレビュー・パフォーマンス最適化
✅ 新技術・未知領域の調査・提案

### モデル切り替え方法
- Claude Code設定: /model コマンドまたはUI設定
- API利用時: model パラメータで指定
  - claude-haiku-4-5-20251001
  - claude-sonnet-4-6
  - claude-opus-4-6
```

表示後、以下のステップで確認する：

**Step 1 — タスクのヒアリング**
```
今取り組んでいるタスクを教えてください。
（例: 「大きなファイルをリファクタリングしたい」「APIドキュメントを読みたい」）
```

**Step 2 — モデル提案**（タスクが入力されたら）

その内容に合わせて最適モデルを1つ推薦し、理由を1〜2行で説明する。