review-brieflisted
Install: claude install-skill uwakeme/wake-skills
# review-brief
一轮修改收尾时,把「为什么改、改了什么、怎么审」沉淀成一份自包含的审查简报,交给另一个没有本对话上下文的 agent 独立复查。
整个 skill 有两条铁律:**审查方读不到你的对话历史**;**你自己也可能是在上下文被压缩之后才总结需求的**。简报里没写的,审查方就不知道;压缩摘要和当下记忆不是原话,会话最早的原始消息才是。需求原话、变更边界、验证方法,宁可多写一句,不能让审查方靠猜。
## 触发场景
| 场景 | 特征 | 需求从哪来 |
| --- | --- | --- |
| A. 刚改完(同会话) | 本对话刚完成一轮修改或修复 | 从对话历史提取,基本不用提问 |
| A'. 长任务(上下文被压缩) | 同一会话,但最初几轮消息已被压缩成摘要 | 回查会话最早的原始消息,摘要只当索引 |
| B. 新会话补生成 | 用户带着某个提交或工作区来找你 | 对话里没有需求,先问用户要 |
判断不出是哪种就直接问一句:"需求是在这个对话里提的,还是之前在别的会话里?"
## Procedure
### Step 1 — 沉淀需求
**场景 A**(从对话历史提取,不要凭印象转述):
**先回查会话最早的原始消息,不要从压缩摘要或当前记忆出发。** 任务一长,上下文就会被压缩:摘要保住的是大意,用户原话、被否掉的方案和验收口径最容易丢。建议顺序:
1. 翻当前会话最早的几轮用户消息(滚到会话开头,或用环境提供的历史检索能力按关键词定位;摘要里若提到"早期消息 ……"就顺着找原文)
2. 从原始消息里摘需求原话、否定项、验收标准;压缩摘要只能当索引,不能当原话引用
3. 早期消息确实无法访问(已被清理、跨会话、子会话)→ 明写"原始消息不可得,以下为压缩摘要 / 转述(⚠)",不要伪装成原话
- **原始需求**:用户原话逐字引用(blockquote),标上消息大致位置 / 时间,方便审查方核对。分多次说的按时间合并;中途改过主意的保留演变("最初要 X,后确认为 Y"——审查方需要知道代码为什么长这样)。报错日志、截图说明、复现数据也原样贴,不要转述
- **问题背景(bug / 排查类必填)**:现象、复现步骤、期望行为 vs 实际行为、环境 / 版本、根因分析、修复思路(为什么改这里能解决根因,而不是只盖住症状)。给不出复现步骤就写"未能记录,需向用户补充",让审查方知道缺什么
- **澄清与追加约束**:讨论中确认的细节、被否掉的方案("不要用 XX 方式实现"也是约束)
- **验收标准**:怎么算做完。用户说过的直接引;用户没说的,从需求推导可观察、可验证的条目,**每条标注"⚠ agent 整理,用户未明确"**——这批条目正是审查方最该帮忙盯的
- **覆盖情况**:哪些验收标准做了、哪些没做 / 只做了一半 / 明确延后。审查方的核心任务之一就是抓漏,没做的必须显式列出来
如果你是子会话、只能拿到父会话的转述而不是完整原始对话:按场景 B 的「二手需求」处理,逐字引用转述内容并注明来源,别假装读过原对话。
**场景 B**(先问再写):问用户要需求描述或 issue / 工单链接、当时的验收标准,以及这是不是 bug(是 bug 就追问复现步骤和期望行为)。**不要根据代码反推需求再冒充原始需求**——反推内容只能作为推断写并标注。拿到的需求原文同样要逐字引用,不要改写成自己的话。
用户也可能已经带着需求文字来(二手转述,不是实现方对话的原始记录):直接逐字引用并注