Agent Skills
返回列表
💻

复审只挑真毛病

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_f274b691/reviewing-for-substance。

技能介绍

要解决的问题

AI 参与评审时有两个常见坏味道:把挑刺当成严谨,以及把改文档当成推进。前者表现为评审意见里塞满「我更喜欢换个说法」「建议总分总结构」这类风格偏好,报告看起来满满当当,实则一条都不改变交付物的行为;后者更隐蔽——会话之间互相统一标题层级、润色彼此的措辞、甚至复审对方的复审意见,几轮下来要交付的代码一行没动,却让人产生「协作很有进展」的错觉。这个技能要做的,是让评审只输出能回答「什么坏了、什么要返工」的问题,并在连续空转时主动喊停。

它如何工作

核心是两条铁律:对每条评审意见问「不改会怎样」,答不上来就不算问题;对每轮工作问「交付物本身前进了什么」,答不上来就不算进展。在这之上有三层机制:

  • 分级过滤:评审发现只允许落进 Blocking(行为错误、契约破坏、需求遗漏、数据丢失,上线必返工)、Material(能跑但埋了真成本,如未处理的状态、实现者只能猜的字段、隐性假设)、Polish(风格品味)三类。风格、措辞、结构偏好不做 findings,即使写出来也可能整段省略。
  • 三条伴生规则:零发现是合法结论,「未发现实质性问题」就是一次完整评审;先用最强解读攻击原稿,存在歧义时歧义本身就是发现;一个可复现的实质缺陷胜过十条泛泛的好评,但真诚给出的通过也是成功,不是失职。
  • 输出格式钉死:结论先行(通过 / 需修改 / 阻断),每条发现带等级和「改了什么后果」一句话;Polish 项只能出现在末尾独立区块,永远不阻塞。

边界提示

针对「评审了空气」和「复审对象不固定」这类问题,规范要求先锁定目标再评审,hit 空对象时诚实索取而非凭空生成。同时,这是一种结构性约束,但要求评审人和作者双方守规矩,不能变成橡皮图章,也不能变成单向命令。多余的步骤比如复审链不嵌套、分支没等下游的元工作算作作秀、当交付物确实是文档时正事转向语义内容且格式循环被拉响、开发区遇到缺环境缺数据时就诚实标注 static-analysis-grade。更多按代码、需求、空转、润色四种类型的完整示例见 references/examples.md。

使用场景

  • AI 生成了需求文档和接口契约,在进入开发前需要一轮评审,但我不需要看到一堆“建议换个说法”之类的废话,只想确认有没有会导致返工的隐患。
  • 多个 AI 会话正在互相修改文档的标题层级和措辞,几轮下来核心功能代码一行没动,需要有人按下暂停键并准确指出当前真正的卡点是什么。
  • 当前交付物本身就是一份证明当前逻辑的规范文档,需要审查其中是否存在会造成真实歧义的未定义边界,而不是纠结格式和排版风格。
  • AI 在没有目标代码数据的情况下对接口改动进行了复审,需要它诚实标出当前发现基于静态推断,并说明具体哪些场景仍未触碰。

适合人员

  • 经常使用 AI 辅助编程和重构的开发者,受够了模型给出大量代码风格建议而忽略核心逻辑缺陷。
  • 用 AI 维护长文档和技术规范的技术写作者,需要在 AI 评审时确保语义和逻辑严谨,而非格式排版。
  • 管理多个 AI 会话协作的工程师或技术负责人,需要防止 Agent 之间陷入无意义的文档治理空转。