Brief

用户配置和学习到的偏好保存在 ~/Clawic/data/brief/ 目录中（首次使用请参考 setup.md，preferences-template.md 提供了学习偏好文件格式）。若旧位置存在数据（如 ~/brief/ 或 ~/clawic/brief/），请将其移至 ~/Clawic/data/brief/。

何时使用

• 用户要求对提供的材料进行执行摘要、TL;DR 或核心结论总结
• 定期状态或项目更新到期，读者需要的是变化量而非重复陈述
• 会议、董事会或评审即将召开，读者需要明确的待决事项及准备清单
• 事件正在发生，利益相关者需要了解影响范围、当前状态和下次更新时间承诺
• 交接、离职或休假覆盖需要包含潜在风险与未决问题的移交说明
• 读者需在多个选项中做选择，需附带权衡分析的推荐意见
• 长篇报告、讨论串、录音稿或文档堆需浓缩为驱动决策的关键信息

不适用场景：当内容无明确决策目标时的单纯压缩 —— 请改用 summarizer 技能处理仅需缩短内容的场景。

快速参考

深度扩展指南：

• templates.md：按类型分节的结构模板
• sources.md：原始材料筛选、冲突与缺口处理
• audiences.md：受众校准
• delivery.md：交付渠道、登记方式与时机
• writing.md：逐行压缩技巧
• recurring.md：持续简报系列管理
• dimensions.md：偏好分类体系
• setup.md：首次使用设置流程

核心规则

1. 用户指定信息来源

当用户请求生成简报时：

1. 用户提供信息，或明确指定获取路径
2. 若某来源需权限，用户必须主动授权
3. 技能负责结构化与格式化输出

示例：

用户： “请简要汇报项目 X 的进展”
代理： “我需要访问项目文档。能否分享状态文档，或授予项目文件夹的访问权限？”
用户： [共享文档或授予权限]
→ 基于用户提供来源生成简报

2. 简报 ≠ 总结

总结是压缩内容；简报是服务于读者下一步行动。若无法说出该简报将促成什么决策或行动，请先问：“你打算用这个做什么？” 有能力的人会总结，而真正懂得简报的人会做出选择。

3. 逆向写作顺序

写作顺序应为：提出请求 → 结论 → 关键点 → 背景；读者阅读顺序相反。从前往后写会导致核心观点被埋没：你最后才意识到重点，也把它留在了最后。

4. 结论必须明确

一句话，不含模糊词。若句中出现“且”，说明有两个结论——保留改变行为的那个，另一个降为关键点。“大部分进展顺利，但……”不是结论，而是拒绝做决策的表现。

5. 三点关键点，最多五条

每一点必须满足：若删除它，读者的决策将发生变化。六条“关键点”意味着尚未确定何为重要——应删减，或在“更多细节”下归类。此选择标准优于原始材料长度：一条决策相关页面胜过四十页背景资料。

6. 每个数字都需有参照物

"$120万收入"只是装饰；"$120万，低于计划8%"才是有效信息。有效参照包括：目标值、前期数据、基准线。若无可比项，应写“尚无基准”或直接省略数字。

7. 状态词汇需明确定义

• 正常推进 —— 时间/范围缓冲区完好
• 存在风险 —— 缓冲区正在被消耗；首次延误即计入，无宽限期
• 已阻塞 —— 无法继续，除非外部特定动作完成

尽早宣布“存在风险”成本极低。毫无预警的绿转红会严重损害未来所有简报的信任度。（配置中 status_scheme: rag 可将上述状态映射为 Green/Amber/Red）

8. 仅根据显式反馈学习

“太详细” / “缺少 X” / “完美” → 在 ~/Clawic/data/brief/preferences.md 中记录一行，标明级别（pattern / confirmed / locked，晋升规则见 dimensions.md）。每次撰写前检查该文件——即使结构精良，若格式不符合学习偏好，仍可能出错。

作用范围

本技能：

• ✅ 将用户提供的信息结构化为简报（扮演写作者角色：起草内容，由用户发送）
• ✅ 根据用户反馈学习格式偏好
• ✅ 将配置与偏好存储在 ~/Clawic/data/brief/

