该技能用于把一个已批准目标转换为提供商中立的角色 DAG 和边界受限的任务包,本身只规划,不创建智能体。角色包括:primary-agent(负责范围、架构与人际沟通)、delegated-executor(执行有限实现或机械性工作)、reviewer(独立测试并判定稳定候选)、synthesizer(结构化已完成输入,不重新开展探索)。宿主为每个角色选择适配器,公开角色字段不写提供商或模型名。
适用条件:两个以上独立任务包可并行;实现与独立评审必须分离;扇出/汇聚或菱形 DAG 能显著缩短关键路径;多个结果需要显式协调与验收。不要拆分尚不知原因的探索性调试,也不要为制造智能体活动而拆分小型内聚改动。
输入包括:目标与授权范围、成功标准、范围内外文件/系统/外部动作、任何子任务可被创建时所需的 policy_ref 与 checkpoint_ref、已记录的人工决策与证据引用。范围或验收含糊时应提一个聚焦问题,不得自行假设外部写入权限。
工作流:确认仓库/工作树根;重述目标与范围;按工作性质与证据依赖识别任务边界;为每个任务分配一个角色;构建无环依赖图;划分写入范围(两个并行写入者不得拥有同一文件);为每个任务添加至少一个可运行或可客观检查的成功标准;以 schema_version 2 写 .coord/plan.yml;为每个非内联任务写 .ai/task__.md;返回就绪任务 id 与依赖顺序,不创建智能体。
执行前宿主需采集可归因的任务前基线,并说明要求编辑还是允许输出不变。任务包需包含上下文、任务前范围确认、目标、范围、验收、返回契约(status、摘要、files_changed、tests_run、evidence_refs、基线与候选引用、变更要求或允许不变的结果及证据、风险、阻塞)。
策略边界:宿主创建任务前必须运行
agent-collab policy evaluate
--policy <policy_ref>
--checkpoint <checkpoint_ref>
--json
仅在 decision=continue 且 spawn_allowed=true 时才可创建。分隔器输出不能覆盖该决定。宿主可在规划期委派只读探索,但不得把仅规划请求变为实现。小内聚工作优先直接执行,并为必需的独立评审保留容量。
不变量包括:提供商名是传输元数据而非公开角色;reviewer 与 synthesizer 不同;任务不能批准自身语义或治理敏感输出;缺失、空、失败、拒绝、取消、超时的任务保持非成功;并行结果列表在下游合成前过滤缺失/失败结果但保留失败记录;智能体投票不能取代证据验证或人工闸门。兼容性方面,历史无 schema 计划与提供商特定任务路径仅可解析,写入方只输出 v2 角色与通用任务路径。具体 schema、策略与迁移细节请参考 references/task_splitter_heuristics.md、docs/public-harness-contract.md 与 docs/migration-0.4.md(资料未提供其内容细节)。