SuperAPI AI 工具集

engineering-review-feedback

编程与开发

查看项目

更新于 10-29 13:28

技能介绍

用途 该技能面向以变更作者身份处理代码评审反馈的场景,包括回复评审意见、起草答复、解决分歧和汇总更新。其核心理念是把评审当作协作改进代码的过程,优先修改代码、测试或注释,让未来的读者受益,而不是只在评审线程里解释。

主要能力 提供一套响应工作流:在情绪受挫时先暂停再回复;识别评审者的真实诉求;将每条意见归类为代码修改、测试修改、文档或注释修改、需要澄清、需讨论的分歧、非阻塞建议。随后优先改进产物而非在评审工具中解释,运行相关验证,并回复改了什么、为什么改、如何测试。

使用方式 针对同意、需澄清、不同意等情形给出应对方式与示例措辞:同意时简短回复并完成修改;需澄清时询问缺失的决策或约束,避免防御性措辞;不同意时比较权衡而非否定对方,若对方技术理由更好则接受并调整,无法达成一致则转为更高带宽的沟通并在评审中回写结论。对不具建设性的反馈,不针锋相对,提取可在代码、测试或文档中解决的技术关切,必要时转入私下沟通或请负责人介入。

还说明「在正确的地方修复」:表达混乱则简化或重命名;隐藏不变量则用类型、校验、断言或聚焦注释编码;行为信心不足则补充测试;缺少上下文则更新 PR 描述、注释、README 或设计文档;因过时 diff 导致的误解则 rebase、删除死代码或更新描述;纯偏好则询问是否必须,否则视为可选。并给出汇总回复模板(本轮已处理、验证命令、待办)与常见错误清单,如愤怒或讽刺回复、只在评审线程解释难懂代码、把每条建议都当强制、用「以后再清理」推迟当前引入的复杂度、借窄评论做无关大范围重构。

适用场景与限制 适用于代码评审中的反馈处理与沟通。资料注明其内容改编自 Google Engineering Practices Documentation(CC-BY 3.0),另在 agentara/skills 以 MIT 发布。该技能不涉及具体工具集成、自动化命令或平台功能,相关能力暂未提供。