SuperAPI AI 工具集

receiving-code-review

编程与开发

查看项目

更新于 10-16 08:49

技能介绍

用途:这是面向代码作者的评审接收技能,与评审者侧的 code-review 配套。它防止两种失误:盲从反馈导致破坏真实代码库,以及未做技术验证就表示认同的表演式配合。在 Prodcraft 中,接收评审需保留既有系统约束、已有契约、发布边界与上游决策;外部反馈是有用输入,不是自动成立的真理。

输入:review-report(评审意见、阻塞问题、提问与变更请求)、source-code(当前实现及周边代码库现实)、test-suite(用于验证每项被接受改动的现有安全网)。

流程:先完整读完评审再动手,把条目分为阻塞性修正、需澄清项、技术上可疑的建议、可选项改进,相关评论整组理解。存在歧义时先澄清再部分实现,不边猜边改;当请求行为不清、建议范围超出当前切片、可能与架构或产品边界冲突、评审者假设了 diff 中不可见的上下文时应发问。逐项对照代码库验证:是否适配当前代码与测试、是否保持兼容、是否违反 YAGNI 或引入无用复杂度、是否与已评审的架构或契约决策冲突、指出的是真实缺陷还是局部症状。正确则实施,不正确则用技术推理与证据回应,而非社交式认同。回应要陈述技术问题、改了什么、仍不清楚什么、证据相悖时为何不应采纳,避免“你说得完全对”之类填充语。按受控顺序逐项实施:阻塞性正确性或安全修复优先,范围安全的清理其次,可选或风格改进最后;每次有意义的改动后运行相关测试,若某项重开另一项须显式记录,不要静默批量修改。最后产出 review-response-record,记录每条评审项的实施、质疑或澄清状态、决策证据、接受的改动后运行的测试或检查,以及仍需评审者或用户解决的争议项。

质量关卡:实施前每条评审项均已分类;模糊反馈在部分实现前已澄清;被接受的建议已验证于当前代码库现实;必要的反驳基于技术与证据;接受的改动后重跑相关测试;最终回应说明改了什么、仍有哪些未解决。

反面模式:表演式认同、对外部评审者的盲从、部分理解就部分实现、批量修改后祈祷、上下文失忆(实施会破坏上游架构、契约或兼容约束的建议)。

限制与状态:资料未提供具体收费、价格、平台与效果信息;打包稳定性与能力就绪度均标注为 beta。公开安装面为 skills/.curated,正式编写源为 skills/05-quality/receiving-code-review/SKILL.md,该包按 npx skills add/update 兼容方式导出。