Data Storage
CODEBLOCK0
Create on first use: INLINECODE0
Scope
This skill:
- - ✅ Structures information user provides into briefs
- ✅ Learns format preferences from explicit feedback
- ✅ Stores preferences in ~/brief/preferences.md
User-driven model:
- - User specifies WHAT information to include
- User grants access to any needed sources
- Skill handles STRUCTURE and FORMAT
This skill does NOT:
- - ❌ Access files, email, or calendar without user request
- ❌ Pull data from sources user hasn't specified
- ❌ Store content (only format preferences)
Quick Reference
| Topic | File |
|---|
| Format dimensions | INLINECODE1 |
| Brief templates |
templates.md |
Core Rules
1. User Specifies Sources
When user requests a brief:
- 1. User provides the information OR specifies where to get it
- If source requires access, user grants it explicitly
- Skill structures and formats the output
Example:
CODEBLOCK1
2. Brief Structure
CODEBLOCK2
3. Learn from Explicit Feedback
- - "Too detailed" → shorten future briefs
- "Missing X" → ask about X in future
- "Perfect" → reinforce current format
- Store preferences in ~/brief/preferences.md
4. Preference Storage Format
One line per preference:
CODEBLOCK3
5. Brief Types
| Type | When | Key elements |
|---|
| Executive | Decision needed | BLUF, recommendation, risks |
| Project |
Status update | Progress, blockers, next steps |
| Meeting | Before meeting | Purpose, context, decisions |
| Handoff | Transition | Current state, gotchas, priorities |
数据存储
~/brief/
├── preferences.md # 已习得的格式偏好
└── templates/ # 自定义简报模板
首次使用时创建:mkdir -p ~/brief/templates
适用范围
本技能:
- - ✅ 将用户提供的信息整理为简报
- ✅ 通过明确反馈学习格式偏好
- ✅ 将偏好存储于 ~/brief/preferences.md
用户驱动模式:
- - 用户指定需包含的WHAT信息
- 用户授予所需来源的访问权限
- 技能负责STRUCTURE和FORMAT
本技能不包含:
- - ❌ 未经用户请求访问文件、邮件或日历
- ❌ 从用户未指定的来源提取数据
- ❌ 存储内容(仅存储格式偏好)
快速参考
| 主题 | 文件 |
|---|
| 格式维度 | dimensions.md |
| 简报模板 |
templates.md |
核心规则
1. 用户指定来源
当用户请求简报时:
- 1. 用户提供信息或指定获取位置
- 如需访问来源,用户需明确授权
- 技能负责结构化输出与格式编排
示例:
用户:请简报项目X状态
助手:我需要访问项目文档。您能否分享
状态文档或授予项目文件夹访问权限?
用户:[分享文档或授予权限]
→ 基于用户提供的来源生成简报
2. 简报结构
📋 [简报类型] — [主题]
⚡ 核心结论
[1-2句话:关键要点]
📊 关键要点
• [要点1]
• [要点2]
• [要点3]
🎯 待办事项
[需做出的决策或采取的行动]
3. 从明确反馈中学习
- - 过于详细 → 缩短未来简报
- 缺少X → 未来询问X相关内容
- 完美 → 强化当前格式
- 将偏好存储于 ~/brief/preferences.md
4. 偏好存储格式
每行一个偏好:
- - 偏好要点列表而非段落
- 执行摘要置于开头
- 有指标时包含指标
- 状态简报不超过1页
5. 简报类型
| 类型 | 适用场景 | 关键要素 |
|---|
| 执行简报 | 需做决策 | BLUF、建议、风险 |
| 项目简报 |
状态更新 | 进展、障碍、下一步 |
| 会议简报 | 会前准备 | 目的、背景、决策 |
| 交接简报 | 工作交接 | 当前状态、注意事项、优先级 |