Token Burner

在 token 过期前自动执行有价值的项目改进任务，不浪费任何额度。

Overview

自动扫描项目，发现代码审查、测试生成、文档完善、依赖审计、重构等任务，按优先级排序后自主执行。使用 worktree 隔离每个任务，执行后自动验证，确保每次修改都是安全的。

When to Use

• User wants to use tokens productively before they expire
• User wants to run an autonomous code improvement session
• User says "burn tokens" / "token burner" / "用掉 token"
• User wants to auto-discover and fix issues across a project
• User inputs /token-burner
• User wants automated code review across the project
• User wants to find and fix code smells automatically
• User wants to improve test coverage without manual effort
• User wants to do a full project health check and cleanup

When NOT to Use:

• User wants to work on a specific, well-defined task (use normal workflow)
• User wants to chat or brainstorm (no token waste concern)
• User's project has no code to improve
• User wants to run automated tests only (use test runner directly)
• User wants to generate documentation only (use doc generation tools)
• User wants to refactor specific files (do it manually for better control)

Core Pattern

Step 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）

生成任务列表，每个任务包含：type、file、description、impact（high/medium/low）、risk（high/medium/low）。

Step 2: 优先级排序

按 score = impact_score × (1 - risk_score) 排序：

安全策略：

• P0 任务（安全漏洞、缺陷）→ 立即执行
• P1 任务（测试）→ 可以执行，但每个任务在 worktree 中隔离
• P2 任务（文档、重构）→ 可以执行
• P3 任务（清理）→ 只在有剩余 token 时执行

前置依赖检查：

执行前先检查所需工具是否可用，缺失时跳过对应任务类型而非静默失败：

# 检查工具可用性
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/ 等目录
• 跳过已由其他 skill 覆盖的任务（如 git-hooks-setup 已配置的）
• 跳过超过 500 行变更的大任务（拆分为子任务）

Step 3: 自主执行

使用 Agent tool 逐个执行任务，每个任务在独立 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. 更新任务状态

每种任务的执行策略：

执行限制：

• 每个任务最多 3 次重试
• 单个任务超时 5 分钟则跳过
• 总任务数默认最多 20 个（可通过 --max-tasks 调整）

Step 4: 记录和报告

每个任务完成后记录到 memory（任务类型、文件、状态、说明），执行结构见 templates/execution-report.md。

Step 5: 收尾

生成最终报告 templates/execution-report.md，包含：

• 执行统计（成功率、耗时、token 消耗估算）
• 每个任务的详细结果
• 未执行任务的原因
• 下次运行建议

Quick Reference

Note: Parameters below are natural language hints parsed by the AI. Without parameters, the AI will ask interactively.

/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

Common Mistakes