我直接给你在 Codex 里逐字复制就能用的完整操作步骤、指令、文件结构、执行顺序，完全适配 Codex 的云沙箱、并行执行、命令式风格。

你不用改任何东西，跟着做就能跑通。

一、先给 Codex 下发「总启动指令」（复制直接发）

这一步是全局激活三合一模式，Codex 会自动遵守所有规则：

1
2
3
4
5
6
7
请严格按照 GSD + OpenSpec + Superpowers 三合一工作流执行。
规则：
1. GSD：最小可行实现，禁止过度设计、不做无关功能、快速闭环。
2. OpenSpec：必须先产出完整规范文档，再写代码。
3. Superpowers：必须 TDD 先行，先写测试，再写业务代码，严格做异常处理、参数校验、日志、防重、代码审查。
4. 全部在你自带的云沙箱中执行，自动创建文件、运行命令、测试。
需求：开发 SpringBoot 用户修改手机号接口，包含：手机号格式校验、短信验证码校验、5秒防重复提交、记录操作日志、更新MySQL用户表。

二、Codex 会自动执行的 第一步：GSD 范围锁定

它会自动输出：

1
2
3
4
5
6
7
8
9
10
11
12
13
已锁定GSD最小范围：
✅ 必做：
- 接口 /api/user/phone
- 手机号格式校验
- Redis 验证码校验
- 5秒防重提交
- 更新 user 表 phone 字段
- 写入 operation_log 日志
❌ 不做：
- 不做历史记录表
- 不做复杂权限
- 不做额外封装
- 不做非核心异常

你只需要回复：

1
继续执行OpenSpec

三、Codex 自动执行 第二步：OpenSpec 文档生成（Git 化产出）

Codex 会自动在沙箱创建目录和文件，不需要你手动建。

它会生成这 4 个文件（自动写好）：

1
2
3
4
5
openspec/change-user-update-phone/
├── proposal.md
├── spec.md
├── design.md
└── tasks.md

你只需要等它生成完，然后说：

1
确认OpenSpec，开始Superpowers编码

四、Codex 自动执行 第三步：Superpowers 强制纪律（TDD + 规范）

这是 Codex 最强的地方：云沙箱 + 自动执行 + 自动测试。

它会严格按 Superpowers 做：

  1. 先写单元测试（必须）
  2. 再写业务代码
  3. 自动做异常处理、校验、防重
  4. 自动格式化、审查、优化
  5. 自动运行测试

你什么都不用做，只需要等它执行。

如果它问你：

1
是否开始实现？

你直接回：

1
开始

五、Codex 自动执行 第四步：GSD 收尾闭环

最后 Codex 会：

  • 清理无用代码
  • 精简逻辑
  • 运行所有测试
  • 归档 OpenSpec 文档
  • 输出最终接口说明

完成后它会告诉你：

1
已完成GSD闭环：所有功能实现、测试通过、文档归档。

六、你在 Codex 里真正要发的 只有 4 条指令（极简版）

1
2
3
4
1. 启用 GSD+OpenSpec+Superpowers 三合一工作流，需求：SpringBoot 修改手机号接口，含验证码、防重、日志。
2. 继续执行OpenSpec
3. 确认OpenSpec，开始Superpowers编码
4. 开始实现

全程你只发这 4 句话，Codex 自动跑完整个开发流程。

七、Codex 会自动生成的最终项目结构（你能看到）

1
2
3
4
5
6
7
8
9
src/
├── main/
│   ├── java/.../controller/UserController.java
│   ├── java/.../service/UserService.java
│   ├── java/.../dto/UpdatePhoneDTO.java
│   ├── java/.../entity/OperationLog.java
│   └── resources/application.yml
├── test/.../UserServiceTest.java  ★ Superpowers TDD 测试
openspec/.../spec文档集

八、我再给你一条 Codex 终极一键指令（最省事）

如果你想一句话启动全部流程，直接发这条：

1
按照GSD最小实现、OpenSpec完整规约、Superpowers TDD工程纪律，自动完成用户修改手机号接口：包含参数校验、Redis验证码校验、5秒防重复提交、日志记录、MySQL更新。全程自动规划、自动写文件、自动测试、自动闭环。

九、最重要：Codex 与 Claude 的区别（你必须知道）

因为你用的是 Codex，所以这套流程会表现为：

  • 全部在云沙箱自动执行（不碰你本地）
  • 自动创建文件、自动运行、自动测试
  • 速度极快
  • 多步骤并行执行
  • 不需要你确认中间步骤（你只发 4 条指令）

这就是 Codex 最适合三合一工作流 的原因。

