token-efficiency について
冗長な出力や不要なツール呼び出し、コーディングの反復を減らすためのコーディングエージェント向けスキルです。出力ルール、タスク別の呼び出し上限、単回で進める手順をまとめています。
主な機能
- 01冗長な前置きや反復の削除
- 02タスク別のツール呼び出し上限
- 03単回で進めるコーディング手順
- 04コーディング・分析・エージェント用プロファイル
- 05トークン効率指標の記録
活用シーン
- 01エージェントの冗長な応答の削減
- 02コーディング作業のツール利用計画
- 03ファイルの再読込や編集の抑制
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/token-efficiencyを入力して読み込まれたか確認します。
詳細
トークン効率
出力トークンの無駄を減らし、コンテキストを消費する反復サイクルを防ぎます。
使用するタイミング
次の場合に使用します。
- セッションのコストが高い、または遅いと感じる
- 出力が冗長で、余計な文章が多い
- Claude がファイルを読み直したり、不必要に反復したりしている
- トークン効率の高い作業のために新しいプロジェクトをセットアップする
迎合を避けるルール
次のパターンは、出力トークンの30～60％を無駄にします。
| パターン | 例 | 修正方法 |
|---|---|---|
| 迎合的な書き出し | "もちろんです！素晴らしい質問です！" | 削除します。回答から始めます。 |
| プロンプトの言い換え | "Xについてのご質問ですね..." | 削除します。直接回答します。 |
| 結びの余計な一言 | "何か必要でしたらお知らせください！" | 削除します。回答したら終わります。 |
| 求められていない提案 | "ほかにも、...するとよいかもしれません。" | 求められていない限り削除します。 |
| AI に関する免責 | "AI モデルとして..." | すべて削除します。 |
| 冗長な前置き | "お手伝いします..." | 削除します。作業内容から始めます。 |
ツール呼び出しの予算
タスクの複雑さに応じて、明示的な予算を設定します。
| タスクの種類 | ツール呼び出しの予算 | まとめに入る時点 |
|---|---|---|
| 簡単な修正／調査 | 20回 | 15回 |
| バグ修正 | 30回 | 25回 |
| 小規模な機能追加 | 50回 | 40回 |
| 大規模な機能追加 | 80回 | 65回 |
| リファクタリング | 50回 | 40回 |
| 探索／調査 | 30回 | 25回 |
まとめに入る時点に達したら、進捗をコミットし、残作業を評価して、続行するか新たに始めるかを決めます。
ワンパスでのコーディング規律
小～中規模のタスクでは、次の手順に従います。
- テストも含め、関連するファイルをすべて読む
- コーディングの前にテストの検証内容を把握する
- 完全な解決策を一度に書く — 段階的に書き進めない
- テストは一度実行する — 合格したら、ただちに終了する
- 失敗した場合：エラーを読み、一度修正して再テストする
- 同じ失敗に対する反復は2回を超えない — アプローチを見直す
- 合格したコードをリファクタリング、改善、または磨き込まない
タスク別プロファイル
作業内容に応じてプロファイルを切り替えます。
コーディングプロファイル
- まずコードを返し、説明はその後に記載する（自明でない場合のみ）
- 過剰設計せず、動作する最もシンプルな解決策を選ぶ
- 変更する前に必ずファイルを読む
- 変更していないコードに docstring を追加しない
- 起こり得ない状況に対するエラー処理を追加しない
- バグを示し、修正を提示して終了する
エージェント／パイプラインプロファイル
- 構造化された出力のみを使用する：JSON、箇条書き、表
- 人間の読者を対象とする場合を除き、散文は使わない
- すべての出力は後処理なしで解析できるようにする
- 作業を実行し、行動を逐一説明しない
- ファイルパス、API エンドポイント、関数名を捏造しない
- 不明な場合は推測せず、null または "UNKNOWN" を返す
分析プロファイル
- まず調査結果を示し、その後に背景と方法を記載する
- 散文より表や箇条書きを使う
- 数値には単位を付ける
- データポイントを捏造しない
- 先に要約を示す（最大3項目）。注意事項は最後に記載する
書き込み前の読み取りの徹底
厳守するルール：
- このセッションで読んでいないファイルには書き込まない
- すでに読んだファイルは、変更されていない限り読み直さない
- コーディングの前にテストを読み、何が合格するか把握する
- 修正を試みる前に、エラー出力を注意深く読む
ASCII のみを使った出力
すべての出力で ASCII 文字のみを使用します。
—（ダッシュ）の代わりに--を使う- スマートクォートではなく
"を使う - カーリーアポストロフィではなく
'を使う - 明示的に求められていない限り、絵文字を使わない
- Unicode の装飾文字や特殊文字を使わない
これにより、コピー＆ペースト時の品質と下流システムとの互換性を確保できます。
効果の測定
次の指標を追跡して、トークン削減効果を測定します。
- 出力の長さ：回答あたりの平均語数（30～50％削減を目標）
- タスクあたりのツール呼び出し数：予算の範囲内に収める
- 読み直し回数：ほぼゼロにする
- 読み取り前の書き込み回数：ゼロにする
- 反復サイクル数：テストは5回以上ではなく、1～2回で合格させる
出典
トークン効率化のパターンは、drona23/claude-token-efficient（MIT）を参考にしています。
コメント
Markdown 対応