现在很多人都在用 Claude 或 Codex 写代码,但只要你真正做过中大型功能,就会遇到:
- 单独使用 Claude:理解需求强,但后端代码容易“自由发挥”,偶尔偏题或改过头
- 单独使用 Codex:代码质量高但需要非常明确的上下文,对整体需求把握不足
- 两者各自强大,却无法自然合作,导致你要在两个模型间来回粘贴上下文、补齐规范、手动串联流程
最终你依然不得不靠人工把这两个强力模型“手动协同”。
而 Spec-to-Code 工作流 最大的价值,就是彻底解决这件事:
它把 Claude 和 Codex 组合成一个"自动化、可控、分工明确的协作开发团队"。
这是裸用 Claude 或裸用 Codex 永远达不到的效果。
关键点:Claude 和 Codex 在工作流中不再是单兵作战,而是明确分工、互相补位
传统方式:
- Claude 擅长理解需求,但代码输出时可能风格不一致、容易重构太多
- Codex 擅长后端开发,但你必须手动给它完整规范,不然它不知道你真正想要什么
Spec-to-Code 方式:
Claude 负责“理解与规范化”,Codex 负责“精确实现后端逻辑”,二者之间通过结构化文档形成自动桥接。
具体分工如下:
1. Claude:负责所有“脑力工作”
Claude 完成你原本要手动做的事情:
- 分析需求并生成高质量规范(requirements-spec.md)
- 生成架构(02-architecture.md)
- 审查代码(codex-review.md)
- 生成测试用例与验证报告
Claude 的强项是理解复杂上下文、生成文档、控制流程,而工作流专门让它承担这些任务。
于是 Codex 不再需要“猜需求”——Claude 会准备好每一份它需要的信息。
2. Codex:负责所有后端代码实现(并输出结构化摘要)
Codex MCP 的强项是:
- 精准写接口
- 严格遵守技术栈
- 一致的后端代码风格
- 快速处理数据库、API、ORM、逻辑实现
工作流强制:
- 所有后端开发只由 Codex 执行
- Codex 必须生成 codex-backend.md
- 包含叙事说明 + 结构化 JSON 摘要
- Claude 基于摘要进行审查与集成检测
于是 Codex 不再需要“推测上下文”——它只需要根据 Claude 的规范生产高质量后端代码。
3. Claude 用 Codex 的结构化摘要继续做审查与验证
Codex 完成后,Claude 会读取其 JSON 摘要内容:
- 实际修改的文件
- 完成状态
- 覆盖的功能
- 技术决策
- 自检清单
Claude 基于此进行:
- 审查
- 集成性检查
- 回归风险评估
- 测试验证
这意味着 Claude 不会随意修改 Codex 的代码,而是基于 Codex 的输出做高层判断和补充内容。
这是裸用 Claude 时完全无法做到的。
效果:两个模型真正形成“互补式流水线”
| 任务类型 | 单独使用 Claude | 单独使用 Codex | 在 Spec-to-Code 中 Claude + Codex 协作 |
|---|---|---|---|
| 理解业务需求 | 强 | 弱 | 由 Claude 负责,优势最大化 |
| 生成规范/架构 | 强 | 弱 | Claude 专职生成,Codex 读取 |
| 后端代码实现 | 会抽风 | 非常强 | Codex 专职负责,Claude 不干预实现细节 |
| 前端/胶水代码 | 中等 | 不擅长 | Claude 子代理负责 |
| 代码一致性 | 容易乱 | 稳定 | Codex 提供,Claude 审核 |
| 测试/验证 | 不稳定 | 不擅长 | Claude 专职 QA |
| 协作者间沟通 | 手动拼凑 | 手动拼凑 | 通过 Markdown 文档自动传递上下文 |
总结一句话:
Claude 负责“想清楚 + 提出规范 + 做审查”,
Codex 负责“严格实现 + 不走神”。
工作流负责“把他们连成流水线,互不越界、互相补位”。
它解决了“裸用 Codex 和 Claude”最大的问题:无法自然协作
传统 AI 写代码的最大痛点:
- Claude 代码质量不稳定
- Codex 不知道完整上下文
- 用户要在两个模型之间拼命 copy 文档
- 没有自动化的审查/验证
- 没有标准化产物
- 没有质量控制阈值
- 没有返工机制
Spec-to-Code 的关键突破点就是:
让 Claude 和 Codex 按“现实软件公司分工”协作,不再互相踩线,也不再需要用户手工协调。
实际使用时,你只需要一句命令
需求开发:
/requirements-pilot "实现一个带邮箱验证的用户注册系统"
Bug 修复:
/bugfix "登录接口返回 500 错误"
从分析 → 规范 → 后端开发(Codex) → 前端代码 → 审查 → 测试
整个流水线自动运行,顺序清晰、分工明确。
项目地址:https://github.com/c1767673917/spec-to-code
(非原创)
还好是小型
cursor 写 plan, codex 拿着plan 去写代码
不错
@c17673917 #0 学习了
厉害了