用 Codex SDK 启动多个并行 subagents。由 primary agent 预先分配 owned paths、阅读文件和验收标准,让 subagents 以 gpt-5.4 + high + danger-full-access 执行并回传改动、检查和风险。
这个技能用于把一个较大的任务拆成多个可并行推进的子任务,由 primary agent 明确分配文件边界,再让多个 subagents 直接执行。
ownedPaths。改了什么、跑了什么检查、还有什么风险。missionownedPathsreadFilesacceptanceCriteriadanger-full-access 执行,但默认只应修改自己负责的 ownedPaths。node、npm 可用codex CLI 可被 @openai/codex-sdk 调用,并已可用npm --prefix .agents/skills/codex-subagents-simple install
npm --prefix .agents/skills/codex-subagents-simple run subagents -- \
--spec /abs/path/to/subagents-spec.json \
--workspace-root /abs/path/to/workspace
npm --prefix .agents/skills/codex-subagents-simple run subagents -- \
--spec /abs/path/to/subagents-spec.json \
--workspace-root /abs/path/to/workspace \
--model gpt-5.4 \
--reasoning-effort high \
--max-parallel 3
默认会把 subagent name + spec path 对应的 threadId 写到:
.agent_cache/codex-subagents-simple/thread-registry.json
下一次运行同一个 spec 时,会自动 resumeThread(...),让每个 subagent 继续自己的线程上下文。
如果你想强制忽略旧线程,使用:
npm --prefix .agents/skills/codex-subagents-simple run subagents -- \
--spec /abs/path/to/subagents-spec.json \
--workspace-root /abs/path/to/workspace \
--fresh
运行时会在每个 runDir 下写:
agents/<name>.status.jsonagents/<name>.events.jsonlrun.json可以实时观察最近一次 run:
npm --prefix .agents/skills/codex-subagents-simple run watch
也可以指定某个 runDir:
npm --prefix .agents/skills/codex-subagents-simple run watch -- \
--run-dir /abs/path/to/run-dir
{
"task": "修复 reverse/java21-baseline 的一组问题",
"acceptanceCriteria": [
"相关模块完成修改",
"每个 subagent 都返回改动、检查和风险"
],
"sharedContextFiles": [
"README.md",
"reverse/java21-baseline/README.md"
],
"subagents": [
{
"name": "entry-chain",
"mission": "修复入口链和启动流程",
"ownedPaths": [
"reverse/java21-baseline/src/manual/GameMIDlet.java",
"reverse/java21-baseline/src/manual/ba.java"
],
"readFiles": [
"reverse/java21-baseline/src/generated-all/GameMIDlet.java",
"reverse/java21-baseline/src/generated-all/ba.java"
],
"extraInstructions": [
"优先保留现有模块边界",
"先跑最小编译检查再结束"
]
}
]
}
.agent_cache/codex-subagents-simple/<timestamp>-<slug>/spec.normalized.json: 标准化后的执行 specrun.json: 本次 run 的元信息与整体状态agents/<name>.status.json: subagent 当前状态快照agents/<name>.events.jsonl: subagent 流式事件日志agents/<name>.json: 每个 subagent 的结构化结果summary.md: 汇总结果首次运行前,建议先执行:
python3 .agents/skills/typescript-quality-gate/scripts/typescript_gate.py \
--module .agents/skills/codex-subagents-simple \
--install