如何使用Claude Code + Crevo 实现 SDD高效/质量开发（规约驱动Vibe-Coding）

一. Claude Code 如何配置我们 Crevo 的 MCP 工具

目标：让 Claude Code 能通过 MCP 访问 Crevo（读取 / 写入 Crevo 导出的 7 大文档、触发 Crevo 的生成/更新接口等）。

真实可用配置

推荐（CLI）方式

# 把 Crevo 的 MCP 服务添加到 Claude Code
claude mcp add --transport http aurakl-crevo https://crevo-mcp.aurakl.ai/mcp?key=your-api-key

• aurakl-crevo 为本次添加的 MCP server 名称（在 Claude Code 中可引用）。
• your-api-key 替换为你在 Crevo 控制台获取的 API Key。

或在项目根创建 .mcp.json

在项目根放入 .mcp.json（项目级别）或放在 global config（全局）：

{
  "mcpServers": {
    "aurakl-crevo": {
      "serverUrl": "https://crevo-mcp.aurakl.ai/mcp?key=your-api-key"
    }
  }
}

验证

claude mcp list

---

二. 如何配置 Crevo 的两个斜杠指令 /crevo 和 /update

创建 /crevo 命令

mkdir -p ~/.claude/commands
echo "使用 Crevo 创建完整的七大文档（用户故事、PRD、系统架构设计、业务流程设计、数据库设计、API 设计、开发计划）。" > ~/.claude/commands/crevo.md

执行后，在 Claude Code 聊天框中直接输入：

/crevo 用户管理系统

Claude Code 将自动调用 Crevo MCP 服务，生成完整的七大文档。

创建 /update 命令

echo "根据最新开发结果，自动更新 Crevo 文档体系（含 PRD、架构、API、测试用例等）。" > ~/.claude/commands/update.md

使用方式：

/update 用户管理系统 v1.2

Crevo 会根据 Claude Code 的开发执行情况，自动同步设计文档，实现智能化的规约闭环更新。

---

三. 如何使用我们的 Crevo 创建 文档

Crevo 负责把产品目标转为“结构化规约”——下面提供可复制的示例片段（真实可导出的 Markdown / OpenAPI / SQL），可直使用 Crevo 生成后供 Claude Code 使用。

文档一览（示例以 用户管理系统 为例）

.spec/
├── user_story.md
├── prd.md
├── architecture.md
├── process_design.md
├── database.md
├── api_spec.md
└── dev_plan.md

1. 用户故事（User Stories）
2. PRD（Product Requirements Document）
3. 系统架构设计（Architecture）
4. 业务流程设计（Process / Flow）
5. 数据库（DB）模型（Schema / Migration）
6. API（OpenAPI Spec）
7. 开发计划（dev_plan）

---

示例 3.1 — 用户故事 docs/user_story.md

# User Stories

## US-001: 用户注册
As a: 未注册用户
I want: 提交邮箱和密码注册账户
So that: 我能登录并使用平台功能

Acceptance Criteria:
- 前端提供邮箱/密码注册表单
- 邮箱格式验证，密码至少 8 位
- 发送激活邮件

---

示例 3.2 — PRD docs/prd.md

# PRD: User Management Service

Objective:
- 提供账号注册、登录、用户资料管理及基于角色的权限控制（RBAC）

Scope:
- Email/Password 注册、OAuth 登录
- 用户 Profile CRUD
- 角色与权限管理
- 审计日志与安全监控

Non-Goals:
- SSO 集成（可在后续迭代考虑）

---

示例 3.3 — 系统架构 docs/architecture.md（摘要）

Components:
- API Gateway
- Auth Service (JWT, OAuth)
- User Service (profile, preferences)
- Role Service (RBAC)
- DB: PostgreSQL + Redis (cache)
- CI/CD: GitHub Actions / Jenkins

---

示例 3.4 — 业务流程 docs/process_design.md（Mermaid）

sequenceDiagram
  User->>Frontend: submit(email, password)
  Frontend->>API: POST /api/v1/register
  API->>AuthService: validate, hash password
  AuthService->>DB: insert user
  AuthService->>EmailService: send activation email
  User->>EmailService: click activation link
  EmailService->>DB: set is_active = true

---

示例 3.5 — DB docs/database.sql

CREATE TABLE users (
  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
  email VARCHAR(255) NOT NULL UNIQUE,
  password_hash TEXT NOT NULL,
  created_at TIMESTAMP WITH TIME ZONE DEFAULT now(),
  is_active BOOLEAN DEFAULT false
);

CREATE TABLE roles (
  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
  name VARCHAR(100) NOT NULL UNIQUE
);

CREATE TABLE user_roles (
  user_id UUID REFERENCES users(id),
  role_id UUID REFERENCES roles(id),
  PRIMARY KEY (user_id, role_id)
);

---

示例 3.6 — API docs/api_spec.yaml（OpenAPI 片段）

