| name | devflow-codex |
| description | 在 Codex 中运行 devflow。用户提到 devflow、start/resume/status/abort devflow、多 agent 工作流，或要求“按 Codex devflow 跑”时使用。 |
DevFlow Codex 工作流
这是 Codex 原生工作流入口。Codex 运行时只读取 .codex/，不读取
.codebuddy/。
.codex/ 与 .codebuddy/ 是两套独立工作流资产；二者应保持流程契约一致，
但互不作为运行时依赖。
必读文件
启动或恢复前必须读取：
.codex/assets/devflow.defaults.yaml.codex/runtime/start-workflow.md.codex/runtime/workflow-state-spec.md- TASK-01 需求澄清时读取
.codex/skills/superpowers/brainstorming/SKILL.md
- TASK-05 知识沉淀时读取
.codex/skills/knowledge-distillation/SKILL.md
- 当前阶段对应的
.codex/agents/<role>.md
- 当前阶段需要的
.codex/rules/ 和 .codex/checklists/
在 Codex 中如何触发
Codex 不会自动把仓库里的命令文件注册进 / 菜单。请用自然语言或显式
skill 触发：
$devflow-codex start 需求描述...
$devflow-codex status TASK_SLUG
$devflow-codex resume TASK_SLUG
$devflow-codex abort TASK_SLUG
也可以直接说：
用 devflow 跑这个需求：...
编排规则
- 主 Codex 线程是唯一 orchestrator。
workflow-state.json 是阶段交接和审计的唯一持久化状态。- 不使用 CodeBuddy 的
team_create、send_message、team_delete。
- medium/large 的 TASK-01 必须使用
superpowers:brainstorming 做需求澄清，
且必须等待用户明确回答或确认后才能进入 TASK-02。
- TASK-02 及之后的角色阶段必须通过 Codex
multi_agent_v1.spawn_agent
派发；只有工具不存在或返回 unavailable/not found 时，才允许主线程内联执行
并在 workflow-state.json.decisions[] 记录降级原因。
- 阶段产物和状态 schema 必须保持 devflow 兼容。
启动协议
按 .codex/runtime/start-workflow.md 执行：
- 初始化
artifacts/{task_slug}/ 和 workflow-state.json。
- Phase 0 做需求草图、影响扫描和规模判定。
- small 进入 SOLO。
- medium/large 先由主 Codex 线程调用
superpowers:brainstorming 完成
TASK-01 需求分析与澄清，写入 01-requirement/requirement-report.md，
经用户确认后再进入 TASK-02。
- TASK-02 起使用
multi_agent_v1.spawn_agent 派发对应角色。
- 如果用户要求先确认方案，停在 TASK-03 前。
阶段协议
每个阶段：
- 先读取
workflow-state.json。
- 读取
.codex/agents/<role>.md。
- 写入阶段开始状态。
- 产出对应 artifact。
- 更新
workflow-state.json。
- 返回主线程，由主线程按 routing table 决定下一阶段。
完成协议
结束时生成 workflow-summary.md，更新 summary 字段，保留全部产物，并向用户
汇总改动、验证、审查和知识沉淀结果。
