代理简报
子代理从空白记忆开始。它只知道您写下的内容。在启动任何子代理、工作流或长时间任务之前,请使用此技能文件夹中的 templates/brief.md 撰写一份简报。
步骤
- 大型任务包含多个部分:首先使用
templates/planner.md运行一个规划代理。它返回 5 到 8 个阶段,每个阶段都有一个可测量的done_when。然后每个阶段获得自己的简报。 - 质量工作(音乐、声音、视觉、写作风格):首先遵循
templates/reference.md。收集 2 到 3 个参考,测量它们,写出差距,制作一个原型,在继续进行其余工作之前让所有者评估它。 - 使用
templates/brief.md的每个标题撰写简报。在不适用的标题下写上“无”。将templates/test-policy.md粘贴到每个涉及构建或更改内容的简报中。 - 在构建步骤之后,使用来自
templates/critic.md的 2 或 3 位评审者,在同一次录制的材料上并行进行评审。将合并后的 must_fix 列表交给一个修复代理。 - 在每一个运行超过约 15 分钟的代理旁边启动一个看门狗(见下文)。
- 告诉用户您启动了什么、预算以及一个诚实的估计。说出什么是不确定的。
每份简报的规则
- 首先阅读:指向文件和章节,而不是粘贴长上下文。
- 引用所有者的原话(如有需要则翻译),以便代理看到真正的要求。
- 如果所有者不在,请说明:“所有者无法回答。请自行决定并记录每个决策。”
- 完成标准必须可以通过脚本、测试或测量来检查。使用数字和范围。
- 代理无法像人一样看或听。让它进行测量(屏幕截图、帧数、响度、峰值),在报告中说明哪些内容无人查看或监听,并将品味判断留给所有者。
- 每份简报都有一个时间预算、一个测试预算和一个终止规则:“时间用完后,停止,写下剩余内容,然后返回。”长时间任务还需要一个检查点(“到 2 小时时,如果 X 尚未开始,则回退到 Y”)。
- 切勿在没有限制的情况下编写“重新运行所有早期测试”或“保持一切正常”。测试新部分在其所在位置;仅当您更改了早期测试覆盖的内容时才重新运行它。
- 列出优先级(万一时间用完的情况),最重要的优先,并说明其余部分将如何处理。
- 交付物保留其所替换内容的名称、格式和长度,以便下一步可以将其直接替换进来。
- 进度文件为每个完成的部件添加一行带时间戳的记录,以便工作能够在中断后继续。
- 硬性规则说明原因(“切勿保存 X:保存会擦除其参考”)。
- 将早期失败作为规则向前传递(“早期剪辑播放为黑色:使用 Main profile 和 yuv420p”)。
- 对冒险的子任务进行时间盒限制:“最多花费 15 分钟,然后回退到 Y。”
- 并行代理获得范围限定:“步骤 3 不是您的工作:不要接触 A 或 B。”
- 要求固定的返回格式:已完成的工作、跳过的工作及原因、测量数据、测试时间、所花时间、剩余工作的估计、文件位置。
看门狗
在每个长时间运行的代理旁边,启动一个后台命令,等待时间预算后打印一行:
sleep 5400; echo "BUDGET exceeded: stage 3 (90 min)"
在后台运行它(Claude Code 会在其完成时通知您)。当它触发时:读取代理的进度文件,然后要么告诉代理结束并返回,要么停止它,要么延长一次预算并告知用户。如果代理提前返回,则停止看门狗。