用途：用 auto-run-agent 编排 Claude Code，对目标项目做持续自动优化。核心原则为不修比乱修重要，每个发现分为 FIX/SKIP/DEFER；扫描维度轮换；每个 fix 独立验证；踩坑写入 MEMORY.md。
扫描维度按轮次轮换：Bug、架构、重复、性能、测试、API。用户可指定维度，否则按项目状态自动选择。
流程分五阶段：
- 探索与评估：确认目标路径，读取 README、CLAUDE.md，分析结构、技术栈、依赖与核心源码，检查 TODO/FIXME 等标记，按维度并行扫描，输出评估报告。
- 分类与设计：每个发现分 FIX/SKIP/DEFER，SKIP 需附理由（如触及公开 API、仅一处使用的重复、语义不同的相似代码、降低可读性的宏），生成结构化 TASKS.md。
- 创建 Runner 环境：commit 后切分支，建立 memory（TASKS.md、CONTEXT.md、DONE.md）、workspace 软链接、logs、config.yaml。config 默认含 max_iterations、max_cost_usd、max_duration、consecutive_no_progress、stop_when_empty、cooldown_duration、worker_timeout、use_git_detection。
- 执行与验证：使用 auto-run-agent 启动，命令为 cd <auto-run-agent 目录> 后执行 ./orchestrator --dir <runner-dir> --max-iterations 50 --max-cost 0 --max-duration 6。每个 fix 后立即验证，失败回滚并标 DEFER，通过则 commit 标 DONE。
- 收尾与学习：跑完整测试套件，bump version，更新 MEMORY.md 并切换下一扫描维度。
规则文件位于 rules/ 下，含 universal.md、rust.md、python.md、typescript.md、go.md，扫描时自动加载。
用户交互：Phase 1 后展示评估报告确认方向，Phase 2 任务列表确认后再建文件，启动前询问迭代次数、时间与成本限制，runner 目录默认 ~/Desktop/code/AI/<project-name>-runner/。
限制：auto-run-agent 位于 <auto-run-agent 目录>；目标项目须先 commit 干净再切分支；workspace 用软链接；多项目并行需注意 API rate limit。具体成本与价格信息暂未提供。