用途
brief 的核心主张是:表达意图的人只需写一句短话,由智能体负责结构化。专家给出的启动语往往很短,让委派真正奏效的是由这句话编译出的简报——它说明完成是什么样、执行者如何知道自己在推进、什么不能碰、有多少时间、谁来接收结果、无人值守时该怎么做。该技能把简报编译到 templates/brief.md,并通过探索仓库来填写字段,而不是向人提问。
适用场景
- 把工作交给任何将在无人监视下运行的对象:子会话、后台智能体、处理 issue 的编码智能体、定时运行或自动化提示。
- 把同一意图分发到 N 个会话、切片、模型或假设。
- 任何超过一句话、且将运行约 30 分钟以上的启动任务。
不适用于你会盯着看的快速交互式编辑,或该工作已有简报的情况;此时应修订现有简报,而非另写一份。
主要能力与编译步骤
- 逐字引用需求:在 ## Ask (verbatim) 下保留错别字和大小写,绝不改写唯一副本;简报经过多个智能体时,引用可防止意图漂移。
- 先探索再提问:读代码、issue、PR、CI 与现有工具,把代码当前实际支持的能力写成基线行;能从仓库填的字段全部填上,提问预算默认为 0,真正需要人时只问一个覆盖全部的问题。
- 结果与所有者:用一行写结果,并指明关心该结果的个人或团队;每个结果一个所有者,所有权分裂就写两份简报。
- 可观测的完成标准:写成他人可运行的检查(测试通过、最终提交 CI 绿、指标跨阈值、截图或视频显示特定状态),并注明算作完成的证据级别;合并不等于已部署或已度量,“它能工作”不算完成标准。
- 反馈回路:迭代型工作运行 find-the-loop 并链接或概括其 Loop Card;没有基线时,执行者第一步就是测一个基线。
- 约束与邻居:列出范围外路径、只读区域、真实安全限制与非目标;每条约束都要有来源与过期时间,无来源的约束删除。列出其他触及相同文件的通道、PR、会话或人员,便于协调而非冲突。
- 预算:记录路由器解析出的花费层级、哪些步骤用高级模型,设定时限、最大迭代或尝试次数、最大 PR 规模、API 与算力上限;轮询时使用 .github/lever.yml budgets: 中的最小间隔与 API 预算;并设定 80% 预算时的停止动作(汇报后完成或挂起)。
- 自主级别:用 autonomy-dial 解析并记录级别、上限及来源;若提示未说明谁落地工作,按 docs/autonomy.md 问一次启动问题,若需求已作答则跳过。
- 缺勤窗口与阻塞策略:说明人何时不在(如“09:00 PT 前无人”),并选择 decide-and-log(自行决定并记录假设)、park-and-next(搁置此项做下一项)、ask-parent(升级给协调智能体而非人)。仅人类能回答的问题在下一次报告中一次性附建议答案呈现;交付优先于计划。
- 停止条件:写全三类——成功(完成标准在所需证据级别通过)、放弃或重规划(预算耗尽,或卡住阈值默认 2 小时无实质进展,则写更简单计划、请第二模型批评后择一)、升级(只有人能做的那个决定)。
- 汇报契约:指明汇报接收者、频率与格式,遵循 progress-contract 与 templates/status-digest.md;默认无变化则静默。
- 扇出(1 of N):多个执行者时写 N 份同级简报,共享同一 Ask、规则、预算与汇报契约,每份加一行“You are 1 of N. Your slice: <区域|模型|假设>”及同级列表;切片写入文件不得重叠,比较各分支时使用同一 Loop Card。
- 归档:简报存于目标仓库的 GitHub issue,标题用结果命名,正文为简报加空的 ## Status 段与 <!-- lever: … --> 标记,指派给结果所有者并打 lever 标签;多条通道时每条一个子 issue 并用 gh api 命令链接到父 issue;先搜索 label:lever,同一结果已有简报则修订。无 triage 权限或他人仓库未获许可时,将简报留在会话中并说明。
- 选择运行器:读取 ~/.copilot/lever.yml 的 brief.runner,否则在 here(本会话协调)、cloud(各通道子 issue 指派给 Copilot)、later(已归档暂不运行)中选一,并按对应方式保持运行或打印后续命令。交互模式归档前展示一次简报,自动驾驶模式直接归档。
可调参数(节选)
问题预算(默认 0)、简报长度(完整模板或精简版)、自主级别 L0–L5、阻塞策略、缺勤窗口、卡住阈值(默认 2 小时,可选 30 分钟–8 小时)、预算停止点(默认 80%,可选 50–100%)、扇出数量、汇报目标与频率、是否归档为 issue、运行器。
输出
一个带 lever 标签并指派给所有者的 issue,正文为填好的 templates/brief.md,每条通道一个子 issue;同级简报共享一个 Ask,各带自己的“1 of N”行。并向用户返回一行摘要:编号、通道数、结果、完成标准、自主级别与运行器。
限制与说明
资料未提供该技能的收费、价格、具体平台兼容范围或安装命令;使用依赖相关仓库配置(.github/lever.yml、~/.copilot/lever.yml)与文档(docs/autonomy.md、docs/tracking.md 等)。主要防止的失败模式包括:多级转述导致的意图漂移、把“我停下了”当作完成、执行者盘问本可探索回答的问题、与邻近工作冲突、无人值守时因首个问题停摆、无界轮询与 API 消耗。