SuperAPI AI 工具集

alignment-review

通用与其它

查看项目

更新于 10-15 22:15

技能介绍

用途:审查代码变更中的缺陷,并检查其是否符合 OpenEnv 原则与 RFC,适用于审查 PR、提交前检查或收到审查请求时。

主要能力:采用两级模型。Tier 1 为无争议问题,可直接修复,包括 lint 失败、调试代码(print、断点)、未初始化变量、类型错误、缺失导入、语法错误、安全问题(凭据泄露、注入漏洞)。Tier 2 为对齐讨论点,需人工判断,包括原则冲突(如新增外部奖励计算、客户端导入服务端代码、API 偏离 Gymnasium 模式)与 RFC 冲突(即使 RFC 处于 Draft 或 In Review 状态也应标记)。

使用方式:先运行自动化检查:bash .claude/hooks/lint.sh 与 bash .claude/hooks/check-debug.sh。再阅读 .claude/docs/PRINCIPLES.md、.claude/docs/INVARIANTS.md,并扫描 rfcs/ 目录,记录各 RFC 状态(Draft、In Review、Accepted、Implemented),重点关注 Draft 与 In Review。随后用 git diff 或提供的 diff 分析变更,识别 Tier 1 机械问题,标记 Tier 2 对齐关切与 RFC 冲突。Tier 2 输出格式为 ALIGNMENT FLAG,含原则/RFC、关切描述与建议审查者(可结合 git blame 定位 PRINCIPLES.md、INVARIANTS.md 相关行作者及冲突 RFC 作者)。

输出格式:Alignment Review Report,含自动化检查结果、开放 RFC 上下文、Tier 1 待修复项、Tier 2 对齐讨论(原则冲突与 RFC 冲突)及汇总。

限制:资料未提供安装方式、收费、平台支持与效果数据;具体审查者需按实际仓库信息确定。