SEVO

让 AI Agent 写的每一行代码，都有需求、有设计、有审计、有证据。

你遇到过这些问题吗？

用 AI Agent 写代码越来越快，但你心里清楚：快不等于靠谱。Agent 生成的代码没有需求定义、没有架构约束、没有独立审计、没有回归验证——改完就算完，出了问题全靠人肉排查。你需要的不是更快的代码生成器，而是一条能让 Agent 稳定交付结果的研发流水线。

SEVO 怎么解决

SEVO（Spec-Execute-Verify-Operate）是面向 vibe coding 用户的 Agent 研发流水线。14 个阶段覆盖从需求到交付的完整链路，每个阶段都有门禁、有证据、有责任归属。

核心能力：

• 需求先行，不靠猜：每次改动从需求规格开始，验收标准写清楚了才动手，Agent 不再自说自话
• 独立审计，不自审：写代码的和审代码的职责分离，评审结论建立在证据上，不是主观判断
• 全链路可追溯：从需求到交付，每个阶段的输入、输出、结论都记录在案，出了问题秒级定位
• 自动推进，不用盯：阶段完成后自动解析下一步和执行角色，流水线自己往前走
• 一个 Agent 也能跑：只有一个 Agent？照样走完整流程，质量降级但功能完整，随时可升级到多 Agent

30 秒快速体验

方式一：OpenClaw 插件（推荐）

# 在 SEVO 项目目录下运行初始化脚本
cd /path/to/sevo-pipeline
bash scripts/init.sh

# 创建第一条流水线
sevo:create my-project "Add user login endpoint"

init.sh 会自动注册插件到 OpenClaw、检测 Agent 环境、配置角色分配。

方式二：独立使用（Standalone）

npm install sevo-pipeline

import { Sevo } from 'sevo-pipeline';

const sevo = new Sevo({
  projectName: 'my-project',
  stages: ['spec', 'implement', 'review', 'verify', 'ledger'],
  adapter: 'standalone',
});

await sevo.init();
const run = await sevo.createRun({ description: 'Add payment integration' });
console.log(run.id, run.status);

14 阶段流水线

需求规格 → 需求评审门禁 → ┬─ 测试用例编写（并行）
                           ├─ UX 验收编写（并行）
                           ├─ 商用验收编写（并行）
                           └─ 架构契约（并行）
                                    ↓
                              架构评审门禁
                                    ↓
编码实现 → 独立审计 → 回归验证 → 发布门禁 → 部署 → 终验 → 交付账本

每一步背后都有门禁把关：

• 需求规格（spec）：写清做什么、给谁做、做到什么程度算完成
• 需求评审门禁（spec-review-gate）：独立评审通过才能往下走
• 测试用例编写（test-case-authoring）：需求通过后并行启动，为实现阶段准备测试用例
• UX 验收编写（ux-acceptance-authoring）：编写开箱即用验收标准
• 商用验收编写（commercial-acceptance-authoring）：编写商用场景验收标准
• 架构契约（contract）：架构方案、实现边界、工作包拆分，与测试用例并行
• 架构评审门禁（contract-review-gate）：产品+开发+质量三方会审
• 编码实现（implement）：按工作包逐个执行，TDD 循环
• 独立审计（review）：代码质量、需求一致性、安全性，由独立角色审查
• 回归验证（regression）：自动化回归检查，确认新改动没有破坏已有功能
• 发布通用化门禁（publish-generalization-gate）：检查产出是否满足通用化标准
• 部署（deploy）：构建打包与发布
• 终验（verify）：清洁环境端到端验证，含陌生人视角走查
• 交付账本（ledger）：串起版本、证据、结论和经验沉淀

智能路由

任务进来后自动判定级别：微小改动（L0）跳过 spec/contract 直接进实现，中大型改动（L1/L2+）走完整 14 阶段。每条流水线有唯一 ID，所有工件可关联追溯。

评审修复闭环

评审发现问题后，自动解析报告、生成修复任务、按优先级排队。修复完成后自动触发定向复验，不用重跑全量评审。

终局收敛验收

验证通过后，流水线自动执行终局差距扫描——逐条对照需求规格的覆盖状态。发现未覆盖的需求时，自动回到实现阶段生成补齐任务。收敛循环最多 3 轮，超限升级为人工介入。

谁会用 SEVO

独立开发者 / Solo Founder 用 Agent 推产品，关心交付速度，也关心返工成本。需要看到每轮改动的目标、边界和交付证据。

Agent 原生开发者 把 AI 当主力编码者。需要一条能约束 Agent 的流程，减少"写完就算完"的假完成。

质量把关者 负责审计需求、架构、代码质量。需要统一的工件链路和独立视角，快速判断通过还是卡住。

平台方 / Agent 提供方 提供不同模型和执行环境。需要接入一套通用研发流水线，核心逻辑与运行时解耦。

CLI 命令

| 命令 | 说明 | |------|------| | sevo:create <slug> "描述" | 创建流水线 | | sevo:status [id] | 查看流水线状态 | | sevo:list | 列出所有活跃流水线 | | sevo:doctor | 运行诊断检查 | | sevo:retry <id> <stage> | 重试失败阶段 | | sevo:pause <id> | 暂停流水线 | | sevo:resume <id> | 恢复流水线 |

配置

角色声明支持三种方式（优先级从高到低）：

1. 用户在配置中显式声明 role 字段
2. SEVO 内置命名约定自动匹配
3. 运行时类型推断

支持按阶段指定执行 Agent（stageAgents），覆盖角色池自动分配。

文档

• 产品需求规格
• 配置参考
• 故障排查

License

MIT License. Commercial use and derivative works must include attribution to the original author ([email protected]).