子代理与任务分工

返回 Codex 教学总目录

目标与准备

本段提到的教学与资源: 第一个专案

子代理是主任务委派出去的工作者，负责明确的一部分，再把结果交回来。它不是另一个自动隔离的 Git 储存库，也不是多开两个视窗就会自动互相协调。适合并行的工作必须各自有输入、范围与成果，而且不必等待另一个子任务先改好档案。这次两个人都只读，因此不需要让他们竞争同一份程式码的写入权。

步骤 1：先确认材料与基准

在自己的完整参考副本打开 index.html、style.css、app.js、core.mjs、core.test.mjs 五个档案。不要开到故意有错的 start 或 broken 版本。Windows、macOS、Linux 都先确认终端机工作目录，再执行同一个测试命令；此练习不需要安装 npm 套件，也不会连外部资料库。保存测试结果与版本，后面才能分辨原本就有的问题。

node --version
node --test core.test.mjs

目前教材包含三个顶层测试，正常参考副本应通过。这个数字只属于本篇提供的材料，不代表你自己的专案一定有三个测试。若找不到 Node 或 core.test.mjs，先回到CLI 排除问题与路径说明，停止后续分工。不要请子代理在材料不全时自行重建一个看起来相似的专案，否则审查对象已经改变。

步骤 2：用明确要求启动两个子代理

在桌面、CLI 或 IDE 的主任务选好练习资料夹，送出下面提示词。现在的本机 Codex 依直接要求或适用的 AGENTS.md／Skill 指示分派子代理；这里直接写清楚要两个。模型与推理深度先沿用主任务，不另外硬写帐号未必可用的模型名称。子代理各自使用模型和工具，会增加用量；两个小型唯读范围比不受限地持续新增工作者容易验收。

Use exactly two subagents for a read-only review of this Small Steps reference copy.
Do not spawn additional subagents or modify files.

Agent A: Read core.mjs. Map addTask, visibleTasks and decodeTasks.
For each function, report its input, behavior, failure or boundary handling, and file/symbol evidence.

Agent B: Read core.test.mjs. Map existing test coverage to those same functions.
Distinguish covered cases from possible missing cases; do not invent a bug just because a test is absent.

Parent: Wait for both reports. Verify cited symbols and reconcile disagreements.
Run node --test core.test.mjs once in the practice directory after collecting the reports.
Return a compact evidence table, actual test result and unverified claims.
If subagents are unavailable, say so; do not present a single-agent answer as delegated work.

送出前，把目前副本的完整根路径与基准结果一并提供，并要求两份回报各自列出读取路径。两份报告即使都写 core.mjs，也可能读到不同 checkout；主任务要将路径对回同一份 expected 副本。把「三项基准通过」标成主任务先前的纪录，不能算成 A 或 B 自己执行的测试。

两个子任务可以同时开始；测试统一由主任务最后执行，避免重复工作。

步骤 3：查看活动、补充条件与停止

桌面从主任务的子代理活动开启个别工作，查看读到哪些档案与目前状态。CLI 在互动画面输入 /agent 切换查看，不是终端机中的 codex agent 命令。IDE 若提供背景代理面板，可展开看状态或开启个别代理。各入口可在主任务直接要求引导或停止某个工作者；看不到面板时先查版本与入口支援，不假造已完成名单。

/agent

Tell Agent A to include duplicate task IDs in its analysis and keep the work read-only.
Wait for the updated evidence before the final summary.

这个补充要由主任务转给 A，再确认 A 的更新真的提到 addTask 对重复 ID 的处理。不要以为在目前打开的另一个视窗输入就一定送到正确对象，先核对代理名称或活动。若要停止 B，可明确写「停止 B，保留已取得证据，B 尚未完成的部分列为未验证」。停止不等于回复变更；本篇只读所以应没有档案差异，若意外有修改仍须另外检查与处理。

步骤 4：核对结果，而不只计算完成数

正常参考版中 addTask 会修剪文字、限制长度、检查 ID，并回传新阵列；visibleTasks 依 active／completed 筛选；decodeTasks 会拒绝错误格式与重复 ID。主任务应回到这些实际函式验证 A 的说法，再对照 B 指出的测试片段。假如 B 说没有测重复 ID，先区分新增时与储存读回时的两种检查，不要只因两份报告不同就选较长的一份。

再由主任务执行一次基准测试，保存实际 exit code 与结果。验收表至少包括「主张、档案／函式、测试证据、已确认或未确认」。有些行为可读程式确定，但没经过浏览器操作；有些测试缺口只是建议，不是现存 Bug。把这些状态分开，读者才知道下一步该补测试、实际重现还是直接修正。

进一步：保存狭义的自订角色

常重复做相同检查时，可以在可信任练习专案建立 .codex/agents/data-reader.toml。这是代理设定 TOML，不是 AGENTS.md，也不会单凭档案存在就启动工作者。先确认没有同名档，再保存下列完整范例；新任务中明确要求使用 data_reader，检查是否按角色读取。这个延伸不必为了完成前面的两人分工而先做。

name = "data_reader"
description = "Inspect Small Steps data invariants with file and symbol evidence."
sandbox_mode = "read-only"
developer_instructions = """
Read core.mjs and report inputs, invariants and error handling.
Do not edit files, invoke external services or spawn other agents.
Cite the relevant functions and distinguish confirmed behavior from assumptions.
If the file is missing, report the missing path and stop.
"""

范例未指定模型，让它沿用已可用的设定。子代理会继承主任务当下的权限；特别在互动 CLI，执行时的父层覆写会重新套用，不能把档案中的 read-only 当作永远高于当前授权的保证。请在委派前检查主任务的权限模式，并保留只读要求。要撤回延伸设定，只移除这次自己新增的角色档，重新开任务核对，不删整个 .codex。

常见问题、边界与下一步

没有建立子代理时，确认是否明确要求、入口与版本可用、是否已有执行中的工作者占用名额；不能用一个模型分饰两角冒充。两个人同时改档时，先停止写入与核对差异，再调整成不同目录或顺序执行，参考 Worktree。子代理等待认证或权限时，主任务应说明来源与哪一步卡住，不能以更多权限偷偷重试同一个被拒绝的动作。

完成时留下两个真实工作者的活动、各自的证据、一次补充条件的回应、主任务的整合与测试结果，以及五个教材档案未被改动的确认。刻意停止 B 的练习可以另开一次执行，标为停止案例，不算两份完成报告。本文的角色设定与参考程式可静态核对，没有宣称已替你的帐号启动代理；桌面、IDE、其他系统与手机介面未实测者依官方文件查证。接续子代理品质验收学习验证看起来合理但缺少证据的回报。

返回 Codex 教学总目录

阅读完整文字说明

Bounded tasks to Subagents to Review

• AI 工具
• 教程
• Codex