Goal & Spec & Test Driven Development
从模糊目标到可验证实现,五层嵌套 Loop 驱动的全栈开发工作流
Core Innovations
不是"理解需求",而是故意曲解需求来发现歧义。每个 phase 都有对抗审查门禁,确保关键歧义无处藏身。
GIVEN / WHEN / THEN 场景作为后续所有阶段的"宪法"。Spec、Plan、Implement、Verify 全部基于契约执行。
Inner (TDD) → Task (review) → Phase (cross-check) → Project (post-mortem) → Meta (harness evolution),层层收敛。
同一套流程,按任务复杂度自动调整重量:brief / standard / comprehensive 三档深度,匹配不同场景。
Playbook System
| Playbook | 适用场景 | 典型关键词 | Phases | 默认深度 |
|---|---|---|---|---|
| feature | 新功能开发 | 新增、实现、开发、构建 | define → plan → implement → verify → finish | standard |
| bugfix | Bug 修复 | 修复、bug、异常、报错 | define → implement → verify → finish | brief |
| refactor | 代码重构 | 重构、整理、优化结构 | define → plan → implement → verify → finish | standard |
| explore | 调查探索 | 调查、研究、分析、探索 | define → research → reflect | standard |
Evolution Pipeline
Clarify 追问 → Challenge 对抗审查 → Prototype 行为原型 → Contract 可执行契约
生成 Spec + Plan + Test。零上下文子 Agent 可独立执行的 task 粒度
Fresh subagent per task,Red → Green → Refactor 循环,两级审查 + 对抗验证
L1 静态 → L2 单元+变异 → L3 集成 → L4 跨产物一致性 → L5 人工审查
测试验证 → 环境检测 → 合并 / PR / 保留 / 丢弃,测试不通过不能合并
产物持久化到 docs/evoloop/archive/ + Contract 合并到活规格库
异步复盘:轨迹分析 → 模式提取 → Warm Memory 更新 → Harness 改进提议
Verification Pyramid
Memory Architecture
当前 Change 上下文,单次对话生命周期,存储在 conversation context,最大约 20K tokens。
项目模式 + 规则库,存储在 references/knowledge/ 目录。RAG top-K 检索,最多 50 条规则,长期未触发则归档到 Cold。
跨项目聚合统计,存储在 ~/.evoloop/stats.json。Meta Loop 专用,用于全局 Harness 改进。
Agent Templates
对抗性需求审查 — 故意曲解需求以发现歧义
跨产物一致性 — 确保 contract / spec / code 无偏差
Task 实现 — 零上下文子 Agent 独立 TDD
Task 审查 — 代码质量和契约遵守审查
对抗性测试 — 高风险 task 的边界和异常审查
证据链验证 — 从 contract 到 code 的完整可追溯性
Harness 改进 — 基于复盘数据优化工作流本身
Cross-Platform
通过 Agent 工具派发 subagent。部署路径:.claude/skills/evoloop/
通过 fork context 派发 subagent。部署路径:.codebuddy/skills/evoloop/
Quick Start