← ClaudeAtlas

review-brieflisted

一轮需求实现或 bug 修复收尾时,生成一份交给另一个 agent 独立复查用的审查简报: 沉淀原始需求与验收标准、圈定本次变更范围(未提交变更或提交区间)、 按需求符合性 / 潜在 bug / 影响面三个维度拟出具体审查要点与操作步骤, 让没有任何对话上下文的审查 agent 也能照着独立完成复查。 触发:"生成审查简报"、"总结本次修改"、"交接给另一个 agent 审查"、"审查交接"、 "改完了整理给审查"、"交给另一个 AI 复查"、"写一份 review brief"、"review brief"、 "这个改动帮我出一份复查清单"。 不要在以下情况使用: - 用户只想让你当场把刚写的代码再看一遍,不需要产出交接文档 → 直接自查即可 - 只想在对话里回顾改了什么、不需要交给别的 agent 审查 → 直接口头总结 - 要走 GitHub PR / GitLab MR 的正式评论流程 → 用对应平台的 review 能力 - 审查对象不是代码变更(文章、方案、文档本身)→ 直接审或用对应技能
uwakeme/wake-skills · ★ 1 · Code & Development · score 71
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 就追问复现步骤和期望行为)。**不要根据代码反推需求再冒充原始需求**——反推内容只能作为推断写并标注。拿到的需求原文同样要逐字引用,不要改写成自己的话。 用户也可能已经带着需求文字来(二手转述,不是实现方对话的原始记录):直接逐字引用并注