openapi: 3.0.3
info:
  title: User Management API
  version: "1.0.0"
paths:
  /api/v1/register:
    post:
      summary: Register user
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RegisterRequest'
      responses:
        '200':
          description: registration accepted
components:
  schemas:
    RegisterRequest:
      type: object
      required:
        - email
        - password
      properties:
        email: { type: string, format: email }
        password: { type: string, minLength: 8 }

---

示例 3.7 — dev_plan docs/dev_plan.md

# Dev Plan: user-management

iterations:
- id: iter-01
  goal: basic registration & login
  tasks:
    - t-101: implement users table and migrations
    - t-102: implement POST /api/v1/register
    - t-103: create unit tests for register flow

- id: iter-02
  goal: RBAC & profile management
  tasks:
    - t-201: implement roles table and user_roles mapping
    - t-202: implement role assignment API
    - t-203: implement user profile CRUD

---

四、根据开发需求创建 Claude Code SubAgent

Crevo 生成的 开发计划（Dev Plan） 会被 Claude Code 解析成一系列开发任务。 每个任务对应一个 SubAgent，它们以 Markdown 文件形式定义在 .claude/agents/ 目录下。

SubAgent 不是从文档自动生成，而是根据 任务类型（开发、测试、代码审查、审计、调度等） 创建。 这种方式能让 Claude Code 按角色分工执行任务。

SubAgent 示例集合

开发代理：dev-agent.md

# Dev Agent
负责根据 Crevo 生成的设计文档完成具体代码开发。

## 输入
- prd.md
- api_spec.md
- db_design.md

## 行为
1. 读取当前迭代的任务
2. 生成或更新对应代码文件
3. 输出代码文件与提交记录

测试代理：test-agent.md

# Test Agent
根据 API 设计与用户故事，自动生成测试用例并执行。

## 输入
- api_spec.md
- user_story.md

## 行为
1. 生成 Jest 测试文件
2. 运行测试并记录结果
3. 输出测试报告到 reports/

代码审查代理：review-agent.md

# Review Agent
审查最新代码提交的安全性、风格一致性与潜在逻辑问题。

## 输入
- 最新提交记录
- 安全规范文档

## 行为
1. 执行静态分析与安全审查
2. 输出审查报告与修复建议

审计代理：audit-agent.md

# Audit Agent
监控系统变更、依赖更新与敏感配置。

## 行为
- 检查依赖变更日志
- 输出合规报告

调度代理：scheduler-agent.md

# Scheduler Agent
负责调度 SubAgent 的执行顺序与依赖关系。

## 行为
1. 读取 dev_plan.md
2. 并发执行独立任务
3. 汇总所有结果并上报 Crevo

这样，Claude Code 的 MCP 层就能依据 Crevo 的开发计划和上下文，动态分配任务到不同 SubAgent，实现模块化执行。

---

五、执行迭代开发并生成代码

当七大文档与 SubAgent 都准备好后，只需执行：

#claude
请帮我完成 dev_plan.md 规划的第一个迭代

Claude Code 会：

1. 读取 dev_plan.md 中的迭代 1 任务；
2. 根据 dev_plan.md 迭代内容中的人物找到对应的 7 大文档与迭代相关的内容进行开发任务规划
3. 调用 scheduler-agent 调度；
4. 分配任务到 dev-agent、test-agent 等；
5. 自动生成代码并运行测试；

---

六. Crevo规约驱动的 Vibe-Coding

Crevo 的核心思想是让所有开发任务都源自 “规约（Spec）”。

Claude Code 与 MCP 架构使这些规约成为上下文真相源，AI 的一切行为都在这个“语义场（Vibe）”中进行。

特征对比：

---

七. SDD Vibe Coding 的优势

• 高效对齐：产品/架构/开发/测试都在同一份结构化文档上对齐，减少会议与反复澄清。
• 可复现与可审计：SubAgent 的每次行为（生成、提交、测试）都有日志、PR 和 CI 记录。
• 自动化闭环：从需求到部署再回流监控数据到文档，形成持续优化循环。
• 降低人为误差：从规约到实现的映射是确定性的——OpenAPI → 代码骨架；User Stories → 测试用例。
• 适用于规模化团队：适合有多团队协作、需要明确接口和契约的大型项目。
• 支持中/英文用户：Crevo 的多语言输出 + Claude Code 的通用 Agent 设计，使跨国团队无障碍协作。

原文出处：微信公众号“遨睿动态”：mp.weixin.qq.com/s/tf6VDQ1Rbn2LdEM...

扩展阅读

Crevo 官方网站: crevo.aurakl.ai/zh

Crevo 官方文档: crevo.aurakl.ai/zh/docs

Claude 官方文档：docs.claude.com/zh-CN/docs/claude-...

本作品采用《CC 协议》，转载必须注明作者和本文链接