SuperAPI AI 工具集

receiving-code-review

编程与开发

查看项目

更新于 11-05 17:18

技能介绍

该技能面向在编写代码过程中接收代码评审反馈的开发者,强调“代码评审需要技术评估,而非情绪表演”。其核心原则是:先验证再实现、先询问再假设、技术正确性优先于社交舒适。

主要能力体现在一套固定的响应流程上:收到反馈后,先完整阅读且不急于反应;用自己的话复述需求或提问;对照代码库实际情况进行核实;评估该建议对本代码库是否技术合理;作出技术性确认或有理有据地反驳;最后逐项实现并逐项测试。文档明确禁止表演式回应,如“你完全正确!”“好点子!”“感谢指出”等,也禁止在验证之前就说“我现在就实现”;替代做法是复述技术需求、提出澄清问题、用技术理由反驳,或直接动手做事。

使用方式上,文档要求先澄清所有不清楚的条目再实现,因为条目之间可能相关,部分理解等于错误实现。对于来自人类伙伴的反馈,可信任但范围不清时仍需询问;对于外部评审者的反馈,则需核查建议是否对本代码库技术正确、是否破坏现有功能、现有实现的原因、是否兼容所有平台与版本、评审者是否了解完整上下文;若难以验证,应直言“没有 X 我无法验证,需要我去调查/询问/继续吗”;若与人类伙伴此前决策冲突,应先停止并与伙伴讨论。文档还针对“实现得更完善”这类建议提出 YAGNI 检查:先用 grep 搜索代码库中的实际调用,若未被使用则建议移除。实现顺序为:先澄清不清楚项,然后依次处理阻塞问题(破坏性、安全性)、简单修复(拼写、导入)、复杂修复(重构、逻辑),每项单独测试并检查回归。文档列举了应当反驳的情形(建议破坏现有功能、评审者缺乏上下文、违反 YAGNI、对该技术栈不正确、存在遗留/兼容性原因、与伙伴架构决策冲突)及反驳方法(用技术理由而非防御心态、提出具体问题、引用可运行的测试或代码、涉及架构时引入人类伙伴)。当反馈正确时,确认方式为直接说明修复内容或展示代码,不使用任何感谢表达。若反驳出错,应事实性说明纠正后继续,不做过长道歉或辩解。

适用场景包括:在收到代码评审意见后决定是否及如何实施、处理含糊或技术上可疑的反馈、区分内部伙伴与外部评审者的反馈、对多条目反馈安排实现顺序。限制方面,该资料为工作方法与行为规范,不包含安装命令、代码示例实现或工具参数;文中提到的 GitHub 回复方式涉及 gh api repos/{owner}/{repo}/pulls/{pr}/comments/{id}/replies 命令,属于操作指引而非常规安装步骤。