brief — review & clear the day's work(回顾并清空当天工作)
用途
brief 是一个个人工作简报技能,用于每天早晨把需要在 Jira、Slack、GitHub 和当日日历中处理的事项集中呈现,并引导用户逐条完成。整个流程分两个阶段:PREP 在后台定时运行并暂存一份简报;REVIEW(/brief)是用户坐下后实际运行的交互式流程,绝大多数情况下用户使用的是 REVIEW。
主要能力
PREP(定时流程,通常无需手动运行)
- scripts/prep.sh 收集 Jira 与 Slack(经由 mywork/slackdump)以及 GitHub(经由 gh)的信息。
- 随后由无头模式 claude -p 在 ~/loop-me/state/brief-<date>.md 组合出暂存的简报(指令文件为 scripts/prep-prompt.md)。
- 通过 scripts/install-schedule.sh 一次性安装定时任务。
- 日历被有意留给 REVIEW 阶段处理(见下)。
REVIEW — /brief
- 加载
读取当天暂存的简报 ~/loop-me/state/brief-$(date +%F).md。若缺失(例如 07:30 时 Mac 关机,或首次使用),立即运行 scripts/prep.sh,再加载它。
- 打开时刷新——暂存简报只是“热缓存”,并非事实本身
在展示任何内容前,先把每个条目更新到最新(不要信任 07:30 的快照):
- 重新检查每个条目的实时状态:Slack 线程已被答复(被 Felix 或他人)→ 剔除;Jira 问题已关闭 / PR 已合并 → 剔除;内容发生实质性变化 → 重新起草。
- 最省事的办法:重新运行 scripts/gather.sh ~/loop-me/state/comms 1 并做差异对比,或抽查特定线程/问题。
- 通过 Google Calendar MCP(list_events, today)获取当天日历并计算空闲时间——这正是日历不放在 PREP 的原因(MCP 只在这里、以交互方式存在)。
- 丢弃任何 id 出现在 ~/loop-me/state/handled.json 中的条目。
- 展示头部信息,然后逐条遍历排名列表
展示头部:日期 · 会议负载(如“3 个会议,约 4 小时空闲”)· 计数(如“6 条回复,2 个评审,1 个待办——3 个阻塞”)。随后自上而下逐条展示,一次一条。对每个条目展示卡片:排名 · 类型 · 若被标记则显示 needs-your-judgment · 谁/何处 · why-now · 草稿(针对回复类条目)· 来源链接。等待 Felix 的指令:
| Felix 说 | 你做什么 |
|---|---|
| send | 把草稿写入临时文件,然后运行 scripts/send.sh <jira KEY | gh URL | slack PERMALINK> … |
| edit(“更温和些”“删掉最后一行”……) | 修改草稿,展示,然后在他确认后发送 |
| skip | 保留;它会顺延到明天的简报(标记为 carried · day N) |
| done / ignore / open | 把其 id 追加到 ~/loop-me/state/handled.json(此后被抑制);对 open 还要打印链接 |
| next / stop | 继续下一条 / 结束遍历 |
send.sh 会自动评论 Jira(acli)和 GitHub(gh);对 Slack 则把回复复制到剪贴板并打印线程链接(自行粘贴并发送)。绝不要发送未在第 2 步刷新过的条目。
- 收尾
更新 ~/loop-me/state/last-brief.json {"ts":"<ISO now>"}。打印一行摘要: "已发送 5 条(3 条 Jira,2 条 GH),2 条 Slack 已复制,1 条跳过(顺延),2 条忽略。"
状态(~/loop-me/state/)
- brief-<date>.md:暂存简报 + 审计轨迹
- last-brief.json:窗口游标
- handled.json:已忽略 id;超过 14 天的条目可被清理
- comms/:原始收集数据
- 可选 ~/loop-me/config/vips.txt:VIP 句柄/邮箱/用户名——用于排名提升,可以不存在
防护规则(Guardrails)
- Jira/GitHub 的发送是真实且立即执行的。每次发送前都要刷新(第 2 步)。
- Slack 目前没有自动发送凭据(采用剪贴板交接)。如果以后在 mytokens 中存入了 Slack chat:write token,可在 scripts/send.sh 中加入真正的发送分支,此项即变为真实自动发送——无需其他改动。
- SKILL_DIR = 本技能的目录(~/.claude/skills/brief)。需要凭据 → 使用 mytokens。
适用场景
适合个人在早晨集中处理来自 Jira、Slack、GitHub 以及当日日历的多来源待办事项,逐条决定发送、修改、跳过或忽略,并保留处理状态与顺延机制。
限制
- 日历仅能在交互式 REVIEW 阶段获取(依赖 Google Calendar MCP)。
- Slack 目前无法自动发送,只能复制到剪贴板由用户自行粘贴发送。
- 若 07:30 时设备未开机或首次使用,暂存简报可能缺失,需要临时运行 PREP。
- 其他未在资料中提及的功能、收费、价格或平台支持情况暂未提供。