用户主导模型：用户决定包含哪些信息并授权访问所需来源；技能负责结构与格式。

本技能不：

• ❌ 在用户未请求时访问文件、邮件或日历
• ❌ 从用户未指定的来源拉取数据
• ❌ 存储简报内容（仅保存配置与格式偏好）

输出审查清单

交付前必须检查以下各项：

• [ ] 结论独立存在时仍能传达核心信息
• [ ] 每个数据指标均有参照物，或明确标注“尚无基准”
• [ ] 请求中明确责任人与截止日期，或注明“无需行动”——绝不能在 FYI 中隐含请求
• [ ] 坏消息位于首屏，紧邻应对措施，不在第四部分
• [ ] 可过期的数据需标注来源与截至日期
• [ ] 冲突来源应展示矛盾，不得合并为单一数值
• [ ] 术语水平匹配最不专业的决策者，而非最专业的读者
• [ ] 格式符合 ~/Clawic/data/brief/config.yaml 和 preferences.md 规定 —— 检查而非记忆

配置项

用户自定义变量。默认值在用户声明偏好前生效；保存于 ~/Clawic/data/brief/config.yaml。

偏好维度 —— 可自定义区域；用户声明的偏好将存入 config.yaml 并应用：

• 受众构成：最常阅读简报的人群（上级、董事会、客户、团队）—— 影响默认模板与术语层级（audiences.md）
• 风格惯例：章节名称、项目符号样式、状态词扩展 —— 改变 templates.md 中的结构
• 时间安排：提前量、频率、交付日 —— 影响 delivery.md 中的时间建议
• 排除项：永不包含的主题或指标（保密、法律）—— 在 sources.md 中用于过滤提取
• 语气风格：坏消息的直接程度、主语（我/我们/团队）、正式程度底线 —— 影响 writing.md 中的语气规则
• 本地化设置：超出 locale 的设定 —— 包括时区（时间戳与截止时间）、多币种策略（显示原币种还是换算后，使用哪个符号）—— 影响 writing.md 中的数字行与 templates.md 中的事件/董事会时间戳

配置与学习偏好区别：config.yaml 存储用户声明的偏好；preferences.md 记录反馈揭示的偏好（见 dimensions.md 中的级别）。用户声明的偏好若涉及配置变量，将直接写入 config.yaml。优先级：配置 > 已确认/锁定的学习偏好 > 默认值。通用变量（locale、时区）还额外回退至 ~/Clawic/profile.yaml：配置 > profile.yaml > 默认值。

常见陷阱

专家分歧点

• 项目符号 vs 叙述式备忘录：亚马逊六页学派认为散文强制完整思考；BLUF 学派认为读者会快速筛选，项目符号更尊重这一习惯。边界判断：匹配阅读习惯——静默阅读前讨论时用叙述；替代会议时用项目符号。此处默认：项目符号，templates.md 中提供叙述式变体。
• 推荐优先 vs 中立陈述：传统做法区分信息简报与决策简报，警告避免倾向性；运营者则认为不愿推荐的简报将分析工作转嫁给读者。边界：默认推荐；仅在调停平级群体时转为中立，并明确说明。
• 上下文多少：“上下文是对读者的尊重” vs “上下文是核心观点的坟墓”。边界：只有当上下文影响读者行动时才保留；用 SCQA 测试（templates.md），否则直接删除。

相关技能

更多 Clawic 技能，请访问 https://clawic.com/skills/brief（用户确认后安装）：

• summarizer - 无决策需求时的内容压缩，仅需更短内容
• digest - 定期从外部来源提取并整理的更新
• report - 固定数据源的周期性配置报告
• meetings - 完整会议系统（笔记、议程、跟进）；本技能仅覆盖会前阅读材料

反馈

• 若有用，欢迎点赞：https://clawic.com/skills/brief
• 最新版本：https://clawic.com/skills/brief

[Clawic](https://clawic.com) 的一部分，可信技能库。获取本技能：https://clawic.com/skills/brief