whaojie797-design/Novera-AI-pipeline

Novera-AI-pipeline

License: MIT
GitHub stars
GitHub last commit

four-agent-pipeline —— 一个 agent 技能，通过四个相互监督、保持诚实的专用 agent，将一个模糊的需求转化为已合并、经门禁验证的代码：Specifier → Coder → Refactorer → Architect。

核心理念：不要审查过程——要对结果设门禁。 人类只审查一个产物（验收规格），其余一切则信赖一套焊接牢固的自动化质量门禁。

流水线

| Agent | 角色 | 职责 | 绝不做的事 |
|-------|------|------|------------|
| 1. Specifier | 需求官 | 将模糊请求编译为 Gherkin 验收标准 + 边界条件 + DoD | 编写哪怕一行实现代码 |
| 2. Coder | 实现官 | 以最小实现让每一条验收测试和单元测试变绿 | 过度设计，或偷偷塞入范围外的功能 |
| 3. Refactorer | 结构官 | 在不改变行为的前提下改进结构；用变异测试证明测试强度 | 以重构之名改变业务逻辑 |
| 4. Architect | 守门人（否决权） | 输出每道门禁的 PASS/FAIL 及实测值；将失败路由回上游 | 重写代码——它只做裁决 |

失败从不会卡在人类身上：每一次 FAIL 都附带实测值与阈值的对比，并自动路由回负责的 agent（references/failure-routing.md）。

钢铁牢笼（质量门禁）

| 门禁 | 默认阈值 |
|------|----------|
| 验收 + 单元测试 | 100% 通过 |
| 覆盖率 | ≥ 85% 行 / 75% 分支 |
| 变异得分 | ≥ 80% |
| 圈复杂度 | 每个函数 ≤ 10 |
| 重复率 | ≤ 3% |
| 依赖方向 / lint / 安全 | 0 违规 / 0 错误 / 0 高危严重 |

每道门禁都是二元的。“差不多”就是 FAIL。各生态系统的完整工具矩阵见：references/steel-cage.md。

安装

本仓库就是该技能——将它克隆到你的 agent 技能目录：

Claude Code
git clone https://github.com/whaojie797-design/Novera-AI-pipeline.git ~/.claude/skills/four-agent-pipeline

然后用诸如“对这个需求运行 four-agent pipeline”或“把这个功能请求编译成验收标准”之类的说法来调用它。

用法

1. 搭建工作区（可选，但很方便）
python scripts/init_pipeline.py my-feature --feature user-login

2. 将需求交给 Specifier（references/specifier.md）
3. 人类签署规格 -> 规格冻结
4. Coder（references/coder.md）            -> 测试 100% 变绿
5. 重构器（references/refactorer.md）  -> 钢笼指标已满足
6. 架构师（references/architect.md）    -> 通过则合并，失败则退回

可与 Claude Code 子代理、CrewAI、MetaGPT 风格的编排器，或使用同一模型的四个独立聊天会话配合使用。

仓库布局

Novera-AI-pipeline/
├── SKILL.md                      # 技能入口点（渐进式披露）
├── references/
│   ├── specifier.md              # 代理 1 完整系统提示词
│   ├── coder.md                  # 代理 2 完整系统提示词
│   ├── refactorer.md             # 代理 3 完整系统提示词
│   ├── architect.md              # 代理 4 完整系统提示词
│   ├── steel-cage.md             # 各生态系统的门禁阈值 + 工具
│   └── failure-routing.md        # 谁失败就退回给谁
├── assets/templates/             # 规格 / 功能 / 报告 / 门禁报告 / 异议
├── scripts/init_pipeline.py      # 工作区脚手架生成器（仅用 Python 标准库）
└── LICENSE                       # MIT

相关

- Novera-AI-skills — 八个
生产就绪的代理技能，附带零依赖脚本
- Novera-AI-agent — 本技能
所操作化的原始中文提示词文档

许可证

MIT — 可复制、修改并用于商业用途，需注明出处。