requesting-code-review
在完成任务、实现主要功能或合并之前使用,以验证工作符合需求。
技能说明obra/superpowers
在完成任务、实现主要功能或合并之前使用,以验证工作符合需求。
技能简介
这个技能用于在完成任务、实现主要功能或合并代码前,自动派发一个代码审查子代理(subagent)来评估工作成果,避免问题累积和扩散。它不会把整个会话历史交给审查者,而是提供精准上下文,让审查更聚焦、更高效。核心原则:尽早审查、频繁审查。
使用场景
- 子代理驱动开发中,每完成一个任务后
- 完成一项主要功能后
- 合并到主分支前
- 遇到困难时,获取新的视角
- 重构前做基线检查
使用方法
- 获取 git SHA 作为审查范围:
BASE_SHA=$(git rev-parse HEAD~1) # 或 origin/main
HEAD_SHA=$(git rev-parse HEAD)
- 派发一个
general-purpose子代理,按code-reviewer.md模板填写以下占位符:
{DESCRIPTION}:所做工作的简要总结{PLAN_OR_REQUIREMENTS}:期望的行为或需求{BASE_SHA}:起始提交{HEAD_SHA}:结束提交
- 根据反馈行动:
- 立即修复 Critical 问题
- 继续前修复 Important 问题
- Minor 问题稍后处理
- 若认为审查有误,提出技术理由反驳
注意事项
- 不要因为“改动简单”就跳过审查。
- 不要忽略 Critical 问题,也不要带着未修复的 Important 问题继续推进。
- 不要把整个会话历史作为上下文——给审查者精确的任务背景即可。
- 审查者若判断错误,可用代码或测试证明,并请求澄清。