在 AzerothCore,我们追求高质量的代码,正因如此我们有一套流程,要求所有提交 AI 辅助 PR 的贡献者认真运行一次 /self-review 会话。
这一步的目标是确保你的 PR 不会引入任何回归或非预期的副作用,从而保持整体代码质量。
这会耗费你额外的时间和 token。 比起更多低质量的 AI 凑数 PR,我们更希望有更少但质量更高的 PR。
/self-review 技能是 agent-toolkit 开源工具集的一部分。
你可以这样快速安装:
git clone https://github.com/eai-org/agent-toolkit.git && cd agent-toolkit && ./install.sh
并记得定期用以下命令保持更新:
cd agent-toolkit && git pull && ./install.sh
自我评审必须使用强大的模型,例如 Claude Fable、GPT Sol,或者至少是 Claude Opus 或同级别的领先模型。
不要使用便宜的模型,因为它们无法产出高质量的结果。
不要试图作弊:维护者随时可以在你的 PR 上运行同样的流程并比较结果。
在本地检出你 PR 的分支,打开你的 AI 智能体,然后运行:
/self-review
这会花费一些时间。请耐心等待。
检查完你的代码后,智能体会提出发现的问题,并给出哪些应该处理的建议。由你来决定。
请仔细检查:不要盲目接受你不确定的改动。如果有任何不清楚的地方,请智能体进一步解释。
评审会持续进行,直到没有需要处理的发现为止。
自我评审会生成一个 <slug>.SELF-REVIEW.md 产物(位于 .agents/plans/<slug>/ 目录),其内容可以直接逐字复制粘贴到你的 PR 评论中。
请勿手动修改该产物的内容,也请勿将该产物文件本身提交到你的 PR 中。
团队保留关闭任何未提供此类产物的 PR 的权利。
就是这样。
/self-review 技能的行为由两部分定义:
另外请记住,技能被指示检查 AzerothCore 仓库中的任何相关治理文档,例如 .agents/docs/ 下的其他文档,当然还有 AGENTS.md 文件。
要对这些内容进行修改,请始终调用以下技能:
*.md 文件时使用 /compact-docs-writer/compact-skill-creator