# devcrew

**Repository Path**: amutek/devcrew

## Basic Information

- **Project Name**: devcrew
- **Description**: DevCrew - AI驱动的软件工程化框架，将虚拟AI开发团队嵌入到你的项目中。支持规范驱动开发（SDD），提供 PRD → Solution → Design → Dev → Test 完整工作流。专为 Qoder IDE 构建。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-15
- **Last Updated**: 2026-03-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

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

<p align="center">
  <a href="./README.md">中文</a> |
  <a href="./README.en.md">English</a> |
  <a href="./README.ar.md">العربية</a> |
  <a href="./README.es.md">Español</a>
</p>

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

## 什么是 DevCrew？

DevCrew 是一套嵌入式的虚拟 AI 开发团队框架，基于 [Qoder](https://qoder.com/) 构建。它将专业的软件工程流程（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 具有自动更新文档的能力，及时同步项目变化，保持知识库实时准确。

---

## 核心工作流程

```mermaid
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
```

### 各阶段说明

| 阶段 | 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

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

```bash
# 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
```

```powershell
# 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
```

**方式二：手动复制**

```bash
# 克隆仓库后复制到现有项目
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. 初始化项目

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

### 3. 开始开发流程

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

### 4. 卸载 DevCrew

**方式一：一键卸载脚本（推荐）**

```bash
# macOS / Linux / WSL - 从 GitHub 卸载
curl -fsSL https://raw.githubusercontent.com/charlesmu99/devcrew/main/uninstall.sh | bash

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

```powershell
# Windows - 从 GitHub 卸载
Invoke-Expression (Invoke-WebRequest -Uri "https://raw.githubusercontent.com/charlesmu99/devcrew/main/uninstall.ps1").Content

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

**方式二：手动卸载**

```bash
# 删除 devcrew-workspace 目录
rm -rf devcrew-workspace/

# 删除 devcrew- 前缀的 Agent 和 Skill（保留自定义内容）
rm -rf .qoder/agents/devcrew-*.md
rm -rf .qoder/skills/devcrew-*/
```

> **注意**：卸载会保留你在 `.qoder/` 目录中的自定义 Agent 和 Skill。如需完全删除所有 Qoder 配置，请手动删除 `.qoder/` 目录。

---

## 目录结构

```
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](./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 不是取代开发者，而是自动化那些枯燥的部分，让团队能专注于更有价值的工作。**