Codev

项目概述#

Codev 是一个面向人机协作的软件开发操作系统，核心理念是 Context Drives Code（上下文驱动代码）。项目提出了 SPIR 协议（Specify-Plan-Implement-Review），将软件开发流程结构化为四个阶段：规范定义、计划分解、代码实现和审查改进。

SPIR 协议#

项目提出的结构化开发协议：

• Specify（规范）：用清晰、无歧义的语言定义要构建的内容
• Plan（规划）：将规范分解为可执行的阶段
• Implement（实现）：为每个阶段构建代码、编写测试、验证需求
• Review（审查）：捕获经验教训并改进方法论

核心特性#

• 📄 自然语言作为主要编程语言：规范和计划驱动实现，所有决策纳入版本控制
• 🤖 AI 原生工作流：结构化格式，AI 智能体可以理解；支持多智能体咨询（GPT-5、Gemini Pro 等）
• 🔄 持续改进：每个项目改进方法论，经验教训反馈到流程中
• 📋 标准兼容：支持 AGENTS.md 标准（Cursor、Copilot 等）和 CLAUDE.md（Claude Code）

Agent Farm#

可选组件，提供基于 Web 的仪表板用于并行管理多个 AI 智能体：

• 协议感知，了解规范、计划和 Codev 约定
• Git worktree 管理，隔离每个构建者的更改
• 自动提示，构建者从实现其分配规范的任务开始
• 支持 Architect-Builder 模式（架构师+构建者）

项目结构#

your-project/
├── codev/
│   ├── specs/              # 功能规范
│   ├── plans/              # 实现计划
│   ├── reviews/            # 审查和经验教训
│   └── resources/          # 参考材料
├── AGENTS.md               # AI 智能体指令
├── CLAUDE.md               # AI 智能体指令
└── [your code]

安装与使用#

系统要求：Node.js 18+、Git 2.5+

# 全局安装
npm install -g @cluesmith/codev

# 初始化项目
mkdir my-project && cd my-project
codev init

# 验证安装
codev doctor

# 启动 Agent Farm 仪表板
af dash start

CLI 命令#

• codev init - 初始化 Codev 项目结构
• codev adopt - 将 Codev 添加到现有项目
• codev doctor - 检查依赖和环境配置
• af spawn <spec_number> - 为指定规范生成构建者
• af status - 检查运行状态
• consult - 多模型同时咨询

配置示例#

在 af-config.json 中配置 AI Shell：

{
  "shell": {
    "architect": "claude --dangerously-skip-permissions",
    "builder": "claude --dangerously-skip-permissions"
  }
}

效果数据#

根据项目案例研究：

• SPIR 方法得分：92-95 分
• VIBE（对话式）方法得分：12-15 分
• 将往返消息从数十条减少至 3-4 次文档审查

项目信息#

• 开源协议：Apache-2.0
• 主要语言：TypeScript (90.8%)
• 当前版本：v2.1.1
• 发布数量：39 个版本
• 提交次数：2,408 次

待确认事项#

• 商业支持：未明确提及企业版或商业支持服务
• 性能基准：对比分数缺乏详细测试方法说明
• 安全审计：未提及代码安全审计或第三方安全评估
• 大规模应用：未找到企业级生产环境案例研究