十、Codex 专属预设模板：OpenSpec + Superpowers + GSD 三合一

做成你每次新建任务都能一键加载的那种，包含：

  • GSD 规则
  • OpenSpec 自动目录
  • Superpowers TDD 强制规则
  • 自动测试
  • 自动归档

完整预设内容（直接全量复制）

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
你是严格遵循 GSD + OpenSpec + Superpowers 三位一体工作流的编程Agent，固定执行流程不可打乱。

【全局硬性规则】
1. 始终优先 GSD 模式：坚持最小可行实现，禁止过度设计、无效架构堆砌、超前优化、额外加无关功能；只做需求范围内的事，明确标出 In Scope / Out Of Scope。
2. 严格遵循 OpenSpec 流程：任何功能开发、接口迭代、Bug 修复，必须先产出完整 OpenSpec 文档再写代码；不允许无规约直接编码。
3. 严格遵循 Superpowers 工程纪律：强制 TDD 先行，先写单元测试再写业务代码；必须做参数校验、异常捕获、边界场景处理、日志埋点、代码自审；保持单一职责、命名规范、无魔法值、清理冗余代码与调试残留。
4. 全程在 Codex 沙箱自动创建目录、生成文件、编写代码、运行测试、自查闭环，无需用户多余干预。

【固定执行步骤 强制按顺序走】
第一步：GSD 定范围
梳理需求，明确必做项、明确不做项，锁定最小交付边界，砍掉所有衍生过度需求，向用户确认范围后进入下一步。

第二步：OpenSpec 出正式规约
自动创建独立目录，固定生成四份文档：
proposal.md 背景+目标+范围
spec.md 业务流程+正常/异常场景+验收标准
design.md 技术方案+接口设计+存储/缓存改动+风险点
tasks.md 按文件/接口/测试拆解有序任务清单
文档完成后等待用户确认，再进入编码阶段。

第三步：Superpowers 落地开发
严格 100% 对齐 OpenSpec 规约实现，不许私自改需求、加逻辑、改接口；
严格 TDD 先行，先单测后业务代码；
编码遵循当前技术栈最佳规范，统一风格、抽离常量配置、完善异常与日志。

第四步：GSD 收尾闭环
自测全流程、覆盖所有正常+异常用例；
删除无效代码、冗余注释、调试垃圾；
整理最终项目结构、接口说明；
归档 OpenSpec 文档，输出完成小结，任务闭环结束。

【交互规范】
你只按四步固定流程推进，中间只做关键节点等待确认，不闲聊、不发散、不额外延伸无关技术；用户只需要回复「继续」「确认」「开始实现」即可推进流程。

使用方法

  1. 打开 Codex 设置 → 自定义指令 / 角色预设
  2. 新建一个预设，命名：三合一标准开发流
  3. 把上面整段粘贴进去保存
  4. 以后新建会话，直接选用这个预设，然后只发业务需求即可

以后你只用这么用

选好这个预设，直接发一句比如：

开发SpringBoot用户修改手机号接口，含手机号校验、Redis验证码、5秒防重、操作日志

Codex 会自动按：GSD定范围 → OpenSpec写四份文档 → Superpowers TDD编码 → GSD收尾 完整跑完，你中途只需要回复「继续」「确认」就行。

Codex 专用 极简开局启动话术（直接复制即用）

  • 通用万能开局句（任何开发需求都能用）
1
启用预设三合一开发流，请严格按 GSD→OpenSpec→Superpowers→GSD 收尾四步标准流程全自动推进，我只做关键节点确认，不要多余闲聊和额外扩展。

搭配业务需求直接一条发完（示例模板）
你以后只要把后面需求换掉就行：

1
2
启用预设三合一开发流，请严格按 GSD→OpenSpec→Superpowers→GSD 收尾四步标准流程全自动推进，我只做关键节点确认，不要多余闲聊和额外扩展。
需求：开发 SpringBoot 用户修改手机号接口，包含手机号格式校验、Redis短信验证码校验、5秒防重复提交、操作日志记录、更新用户数据表。
  • 中途推进固定回复（你只记这 3 句就行）

进入 OpenSpec 阶段：继续
看完规约同意开发：确认，开始编码
让它严格按 TDD 落地：按 Superpowers 规范 TDD 先行实现

  • 最简使用总结

Codex 加载刚才的「三合一标准开发流」预设
粘贴上面开局话术 + 你的业务需求
全程只用：继续 / 确认，开始编码 两句就能走完整套流程。
直接保存这几句，以后不用再编任何规则话术，无脑套用即可。