DevCrew - AI 驱动的软件工程化框架

中文 | English | العربية | Español

让任何软件项目快速实现工程化落地的虚拟 AI 开发团队

什么是 DevCrew？

DevCrew 是一套嵌入式的虚拟 AI 开发团队框架，基于 Qoder 构建。它将专业的软件工程流程（PRD → Solution → Design → Dev → Test）转化为可复用的 Agent 工作流，帮助开发团队实现规范驱动开发（SDD）。

通过 CLI 或复制方式将 Agent 和 Skill 集成到现有项目，即可快速初始化项目文档体系和虚拟软件团队，按照标准工程流程分步实现功能的新增和修改。

---

解决 8 个核心问题

1. AI 忽略现有项目文档（知识断层）

问题：现有 SDD 或 Vibe Coding 方法依赖 AI 实时总结项目，容易遗漏关键上下文，导致开发结果偏离预期。

解决：knowledge/ 知识库作为项目的"事实来源"，沉淀架构设计、功能模块、业务流程等核心信息，确保需求源头不偏差。

2. 需求文档直接转技术文档（内容遗漏）

问题：从 PRD 直接跳到详细设计，容易遗漏需求细节，开发出的功能与需求脱节。

解决：增加 Solution 文档环节，不考虑技术细节，只聚焦需求骨架：

• 包含哪些页面和组件？
• 页面操作流程
• 后端处理逻辑
• 数据存储结构

开发阶段只需基于特定技术栈"填肉"，确保功能"贴着骨头（需求）"生长。

3. Agent 搜索范围不确定（不确定性）

问题：复杂项目中，AI 大范围搜索代码和文档，结果不确定，难以保证一致性。

解决：明确的文档目录结构和模板，基于每个 Agent 所需内容设计，实现 逐级披露、按需加载，确保确定性。

4. 环节缺失、任务遗漏（流程断裂）

问题：缺乏完整的工程流程覆盖，容易遗漏关键步骤，质量难以保证。

解决：覆盖软件工程全环节：

PRD（需求）→ Solution（方案）→ API Contract（契约）
    → Design（设计）→ Dev（开发）→ Test（测试）

• 每个环节产出物是下一环节的输入
• 每步需人工确认后方可执行
• 所有 Agent 执行都有 todo 清单，完成后自检

5. 团队协作效率低（知识孤岛）

问题：AI 编程经验难以在团队间共享，重复踩坑。

解决：所有 Agents、Skills 和相关文档与源码一起进入 Git 版本管控：

• 一人优化，团队共享
• 知识沉淀在代码库中
• 提升团队协同效率

7. 单 Agent 上下文过长（性能瓶颈）

问题：大型复杂任务超出单 Agent 上下文窗口，导致理解偏差、输出质量下降。

解决：子 Agent 自动调派机制：

• 复杂任务自动识别并拆分为子任务
• 每个子任务由独立子 Agent 执行，上下文隔离
• 父 Agent 协调汇总，确保整体一致性
• 避免单 Agent 上下文膨胀，保障输出质量

8. 需求迭代混乱（管理困难）

问题：多个需求混杂在同一分支，相互影响，难以追踪和回滚。

解决：每个需求作为独立项目：

• 每个需求创建独立迭代目录 projects/pXXX-[需求名]/
• 完整隔离：文档、设计、代码、测试独立管理
• 快速迭代：小粒度交付，快速验证，快速上线
• 灵活归档：完成后归档至 archive/，历史清晰可追溯

6. 文档更新滞后（知识腐化）

问题：项目演进后文档过时，AI 基于错误信息工作。

解决：Agent 具有自动更新文档的能力，及时同步项目变化，保持知识库实时准确。

---

核心工作流程

graph LR
    A[PRD<br/>需求文档] --> B[Solution<br/>技术方案]
    B --> C[API Contract<br/>接口契约]
    C --> D[Design<br/>详细设计]
    D --> E[Dev<br/>开发实现]
    E --> F[Test<br/>测试验证]
    F --> G[Archive<br/>归档]
    
    H[Knowledge<br/>知识库] -.-> A
    H -.-> B
    H -.-> D
    H -.-> E
    
    E -.-> H
    F -.-> H

Loading

各阶段说明

阶段	Agent	输入	输出	人工确认
PRD	PM	用户需求	产品需求文档	✅ 必需
Solution	Planner	PRD	技术方案 + 接口契约	✅ 必需
Design	Designer	Solution	前端/后端设计文档	✅ 必需
Dev	Dev	Design	代码 + 任务记录	✅ 必需
Test	Test	Dev 产出 + PRD 验收标准	测试报告	✅ 必需

---

与现有方案对比

维度	Vibe Coding	Ralph 循环	DevCrew
文档依赖	忽略现有文档	依赖 AGENTS.md	结构化知识库
需求传递	直接编码	PRD → 代码	PRD → Solution → Design → 代码
人工介入	❌	启动时	每阶段确认
流程完整性	❌	中等	完整工程流程
团队协作	难共享	个人效率	团队知识共享
上下文管理	单实例	单实例循环	子 Agent 自动调派
迭代管理	混杂	任务列表	需求即项目，独立迭代
确定性	❌	中等	高（逐级披露）

