一套跑在 Claude Code 里的 Java TDD 全流程自动化插件。从 MRD 到可跑通单测的代码，全程 AI 驱动，人在关键节点确认。
| 版本 | 日期 | 公告 | 摘要 |
|---|---|---|---|
| v4.0.0 | 2026-07-16 | RELEASE_2026-07-16.md | 真实 ecom case 回归；主流程调整为 00-05；新增 Stage 04 集成测试；Stage 05 领域归档；统一 CodeGraph 和领域知识库口径 |
| v3.3.0 | 2026-05-21 | RELEASE_2026-05-21.md | Harness 稳定性升级；Doctor、状态一致性、安全微操作、复杂度分级、模型路由和回归测试 |
完整版本记录见 CHANGELOG.md。v3.3.0 的反馈驱动升级总览见 v3.3.0-upgrade-summary.md。
后端研发的日常痛点：
- 信息对齐成本高：MRD 是产品语言，开发要自己翻译成技术方案，理解偏差很常见
- 单测覆盖率低：不是不想写，是写起来太耗时，尤其是 mock 复杂依赖的时候
- 跨域需求难拆分：一个需求同时涉及多个应用，每个应用得单独出方案，容易遗漏
- 知识靠人脑记：老代码为什么这么设计，新人根本摸不着头脑
dev-workflow 把研发流程拆成 6 个可恢复阶段，每个阶段背后是一组 Agent 自动执行：
/dev-workflow:00-init 环境初始化（一次性）
/dev-workflow:01-knowledge-base 构建领域知识库
/dev-workflow:02-implementation-plan MRD → PRD + 技术方案
/dev-workflow:03-code-gen-tdd 代码 + 单测 + 自动纠错
/dev-workflow:04-integration-test 集成测试 + 造数/清理方案
/dev-workflow:05-archive 归档 + 领域知识库更新
五种自动纠错机制（/03-code-gen-tdd 阶段）
| 机制 | 说明 |
|---|---|
| OpenSpec + TestSpec 双向比对 | 接口规格和测试规格互相比对，检查遗漏 |
| 编译纠正 | 编译报错自动反馈给 Agent，修复后重新编译 |
| 代码审查纠正 | 对照 CLAUDE.md 规范 Review，发现问题自动修改 |
| 单测未通过纠正 | 失败原因分析后自动修复，重新执行 |
| 覆盖率不足纠正 | 低于阈值时自动补充测试用例 |
断点续传：每个阶段完成后状态写入 execution-state.md，中途失败直接继续，不从头重跑。
跨域支持：一个 MRD 涉及多个应用时，自动路由分配、分别出方案、OpenSpec 保证接口对齐。
领域知识库：知识库统一落在 spaces/knowledge/knowledge-base/domains/{domain}/，01-knowledge-base 生成全量领域上下文，05-archive 只做领域级归档更新，不再写 {app}/app-knowledge-base/。
CodeGraph 集成：00-init 支持本地 CodeGraph 安装和 MCP 配置；技术方案、Review 和归档阶段使用 codegraph query/sync 或 MCP 工具做调用链与影响面分析。CodeGraph 不可用时流程降级为静态扫描，并在产物中记录 not_available 或 fallback 原因。
| 文档 | 内容 |
|---|---|
| QUICK_START.md | 6 阶段上手指南 |
| ARCHITECTURE.md | 架构设计说明 |
| FEISHU_SETUP.md | 飞书集成配置（可选） |
| CONTRIBUTING.md | 贡献指南 |
| CHANGELOG.md | 版本记录 |
| RELEASE_2026-07-16.md | v4.0.0 发布公告 |
| RELEASE_2026-05-21.md | v3.3.0 发布公告 |
| v3.3.0-upgrade-summary.md | 0521 反馈升级总览 |
examples/ 已按真实 ecom case 对齐，核心样本来自：
- 业务工程：
/ecom - 需求空间：
/ecom/req/targeted-campaign-stock-guard - 领域知识库：
/ecom/spaces/knowledge/knowledge-base
对应示例目录：
examples/01-knowledge-base/knowledge-base/：真实领域知识库结构快照examples/03-code-gen-tdd/：多应用代码生成状态与 app-statesexamples/04-integration-test/：需求级集成测试、seed SQL、cleanup SQLexamples/05-archive/：领域归档输入和真实归档报告示例
- Claude Code（CLI）
- Java 8+、Maven 3.6+
- JUnit 4 或 JUnit 5（项目已有即可）
- CodeGraph（推荐）：本地源码可用时从
/Users/xu/Downloads/codegraph-main执行npm install && npm run build && npm link，否则可用npm install -g @colbymchenry/codegraph
✅ 后端服务类需求，有明确接口变更和业务逻辑
✅ 跨域需求，涉及多个 Spring Boot 应用
✅ 需要快速提升单测覆盖率的存量项目
❌ 纯配置变更、前端交互、算法调优（暂不适合）
