Community生产力与协作github.com

promptbyprompt/agent-briefs

在委派任务前撰写一页简报。每当您启动子代理(Agent 工具)、工作流、后台作业或任何需要另一个 Claude 执行的长步骤任务时,以及分阶段规划大型构建时,使用此技能。简报为代理提供优先阅读的文件、目标、所有者原话、可衡量的完成标准、机器规则与硬性规则、时间预算、测试预算、终止规则、优先级、可互换交付物、进度文件以及固定返回格式。还涵盖阶段规划、无写权限的评审者、定向测试策略以及在质量工作前对照参考标准进行测量。

agent-briefs 是什么?

Agent Briefs 是一个用于结构化子代理任务委派的技能,适用于 Claude Code、Cursor、Codex 等平台。它的核心思想是:在启动任何子代理、工作流或长时间任务之前,使用该技能提供的 `templates/brief.md` 模板撰写一份一页简报,从而为子代理提供完整的上下文和约束。该技能通过标准化的模板和规则,确保子代理理解目标、遵循可测量的完成标准、遵守时间和测试预算,并在预算耗尽时有序停止并返回结果。它还支持通过规划代理将大任务分解为多个阶段,每个阶段拥有独立的简报;通过参考模板进行质量工作前的校准;通过评审模板让多位无写权限的评审者并行审查输出;以及通过看门狗机制监控长时间运行的任务,确保它们在时间预算内及时返回。最终,Agent Briefs 强制要求固定的返回格式,包括已完成和跳过的内容、测量数据、所用时间、剩余工作估计和文件位置,从而提升任务委派的可靠性和结果的可复现性。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/promptbyprompt/claude-brief-kit/tree/HEAD/agent-briefs

Installed? Explore more 生产力与协作 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

代理简报

子代理从空白记忆开始。它只知道您写下的内容。在启动任何子代理、工作流或长时间任务之前,请使用此技能文件夹中的 templates/brief.md 撰写一份简报。

步骤

  1. 大型任务包含多个部分:首先使用 templates/planner.md 运行一个规划代理。它返回 5 到 8 个阶段,每个阶段都有一个可测量的 done_when。然后每个阶段获得自己的简报。
  2. 质量工作(音乐、声音、视觉、写作风格):首先遵循 templates/reference.md。收集 2 到 3 个参考,测量它们,写出差距,制作一个原型,在继续进行其余工作之前让所有者评估它。
  3. 使用 templates/brief.md 的每个标题撰写简报。在不适用的标题下写上“无”。将 templates/test-policy.md 粘贴到每个涉及构建或更改内容的简报中。
  4. 在构建步骤之后,使用来自 templates/critic.md 的 2 或 3 位评审者,在同一次录制的材料上并行进行评审。将合并后的 must_fix 列表交给一个修复代理。
  5. 在每一个运行超过约 15 分钟的代理旁边启动一个看门狗(见下文)。
  6. 告诉用户您启动了什么、预算以及一个诚实的估计。说出什么是不确定的。

每份简报的规则

  • 首先阅读:指向文件和章节,而不是粘贴长上下文。
  • 引用所有者的原话(如有需要则翻译),以便代理看到真正的要求。
  • 如果所有者不在,请说明:“所有者无法回答。请自行决定并记录每个决策。”
  • 完成标准必须可以通过脚本、测试或测量来检查。使用数字和范围。
  • 代理无法像人一样看或听。让它进行测量(屏幕截图、帧数、响度、峰值),在报告中说明哪些内容无人查看或监听,并将品味判断留给所有者。
  • 每份简报都有一个时间预算、一个测试预算和一个终止规则:“时间用完后,停止,写下剩余内容,然后返回。”长时间任务还需要一个检查点(“到 2 小时时,如果 X 尚未开始,则回退到 Y”)。
  • 切勿在没有限制的情况下编写“重新运行所有早期测试”或“保持一切正常”。测试新部分在其所在位置;仅当您更改了早期测试覆盖的内容时才重新运行它。
  • 列出优先级(万一时间用完的情况),最重要的优先,并说明其余部分将如何处理。
  • 交付物保留其所替换内容的名称、格式和长度,以便下一步可以将其直接替换进来。
  • 进度文件为每个完成的部件添加一行带时间戳的记录,以便工作能够在中断后继续。
  • 硬性规则说明原因(“切勿保存 X:保存会擦除其参考”)。
  • 将早期失败作为规则向前传递(“早期剪辑播放为黑色:使用 Main profile 和 yuv420p”)。
  • 对冒险的子任务进行时间盒限制:“最多花费 15 分钟,然后回退到 Y。”
  • 并行代理获得范围限定:“步骤 3 不是您的工作:不要接触 A 或 B。”
  • 要求固定的返回格式:已完成的工作、跳过的工作及原因、测量数据、测试时间、所花时间、剩余工作的估计、文件位置。

看门狗

在每个长时间运行的代理旁边,启动一个后台命令,等待时间预算后打印一行:

sleep 5400; echo "BUDGET exceeded: stage 3 (90 min)"

在后台运行它(Claude Code 会在其完成时通知您)。当它触发时:读取代理的进度文件,然后要么告诉代理结束并返回,要么停止它,要么延长一次预算并告知用户。如果代理提前返回,则停止看门狗。

相关技能