Briefing 是一个面向任务上下文的简要汇报技能,目标是给用户一个简短、可直接用于决策的当前任务视图,恢复其任务范围内的工作上下文,而不是把整个对话或代码库重新倾倒给用户。
用途
当用户明确要求一份简报或了解当前进展时使用。它帮助用户在不重新加载代码库的情况下,快速掌握当前任务的状态、相关代码和关键约束,从而决定下一步。
信息来源
按以下顺序读取来源,一旦你要汇报的每个点都能对应到已读内容就停止;其他内容需标注为推断:
- 当前对话
- 代码库中最小的一组相关文件
- 相关本地文档,例如 AGENTS.md、ARCHITECTURE.md 或邻近模块文档,前提是它们会改变对任务的理解方式
当文件路径能实质性地帮助用户重新连接到代码时,使用文件路径。
侧重点
根据用户的明确请求推断侧重点;默认是状态;如果混合,则组合所需的侧重点,而不是把回复变成菜单。
- status(状态)——被要求了解进展或当前状态:以当前实现状态为中心。
- plan(计划)——被问及接下来可能做什么:以可能的方法和涉及区域为中心。
- teach(讲解)——被要求理解相关代码:以角色、边界和流程为中心。
- decision(决策)——被问及做决策需要关注什么:以约束、权衡和高影响未知项为中心。
非目标
不要使用此技能生成:
- 仓库的完整架构总结
- 计划评审、代码评审或设计评审
- 项目路线图重建,除非当前任务依赖它
- 整个对话的冗长回顾
- 逐行实现细节讲解,除非用户明确要求
工作流程
- 确定请求的侧重点(见“侧重点”)。
- 恢复任务边界。
- 用具体措辞陈述当前请求。
- 如有需要,将当前任务与早先的旁支讨论区分开。
- 只收集相关上下文。
- 从当前对话开始。
- 读取能解释当前状态的最小文件集和文档。
- 优先选择入口点、已触及文件、邻近接口和稳定文档,而不是广泛探索。
- 综合以便快速定位。
- 将原始发现压缩为用户现在需要的少数事实。
- 直接点名相关文件和模块。
- 解释每个文件和模块对当前任务为何重要。
- 积极裁剪。
- 删除重复点。
- 删除代码琐事和低信号历史。
- 删除推测性陈述,除非它们被明确标注。
- 除非当前任务确实以开放问题为中心,否则不要创建开放问题。
输出
默认总共 8-14 条要点,或等量的简短小节。除非用户另有要求,使用以下结构:
- 当前任务:一到三条要点,说明正在处理什么。
- 相关代码:关键文件或模块,并简短说明每个为何重要。
- 当前重点:此任务最重要的实现事实、行为或约束。
- 决策背景:用户做出下一步决策所需的事实。
- 仅在有助于时,加入一条轻量的下一步说明。
适用场景
适用于用户要求了解当前任务进展、需要快速恢复任务上下文、准备做下一步决策,或希望理解相关代码角色与流程的场景。
限制
该技能不用于完整架构总结、各类评审、路线图重建、冗长对话回顾或逐行实现细节讲解,除非用户明确要求。其他具体限制、收费、价格、平台或效果信息暂未提供。