SuperAPI AI 工具集

self-review-guide

通用与其它

查看项目

更新于 10-16 05:07

技能介绍

用途:分析 git diff,生成 self-review 会在其输出文件旁自动发现的导览 XML(review.guide.xml)。它只回答“人应该按什么顺序、带着什么背景读这份 diff”,不做评审结论。

主要能力:把按字母排序的文件树重组为 2–5 个命名分组,给出每组理由、每个文件在本次变更中的一句话角色说明,以及首个文件前展示的整体概览。文档顺序即阅读顺序;每个 diff 文件最多出现在一个组中,未列入的文件由消费者放入隐式“Everything else”组,不会被隐藏。

使用方式:读取 $ARGUMENTS 作为 git diff 参数,为空则默认未暂存变更(git diff);支持 --staged、HEAD~3、main..feature-branch、-- path/to/file 等,也支持 GitHub PR / GitLab MR URL。读取 .self-review.yaml 的 output-file 与 guide-file 确定输出路径,默认由 review.xml 推导为 review.guide.xml。用 git diff $ARGUMENTS 取 diff,空则停止;用 git rev-parse --show-toplevel 取仓库根。按 XSD 构建 XML 后用 xmllint --schema .agents/skills/self-review-guide/assets/self-review-guide-v1.xsd GUIDE_XML_PATH --noout 校验,失败则修正重试;未安装 xmllint 则警告并跳过。最后打印文件数、分组名与输出路径,并提示用 self-review <same-diff-args> 自动加载。

限制:只做呈现与排序,不隐藏、不折叠、不标记可跳过;禁止出现 skip、ignore 等措辞,也不得给出严重性、置信度、缺陷或评论(那是 self-review-critique 的职责)。rationale 与 description 为单句纯文本,overview 为 Markdown。路径为仓库相对路径,重命名文件用新路径;过期条目会被静默丢弃。校验不通过的导览会被 self-review 静默忽略。具体收费、平台支持等资料暂未提供。