Claude Orchestrator

✨ Claude Orchestrator: 您的 AI 开发团队总指挥

厌倦了手动管理开发任务？让 Claude Orchestrator 为您自动规划、执行和复核开发流程，释放您的双手，专注创新！

---

💡 产品简介

别再手动开发，让 Claude Code 全程代劳。

将 Claude Orchestrator 嵌入您的项目后，它将像一位高效的 LEAD Developer 一样，自动发现项目需求、将开发任务下发给 Developer 角色的 Claude Code 去实现，并在开发完成后进行严格复核。整个流程清晰流畅，几乎无需人工干预。

如果您已经在使用 Claude Code，但觉得逐条管理和跟进任务繁琐复杂，那么 Claude Orchestrator 将是您理想的解决方案，它能将开发流程自动化，显著节省您的时间和精力。

我们热烈欢迎任何人参与贡献与改进，共同打造更强大的自动化开发工具！本项目已开源。

---

🎯 工作原理：AI 协作自动化

Claude Orchestrator 协调 4 个专业 AI 代理，自动化您的整个开发工作流。就像一个完整的 AI 团队协同工作：

1. Planner（规划师）: 负责定义产品愿景和功能。
2. Designer（设计师）: 负责创建设计令牌和规范。
3. Tech Lead（技术主管）: 负责编写实现指南和架构设计。
4. Developer（开发者）: 负责阅读指令并实现实际代码。

整个流程涵盖了从需求发现到代码实现再到最终审查的完整生命周期：

• Discovery（发现）：扫描项目结构，识别并创建任务队列。
• Planner（规划）：定义产品愿景、拆解功能、设计用户流程、文档化需求。
• Designer（设计）：创建设计令牌、定义样式规范，确保视觉一致性。
• Tech Lead（技术指导）：分析规划与设计，撰写详细实现指南和定义架构。
• Developer（开发）：根据指令实现功能，应用设计令牌，并进行构建验证。
• Review & Verification（审查与验证）：Tech Lead 对代码进行审查，比对设计规范，报告差异，并记录完成情况。

任务状态流转：pending → in_progress → awaiting_review → completed 或 in_progress → rejected。

---

⚙️ 核心优势

• 🔌 四代理 AI 协作： 完整的 AI 团队，分工明确，效率倍增。
• 🕵️ 自动任务发现： 无需手动安排，系统自动识别并分配任务。
• 🎨 视觉一致性保障： 自动对比设计规范与实现，确保项目视觉统一。
• ⏱ 流程自动化： 告别繁琐管理，开发流程全自动化。
• 💾 进度实时保存： 随时停止和恢复工作流，进度永不丢失。

---

🚀 快速上手

先决条件：

• Node.js >= 18.0.0
• Claude Code CLI 已安装并完成认证（如果未安装，请执行 npm install -g @anthropic-ai/claude-code；如果未认证，请执行 claude login）。

安装：

npm install -g @graygate/claude-orchestrator

使用步骤：

1. 初始化项目：

   cd your-project
   claude-orchestrator init

2. 定义开发范围与目标：

   claude-orchestrator start \
   --scope "Implement user authentication" \
   --goals "Login,Register,Password Reset"

3. 监控进度：

   # 查看当前状态
   claude-orchestrator status
   # 实时查看日志
   claude-orchestrator logs --follow

您还可以使用以下命令管理工作流：

• claude-orchestrator stop: 优雅地停止代理。
• claude-orchestrator resume: 从上次中断的地方恢复。

在编排过程中，您可以使用键盘快捷键进行操作：

• l: 显示最近的日志条目
• s: 显示当前状态
• p: 当前任务完成后暂停
• q: 优雅地停止
• r: 恢复暂停的工作

---

📂 项目结构与配置

Claude Orchestrator 会在您的项目目录中创建一个 .claude-orchestrator/ 文件夹，其中包含：

• config.json: 项目配置
• status.json: 4 个代理的当前状态
• queue.json: 任务队列
• messages/: 代理间的通信记录
• design/: 设计产物 (如 tokens.json)
• logs/log.md: 开发日志

config.json 示例：

{
  "project": {
    "name": "your-project",
    "path": "/absolute/path/to/project"
  },
  "scope": "Development scope description",
  "goals": ["goal1", "goal2"],
  "platform": "web",
  "maxTasks": 10,
  "continuous": false,
  "figma": {
    "enabled": false,
    "fileKey": "optional-figma-file-key",
    "accessToken": "optional-figma-access-token"
  }
}

---

❓ 常见问题及解决方案：

• 提示“Claude Code CLI not found”：

  npm install -g @anthropic-ai/claude-code

• Claude Code 未认证：

  claude login

• 任务卡住：

  # 检查状态
  claude-orchestrator status
  # 查看最近日志
  claude-orchestrator logs --tail 50
  # 停止并恢复
  claude-orchestrator stop
  claude-orchestrator resume