---

快速开始

1. 安装 DevCrew

方式一：一键安装脚本（推荐）

# macOS / Linux / WSL - 从 GitHub 安装
curl -fsSL https://raw.githubusercontent.com/charlesmu99/devcrew/main/install.sh | bash

# macOS / Linux / WSL - 从 Gitee 安装（中国镜像）
curl -fsSL https://gitee.com/amutek/devcrew/raw/main/install.sh | bash

# Windows - 从 GitHub 安装
Invoke-Expression (Invoke-WebRequest -Uri "https://raw.githubusercontent.com/charlesmu99/devcrew/main/install.ps1").Content

# Windows - 从 Gitee 安装（中国镜像）
Invoke-Expression (Invoke-WebRequest -Uri "https://gitee.com/amutek/devcrew/raw/main/install.ps1").Content

方式二：手动复制

# 克隆仓库后复制到现有项目
git clone https://github.com/charlesmu99/devcrew.git
# 或：git clone https://gitee.com/amutek/devcrew.git

cp -r devcrew/.qoder devcrew/devcrew-workspace /path/to/your-project/

2. 初始化项目

# 运行初始化 Skill，自动生成知识库和项目结构
# 由 devcrew-project-init Skill 自动执行

3. 开始开发流程

# 1. 创建 PRD
# 2. 生成 Solution
# 3. 确认 API Contract
# 4. 详细设计
# 5. 开发实现
# 6. 测试验证

---

目录结构

your-project/
├── .qoder/                          # DevCrew 配置（运行时）
│   ├── agents/                      # 6 个角色 Agent
│   │   ├── devcrew-pm.md
│   │   ├── devcrew-planner.md
│   │   ├── devcrew-designer-frontend.md
│   │   ├── devcrew-designer-backend.md
│   │   ├── devcrew-dev-[framework].md
│   │   └── devcrew-test-[framework].md
│   └── skills/                      # 16 个 Skill
│       ├── devcrew-pm-prd/
│       ├── devcrew-solution-plan/
│       ├── devcrew-solution-api-contract/
│       ├── devcrew-design-frontend/
│       ├── devcrew-design-backend/
│       ├── devcrew-dev-task/
│       ├── devcrew-test-report/
│       ├── devcrew-knowledge-dispatch/
│       ├── devcrew-knowledge-bizs-init/
│       ├── devcrew-knowledge-bizs-sync/
│       ├── devcrew-knowledge-arch-init/
│       ├── devcrew-knowledge-arch-sync/
│       ├── devcrew-workflow-diagnose/
│       ├── devcrew-create-se-infrastructure/
│       ├── devcrew-skill-develop/
│       └── devcrew-agent-optimize/
│
└── devcrew-workspace/              # 工作区（初始化时生成）
    ├── docs/                        # 管理性文档
    │   ├── README.md
    │   ├── agent-knowledge-map.md
    │   └── PROJECT-INTRODUCTION.md
    ├── knowledge/                   # 项目知识库（动态生成）
    │   ├── README.md
    │   ├── constitution.md
    │   ├── architecture/
    │   ├── bizs/
    │   └── domain/
    └── projects/                    # 迭代项目（动态生成）
        ├── p001-user-auth/          # 需求即项目，独立迭代
        │   ├── 00.meta/
        │   ├── 01.prds/
        │   ├── 02.solutions/
        │   ├── 03.designs/
        │   ├── 04.tasks/
        │   ├── 05.tests/
        │   └── tech-debt/
        ├── p002-dashboard-v2/       # 另一个独立需求
        └── archive/                 # 已完成迭代归档
            ├── p000-onboarding-archived-2026-03-01/
            └── tech-debt/

---

核心设计原则

1. 规范驱动：先写规范，再由规范"长出"代码
2. 逐级披露：Agent 从最小入口开始，按需获取信息
3. 人工确认：每阶段产出需人工确认，避免 AI 跑偏
4. 上下文隔离：大任务拆分为小粒度、上下文隔离的子任务
5. 子 Agent 协作：复杂任务自动调派子 Agent，避免单 Agent 上下文膨胀
6. 快速迭代：每个需求作为独立项目，快速交付、快速验证
7. 知识共享：所有配置与源码一起 Git 管控

---

适用场景

✅ 推荐使用

• 需要规范流程的中大型项目
• 团队协作的软件开发
• 遗留项目的工程化改造
• 需要长期维护的产品

❌ 不太适合

• 个人快速原型验证
• 探索性、需求极不确定的项目
• 一次性脚本或工具

---

---

更多信息

• Agent 知识地图: devcrew-workspace/docs/agent-knowledge-map.md
• GitHub: https://github.com/charlesmu99/devcrew
• Gitee: https://gitee.com/amutek/devcrew
• Qoder IDE: https://qoder.com/

---

DevCrew 不是取代开发者，而是自动化那些枯燥的部分，让团队能专注于更有价值的工作。