让 Claude Code 24小时自主运行的编排系统。
- Worker 短命，Orchestrator 长存 - 避免上下文窗口耗尽
- 外部记忆 - 通过 Markdown 文件传递上下文
- 自主发现任务 - 任务完成后自动发现新任务
- 多重终止条件 - 防止失控运行
┌─────────────────┐
│ Orchestrator │ ← 长期运行，管理 Worker 生命周期
└────────┬────────┘
│ 启动
▼
┌─────────────────┐
│ Worker │ ← 短期运行，执行具体任务
│ (Claude Code) │
└────────┬────────┘
│ 读写
▼
┌─────────────────┐
│ Memory Layer │ ← 外部记忆文件
│ - TASKS.md │ 任务列表
│ - CONTEXT.md │ 项目上下文
│ - DONE.md │ 完成历史
└─────────────────┘
# 确保已安装 Claude Code
npm install -g @anthropic-ai/claude-code
# 安装 Python 依赖
pip install pyyaml编辑 config.yaml：
# 目标项目路径
workspace_path: /path/to/your/project
# 运行限制（0 = 无限制）
max_iterations: 0
max_cost_usd: 0
max_duration_hours: 0
# 无进展检测（连续N次无进展则停止）
consecutive_no_progress: 5编辑 memory/TASKS.md 添加初始任务：
# 待办任务
## 高优先级
- [ ] 你的第一个任务
- [ ] 你的第二个任务
## 低优先级
- [ ] 可选任务编辑 memory/CONTEXT.md 描述项目：
# 项目上下文
## 项目概述
描述你的项目...
## 技术栈
- 语言/框架
- 重要约定./start.sh或直接运行：
python3 orchestrator.py按 Ctrl+C 优雅停止。
| 参数 | 默认值 | 说明 |
|---|---|---|
max_iterations |
0 | 最大迭代次数，0=无限 |
max_cost_usd |
0 | 最大成本(USD)，0=无限 |
max_duration_hours |
0 | 最大运行时间(小时)，0=无限 |
consecutive_no_progress |
5 | 连续无进展次数后停止 |
stop_when_empty |
false | 任务列表为空时是否停止 |
cooldown_seconds |
10 | 每次迭代间隔 |
worker_timeout_seconds |
1800 | Worker 超时时间(30分钟) |
- Orchestrator 读取 Memory 文件，构建 Prompt
- 启动 Worker（Claude Code）执行任务
- Worker 完成任务后更新 Memory 文件
- Orchestrator 检测文件变化，判断是否有进展
- 循环执行，直到达到终止条件
Worker 的 Prompt 包含关键指令：
- 每次只完成 1-2 个任务
- 永远保持 TASKS.md 中有未完成的任务（自己发现新任务）
- 完成后必须更新 .md 文件
这确保系统能持续运行。
大任务应拆分为小任务：
## 高优先级
- [ ] 实现用户认证
- [ ] 设计数据库表结构
- [ ] 实现注册 API
- [ ] 实现登录 API
- [ ] 添加 JWT 验证为不同项目创建独立的 runner 目录：
runners/
├── project-a/
│ ├── orchestrator.py
│ ├── config.yaml
│ └── memory/
└── project-b/
├── orchestrator.py
├── config.yaml
└── memory/
使用此系统在 24 小时内完成：
伐木人游戏 - 从零开始自主开发：
- 68+ 个功能迭代
- 12 种皮肤
- 11 种语言
- 游戏回放、分享、无限模式等
SpaceView - 磁盘空间分析工具优化：
- 33+ 个功能迭代
- 收藏、批量删除、重复文件检测
- 4 个新主题
- 键盘快捷键、手势支持
MIT