CrewAI + OpenHands 协作开发系统原型

这是一个用于项目规划、任务派发、执行落地、阶段复评的协作开发系统原型。

当前系统的基本思路是：

• CrewAI 负责：

  • 项目规划
  • 阶段拆解
  • 评审与 gate 决策
  • 输出结构化派单协议

• OpenHands 负责：

  • 接收 rework item
  • 在独立 workspace 内执行
  • 产出文档、代码、测试与结果记录

• Workspace 负责：

  • 承载真实项目交付内容
  • 让执行层与编排层解耦

---

当前状态

当前系统已经完成了一个可工作的 MVP 验证：

• CrewAI 已可运行
• OpenHands 已可运行
• 已建立 gate JSON 协议
• 已跑通一个 Todo CLI 小项目闭环
• 已完成多轮评审与返工
• 第三轮复评结果为 PASS

---

仓库结构

• src/crewai_oh_demo/

  • CrewAI 编排主体

• scripts/

  • 派单、快照、复评等桥接脚本

• workspaces/

  • 真实项目工作区

• docs/

  • 产品化文档、安装文档、使用手册

---

文档入口

请优先阅读：

• docs/README.md

  • 文档总入口

• docs/01_productization_plan.md

  • 产品化总计划

• docs/02_system_overview.md

  • 系统结构总览

• docs/03_installation_and_troubleshooting.md

  • 安装与排障总结

• docs/04_user_guide_new_project.md

  • 新项目使用手册

• docs/05_user_guide_takeover_project.md

  • 半途项目接手使用手册

• docs/06_productization_status.md

  • 当前产品化完成度与下一步建议

---

当前推荐用法

新项目

1. 创建 workspaces/<project_name>/
2. 写 PROJECT_SPEC.md
3. 生成 gate
4. 使用 dispatch_rework.py 派单
5. 使用 build_workspace_snapshot.py 生成快照
6. 使用 review_workspace.py 复评
7. 迭代直到 PASS

半途项目接手

1. 建立新的接手 workspace
2. 整理现状与核心事实
3. 生成 snapshot
4. 先做接手首轮评审
5. 再派单、复评、闭环推进

---

当前边界

当前系统仍属于原型阶段，已知边界包括：

• OpenHands 当前使用 process runtime
• 尚未切到 Docker / rootless Docker
• OpenHands 当前执行层优先使用 Anthropic-compatible 路线
• 一些脚本已具备通用化能力，但还未完全一键化

---

说明

当前仓库已经不只是一次性实验，而是一个可以继续产品化和模板化的基础骨架。