mcpField
B
briefing

briefing

github.com/sjunepark开发150 次安装3 周前更新
代码仓库

关于 briefing

briefing 是帮助 Agent 快速恢复当前任务背景并提供决策信息的技能,面向需要简短进度说明或代码定向梳理的场景。它按任务重点查阅最少量的相关来源,并避免复述整段对话或整个代码库。

主要功能

  1. 01识别状态、计划、教学或决策重点
  2. 02按顺序查阅相关对话与文件
  3. 03限定上下文收集范围
  4. 04提炼关键文件、事实和约束
  5. 05按简短章节组织简报

适用场景

  1. 01接手任务时快速了解当前进度
  2. 02确定下一步方案和相关文件
  3. 03理解任务涉及的代码边界与流程

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/sjunepark/agent-scripts --skill briefing

安装后在 Claude Code 中输入/briefing确认已加载。

附带文件agents/openai.yaml

详细介绍

简报

向用户简要呈现当前任务中有助于决策的情况。恢复与任务相关的工作上下文,不要把整段对话或整个代码库都复述一遍。

来源

按以下顺序阅读来源,并在你准备简报的每一点都有依据后停止;其他内容标记为推断:

  • 当前对话
  • 代码库中最少量的相关文件
  • 相关本地文档,例如 AGENTS.md、ARCHITECTURE.md 或附近的模块文档(仅当它们会影响对任务的理解时)

如果文件路径能明显帮助用户重新了解代码,请注明。

重点

根据用户的明确要求判断重点;默认为 status;如果重点混合,则结合所需重点,不要把回复写成选项菜单。

  • status — 用户要求了解进展或当前状态:聚焦当前实现状态。
  • plan — 用户询问接下来可能采取的步骤:聚焦可能的方案和涉及的区域。
  • teach — 用户想了解相关代码:聚焦各部分的职责、边界和流程。
  • decision — 用户需要做出决策:聚焦约束、权衡和影响重大的未知事项。

非目标

不要使用此技能来生成:

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

工作流程

  1. 确定所需重点(见“重点”)。

  2. 明确任务边界。

  • 具体说明当前请求。
  • 必要时区分当前任务与之前的旁支讨论。
  1. 收集必要的上下文。
  • 从当前对话开始。
  • 只阅读能够说明当前状态的最少量文件和文档。
  • 优先查看入口点、已修改文件、相邻接口和稳定文档,避免广泛探索。
  1. 综合信息,便于快速了解。
  • 将原始发现归纳为用户当前需要了解的少数事实。
  • 直接指出相关文件和模块。
  • 说明它们与当前任务的关系。
  1. 大幅精简。
  • 删除重复内容。
  • 删除代码细节和价值较低的历史信息。
  • 删除推测性陈述,除非明确标注为推断。
  • 除非当前任务确实涉及未决问题,否则不要提出开放性问题。

输出

默认总计 8–14 条要点,或篇幅相当的简短章节。

除非用户另有要求,否则采用以下结构:

当前任务
  • 用 1–3 条要点说明正在处理的内容。
相关代码
  • 列出关键文件或模块,并简要说明其重要性。
当前重要事项
  • 说明与当前任务相关的实现事实、行为或约束。
决策背景
  • 仅列出用户做出下一步决策所需的信息。
  • 只有在有帮助时,才简要说明下一步。

评论

支持 Markdown