token-burner

Token Burner

トークンが期限切れになる前に価値のあるプロジェクト改善タスクを自動実行し、利用枠を無駄にしません。

概要

プロジェクトを自動スキャンし、コードレビュー、テスト生成、ドキュメントの改善、依存関係の監査、リファクタリングなどのタスクを見つけて、優先順位を付けて自律的に実行します。各タスクを worktree で分離し、実行後に自動検証することで、すべての変更が安全であることを確認します。

使用するタイミング

• ユーザーが、期限切れになる前にトークンを有効活用したい場合
• ユーザーが自律的なコード改善セッションを実行したい場合
• ユーザーが「burn tokens」／「token burner」／「トークンを使い切って」と言った場合
• ユーザーがプロジェクト全体から問題を自動で見つけて修正したい場合
• ユーザーが /token-burner を入力した場合
• ユーザーがプロジェクト全体の自動コードレビューを希望する場合
• ユーザーがコードの問題点を自動で見つけて修正したい場合
• ユーザーが手作業なしでテストカバレッジを改善したい場合
• ユーザーがプロジェクト全体の健全性を確認して整理したい場合

使用しないタイミング：

• ユーザーが具体的で明確なタスクに取り組みたい場合（通常のワークフローを使用）
• ユーザーが会話やブレインストーミングを希望する場合（トークンを使い切る懸念がない）
• プロジェクトに改善できるコードがない場合
• ユーザーが自動テストのみを実行したい場合（テストランナーを直接使用）
• ユーザーがドキュメントのみを生成したい場合（ドキュメント生成ツールを使用）
• ユーザーが特定のファイルをリファクタリングしたい場合（より適切に制御できるよう手動で実施）

基本パターン

ステップ 1：プロジェクトのスキャン

プロジェクトの種類と構造を検出し、実行可能なタスクを見つけます：

# 检测项目类型
test -f package.json && echo "Node.js"
test -f go.mod && echo "Go"
test -f requirements.txt && echo "Python"
test -f Cargo.toml && echo "Rust"

# 检测 git 状态
git log --oneline -5          # 最近变更
git diff --stat HEAD~3        # 变更范围
git status --porcelain        # 未提交变更

タスク検出エンジン：（詳しくは templates/task-discovery.md を参照）

タスクの種類	検出方法	優先度
🔒 依存関係のセキュリティ	dependency-audit スキルが利用可能なら委任し、そうでなければ監査ツールを直接実行	P0 - 直ちに実行
🐛 コードの不具合	git diff 内のロジック上の問題を分析	P0 - 直ちに実行
🧪 テストカバレッジ	テストのないソースファイルを見つけ、カバレッジを確認	P1 - 高優先度
📝 ドキュメントの不足	README、関数コメント、API ドキュメントを確認	P2 - 中優先度
♻️ コードのリファクタリング	重複コード、複雑な関数、コードスメル	P2 - 中優先度
🧹 Git の整理	古いブランチ、競合マーカー、大きなファイル	P3 - 低優先度

タスクリストを生成します。各タスクには type、file、description、impact（high/medium/low）、risk（high/medium/low）を含めます。

ステップ 2：優先順位付け

score = impact_score × (1 - risk_score) に従って並べ替えます：

要因	high	medium	low
impact	3	2	1
risk	0.8	0.4	0.1

安全ポリシー：

• P0 タスク（セキュリティ上の脆弱性、不具合）→ 直ちに実行
• P1 タスク（テスト）→ 実行可能。ただし、各タスクを worktree で分離
• P2 タスク（ドキュメント、リファクタリング）→ 実行可能
• P3 タスク（整理）→ 残りのトークンがある場合のみ実行

前提条件の確認：

実行前に必要なツールが利用可能かを確認し、ツールがない場合は黙って失敗するのではなく、該当するタスクの種類をスキップします：

# 检查工具可用性
command -v jq >/dev/null 2>&1 || echo "⚠️ jq 未安装，安全审计任务将跳过"
command -v npm >/dev/null 2>&1 || echo "⚠️ npm 未安装，Node.js 审计将跳过"
command -v go >/dev/null 2>&1 || echo "⚠️ go 未安装，Go 审计将跳过"
command -v pip-audit >/dev/null 2>&1 || echo "⚠️ pip-audit 未安装，Python 审计将跳过"

フィルタリングルール：

