SuperAPI AI 工具集

alignment-review

通用与其它

查看项目

更新于 10-16 00:29

技能介绍

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

主要能力:采用两级模型。Tier 1 为无争议问题,可直接修复,包括 lint 失败、调试代码(print、断点)、未初始化变量、类型错误、缺失导入、语法错误及安全问题(凭据泄露、注入漏洞)。Tier 2 为对齐讨论点,需人工判断,包括原则冲突(如新增外部奖励计算、客户端导入服务端代码、偏离 Gymnasium 模式的新 API)与 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;随后用 git diff 或提供的 diff 分析变更,识别 Tier 1 问题、标记 Tier 2 对齐与 RFC 冲突。Tier 2 需按指定格式输出 ALIGNMENT FLAG,注明涉及的原则或 RFC 编号、具体顾虑及建议审查者(可结合 git blame 定位原则与不变量的作者及冲突 RFC 作者)。最终报告包含自动化检查结果、相关开放 RFC 背景、Tier 1 待修复清单、Tier 2 原则冲突与 RFC 冲突,以及问题数量汇总。

限制:资料未提供该技能的安装方式、依赖环境、支持平台、收费与效果信息;其检查依赖项目内 .claude 目录下的脚本与文档,以及 rfcs/ 目录结构。