tencent 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 字段，保留全部产物，并向用户
汇总改动、验证、审查和知识沉淀结果。