SuperAPI AI 工具集

briefing

办公与效率

查看项目

更新于 10-16 02:03

技能介绍

Briefing 是一个面向任务上下文的简要汇报技能,目标是给用户一个简短、可直接用于决策的当前任务视图,恢复其任务范围内的工作上下文,而不是把整个对话或代码库重新倾倒给用户。

用途

当用户明确要求一份简报或了解当前进展时使用。它帮助用户在不重新加载代码库的情况下,快速掌握当前任务的状态、相关代码和关键约束,从而决定下一步。

信息来源

按以下顺序读取来源,一旦你要汇报的每个点都能对应到已读内容就停止;其他内容需标注为推断:

  1. 当前对话
  2. 代码库中最小的一组相关文件
  3. 相关本地文档,例如 AGENTS.md、ARCHITECTURE.md 或邻近模块文档,前提是它们会改变对任务的理解方式

当文件路径能实质性地帮助用户重新连接到代码时,使用文件路径。

侧重点

根据用户的明确请求推断侧重点;默认是状态;如果混合,则组合所需的侧重点,而不是把回复变成菜单。

  • status(状态)——被要求了解进展或当前状态:以当前实现状态为中心。
  • plan(计划)——被问及接下来可能做什么:以可能的方法和涉及区域为中心。
  • teach(讲解)——被要求理解相关代码:以角色、边界和流程为中心。
  • decision(决策)——被问及做决策需要关注什么:以约束、权衡和高影响未知项为中心。

非目标

不要使用此技能生成:

  • 仓库的完整架构总结
  • 计划评审、代码评审或设计评审
  • 项目路线图重建,除非当前任务依赖它
  • 整个对话的冗长回顾
  • 逐行实现细节讲解,除非用户明确要求

工作流程

  1. 确定请求的侧重点(见“侧重点”)。
  2. 恢复任务边界。
    • 用具体措辞陈述当前请求。
    • 如有需要,将当前任务与早先的旁支讨论区分开。
  3. 只收集相关上下文。
    • 从当前对话开始。
    • 读取能解释当前状态的最小文件集和文档。
    • 优先选择入口点、已触及文件、邻近接口和稳定文档,而不是广泛探索。
  4. 综合以便快速定位。
    • 将原始发现压缩为用户现在需要的少数事实。
    • 直接点名相关文件和模块。
    • 解释每个文件和模块对当前任务为何重要。
  5. 积极裁剪。
    • 删除重复点。
    • 删除代码琐事和低信号历史。
    • 删除推测性陈述,除非它们被明确标注。
    • 除非当前任务确实以开放问题为中心,否则不要创建开放问题。

输出

默认总共 8-14 条要点,或等量的简短小节。除非用户另有要求,使用以下结构:

  • 当前任务:一到三条要点,说明正在处理什么。
  • 相关代码:关键文件或模块,并简短说明每个为何重要。
  • 当前重点:此任务最重要的实现事实、行为或约束。
  • 决策背景:用户做出下一步决策所需的事实。
  • 仅在有助于时,加入一条轻量的下一步说明。

适用场景

适用于用户要求了解当前任务进展、需要快速恢复任务上下文、准备做下一步决策,或希望理解相关代码角色与流程的场景。

限制

该技能不用于完整架构总结、各类评审、路线图重建、冗长对话回顾或逐行实现细节讲解,除非用户明确要求。其他具体限制、收费、价格、平台或效果信息暂未提供。