briefing-cardlisted
Install: claude install-skill vincent-wen789/claude-briefing-cards
# briefing-card 汇报卡
> 🔴 **状态(2026-06-14 起)· 冻结开发,进入真实使用检验**
> 功能完整(三类卡 + T0–T3 路由 + 自动/手动触发 + 安全层)· 5 轮独立 review 过 · darwin 86.8。**唯一缺口是真实使用 = 0**,所有「好用 / 触发准 / 体验顺」的结论都来自 subagent 模拟。
> **除非 Vincent 撞到真实场景的具体问题(该画没画 / 卡点着别扭 / 触发漏了),否则不要再加功能、不要再 review**——边际收益已递减,复杂度利息在涨(110 行 + CLAUDE.md 两段,今天连改文件都出过「报 success 没落地」的乌龙)。下一个改动应由真实使用反馈驱动,不由「还能更完善」驱动。
## ⚠️ 装到别的机器(触发引擎不在本文件)
本 skill 的**自动触发靠 CLAUDE.md 里 `## 汇报卡 briefing-card(自动触发)` 那段**,不在 SKILL.md。只 copy 本文件夹 → 只剩手动触发(`出个卡` / 回传),自动出卡失灵(Vincent 2026-07-06 实测撞到)。装机:① copy 文件夹到目标机 `~/.claude/skills/` ② 把 `claude-md-block.md` 里 `8<` 之间的段落粘进目标机 CLAUDE.md。
## Overview
用聊天内渲染的 HTML 卡片替代纯文字,做决策请求和进度汇报。两个核心价值:**模板强制完整**(固��区块逼着填全信息)+ **决策按钮闭环**(点按钮 = 回传决策,消灭误解)。颗粒度路由是灵魂——画错时机比不画更糟。
## T0–T3 路由(先过这道闸再动手)
| 档 | 形式 | 条件 |
|----|------|------|
| T0 | 普通文字 | 一句话能说清 / 单一事实 / 闲聊。**绝不画卡** |
| T1 | AskUserQuestion | 2-4 个选项,每项利弊一行讲得清,不需要图/链接 |
| T2 | 聊天内卡片(本 skill 主体) | 决策需多维对比/证据链接/内联数据图形;进度 ≥3 条线或含 blocker;pending 确认 ≥3 项且每项带出处(≤2 项走文字或 AskUserQuestion) |
| T3 | HTML 文件 | 要存档 / 发给别人 / 要看内容图 / 超约两屏 → 转 huashu-design |
**默认翻转(2026-06-18 · Vincent 第一条真实使用反馈:手动召唤太累、触发太怂)**:一旦判定本轮属于**汇报 / 进度 / 决策 / 选项 / 确认 / 拍板**场景,**默认假设落 T2 出卡**——举证责任反过来:不再问「够不够得上 T2」,而是问「能不能安全降到 T0/T1」。只有①一句话能说清 / 单一事实 / 闲聊 → 降 T0;②2-4 个选项且每项利弊压得进一行、不需图/链接 → 降 T1。两条都不满足就出卡,别再犹豫。**翻转的是判定倾向,不是取消节流**:防卡墙节流(硬规则那条,1 小时 ≥2 张卡自动降文字)仍然全程生效,被卡片刷屏的风险由它兜底——所以放心偏向出卡。
从 T0 往上判断,停在第一个满足的档。T1 vs T2 拿不准:把每个选项压成一行(利弊 + 改动量 + 介入点)——全部压得进且不需要链接/图 → T1;任何一个选项压不进一行,或需要链接/图/对比表 → T2。注意:改动量