Codex Multi-Agent Framework

一个面向 Codex 的轻量多 Agent 协作规范，用于统一任务拆分、风险分级、测试、审查和 交付流程，在不降低验证质量的前提下提升执行效率、压缩端到端交付时间。

首版 Skill 已实现，保持一个 SKILL.md 和三份任务模板，不包含 Plugin、daemon、DAG 生成器或调度平台。

核心价值

框架通过以下方式缩短真实交付周期：

• R0/R1 走快速路径，避免小改动启动完整多 Agent 和安全审查流程；
• R2/R3 只并行文件、接口和 worktree 相互独立的任务，缩短关键路径；
• 测试分为 Focused、Milestone、Final，避免每次小修复都重复完整矩阵；
• 只有审查发现 finding 才创建 Fixer，减少无效角色和交接；
• 将长回合拆成可返回的短里程碑，减少 UI 久不更新造成的停滞误判；
• 合并同一波审批，并用最小 run-status.md 避免等待、中断和重启后的重复工作。

这里的“效率”指包含实现、等待、验证、返工和恢复在内的端到端时间，不是跳过高风险 任务必需的测试或审查。

要解决的问题

Codex 已经具备子智能体、worktree、测试和代码审查能力，真正缺少的不是“再启动更多 Agent”，而是一套轻量、统一的交付判断：

• 什么时候单 Agent 足够，什么时候才需要多 Agent；
• 如何拆分任务，避免并行修改同一文件或共享状态；
• 如何让测试和审查强度匹配实际风险；
• 如何在长任务中持续协调，并在中断后可靠恢复。

缺少这些边界时，小改动容易流程过重，高风险改动又可能验证不足，多 Agent 的协调成本 甚至会高于实现本身。本项目要解决的是交付效率、协作一致性和可验证性，不改变模型 能力，也不建设新的调度平台。

内容

SKILL.md
templates/task-brief.md
templates/review-prompt.md
templates/run-status.md

完整设计见轻量多 Agent 协作规范。

使用

1. Clone 仓库

每台电脑都从公开 GitHub 仓库 clone，不要手工复制 Skill 文件。只使用框架不需要成为 仓库协作者。

Windows 示例：

git clone https://github.com/jiangyz-bit/codex-multi-agent-framework.git D:\AI\codex-multi-agent-framework

macOS/Linux 示例：

git clone https://github.com/jiangyz-bit/codex-multi-agent-framework.git /absolute/path/codex-multi-agent-framework

2. 链接到用户级 Skills 目录

链接名称必须是 multi-agent-delivery。不需要修改全局 AGENTS.md。

Windows PowerShell：

$skillRoot = Join-Path $env:USERPROFILE '.codex\skills'
New-Item -ItemType Directory -Force -Path $skillRoot | Out-Null
New-Item -ItemType Junction `
  -Path (Join-Path $skillRoot 'multi-agent-delivery') `
  -Target 'D:\AI\codex-multi-agent-framework'

macOS/Linux：

mkdir -p ~/.codex/skills
ln -s /absolute/path/codex-multi-agent-framework ~/.codex/skills/multi-agent-delivery

如果目标链接已经存在，先确认它是否已经指向本仓库，不要直接覆盖。

3. 验证安装

Windows PowerShell：

Test-Path "$env:USERPROFILE\.codex\skills\multi-agent-delivery\SKILL.md"

macOS/Linux：

test -f ~/.codex/skills/multi-agent-delivery/SKILL.md && echo "installed"

Windows 应返回 True，macOS/Linux 应输出 installed。然后新建一个 Codex 任务； 如果当前客户端尚未刷新 Skills 列表，重新打开 Codex。

4. 显式调用

在需要使用框架时直接说明任务，例如：

使用 $multi-agent-delivery 处理这个任务。先判断 R0-R3，再按最小充分流程实现、验证和审查。

未显式调用时，Codex 按原有方式工作。小型 R0/R1 任务不会因为使用本 Skill 而自动进入完整多 Agent 流程。

5. 更新

在仓库中拉取最新 main 即可，junction/symlink 不需要重建：

git -C D:\AI\codex-multi-agent-framework pull --ff-only

项目特有的架构、命令和长期约束仍放在项目自己的 AGENTS.md、 ARCHITECTURE.md 或模块级 AGENTS.md 中。

License

本项目采用 MIT License，可以自由使用、修改和分发，但需保留原始版权与 许可声明。