用途
该技能用于指导开发者在收到代码评审反馈后、着手实现建议之前的行为方式,尤其适用于反馈内容不清晰或技术上存在疑问的情况。其核心立场是:外部反馈是待评估的建议,而不是必须服从的命令;应以技术严谨性取代社交性顺从。
主要能力
- 六步响应流程:阅读完整反馈而不急于反应、用自己的话复述需求(或提问)、对照代码库现实进行核实、评估建议是否适用于当前代码库、给出技术性确认或有理有据的反驳、逐项实现并逐项测试。
- 禁止表演式回应:不鼓励“你说得完全对”“好观点”“感谢指出”等表达,也不鼓励在验证前宣称“我现在就实现”。替代做法是复述技术要求、提出澄清问题、以技术理由反驳、或直接开始工作。
- 不清晰反馈的处理规则:若任一反馈条目不清楚,应停止实现并就先澄清;文中举例说明,评审者要求“修复第1至6项”、开发者仅理解1、2、3、6项时,错误做法是先做已理解的部分、之后再问4和5,正确做法是先说明理解范围并请求澄清4和5。
- 区分反馈来源:来自人类伙伴的反馈被视为可信,理解后即可实现,但范围不清时仍需询问,并跳过表演式认同、直接行动或作技术确认;来自外部评审者的反馈则需先检查若干问题,包括是否对当前代码库技术正确、是否破坏现有功能、现有实现的原因、是否在所有平台与版本上可行、评审者是否掌握完整上下文。若建议看似错误,应以技术理由反驳;若难以验证,应明确说明“在没有X的情况下我无法验证,是否应当调查/询问/继续”。
- YAGNI检查:当评审者建议“按规范实现”时,先在代码库中检索实际使用情况;若未被使用,可提出“该端点未被调用,是否应删除(YAGNI)”;若确有使用,再按规范实现。
- 多条目实现顺序:先澄清所有不清楚项,再按阻塞性问题(破坏、安全)、简单修复(拼写、导入)、复杂修复(重构、逻辑)的顺序处理,每项单独测试,并确认无回归。
- 适合反驳的场景:建议破坏现有功能、评审者缺乏完整上下文、违反YAGNI(未使用功能)、对当前技术栈技术不正确、存在遗留或兼容性原因、与架构决策冲突。反驳时应使用技术理由而非防御性态度,提出具体问题,引用可用的测试或代码,涉及架构问题时引入人类伙伴。
- 确认正确反馈的方式:用“已修复,简述改动”“好发现——具体问题,已在某处修复”或直接修复并在代码中体现;避免感谢类表达,理由是行动本身已表明听到了反馈。
使用方式
该技能以行为准则形式呈现,并未在资料中提供安装命令或代码示例,具体调用方式暂未提供。开发者可在收到评审反馈时按上述流程逐条执行。
适用场景
适用于日常代码评审往返、外部贡献者或自动化评审工具给出建议、多条目反馈需要排序处理、以及需要判断是否应拒绝某条建议的场合。
限制
资料未提供该技能的运行环境、平台支持、安装方式或工具集成细节;其内容为流程与沟通规范,不涉及具体代码实现或自动化执行能力。