Evoloop

Goal & Spec & Test Driven Development

从模糊目标到可验证实现,五层嵌套 Loop 驱动的全栈开发工作流

五层嵌套 Loop 对抗性质量门禁 验证金字塔 L1–L5 自适应深度 可执行契约

核心创新

⚔️

对抗性收敛

不是"理解需求",而是故意曲解需求来发现歧义。每个 phase 都有对抗审查门禁,确保关键歧义无处藏身。

📜

可执行契约

GIVEN / WHEN / THEN 场景作为后续所有阶段的"宪法"。Spec、Plan、Implement、Verify 全部基于契约执行。

🔁

五层嵌套 Loop

Inner (TDD) → Task (review) → Phase (cross-check) → Project (post-mortem) → Meta (harness evolution),层层收敛。

📐

自适应深度

同一套流程,按任务复杂度自动调整重量:brief / standard / comprehensive 三档深度,匹配不同场景。

Playbook 体系

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

演进流水线

🎯 Define需求定义
→
📐 Plan方案设计
→
⚡ ImplementTDD 实现
→
✅ Verify验证金字塔
→
🏁 Finish完成 & 合并

🎯 Define

Clarify 追问 → Challenge 对抗审查 → Prototype 行为原型 → Contract 可执行契约

📐 Plan

生成 Spec + Plan + Test。零上下文子 Agent 可独立执行的 task 粒度

⚡ Implement

Fresh subagent per task,Red → Green → Refactor 循环,两级审查 + 对抗验证

✅ Verify

L1 静态 → L2 单元+变异 → L3 集成 → L4 跨产物一致性 → L5 人工审查

🏁 Finish

测试验证 → 环境检测 → 合并 / PR / 保留 / 丢弃,测试不通过不能合并

📦 Archive

产物持久化到 docs/evoloop/archive/ + Contract 合并到活规格库

🔄 Reflect

异步复盘:轨迹分析 → 模式提取 → Warm Memory 更新 → Harness 改进提议

验证金字塔 L1 → L5

L1 · 静态检查 — lint, type check(秒级)
L2 · 单元测试 + 变异测试轻量版(秒–分钟)
L3 · 集成测试 + 浏览器测试(分钟)
L4 · 跨产物一致性 + 可追溯性验证(分钟)
L5 · 人工审查门禁(L1–L4 全部通过后触发)

三层记忆架构

🔥

Hot Memory

当前 Change 上下文,单次对话生命周期,存储在 conversation context,最大约 20K tokens。

📚

Warm Memory

项目模式 + 规则库,存储在 references/knowledge/ 目录。RAG top-K 检索,最多 50 条规则,长期未触发则归档到 Cold。

🧊

Cold Memory

跨项目聚合统计,存储在 ~/.evoloop/stats.json。Meta Loop 专用,用于全局 Harness 改进。

Agent 体系

🔍 adversarial-goal-reviewer

对抗性需求审查 — 故意曲解需求以发现歧义

🔗 consistency-checker

跨产物一致性 — 确保 contract / spec / code 无偏差

🛠️ implementer

Task 实现 — 零上下文子 Agent 独立 TDD

👀 task-reviewer

Task 审查 — 代码质量和契约遵守审查

⚔️ adversarial-task-reviewer

对抗性测试 — 高风险 task 的边界和异常审查

🧩 traceability-checker

证据链验证 — 从 contract 到 code 的完整可追溯性

🔧 harness-updater

Harness 改进 — 基于复盘数据优化工作流本身

跨平台兼容

Claude Code

通过 Agent 工具派发 subagent。部署路径:
.claude/skills/evoloop/

CodeBuddy

通过 fork context 派发 subagent。部署路径:
.codebuddy/skills/evoloop/

快速开始

# 功能开发
用户: 帮我实现用户登录功能
→ playbook=feature, depth=standard
→ define → plan → implement → verify → finish → archive → reflect

# Bug 修复(快速模式)
用户: 修复订单状态显示错误,quick
→ playbook=bugfix, depth=brief
→ define → implement → finish → archive