用途:按用户提供的任务集(docs/<feature-slug>/tasks 及其引用的 spec)端到端实现 Unity 功能,主流程只做协调,所有仓库编辑都交给子代理。
前置门槛:需完整阅读任务与 spec;/unity-cli 可用;UI 工作需 /ui-ugui(Runtime/Canvas)或 /ui-imgui(Editor IMGUI)可用;任务不得依赖项目未引用的外部包(含需改 .asmdef、Packages/manifest.json 或导入 TMP Essentials 等编辑器资源);运行 unity status,若无 Editor 打开需请用户打开。门槛不满足即停止并询问。
主要能力与流程:按文件名顺序为每个任务派生一个子代理并等待完成,子代理依次执行 Sources(读任务与 spec,查找 docs/ 中的编码与测试规范)、Implementation(非代码与 .asmdef 编辑用 /unity-cli,不直接改 Unity YAML;UI 用 /ui-ugui 或 /ui-imgui;自动化行为按 /unity-tdd)、Validation(按 test-protocol.md 跑验收检查,通过后重跑指定 EditMode/PlayMode 套件,Player 构建与人工试玩列为 deferred)、Report(固定格式,含 Outcome、Changed files、Validation、Unity TDD、Blockers)。全部任务成功后应用 /unity-code-review,再派生一个修复子代理,对评分 1–5 的发现逐条核实为有效或误报,只修有效项,重跑受影响验证,并输出 Finding disposition 报告。最后汇总各任务结果、累计改动文件、验证状态、TDD 应用情况、审查发现与修复动作。
限制:子代理不得运行 git add、git commit、git stash,除非用户明确要求该操作;任务仅在子代理报告 Success 且验收通过时视为完成;出现门槛失败、阻塞或验证失败需停止并转达报告,待用户解决后从该任务继续;不进行第二次审查。