用途
loop-briefing 是一个上下文触发(contextually-invoked)的简报技能,服务于自主运行的 Claude Code /loop 会话。它的核心作用是在两种特定情形下通过 Pushover 通知用户,避免自主循环在无人知晓的情况下卡住或空转。
主要能力
该技能建立在 TS 核心 pushover_core.ts 的 loop-brief 之上,流程为:
- 收集上下文:项目、当前工作目录(cwd)、分支、git 状态、近期提交,以及调用时传入的任何细节。
- 渲染:通过 Satori 生成 PNG 图像。
- 发送:根据情形选择通知级别。
通知级别分为两类:
- BLOCKED:需要立即决策,使用 emergency 级别并带回执(receipt),会持续告警直到用户确认(ack)。
- DONE:无剩余有意义工作,使用 high-priority 级别,不触发告警。
使用方式
BLOCKED 情形(需要决策,emergency + 回执):
env -u HTTPS_PROXY -u HTTP_PROXY bun "$(cc-plugin-root pushover-commander)/skills/_lib/pushover_core.ts" loop-brief \
--kind blocked --reason "must choose auth method" --body /tmp/decision_options.txt
DONE 情形(无剩余有意义工作,high priority,无告警):
env -u HTTPS_PROXY -u HTTP_PROXY bun "$(cc-plugin-root pushover-commander)/skills/_lib/pushover_core.ts" loop-brief \
--kind done --reason "all tasks complete, matrix exhausted"
--body - 形式可从 stdin 读取细节内容。
触发时机(两情形规则)
- Blocked:循环无法在没有人工介入的情况下安全继续——需要决策、澄清、审查,或在多个选项之间做选择。建议在会话中配合一次 AskUserQuestion 调用,以便用平实语言呈现选项及其权衡。
- Done:在初始或更新后的指令下已无有意义剩余工作;循环应停止安排后续唤醒(CronDelete)。
不要为常规进度触发该技能。
适用场景
适用于自主运行的 Claude Code /loop 会话,尤其是需要人工决策才能继续、或已彻底完成任务的时刻。
限制与注意事项
- 仅用于上述两种情形,常规进度不应触发。
- 该技能被描述为自进化:若指令有误、参数漂移或需要变通方案,应立即修正文件,不要推迟;但仅针对真实、可复现的问题更新,不做推测性修改。
- 执行后需自检:简报是否在正确时机、携带正确的 git 与会话上下文触发;emergency 与 high-priority 的路由是否正确(Blocked = emergency+receipt,Done = high-priority),若颠倒需修正。
- 关于收费、价格、支持平台等更多信息,资料中暂未提供。