Agent Skills › Tencent/LoopForge › devflow-codex

devflow-codex

GitHub

Codex多Agent工作流编排技能,支持启动、恢复、状态查询及中止。通过主线程协调子代理执行需求澄清、开发等阶段,管理持久化状态与产物,实现自动化软件开发流程。

local/.codex/skills/devflow-codex/SKILL.md Tencent/LoopForge

Trigger Scenarios

用户提到devflow 要求start/resume/status/abort devflow 提及多agent工作流 要求按Codex devflow跑

Install

npx skills add Tencent/LoopForge --skill devflow-codex -g -y
More Options

Non-standard path

npx skills add https://github.com/Tencent/LoopForge/tree/main/local/.codex/skills/devflow-codex -g -y

Use without installing

npx skills use Tencent/LoopForge@devflow-codex

指定 Agent (Claude Code)

npx skills add Tencent/LoopForge --skill devflow-codex -a claude-code -g -y

安装 repo 全部 skill

npx skills add Tencent/LoopForge --all -g -y

预览 repo 内 skill

npx skills add Tencent/LoopForge --list

SKILL.md

Frontmatter
{
    "name": "devflow-codex",
    "description": "在 Codex 中运行 devflow。用户提到 devflow、start\/resume\/status\/abort devflow、多 agent 工作流,或要求“按 Codex devflow 跑”时使用。"
}

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 触发:

$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 执行:

  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-02 起使用 multi_agent_v1.spawn_agent 派发对应角色。
  6. 如果用户要求先确认方案,停在 TASK-03 前。

阶段协议

每个阶段:

  1. 先读取 workflow-state.json。
  2. 读取 .codex/agents/<role>.md。
  3. 写入阶段开始状态。
  4. 产出对应 artifact。
  5. 更新 workflow-state.json。
  6. 返回主线程,由主线程按 routing table 决定下一阶段。

完成协议

结束时生成 workflow-summary.md,更新 summary 字段,保留全部产物,并向用户 汇总改动、验证、审查和知识沉淀结果。

Version History

  • dd56585 Current 2026-11-16 13:49

Same Skill Collection

local/.claude/skills/agent-observability/SKILL.md
local/.claude/skills/brainstorming/SKILL.md
local/.claude/skills/knowledge-distillation/SKILL.md
local/.claude/skills/tech-design/SKILL.md
local/.claude/skills/writing-plans/SKILL.md
local/.codebuddy/skills/agent-observability/SKILL.md
local/.codebuddy/skills/brainstorming/SKILL.md
local/.codebuddy/skills/knowledge-distillation/SKILL.md
local/.codebuddy/skills/tech-design/SKILL.md
local/.codebuddy/skills/writing-plans/SKILL.md
local/.codex/skills/knowledge-distillation/SKILL.md
local/.codex/skills/superpowers/brainstorming/SKILL.md
local/.cursor/skills/agent-observability/SKILL.md
local/.cursor/skills/brainstorming/SKILL.md
local/.cursor/skills/knowledge-distillation/SKILL.md
local/.cursor/skills/tech-design/SKILL.md
local/.cursor/skills/writing-plans/SKILL.md
local/skills/devflow-clarify-requirements/SKILL.md
local/skills/devflow/SKILL.md
skills/report-workflow-usage/SKILL.md

Metadata

Files
0
Version
dd56585
Hash
6abd3a95
Indexed
2026-11-16 13:49

inicio - Wiki
Copyright © 2011-2026 iteam. Current version is 2.156.0. UTC+08:00, 2026-11-16 14:56
浙ICP备14020137号-1