devflow-codexlisted
Install: claude install-skill Tencent/LoopForge
# DevFlow Codex 工作流
这是 Codex 原生工作流入口。Codex 运行时只读取 `.codex/`,不读取
`.codebuddy/`。
`.codex/` 与 `.codebuddy/` 是两套独立工作流资产;二者应保持流程契约一致,
但互不作为运行时依赖。
## 必读文件
启动或恢复前必须读取:
1. `.codex/assets/devflow.defaults.yaml`
2. `.codex/runtime/start-workflow.md`
3. `.codex/runtime/workflow-state-spec.md`
4. TASK-01 需求澄清时读取 `.codex/skills/superpowers/brainstorming/SKILL.md`
5. TASK-05 知识沉淀时读取 `.codex/skills/knowledge-distillation/SKILL.md`
6. 当前阶段对应的 `.codex/agents/<role>.md`
7. 当前阶段需要的 `.codex/rules/` 和 `.codex/checklists/`
## 在 Codex 中如何触发
Codex 不会自动把仓库里的命令文件注册进 `/` 菜单。请用自然语言或显式
skill 触发:
```text
$devflow-codex start 需求描述...
$devflow-codex status TASK_SLUG
$devflow-codex resume TASK_SLUG
$devflow-codex abort TASK_SLUG
```
也可以直接说:
```text
用 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` 执行:
1. 初始化 `artifacts/{task_slug}/` 和 `workflow-state.json`。
2. Phase 0 做需求草图、影响扫描和规模判定。
3. small 进入 SOLO。
4. medium/large 先由主 Codex 线程调用 `superpowers:brainstorming` 完成
TASK-01 需求分析与澄清,写入 `01-requirement/requirement-report.md`,
经用户确认后再进入 TASK-02。
5. TASK-0