使用 receiving-code-review 有理有据地处理 PR 审查意见
機械翻訳 / Machine-translated

機械翻訳 / Machine-translated
原文:receiving-code-reviewでPRのレビュー指摘に根拠を持って対応(cccskills)
技能页面:receiving-code-review
本文结论
在 PR 中收到审查意见时,有时会纠结是否应该直接修改。
安装 receiving-code-review 后,Agent 会先将意见与代码及对应环境进行核对,再给出回复并执行修改。
本文整理了该技能的确认流程、安装方法、请求示例,以及安装前需了解的注意事项。
Agent 不会立即实现审查意见。
它会先与代码进行对照,给出附有依据的回复草案。
例如,在外部审查中被要求删除旧实现时,请求示例如下:
PR 审查中有意见指出"请删除旧有代码"。
请结合代码与对应环境,确认是否可以删除。
Agent 会读取意见,并用自己的话重新表述需求。
然后调查构建目标版本以及所使用 API 的要求。
SKILL.md 示例中给出的结论是:"构建目标为 10.15 以上,该 API 需要 13 以上。
为保持向后兼容性,旧实现是必要的。"
随后,Agent 会反问用户是否要停止对 13 以下版本的支持。
回复中不包含"您说得对"之类的附和,也没有致谢的话。
如果意见正确,就简短地说明"已修改"并告知变更内容;如果意见有误,则以代码或测试为依据进行反驳。
**不盲目接受意见,确认后再修改。
这是本技能的核心。
**
本技能按照固定的 6 个步骤处理审查意见。
判断标准是技术上是否正确,而非对方的情绪。
只要意见中有一项不明白,Agent 就会暂停实现。
因为各项之间相互关联,只理解部分内容就推进可能导致实现错误。
因此,Agent 会将明白的项目和不明白的项目分开说明,例如:"1、2、3、6 已理解,4 和 5 需要确认。"
根据意见来自用户本人还是外部审查者,处理方式有所不同,具体如下:
| 意见来源 | 处理方式 |
|---|---|
| 用户本人 | 信任处理。理解后即实现,范围模糊时提问 |
| 外部审查者 | 实现前先确认。检查以下内容:在该代码库中是否正确、是否会破坏现有功能、当前实现的原因、是否在所有环境和版本中都能运行、审查者是否了解整体背景 |
外部建议有时可能与用户此前确定的设计相冲突。
遇到这种情况,Agent 会先与用户商量。
收到"应该正式实现"的建议时,Agent 会先在代码库中搜索实际调用处。
如果没有任何地方调用,则会反问:"该端点未被调用,是否可以删除?"
这符合"不构建不必要的功能"(YAGNI)的理念。
意见较多时,解决不明之处后按以下顺序修改:
每次修改后单独进行测试,最后确认现有功能是否受到影响(是否存在回归)。
避免将所有修改一次性完成后再统一测试,这是常见的失败做法。
反驳后发现自己的错误,也不会进行冗长的道歉或辩解。
只需陈述事实:"确认后发现意见是正确的,原因是~,将进行修改。"然后继续工作。
请在终端运行以下命令。
使用 npx skills add 时,可以选择 Claude Code 或 Codex 等目标 Agent。
npx skills add https://github.com/obra/superpowers --skill receiving-code-review
如果让 Agent 帮忙安装,请原文发送以下内容:
次の Agent Skill をインストールしてください。
https://github.com/obra/superpowers/tree/main/skills/receiving-code-review
まず SKILL.md と付属ファイルの中身を確認し、不審な処理(外部への送信、認証情報の読み取りなど)がないことを確かめてから、Claude Code なら ~/.claude/skills/receiving-code-review/、Codex なら ~/.agents/skills/receiving-code-review/ に配置してください。
根据使用范围,存放位置有以下两种:
| Agent | 所有项目中使用 | 仅在特定项目中使用 |
|---|---|---|
| Claude Code | ~/.claude/skills/ | 项目的 .claude/skills/ |
| Codex | ~/.agents/skills/ | 项目的 .agents/skills/ |
技能内容仅有 SKILL.md 一个文件,不包含脚本。
它是决定 Agent 推进方式的操作手册,在本地环境中运行。
与外部通信仅限于使用 gh 命令向 GitHub 发布回复时。
请求可以用中文编写。
以下是按目的分类的 3 个示例:
请将此 PR 的审查意见与代码进行对照,区分出合理的意见和不明确的意见。
每条意见都会返回需求重新表述及与代码对照的结果。
不明确的项目会以提问形式集中呈现,说明需要确认的内容。
此阶段不进行任何修改。
审查者说"请把指标统计功能正式实现,包含数据库、日期过滤和 CSV 导出"。
请调查是否真的有必要。
Agent 会在代码库中搜索,查找对应端点的调用方。
如果没有调用,则返回确认:"未发现任何调用,是否可以删除?是否有遗漏的使用处?"
请逐一修改已达成一致的意见,并分别进行测试。
最后请确认对现有功能的影响。
修改从涉及功能或安全的意见开始,依次推进。
每修改一处就进行测试,完成后简短报告变更内容。
最后确认是否存在回归,工作结束。
最终决定修改哪些内容,请由审查者与用户协商确定。
本技能负责整理反驳依据,但涉及设计的判断需与用户商量后推进。
对于无法在本地验证的意见,Agent 会询问方针:"没有~就无法验证,请问是调查、询问还是继续推进?"
GitHub 的逐行评论会在该评论的讨论串内回复,不会作为 PR 整体评论发布。
发布使用 gh api,因此需要可以使用 gh 命令的环境。
回复文本中有意去除了感谢和附和的话语。
如果团队习惯上希望添加一句话,请在发布前自行补充。
许可证为 MIT,原文为英文。
**安装前请阅读 SKILL.md 的内容,确认流程是否符合自己的操作习惯。
**
结合 obra/superpowers 的其他技能,可以将审查前后的工作串联起来。
requesting-code-review 是在实现后或合并前向其他 Agent 请求审查的技能。
可以形成"用 receiving-code-review 确认收到的意见后再修改"的工作流。
systematic-debugging 是通过复现步骤、日志和近期变更来调查 bug 或测试失败原因的技能,适合在修改后测试出现失败时进行调查。
finishing-a-development-branch 是在实现完成后确认全部测试,并选择合并或创建 Pull Request 来推进工作的技能,适合在完成审查应对后的收尾工作。
不,反驳并不是前提。
正确的意见会直接修改,并简短告知变更内容。
只有在存在技术性理由的情况下才会反驳,例如:会破坏现有功能、审查者缺乏上下文信息、需要添加未使用的功能等。
用户本人的指示会被信任处理,理解后即实现。
但如果范围模糊,Agent 会返回提问。
逐行审查评论的回复会发布在该评论的讨论串内,不会作为 PR 整体评论发布。
receiving-code-review 是一个按照确认、回复、修改与测试的顺序处理审查意见的技能。
不明之处先集中提问,外部建议结合代码与对应环境进行核对。
修改逐一进行测试,最后确认对现有功能的影响,这是其主要特点。
如果经常遇到不确定是否应该修改意见的情况,请先在一个 PR 上试用。
详情请访问 cccskills 页面。
本文转载自 cccskills 的文章《receiving-code-reviewでPRのレビュー指摘に根拠を持って対応》。
技能详情与安装方法请参见 cccskills 的 receiving-code-review 页面。