code-review
Installation
SKILL.md
从三个维度评审 HEAD 与用户指定的比较基准之间的 diff:
- 规范:代码是否符合本仓库成文的编码规范?
- 规格:代码是否准确实现了来源 issue 或规格?
- 上线风险:代码合并、部署之后,是否会丢数据、破坏现有调用方、引入安全问题或拖垮性能?
评审由子代理完成,子代理数量按 diff 的规模和风险决定(见第 4 步),然后由本 skill 按三个维度分别汇总。
过程
1. 确定比较基准
用户指定的就是比较基准(提交 SHA、分支名、tag、main、HEAD~5 等)。用户没有指定时,询问用户。
记下 diff 命令:git diff <比较基准>...HEAD(三个点,与 merge-base 比较),以及提交列表命令:git log <比较基准>..HEAD --oneline。
继续之前,确认比较基准可以解析(git rev-parse <比较基准>)且 diff 不为空。无效的引用或空 diff 应该在这一步报错,而不是在子代理中报错。
把提交列表、git diff --stat 和带上下文的完整 diff(git diff -U10 <比较基准>...HEAD)写入临时目录中一个名称唯一的文件,作为评审材料。子代理读取这个文件,diff 本身不进入你的上下文。