[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7APMH5MK3THECW2QJMZBN0D":3,"skill-same:01M7APMH5MK3THECW2QJMZBN0D":54},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":32,"commitSha":33,"skillDirectory":34,"forksCount":14,"repositoryHtmlUrl":35,"repositoryHomepageUrl":6,"ownerHtmlUrl":36,"ownerBlogUrl":37,"ownerDescription":38,"updatedAt":39,"install":40,"resources":53},"01M7APMH5MK3THECW2QJMZBN0D","receive-review",null,"处理 reviewer 反馈：Red→Green 修复 + 技术论证（禁止表演性同意）。 Use when: 收到 review 结果、reviewer 提了 P1\u002FP2、需要处理反馈。 Not for: 发 review 请求（用 request-review）、自检（用 quality-gate）。 Output: 逐项修复确认 + reviewer 放行。","peps1666\u002FBuildCrew-AI","peps1666","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F128503359?v=4","01M7APD9BQ6NTJ79J9FTB6YZGT","junhao zhou","01M7APD9CD06Q6CCJ22FYVG2AK",0,"MIT","https:\u002F\u002Fgithub.com\u002Fpeps1666\u002FBuildCrew-AI\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Freceive-review\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: receive-review\ntips_exempt: harness-internal review re-entry convention; no distinct end-user capability surface\ndescription: >\n  处理 reviewer 反馈：Red→Green 修复 + 技术论证（禁止表演性同意）。\n  Use when: 收到 review 结果、reviewer 提了 P1\u002FP2、需要处理反馈。\n  Not for: 发 review 请求（用 request-review）、自检（用 quality-gate）。\n  Output: 逐项修复确认 + reviewer 放行。\ntriggers:\n  - \"review 结果\"\n  - \"review 意见\"\n  - \"reviewer 说\"\n  - \"fix these\"\n  - \"github-review-feedback\"\n---\n\n> **SOP 位置**: 本 skill 是 `sop-definitions\u002Fdevelopment.yaml` stage `review` 的反馈处理执行细节。\n> **上一步**: `request-review` | **下一步**: `merge-gate`\n\n# Receive Review\n\n处理 reviewer 反馈的完整流程。核心原则：**技术正确性 > 社交舒适，验证后再实现，禁止表演性同意。**\n\n## 触发入口\n\n| 来源 | 说明 |\n|------|------|\n| operator\u002F猫猫转述 | 手动告知 review 结果 |\n| `github-review-feedback` connector 通知 | F140 自动投递：review decisions（approved\u002Fchanges_requested）+ inline\u002Fconversation comments |\n| 云端 Codex review | 通过 ReviewRouter 投递的 email review 结果 |\n\n收到 `github-review-feedback` 通知时，按下面的核心知识处理——不区分来源，只区分反馈类型。\n\n### 自动触发处理（F140 Phase B）\n\n当 `github-review-feedback` connector 唤醒你时：\n\n1. 读取通知内容，识别 review decision 类型\n2. `CHANGES_REQUESTED` → 直接进入下方 Red→Green 流程\n3. `APPROVED` → 不需要 receive-review，检查是否可以走 merge-gate\n4. `COMMENTED` → 判断是否需要代码修改，需要则进入 Red→Green 流程\n5. 处理完成后通知operator结果（KD-13: 事后通知）\n\n详见 `refs\u002Fpr-signals.md` Phase B 自动响应行为。\n\n## 核心知识\n\n### 两类反馈，处理方式不同\n\n| 类型 | 特征 | 处理 |\n|------|------|------|\n| **代码级** | bug \u002F edge case \u002F 性能 \u002F 命名 | Red→Green 修复流程 |\n| **愿景级** | \"这不是operator要的\" \u002F \"缺了多项目管理\" \u002F \"UI 不可用\" | STOP → 回读原始需求 → 升级operator |\n\n> **愿景级反馈不能用代码 patch 修补设计问题。** 先对照operator experience验证 reviewer 说得对吗；如确实偏离，升级operator确认偏差范围，再重新设计。\n\n### Reviewer Delta Annotation（F253 AC-B2）\n\n当 review request 附有 **Fresh-Context Findings** 节时，reviewer 在自己的 findings 中标注 delta tag，量化 cross-model review 增值：\n\n| Tag | 含义 | 用途 |\n|-----|------|------|\n| `[FC:covered]` | 该 finding 已被 fresh-context 发现 | 量化 fresh-context 覆盖率 |\n| `[FC:new]` | 该 finding 是 fresh-context **未发现**的新发现 | 量化正式 reviewer 增值（reviewer delta metric） |\n| `[FC:N\u002FA]` | 该 finding 不适用 delta 标注（如愿景级\u002F架构级） | 排除非代码 finding |\n\n**Annotation 格式**：在 finding 行末加 tag\n\n```\nP2-1: 边界条件未处理 — src\u002Ffoo.ts:42 [FC:covered]\nP1-1: Race condition in concurrent writes — src\u002Fbar.ts:18 [FC:new]\nP3-1: 建议重新考虑整体架构方向 [FC:N\u002FA]\n```\n\n**注意**：\n- 标注是 lightweight annotation，不增加 review 流程摩擦\n- Review request 无 Fresh-Context Findings 节时（未触发 fresh-context），不标注\n- Delta 数据自然累积在 review 记录中，Phase C `eval:qc` 聚合分析\n- 标注不影响 finding 的 severity 判定或处理流程\n\n### 禁止的响应（表演性同意）\n\n```\n❌ \"You're absolutely right!\"    ❌ \"Great point!\"\n❌ \"Excellent feedback!\"         ❌ \"Thanks for catching that!\"\n❌ \"让我现在就改\"（验证之前）\n```\n\n行动说明一切——直接修复，代码本身证明你听到了反馈。\n\n### Push Back 标准\n\n当以下情况时**必须** push back，用技术论证，不是防御性反应：\n\n- 建议会破坏现有功能\n- Reviewer 缺少完整上下文\n- 违反 YAGNI（过度设计）\n- 与架构决策\u002Foperator要求冲突\n- 建议会让实现**更偏离**operator原始需求\n\n如果你 push back 了但你错了：陈述事实然后继续，不要长篇道歉。\n\n### Fallback 层数检测（F177 Phase D）🔴\n\nReview 代码时，自动执行 `node scripts\u002Fcheck-fallback-layers.mjs` 检测 fallback 模式增长。\n同一文件新增 ≥3 层 fallback → 触发坐标系自检（三问）：\n1. 这个 fix 是在修坐标系，还是在给错误坐标系打补丁？\n2. 能否用坐标变换（换一个问题分解方式）消除这些 fallback 层？\n3. 每一层 fallback 为什么不能去掉？\n\nreview 报告中必须包含 fallback 层数分析结果。\n\n**Review 有零分歧 = 走过场**（反顺从规则）。真正的 review 需要技术争论。\n\n## 流程\n\n```\nWHEN 收到 review 反馈:\n\n1. READ  — 完整读完，不要边读边反应。**R2+ 时额外动作**：回看上轮 finding 列表，标注每个 finding 的 failure-mode 类型，用于 AUDIT 步骤的同型判别\n2. CLASSIFY — 区分愿景级 vs 代码级；按 P1\u002FP2\u002FP3 分优先级\n3. CLARIFY — 有不清晰的问题先全部问清，再动手\n4. VERIFY — reviewer 说的问题真的存在吗？（见下方三道门）\n5. AUDIT — failure-mode sweep（见下方 §16e 判别）\n6. FIX — 通过验证的问题 + audit 发现的同类问题 Red→Green 修复\n7. CONFIRM — 修完回给 reviewer 确认，不能自判\"改对了\"\n```\n\n### VERIFY 三道门（少一道不准照改）\n\n对每条 review 意见，改代码之前必须过三道门：\n\n1. **Spec Gate** — 这条意见和现有 AC\u002F需求冲突吗？\n   - 冲突 → pushback，附 AC 原文\n   - 不冲突 → 进下一道\n2. **Mechanism Gate** — reviewer 说\"这不行\"的证据是什么？\n   - 有失败用例 \u002F 真实平台限制 → 进下一道\n   - 只是\"不优雅\"\u002F\"理论上不安全\"但拿不出失败路径 → 当假设处理，pushback 要求证据\n3. **Feature Gate** — 按建议改完后，核心用户路径还活着吗？\n   - 改完跑一遍最关键的用户路径（不是只跑测试）\n   - 功能死了 → 回滚，review 建议作废，不管它理论上多优雅\n\n**特别注意**：remote reviewer（Codex cloud）没有运行环境，判断基于静态分析和理论推理。你有本地环境 → **你的实测证据 > 他的理论推理**。\n\n**修复顺序**：P1（blocking）→ P2（必须修）→ P3（讨论后当场修或放下，不记 BACKLOG）\n\n**澄清原则**：有任何问题不清晰，先 STOP，全部问清再动手。部分理解 = 错误实现。\n\n### AUDIT — Failure-Mode Sweep（shared-rules §16e）\n\nVERIFY 完所有 findings 之后、动手修之前，做一次 failure-mode 判别：\n\n**判别问**：这些通过验证的 P1\u002FP2 里，有没有 ≥2 个属于**同一类 failure mode**？（边界遗漏、null 不安全、错误处理不一致、状态转换缺路径、类型假设不安全……）\n\n- **有** → 做 failure-mode audit 再修：\n  1. **抽象**：一句话说清它们违反了什么不变量\n  2. **扫描**：带着这个不变量 grep 本 PR diff 里所有同类位置（sibling call sites、同性质边界群）\n  3. **防护**：能否加类型\u002F封装\u002F测试让它不可能再违反\n  4. **自报告**：audit 结果写进修复确认信，让 reviewer 不用下轮再 grep 同型\n- **没有**（全是独立、不同类的点问题）→ 跳过 audit，直接进 FIX\n\n**R2+ 额外检查**：如果本轮的 finding 和上轮是**同型**——不管数量多少，**强制 audit**。同型第二次出现 = author 上轮没泛化，这次必须补上。\n\n**≥3 轮升级规则（F229 PR-A1 20 轮教训）🔴**：同一状态对象的 finding 连续 **≥3 轮**出现（哪怕每轮都\"修好了\"）= 不是你修得不对，是 **plan\u002Fspec 层欠状态机的边**——代码层 audit 扫不出\"spec 没定义 restore boundary\"这种上游缺失。停手，@ plan\u002Fspec 作者按 writing-plans「Stateful Object Gate」补状态转移表 + 不变量，补完再继续修。**别一个人打到 R20**（PR #2202：实现猫每轮诚实修好当轮 finding，但缺这个升级出口，20 轮才合入）。\n\n> **为什么在 FIX 之前**：先 audit 再修 = 一次修完所有同类；先修再 audit = 改了一个又发现三个，反复 rebase。\n\n## Red→Green 修复流程\n\n对每个 P1\u002FP2 问题：\n\n**Step 0: 创建修复任务**（F160 Phase C — 在动手修之前）\n调用 `cat_cafe_create_task` 为每个 P1\u002FP2 创建独立跟踪任务：\n- title: `[P{N}] {问题摘要}`（如 `[P2] TaskComposer HTTP 错误时丢失输入`）\n- why: reviewer 的原始描述（≤120 字）\n- 修复完成后 `cat_cafe_update_task` 状态改为 `done`\n\n**Gotcha**: 不要为 P3 创建任务——P3 当场修或放下，不记 BACKLOG 也不记毛线球。\n\n```\n1. 理解问题\n2. 写失败测试（Red）\n3. 运行测试，确认红灯\n4. 修复代码\n5. 运行测试，确认绿灯（Green）\n6. 运行完整测试套件，确认无 regression\n```\n\n**例外**：如果无法稳定自动化复现，提供最小手工复现步骤 + 说明原因，但不能跳过验证结论。\n\n## 修复后确认（硬规则）\n\n**修复完成 ≠ 可以合入。必须回到本轮可验证的 feedback source 确认。** 对本地 review，权威来源是\n**direct review carrier**（直接承载 review 请求、由 lease `predecessorThreadId` 绑定的 thread），不是任务祖先\nthread，也不是第一次误投 verdict 的落点。若二者冲突，停止沿错路级联并回 direct review carrier。\n\n### 本地 reviewer 复入载体（terminal 之后的新工作）\n\nP1\u002FP2 修复产生的新 exact HEAD 是一轮新的、可执行的 review work，不是对上一轮 terminal verdict 的礼貌 ACK。向本地 reviewer 发修复确认前，必须重新加载 `request-review`，并用结构化 successor 载体：同 thread 用 `post_message(action.mode=single)`，跨 thread 用对应 cross-thread action；两者都带 `coordination.phase=active`、`reviewReentry`（reason + durable evidenceRef）、显式 `clientMessageId` 与唯一 reviewer `targetCats`。\n\n只用普通行首 `@reviewer`、`replyTo` 或裸 `targetCats` 回 terminal verdict，服务端会按 ACK 正确抑制；不得把正文看起来“像正式复审”当机器可判 provenance，也不得靠反复重发碰运气。最终 verdict 仍按 `request-review` 用 terminal coordination 返回。\n\n| Feedback source | 修复后动作 |\n|-----------------|------------|\n| 本地猫 reviewer | 在 direct review carrier 向 `@reviewer` 发送结构化修复确认请求；等 reviewer 明确放行当前 SHA |\n| cloud \u002F GitHub review | 在 GitHub 回复或标注修复证据，push 新 SHA 后**只重新触发 cloud review**，等 PR tracking \u002F review feedback；不要 @ 本地旧 reviewer |\n| CI \u002F PR check | 修复后 rerun\u002Fcheck gate；若只是外部 check gate，不需要本地 reviewer 续签 |\n| operator \u002F 愿景级 feedback | 回读原始需求；需要价值取舍时带 Decision Packet 给operator |\n\n```\n❌ 错误：cloud P2 修复 → @ 本地旧 reviewer 续签 → 等 cloud → 再 @ 本地 reviewer\n✅ 正确：cloud P2 修复 → re-trigger cloud review → 等 PR truth source；local peer 只在非 cloud 行为 delta \u002F scope 扩大时介入\n```\n\n确认信格式（简要，详细版见 `refs\u002F` 如有需要）：\n\n```markdown\n## 修复确认请求\n\n| # | 问题 | 状态 | Red→Green |\n|---|------|------|-----------|\n| P1-1 | {描述} | ✅ | {test file}: FAIL → PASS |\n| P2-1 | {描述} | ✅ | {test file}: FAIL → PASS |\n\n测试结果：pnpm test → {X} passed, 0 failed\nCommit: {sha} — {message}\nFresh-Context Delta: {N} FC:covered, {M} FC:new, {K} FC:N\u002FA \u003C!-- 仅 review request 含 FC 节时 -->\n\n请确认修复，确认后执行合入。\n```\n\n修复完成后（F160 Phase C）：\n- 每个 P1\u002FP2 修复任务 → `cat_cafe_update_task` 状态改为 `done`\n- 回到上述可验证 feedback source 确认（本地 review 以 direct review carrier 为准）\n\n**remote review 修了 P1\u002FP2 → 必须 re-trigger remote review，不能自判通过直接合入，也不能把 cloud gate 投射成本地旧 reviewer。**\n\n## Reviewer 验证 UX\u002F前端改动（硬规则）\n\n> 教训（F121 狼人杀）：reviewer 只看代码没打开浏览器，author 连续 9 轮瞎猜修都没被发现。\n\n**涉及 UX\u002F前端\u002F交互的改动，reviewer 必须实际打开浏览器操作验证**，不能只看代码和测试输出。\n\n```\n验证清单：\n1. 打开浏览器（Playwright\u002FChrome MCP）访问对应页面\n2. 按 AC 或 bug 复现步骤实际操作\n3. 截图\u002F录屏作为验证证据\n4. 如果和设计稿（.pen）有出入，标注差异\n```\n\n没有浏览器验证的前端 review = 走过场。\n\n## TAKEOVER 降级（同线程同任务）\n\nReviewer 在 review 过程中发现 author 触发以下任一条件，可直接发起 TAKEOVER（详见 shared-rules §18）：\n\n1. 连续 3 轮无有效证据增量；\n2. 连续 2 次假绿（声明 fixed 但复验失败）；\n3. 你（reviewer）被迫对同一验收点重复验证 2 次。\n\n**触发后**：在 thread 显式宣布 TAKEOVER → 原 author 停止试错 → 你或另一只猫接手修复。接管猫不得自审，需由另一只猫 review。\n\n## Common Mistakes\n\n| 错误 | 正确做法 |\n|------|----------|\n| 边读边改，没读完 | 读完整反馈，分类后再动手 |\n| 有不清晰的问题但先改清晰的 | 全部澄清后再统一动手 |\n| 没写 Red 测试直接改代码 | 先写失败测试，确认红灯，再修 |\n| 修完自判\"对了\"直接合入 | 必须回给 reviewer 确认 |\n| 全盘接受，零 push back | 有技术理由必须说出来 |\n| 愿景级问题用代码 patch | STOP，升级operator，不要硬修 |\n| 云端 P1 修完不 re-trigger | 必须重新触发remote review |\n| 前端改动只看代码不开浏览器 | 涉及 UX 必须打开浏览器实操验证 |\n| 只修 reviewer 指的那一个点（补锅匠） | 先判 failure mode 是否同类，是则 audit 本 PR diff 全扫再修 |\n| 同型 finding 打到 R5+ 还在逐轮修 | **第 3 轮就停**，升级 plan\u002Fspec 作者补状态机（≥3 轮升级规则）——代码层修不掉 spec 层的洞 |\n\n## 和其他 skill 的区别\n\n| Skill | 关注点 | 时机 |\n|-------|--------|------|\n| `quality-gate` | 自己检查自己（spec + 证据） | 提 review 之前 |\n| `request-review` | 发出 review 请求 | 自检通过之后 |\n| **receive-review（本 skill）** | 处理 reviewer 的反馈 | 收到 review 之后 |\n| `merge-gate` | 合入前门禁 + PR + remote review | reviewer 放行之后 |\n\n### Review 沙盒生命周期\n\nReviewer 在 review 期间创建的沙盒：\n- **创建**：按 `request-review` 约定的路径 `\u002Ftmp\u002Fcat-cafe-review\u002F{review-target-id}\u002F{reviewer-handle}`\n- **回收**：**不由 reviewer 负责**。merge-gate 在 merge 后统一回收（Step 8.5）。\n- Reviewer 放行后**不需要**主动清理沙盒，也不需要报告沙盒路径。\n\n> 为什么不让 reviewer 自己清理：reviewer session 在放行后结束，下次唤醒时 context 已换，\n> 根本不记得自己在 \u002Ftmp 留了什么。merge-gate 是唯一确定性终态。\n\n## 下一步\n\nReviewer 放行（\"LGTM\"\u002F\"通过\"\u002F\"可以合入\"）→ `merge-gate`（SOP stage `merge`）。\n","> **SOP 位置**: 本 skill 是 `sop-definitions\u002Fdevelopment.yaml` stage `review` 的反馈处理执行细节。\n> **上一步**: `request-review` | **下一步**: `merge-gate`\n\n# Receive Review\n\n处理 reviewer 反馈的完整流程。核心原则：**技术正确性 > 社交舒适，验证后再实现，禁止表演性同意。**\n\n## 触发入口\n\n| 来源 | 说明 |\n|------|------|\n| operator\u002F猫猫转述 | 手动告知 review 结果 |\n| `github-review-feedback` connector 通知 | F140 自动投递：review decisions（approved\u002Fchanges_requested）+ inline\u002Fconversation comments |\n| 云端 Codex review | 通过 ReviewRouter 投递的 email review 结果 |\n\n收到 `github-review-feedback` 通知时，按下面的核心知识处理——不区分来源，只区分反馈类型。\n\n### 自动触发处理（F140 Phase B）\n\n当 `github-review-feedback` connector 唤醒你时：\n\n1. 读取通知内容，识别 review decision 类型\n2. `CHANGES_REQUESTED` → 直接进入下方 Red→Green 流程\n3. `APPROVED` → 不需要 receive-review，检查是否可以走 merge-gate\n4. `COMMENTED` → 判断是否需要代码修改，需要则进入 Red→Green 流程\n5. 处理完成后通知operator结果（KD-13: 事后通知）\n\n详见 `refs\u002Fpr-signals.md` Phase B 自动响应行为。\n\n## 核心知识\n\n### 两类反馈，处理方式不同\n\n| 类型 | 特征 | 处理 |\n|------|------|------|\n| **代码级** | bug \u002F edge case \u002F 性能 \u002F 命名 | Red→Green 修复流程 |\n| **愿景级** | \"这不是operator要的\" \u002F \"缺了多项目管理\" \u002F \"UI 不可用\" | STOP → 回读原始需求 → 升级operator |\n\n> **愿景级反馈不能用代码 patch 修补设计问题。** 先对照operator experience验证 reviewer 说得对吗；如确实偏离，升级operator确认偏差范围，再重新设计。\n\n### Reviewer Delta Annotation（F253 AC-B2）\n\n当 review request 附有 **Fresh-Context Findings** 节时，reviewer 在自己的 findings 中标注 delta tag，量化 cross-model review 增值：\n\n| Tag | 含义 | 用途 |\n|-----|------|------|\n| `[FC:covered]` | 该 finding 已被 fresh-context 发现 | 量化 fresh-context 覆盖率 |\n| `[FC:new]` | 该 finding 是 fresh-context **未发现**的新发现 | 量化正式 reviewer 增值（reviewer delta metric） |\n| `[FC:N\u002FA]` | 该 finding 不适用 delta 标注（如愿景级\u002F架构级） | 排除非代码 finding |\n\n**Annotation 格式**：在 finding 行末加 tag\n\n```\nP2-1: 边界条件未处理 — src\u002Ffoo.ts:42 [FC:covered]\nP1-1: Race condition in concurrent writes — src\u002Fbar.ts:18 [FC:new]\nP3-1: 建议重新考虑整体架构方向 [FC:N\u002FA]\n```\n\n**注意**：\n- 标注是 lightweight annotation，不增加 review 流程摩擦\n- Review request 无 Fresh-Context Findings 节时（未触发 fresh-context），不标注\n- Delta 数据自然累积在 review 记录中，Phase C `eval:qc` 聚合分析\n- 标注不影响 finding 的 severity 判定或处理流程\n\n### 禁止的响应（表演性同意）\n\n```\n❌ \"You're absolutely right!\"    ❌ \"Great point!\"\n❌ \"Excellent feedback!\"         ❌ \"Thanks for catching that!\"\n❌ \"让我现在就改\"（验证之前）\n```\n\n行动说明一切——直接修复，代码本身证明你听到了反馈。\n\n### Push Back 标准\n\n当以下情况时**必须** push back，用技术论证，不是防御性反应：\n\n- 建议会破坏现有功能\n- Reviewer 缺少完整上下文\n- 违反 YAGNI（过度设计）\n- 与架构决策\u002Foperator要求冲突\n- 建议会让实现**更偏离**operator原始需求\n\n如果你 push back 了但你错了：陈述事实然后继续，不要长篇道歉。\n\n### Fallback 层数检测（F177 Phase D）🔴\n\nReview 代码时，自动执行 `node scripts\u002Fcheck-fallback-layers.mjs` 检测 fallback 模式增长。\n同一文件新增 ≥3 层 fallback → 触发坐标系自检（三问）：\n1. 这个 fix 是在修坐标系，还是在给错误坐标系打补丁？\n2. 能否用坐标变换（换一个问题分解方式）消除这些 fallback 层？\n3. 每一层 fallback 为什么不能去掉？\n\nreview 报告中必须包含 fallback 层数分析结果。\n\n**Review 有零分歧 = 走过场**（反顺从规则）。真正的 review 需要技术争论。\n\n## 流程\n\n```\nWHEN 收到 review 反馈:\n\n1. READ  — 完整读完，不要边读边反应。**R2+ 时额外动作**：回看上轮 finding 列表，标注每个 finding 的 failure-mode 类型，用于 AUDIT 步骤的同型判别\n2. CLASSIFY — 区分愿景级 vs 代码级；按 P1\u002FP2\u002FP3 分优先级\n3. CLARIFY — 有不清晰的问题先全部问清，再动手\n4. VERIFY — reviewer 说的问题真的存在吗？（见下方三道门）\n5. AUDIT — failure-mode sweep（见下方 §16e 判别）\n6. FIX — 通过验证的问题 + audit 发现的同类问题 Red→Green 修复\n7. CONFIRM — 修完回给 reviewer 确认，不能自判\"改对了\"\n```\n\n### VERIFY 三道门（少一道不准照改）\n\n对每条 review 意见，改代码之前必须过三道门：\n\n1. **Spec Gate** — 这条意见和现有 AC\u002F需求冲突吗？\n   - 冲突 → pushback，附 AC 原文\n   - 不冲突 → 进下一道\n2. **Mechanism Gate** — reviewer 说\"这不行\"的证据是什么？\n   - 有失败用例 \u002F 真实平台限制 → 进下一道\n   - 只是\"不优雅\"\u002F\"理论上不安全\"但拿不出失败路径 → 当假设处理，pushback 要求证据\n3. **Feature Gate** — 按建议改完后，核心用户路径还活着吗？\n   - 改完跑一遍最关键的用户路径（不是只跑测试）\n   - 功能死了 → 回滚，review 建议作废，不管它理论上多优雅\n\n**特别注意**：remote reviewer（Codex cloud）没有运行环境，判断基于静态分析和理论推理。你有本地环境 → **你的实测证据 > 他的理论推理**。\n\n**修复顺序**：P1（blocking）→ P2（必须修）→ P3（讨论后当场修或放下，不记 BACKLOG）\n\n**澄清原则**：有任何问题不清晰，先 STOP，全部问清再动手。部分理解 = 错误实现。\n\n### AUDIT — Failure-Mode Sweep（shared-rules §16e）\n\nVERIFY 完所有 findings 之后、动手修之前，做一次 failure-mode 判别：\n\n**判别问**：这些通过验证的 P1\u002FP2 里，有没有 ≥2 个属于**同一类 failure mode**？（边界遗漏、null 不安全、错误处理不一致、状态转换缺路径、类型假设不安全……）\n\n- **有** → 做 failure-mode audit 再修：\n  1. **抽象**：一句话说清它们违反了什么不变量\n  2. **扫描**：带着这个不变量 grep 本 PR diff 里所有同类位置（sibling call sites、同性质边界群）\n  3. **防护**：能否加类型\u002F封装\u002F测试让它不可能再违反\n  4. **自报告**：audit 结果写进修复确认信，让 reviewer 不用下轮再 grep 同型\n- **没有**（全是独立、不同类的点问题）→ 跳过 audit，直接进 FIX\n\n**R2+ 额外检查**：如果本轮的 finding 和上轮是**同型**——不管数量多少，**强制 audit**。同型第二次出现 = author 上轮没泛化，这次必须补上。\n\n**≥3 轮升级规则（F229 PR-A1 20 轮教训）🔴**：同一状态对象的 finding 连续 **≥3 轮**出现（哪怕每轮都\"修好了\"）= 不是你修得不对，是 **plan\u002Fspec 层欠状态机的边**——代码层 audit 扫不出\"spec 没定义 restore boundary\"这种上游缺失。停手，@ plan\u002Fspec 作者按 writing-plans「Stateful Object Gate」补状态转移表 + 不变量，补完再继续修。**别一个人打到 R20**（PR #2202：实现猫每轮诚实修好当轮 finding，但缺这个升级出口，20 轮才合入）。\n\n> **为什么在 FIX 之前**：先 audit 再修 = 一次修完所有同类；先修再 audit = 改了一个又发现三个，反复 rebase。\n\n## Red→Green 修复流程\n\n对每个 P1\u002FP2 问题：\n\n**Step 0: 创建修复任务**（F160 Phase C — 在动手修之前）\n调用 `cat_cafe_create_task` 为每个 P1\u002FP2 创建独立跟踪任务：\n- title: `[P{N}] {问题摘要}`（如 `[P2] TaskComposer HTTP 错误时丢失输入`）\n- why: reviewer 的原始描述（≤120 字）\n- 修复完成后 `cat_cafe_update_task` 状态改为 `done`\n\n**Gotcha**: 不要为 P3 创建任务——P3 当场修或放下，不记 BACKLOG 也不记毛线球。\n\n```\n1. 理解问题\n2. 写失败测试（Red）\n3. 运行测试，确认红灯\n4. 修复代码\n5. 运行测试，确认绿灯（Green）\n6. 运行完整测试套件，确认无 regression\n```\n\n**例外**：如果无法稳定自动化复现，提供最小手工复现步骤 + 说明原因，但不能跳过验证结论。\n\n## 修复后确认（硬规则）\n\n**修复完成 ≠ 可以合入。必须回到本轮可验证的 feedback source 确认。** 对本地 review，权威来源是\n**direct review carrier**（直接承载 review 请求、由 lease `predecessorThreadId` 绑定的 thread），不是任务祖先\nthread，也不是第一次误投 verdict 的落点。若二者冲突，停止沿错路级联并回 direct review carrier。\n\n### 本地 reviewer 复入载体（terminal 之后的新工作）\n\nP1\u002FP2 修复产生的新 exact HEAD 是一轮新的、可执行的 review work，不是对上一轮 terminal verdict 的礼貌 ACK。向本地 reviewer 发修复确认前，必须重新加载 `request-review`，并用结构化 successor 载体：同 thread 用 `post_message(action.mode=single)`，跨 thread 用对应 cross-thread action；两者都带 `coordination.phase=active`、`reviewReentry`（reason + durable evidenceRef）、显式 `clientMessageId` 与唯一 reviewer `targetCats`。\n\n只用普通行首 `@reviewer`、`replyTo` 或裸 `targetCats` 回 terminal verdict，服务端会按 ACK 正确抑制；不得把正文看起来“像正式复审”当机器可判 provenance，也不得靠反复重发碰运气。最终 verdict 仍按 `request-review` 用 terminal coordination 返回。\n\n| Feedback source | 修复后动作 |\n|-----------------|------------|\n| 本地猫 reviewer | 在 direct review carrier 向 `@reviewer` 发送结构化修复确认请求；等 reviewer 明确放行当前 SHA |\n| cloud \u002F GitHub review | 在 GitHub 回复或标注修复证据，push 新 SHA 后**只重新触发 cloud review**，等 PR tracking \u002F review feedback；不要 @ 本地旧 reviewer |\n| CI \u002F PR check | 修复后 rerun\u002Fcheck gate；若只是外部 check gate，不需要本地 reviewer 续签 |\n| operator \u002F 愿景级 feedback | 回读原始需求；需要价值取舍时带 Decision Packet 给operator |\n\n```\n❌ 错误：cloud P2 修复 → @ 本地旧 reviewer 续签 → 等 cloud → 再 @ 本地 reviewer\n✅ 正确：cloud P2 修复 → re-trigger cloud review → 等 PR truth source；local peer 只在非 cloud 行为 delta \u002F scope 扩大时介入\n```\n\n确认信格式（简要，详细版见 `refs\u002F` 如有需要）：\n\n```markdown\n## 修复确认请求\n\n| # | 问题 | 状态 | Red→Green |\n|---|------|------|-----------|\n| P1-1 | {描述} | ✅ | {test file}: FAIL → PASS |\n| P2-1 | {描述} | ✅ | {test file}: FAIL → PASS |\n\n测试结果：pnpm test → {X} passed, 0 failed\nCommit: {sha} — {message}\nFresh-Context Delta: {N} FC:covered, {M} FC:new, {K} FC:N\u002FA \u003C!-- 仅 review request 含 FC 节时 -->\n\n请确认修复，确认后执行合入。\n```\n\n修复完成后（F160 Phase C）：\n- 每个 P1\u002FP2 修复任务 → `cat_cafe_update_task` 状态改为 `done`\n- 回到上述可验证 feedback source 确认（本地 review 以 direct review carrier 为准）\n\n**remote review 修了 P1\u002FP2 → 必须 re-trigger remote review，不能自判通过直接合入，也不能把 cloud gate 投射成本地旧 reviewer。**\n\n## Reviewer 验证 UX\u002F前端改动（硬规则）\n\n> 教训（F121 狼人杀）：reviewer 只看代码没打开浏览器，author 连续 9 轮瞎猜修都没被发现。\n\n**涉及 UX\u002F前端\u002F交互的改动，reviewer 必须实际打开浏览器操作验证**，不能只看代码和测试输出。\n\n```\n验证清单：\n1. 打开浏览器（Playwright\u002FChrome MCP）访问对应页面\n2. 按 AC 或 bug 复现步骤实际操作\n3. 截图\u002F录屏作为验证证据\n4. 如果和设计稿（.pen）有出入，标注差异\n```\n\n没有浏览器验证的前端 review = 走过场。\n\n## TAKEOVER 降级（同线程同任务）\n\nReviewer 在 review 过程中发现 author 触发以下任一条件，可直接发起 TAKEOVER（详见 shared-rules §18）：\n\n1. 连续 3 轮无有效证据增量；\n2. 连续 2 次假绿（声明 fixed 但复验失败）；\n3. 你（reviewer）被迫对同一验收点重复验证 2 次。\n\n**触发后**：在 thread 显式宣布 TAKEOVER → 原 author 停止试错 → 你或另一只猫接手修复。接管猫不得自审，需由另一只猫 review。\n\n## Common Mistakes\n\n| 错误 | 正确做法 |\n|------|----------|\n| 边读边改，没读完 | 读完整反馈，分类后再动手 |\n| 有不清晰的问题但先改清晰的 | 全部澄清后再统一动手 |\n| 没写 Red 测试直接改代码 | 先写失败测试，确认红灯，再修 |\n| 修完自判\"对了\"直接合入 | 必须回给 reviewer 确认 |\n| 全盘接受，零 push back | 有技术理由必须说出来 |\n| 愿景级问题用代码 patch | STOP，升级operator，不要硬修 |\n| 云端 P1 修完不 re-trigger | 必须重新触发remote review |\n| 前端改动只看代码不开浏览器 | 涉及 UX 必须打开浏览器实操验证 |\n| 只修 reviewer 指的那一个点（补锅匠） | 先判 failure mode 是否同类，是则 audit 本 PR diff 全扫再修 |\n| 同型 finding 打到 R5+ 还在逐轮修 | **第 3 轮就停**，升级 plan\u002Fspec 作者补状态机（≥3 轮升级规则）——代码层修不掉 spec 层的洞 |\n\n## 和其他 skill 的区别\n\n| Skill | 关注点 | 时机 |\n|-------|--------|------|\n| `quality-gate` | 自己检查自己（spec + 证据） | 提 review 之前 |\n| `request-review` | 发出 review 请求 | 自检通过之后 |\n| **receive-review（本 skill）** | 处理 reviewer 的反馈 | 收到 review 之后 |\n| `merge-gate` | 合入前门禁 + PR + remote review | reviewer 放行之后 |\n\n### Review 沙盒生命周期\n\nReviewer 在 review 期间创建的沙盒：\n- **创建**：按 `request-review` 约定的路径 `\u002Ftmp\u002Fcat-cafe-review\u002F{review-target-id}\u002F{reviewer-handle}`\n- **回收**：**不由 reviewer 负责**。merge-gate 在 merge 后统一回收（Step 8.5）。\n- Reviewer 放行后**不需要**主动清理沙盒，也不需要报告沙盒路径。\n\n> 为什么不让 reviewer 自己清理：reviewer session 在放行后结束，下次唤醒时 context 已换，\n> 根本不记得自己在 \u002Ftmp 留了什么。merge-gate 是唯一确定性终态。\n\n## 下一步\n\nReviewer 放行（\"LGTM\"\u002F\"通过\"\u002F\"可以合入\"）→ `merge-gate`（SOP stage `merge`）。\n",{"name":5,"triggers":24,"description":30,"tips_exempt":31},[25,26,27,28,29],"review 结果","review 意见","reviewer 说","fix these","github-review-feedback","处理 reviewer 反馈：Red→Green 修复 + 技术论证（禁止表演性同意）。 Use when: 收到 review 结果、reviewer 提了 P1\u002FP2、需要处理反馈。 Not for: 发 review 请求（用 request-review）、自检（用 quality-gate）。 Output: 逐项修复确认 + reviewer 放行。\n","harness-internal review re-entry convention; no distinct end-user capability surface","main","e43f83d5ceb309323cae7e0f31e5e48fd816a57d",".claude\u002Fskills\u002Freceive-review","https:\u002F\u002Fgithub.com\u002Fpeps1666\u002FBuildCrew-AI","https:\u002F\u002Fgithub.com\u002Fpeps1666","https:\u002F\u002Fwww.cug.edu.cn\u002F","My name is Zhou Junhao, and I am from China University of Geosciences (Wuhan). My major is Resources and Environment, and my research direction is Remote Sensin","2026-08-16 00:25:38",{"source":8,"skillName":5,"commands":41,"prompt":51,"zipAvailable":52},[42,45,48],{"tool":43,"command":44},"npx","npx skills add peps1666\u002FBuildCrew-AI --skill receive-review",{"tool":46,"command":47},"bunx","bunx skills add peps1666\u002FBuildCrew-AI --skill receive-review",{"tool":49,"command":50},"pnpm","pnpm dlx skills add peps1666\u002FBuildCrew-AI --skill receive-review","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fpeps1666\u002FBuildCrew-AI\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Freceive-review\u002FSKILL.md",true,[],[55,61,68,75,82,89],{"skillNo":56,"name":57,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":58,"categories":59,"keywords":60,"publishedAt":19},"01M7APYYSHV2SSSRV5Q15JWWPF","plugin-reconcile-skill","https:\u002F\u002Fgithub.com\u002Fpeps1666\u002FBuildCrew-AI\u002Fblob\u002Fmain\u002Fplugins\u002Ftest-reconcile-plugin-regr\u002Fskills\u002Fplugin-reconcile-skill\u002FSKILL.md",[],[],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":19},"01M7APYWAJ119TPF079F2AXWAS","weixin-mp","通过 Limb 体系操作微信公众号：发布文章、上传图片、管理草稿。 Use when: 需要发布内容到微信公众号、查看草稿、检查公众号连接状态。 Not for: 其他平台的发布、纯文本聊天、非公众号相关操作。 Output: 微信公众号操作结果（发布ID、草稿列表、图片URL等）。","https:\u002F\u002Fgithub.com\u002Fpeps1666\u002FBuildCrew-AI\u002Fblob\u002Fmain\u002Fpackages\u002Fapi\u002Fsrc\u002Fplugins\u002Fweixin-mp\u002Fskills\u002Fweixin-mp\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":19},"01M7APYNNEMBP2T62WT0JT7GNE","writing-skills","创建或修改 Clowder AI skill \u002F MCP tool description 的元技能（含质量标准、范本、发布）。 Use when: 写新 skill、修改现有 skill、写\u002F改 MCP tool description、验证 skill 质量； 或者功能实现中产出了 SKILL.md \u002F cat-cafe-skills\u002F 新目录 \u002F manifest.yaml skill 条目。 Not for: 使用 skill（直接触发对应 skill）。 Output: 新\u002F更新的 SKILL.md + manifest 条目 + symlinks。 GOTCHA: 软硬同重——skill\u002FMCP 质量 = 代码质量；不要写模型已知的通用教程，先过价值门禁。","https:\u002F\u002Fgithub.com\u002Fpeps1666\u002FBuildCrew-AI\u002Fblob\u002Fmain\u002Fcat-cafe-skills\u002Fwriting-skills\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":19},"01M7APYHJDXRH9EDP5D3JZHSVN","writing-plans","将 spec\u002F需求拆分为可执行的分步实施计划。 Use when: 有 spec 或需求，准备动手前需要拆分步骤。 Not for: trivial 改动（≤5 行）、已有详细计划。 Output: 分步实施计划（含 TDD 步骤和检查点）。","https:\u002F\u002Fgithub.com\u002Fpeps1666\u002FBuildCrew-AI\u002Fblob\u002Fmain\u002Fcat-cafe-skills\u002Fwriting-plans\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":19},"01M7APYD2SSZ6Y6CF5SD3YZ5C0","worktree","为代码、脚本、API 与第一方执行面创建隔离 Git worktree，并配置 Redis 6398；classifier 放行的 co-creation docs direct push 不进入本流程。","https:\u002F\u002Fgithub.com\u002Fpeps1666\u002FBuildCrew-AI\u002Fblob\u002Fmain\u002Fcat-cafe-skills\u002Fworktree\u002FSKILL.md",[],[],{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":19},"01M7APY8R4E7RR2WZVPH9V8WWP","workspace-navigator","猫猫把“打开文档、代码或日志”等模糊意图解析成本地绝对路径或 worktree 相对路径，并返回 applied、queued、blocked 或 unconfirmed 的真实 Workspace 投递状态。","https:\u002F\u002Fgithub.com\u002Fpeps1666\u002FBuildCrew-AI\u002Fblob\u002Fmain\u002Fcat-cafe-skills\u002Fworkspace-navigator\u002FSKILL.md",[],[]]