Skip to content

Self-hosted workflows for coding-agent delivery. Orchestrate CodeBuddy, Codex and Claude Code with scripts and human approval gates. Includes Local workflows for coding assistants.

1.8 KB
Raw Blame

Codex DevFlow

.codex/ 是 Codex 独立工作流资产,不是 .codebuddy/ 的符号链接或运行时代理。

资产边界

Codex devflow 只读取:

  • .codex/assets/devflow.defaults.yaml
  • .codex/runtime/start-workflow.md
  • .codex/runtime/workflow-state-spec.md
  • .codex/skills/superpowers/brainstorming/SKILL.md
  • .codex/agents/*.md
  • .codex/agents/devflow-*.toml
  • .codex/rules/*.mdc
  • .codex/checklists/*.md
  • .codex/skills/devflow-codex/SKILL.md

.codebuddy/ 保留给 CodeBuddy 使用。Codex 工作流不得在运行时读取 .codebuddy/ 的 agents、rules、runtime、commands、hooks 或 settings。

medium/large 需求必须先由主 Codex 线程执行 TASK-01:读取并使用 superpowers:brainstorming 做需求分析与澄清,产物写入 artifacts/{task_slug}/01-requirement/requirement-report.md,再进入 TASK-02。 small 路径进入 SOLO,不执行 TASK-01。

Codex 适配差异

  • Codex 不注册仓库内 slash start-devflow 命令。
  • 用 $devflow-codex start ... 或自然语言触发。
  • 主 Codex 线程负责 orchestration。
  • TASK-02 及之后必须使用 Codex multi_agent_v1.spawn_agent 派发角色 agent。
  • 不使用 team_create、send_message、team_delete。
  • workflow-state.json 是阶段交接、恢复和审计的唯一状态。

恢复检查

新线程无法识别 skill 时,检查:

  1. .agents/skills/devflow-codex 是否指向 ../../.codex/skills/devflow-codex
  2. .agents/skills/superpowers-brainstorming 是否指向 ../../.codex/skills/superpowers/brainstorming
  3. .codex/skills/devflow-codex/SKILL.md 是否存在且权限为 644
  4. .codex/skills/superpowers/brainstorming/SKILL.md 是否存在
  5. .codex 是否为真实目录,而不是指向 .codebuddy 的符号链接