代码审查Skill code-review

这个技能专注于代码审查的最佳实践,包括以技术严谨性接收反馈、使用代码审查子代理进行系统审查,以及在做出任何完成声明之前进行验证,旨在提高软件开发质量、防止虚假完成声明并促进团队协作。关键词:代码审查、技术评估、验证、DevOps、软件质量、代码质量、CI/CD、拉取请求。

DevOps 0 次安装 0 次浏览 更新于 3/15/2026

name: 代码审查 description: 在接收代码审查反馈时使用(特别是如果反馈不明确或技术上可疑),在完成任务或需要审查后才能继续的主要功能时,或在做出任何完成/成功声明之前使用。涵盖三种实践 - 以技术严谨性接收反馈而非表演性同意,通过代码审查子代理请求审查,以及在做出任何状态声明之前需要证据的验证门。对于子代理驱动开发、拉取请求和防止虚假完成声明至关重要。

代码审查

指导正确的代码审查实践,强调技术严谨性、基于证据的声明和验证而非表演性响应。

概述

代码审查需要三种不同的实践:

  1. 接收反馈 - 技术评估而非表演性同意
  2. 请求审查 - 通过代码审查子代理进行系统审查
  3. 验证门 - 在任何完成声明之前提供证据

每种实践都有详细的触发条件和协议,在参考文件中。

核心原则

始终遵循 YAGNIKISSDRY 原则。 诚实、直接、简洁。 技术正确性优先于社交舒适度。 在实施前验证。在假设前询问。在声明前提供证据。

何时使用此技能

接收反馈

触发时机:

  • 从任何来源接收代码审查评论
  • 反馈似乎不明确或技术上可疑
  • 需要优先处理多个审查项目
  • 外部审查员缺乏完整上下文
  • 建议与现有决策冲突

参考: references/code-review-reception.md

请求审查

触发时机:

  • 在子代理驱动开发中完成每个任务后
  • 完成主要功能或重构后
  • 在合并到主分支之前
  • 卡住并需要新视角时
  • 修复复杂错误后

参考: references/requesting-code-review.md

验证门

触发时机:

  • 即将声称测试通过、构建成功或工作完成时
  • 在提交、推送或创建PR之前
  • 移动到下一个任务时
  • 任何暗示成功/完成的声明
  • 表达对工作的满意度时

参考: references/verification-before-completion.md

快速决策树

情况?
│
├─ 接收反馈
│  ├─ 不明确项目? → 停止,首先请求澄清
│  ├─ 来自人类伙伴? → 理解,然后实施
│  └─ 来自外部审查员? → 在实施前技术验证
│
├─ 完成工作
│  ├─ 主要功能/任务? → 请求代码审查子代理审查
│  └─ 合并前? → 请求代码审查子代理审查
│
└─ 即将声称状态
   ├─ 有新鲜验证? → 用证据声明
   └─ 没有新鲜验证? → 首先运行验证命令

接收反馈协议

响应模式

阅读 → 理解 → 验证 → 评估 → 响应 → 实施

关键规则

  • ❌ 无表演性同意:“你完全正确!”、“好观点!”、“感谢[任何内容]”
  • ❌ 在验证前不实施
  • ✅ 重述要求、提问、用技术推理推回,或直接开始工作
  • ✅ 如果不明确:停止并首先请求所有不明确项目的澄清
  • ✅ YAGNI检查:在实施建议的“正确”功能前,grep使用情况

来源处理

  • 人类伙伴: 可信 - 理解后实施,无表演性同意
  • 外部审查员: 验证技术正确性,检查是否破坏,如果错误则推回

完整协议: references/code-review-reception.md

请求审查协议

何时请求

  • 在子代理驱动开发中每个任务后
  • 主要功能完成后
  • 合并到主分支前

过程

  1. 获取git SHAs:BASE_SHA=$(git rev-parse HEAD~1)HEAD_SHA=$(git rev-parse HEAD)
  2. 通过Task工具派遣代码审查子代理,包含:WHAT_WAS_IMPLEMENTED, PLAN_OR_REQUIREMENTS, BASE_SHA, HEAD_SHA, DESCRIPTION
  3. 根据反馈行动:立即修复关键问题,在继续前修复重要问题,记录次要问题稍后处理

完整协议: references/requesting-code-review.md

验证门协议

铁律

没有新鲜验证证据,不做完成声明

门功能

识别命令 → 运行完整命令 → 读取输出 → 验证确认声明 → 然后声明 跳过任何步骤 = 撒谎,未验证

要求

  • 测试通过:测试输出显示0失败
  • 构建成功:构建命令退出0
  • 错误修复:原始症状测试通过
  • 要求满足:逐行检查清单已验证

红旗 - 停止

使用“应该”/“可能”/“似乎”,在验证前表达满意度,未验证就提交,信任代理报告,任何暗示成功而未运行验证的措辞

完整协议: references/verification-before-completion.md

与工作流集成

  • 子代理驱动: 每个任务后审查,在移动到下一个前验证
  • 拉取请求: 验证测试通过,在合并前请求代码审查审查
  • 一般: 在任何状态声明前应用验证门,对无效反馈推回

底线

  1. 技术严谨性优先于社交表现 - 无表演性同意
  2. 系统审查流程 - 使用代码审查子代理
  3. 证据先于声明 - 始终验证门

验证。提问。然后实施。证据。然后声明。