• node_modules/、vendor/、.git/ などのディレクトリをスキップ
• 他のスキルですでに対応済みのタスク（git-hooks-setup で設定済みのものなど）をスキップ
• 変更が 500 行を超える大きなタスクをスキップ（子タスクに分割）

ステップ 3：自律実行

Agent tool を使用してタスクを 1 つずつ実行し、各タスクを独立した worktree で処理します：

对每个 task in 队列:
  retries = 0
  max_retries = 3
  while retries < max_retries:
    1. Agent(task.prompt, {
         subagent_type: "general-purpose",
         isolation: "worktree",
         description: "token-burner:" + task.type
       })
    2. 在 worktree 中跑测试验证
    3. 如果测试通过 → 合并到主分支，break
    4. 如果测试失败 → retries++
       - 如果 retries < max_retries → 回滚 worktree，重试
       - 如果 retries >= max_retries → 记录失败原因，跳过此任务
    5. 更新任务状态

タスクの種類ごとの実行方針：

タスクの種類	実行方法	検証方法
🔒 依存関係のセキュリティ	監査ツールを実行し、修正コマンドを生成	再監査して確認
🐛 コードの不具合	diff を分析し、問題を特定して修正	関連するテストを実行
🧪 テストカバレッジ	ソースファイルのユニットテストを生成	新しいテストを実行して成功を確認
📝 ドキュメントの不足	README／コメント／API ドキュメントを生成	ドキュメントの形式を確認
♻️ コードのリファクタリング	関数の抽出、重複の解消、ロジックの簡略化	すべてのテストを実行
🧹 Git の整理	不要なファイルの整理、フォーマット	git status で確認

実行制限：

• 各タスクの再試行は最大 3 回
• 1 つのタスクが 5 分でタイムアウトした場合はスキップ
• タスクの総数はデフォルトで最大 20 個（--max-tasks で調整可能）

ステップ 4：記録とレポート

各タスクの完了後、タスクの種類、ファイル、状態、説明を memory に記録します。実行の構成は templates/execution-report.md を参照してください。

ステップ 5：終了処理

最終レポート templates/execution-report.md を生成します。レポートには次を含めます：

• 実行統計（成功率、所要時間、トークン消費量の推定）
• 各タスクの詳細な結果
• 未実行タスクの理由
• 次回実行時の推奨事項

クイックリファレンス

注：以下のパラメーターは AI が解釈する自然言語のヒントです。パラメーターを指定しない場合、AI が対話形式で確認します。

/token-burner                          # Scan and execute all tasks
/token-burner 只跑测试和文档            # Only test and doc tasks
/token-burner 最多跑 10 个任务          # Limit to 10 tasks
/token-burner 只扫描不执行              # Scan only, don't execute
/token-burner 扫描 /path/to/repo       # Target specific project

ヒント	説明	デフォルト
type のみ実行	タスクの種類のフィルター（security/bug/test/docs/refactor/clean）	すべて
最大 N 個のタスクを実行	実行するタスクの最大数	20
スキャンのみ実行	スキャンのみ行い、実行しない	false
path をスキャン	対象プロジェクトのパス	現在のディレクトリ

よくある間違い

間違い	正しい方法	理由
テストを実行せずにマージする	各タスクの実行後に必ず検証する	新たなバグの混入を防ぐ
一度に多くのタスクを実行する	20 個以内に抑える	トークンが尽きて途中で止まるのを防ぐ
worktree による分離を省略する	常に isolation: "worktree" を使用する	タスク同士の干渉を防ぐ
実行結果を記録しない	memory ファイルに書き込む	次回の実行で、どのタスクを済ませたか把握する必要がある
本番コードを検証しない	変更後に必ずテストを実行する	既存の機能を壊さないことを確認する
ツールが利用可能か確認しない	実行前にツールの有無を確認する	ツールがないタスクはエラーにせずスキップする
大規模なプロジェクトでタスク数を制限しない	--max-tasks を設定して制限する	トークンが尽きてタスクが中断するのを防ぐ
リスク評価を省略する	impact × (1 - risk) に従って並べ替える	高リスクのタスクは慎重に扱う
node_modules などのディレクトリを区別しない	vendor/node_modules/.git をスキップする	サードパーティーコードのスキャンによるトークンの浪費を防ぐ
リファクタリング時に diff を確認しない	1 タスクあたりの変更を 500 行未満に制限する	大きすぎる変更は安全性の検証が難しい