Skip to content

lordmos/dev-crew

Repository files navigation

语言 / Language: 简体中文 · English

DevCrew

DevCrew

给 AI 一套协作协议,让它像真正的团队一样工作。

帮你做好 harness!

npm version License: MIT Node.js PRs Welcome


痛点

用 AI(Copilot、Claude、Cursor…)辅助开发时,你是否遇到过:

问题 表现
无记忆 换个对话窗口,AI 忘了之前做了什么
无分工 AI 同时充当 PM + 架构师 + 开发 + 测试,顾此失彼
会跑偏 做着做着偏离目标,没有检查点纠正
质量盲区 没有审查环节,bug 和技术债悄悄积累
不知从何开始 面对新项目,不知道如何编排 AI 协作

根因:AI 缺少一套持久化的协作协议。DevCrew 就是那套协议。


30 秒上手

方式一:通过 Agent Skills 安装(推荐)

npx skills add lordmos/dev-crew

兼容 44+ AI 平台(Claude Code、GitHub Copilot、Cursor、Codex 等),自动将 DevCrew 协议安装到你的 Agent。详见 skills.sh

方式二:通过 CLI 安装

npm install -g @lordmos/dev-crew
cd your-project
crew init --platform copilot   # 或 cursor / claude

三步完成——INSTRUCTIONS.md 自动放到你的 AI 平台读取的位置,AI 立刻获得多 Agent 团队编排能力。

平台 命令 指令文件位置
GitHub Copilot crew init -p copilot .github/copilot-instructions.md
Cursor crew init -p cursor .cursorrules
Claude Code crew init -p claude CLAUDE.md
通用 crew init INSTRUCTIONS.md(手动引用)

可同时指定多个平台:crew init -p copilot cursor


它是怎么工作的

你: 我要给 API 加认证中间件

AI: [PdM] 创建变更 add-api-auth,模式: Standard
    Plan — 需求整理:
    - 目标: 为所有 /api/ 路由添加 JWT 认证
    - 验收标准: [ ] 未携带 token 返回 401  [ ] 过期 token 返回 401
    请确认。

你: 确认

AI: Design → Execute → Verify — 全部通过。请确认验收。

你: 确认

AI: [OK] 变更 add-api-auth 完成。

你只确认了两次(需求 + 结果),其余全部自动。


crew init 做了什么

your-project/
├── INSTRUCTIONS.md    ← AI 行为指令(核心文件)
├── dev-crew.yaml      ← 项目配置(模式、专家选择)
└── dev-crew/
    ├── specs/         ← 共享规约
    └── memory/        ← Agent 长期记忆(自动积累)

AI 读取 INSTRUCTIONS.md 后,PjM 自动编排团队,各 Agent 按 PDEVI 流程平行协作。


核心概念

PDEVI 工作流

flowchart LR
    P["Plan"] --> D["Design"]
    D --> E["Execute"]
    E --> V["Verify"]
    V -->|不通过| I["Iterate"]
    I -->|方案问题| D
    I -->|实现问题| E
    V -->|通过| Done["[OK] 完成"]
Loading

三种模式,覆盖所有场景:

模式 流程 适用
Standard P → D → E → V → I 新功能、重构
Express P → E → V Bug 修复
Prototype P → D → E 快速原型

按需组建团队

PjM 根据用户需求按需创建 Agent,常见角色:

Agent 职责
PjM 项目经理 任务拆解、Agent 调度、进度协调
PdM 产品经理 需求梳理、PRD 导入、验收标准
Architect 架构师 技术选型、任务分解、依赖分析
Implementer 开发 代码生成、重构、依赖安装
Tester 测试 测试执行、验收检查、覆盖率
Reviewer 审查 规范检查、安全扫描、最佳实践

团队规模不固定,PjM 按需创建更多 Agent(如 DBA、技术文档、运维),无需手动分配。

领域专家(29 位)

另有 29 位领域专家覆盖 10 个领域,按需激活:

游戏开发(8)· UI/UX(3)· 安全(1)· DevOps(3)· 测试(3)· 工程(5)· 数据(2)· AI/ML(1)· Web3(1)· 空间计算(2)

# dev-crew.yaml
specialists:
  - game-designer
  - security-engineer
crew agents  # 查看所有可用专家

完整列表见 领域专家目录


Skills

Skill CLI MCP Tool 用途
init crew init crew_init 初始化工作区 + Agent 记忆文件
plan crew plan <名称> crew_plan 创建变更并开始工作
status crew status crew_status 查看当前进度
checkpoint crew checkpoint crew_checkpoint 阶段审计 + 一致性检查 + 记忆同步
release crew release crew_release 归档变更 + 记忆整合
agents crew agents crew_agents 列出可用领域专家

自然语言同样有效——"做个检查点",AI 自动调用 checkpoint skill


使用场景

场景 你说 DevCrew 做
从零开始 "有个想法,从零构建" 初始化 → 引导需求 → Standard
已有 PRD "需求文档在这,执行吧" 导入 PRD → 提炼 → Standard
中途接入 "代码已有,帮我续上" 扫描代码 → 建基线 → Standard
头脑风暴 "讨论一下方案" 探索模式(不改代码)
Bug 修复 "有个 bug,快修" Express 模式
代码重构 "这段代码要重构" Standard 完整流程
快速原型 "先做个原型验证" Prototype 模式
学习代码库 "帮我理解这段代码" 探索模式(分析代码)

架构

┌─────────────────────────────────────────────────────┐
│  接入层                                              │
│  ┌───────────┐ ┌──────────┐ ┌─────────────────────┐ │
│  │ Agent     │ │ CLI      │ │ MCP Server          │ │
│  │ Skills    │ │ crew *   │ │ crew_*              │ │
│  │ SKILL.md  │ │          │ │                     │ │
│  └───────────┘ └──────────┘ └─────────────────────┘ │
├─────────────────────────────────────────────────────┤
│  协议层(核心,零工具依赖)                            │
│  INSTRUCTIONS.md · PDEVI 工作流 · 文件约定             │
└─────────────────────────────────────────────────────┘

三种接入方式:通过 npx skills add 安装到任意 Agent、通过 CLI 命令操作、通过 MCP Server 程序化调用。即使不装任何工具,手动放入 INSTRUCTIONS.md 也能工作。


文档

文档 说明
用户手册 8 种场景详细指南
最佳实践 场景串联示例
领域专家 29 位专家 · 10 个领域

贡献

欢迎参与!详见 CONTRIBUTING.md

许可证

MIT

致谢

领域专家部分基于 agency-agents-zh 项目改编。

About

帮你做harness!— 开箱即用的AI Agent 软件开发团队编排框架与 CLI + Skill 工具

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors