SuperAPI AI 工具集

pragmatic-code-review

智能体与模型

查看项目

更新于 10-16 05:54

技能介绍

Pragmatic Code Review 用于对用户明确指定的代码范围做一次完整、可审计的代码审查。其目标是让所有已知的必需审查工作都进入一份可审计的审查轨迹(Auditable Review Trace),并在最终复查未发现新缺口后才算完成,之后才输出最终报告。

主要能力:按用户指定的质量级别 L1–L5 审查(未提供时默认 L3 并说明);以“检查触发项”作为唯一的数值触发标准,包括函数有效逻辑行数、必需参数个数、最大嵌套深度、同一重复知识的确认出现次数、源文件行数;违规判定为测量值严格大于该级别触发值,等于触发值不算违规。加载八类规则包:设计与可维护性、测试、安全与隐私、契约与兼容性、可靠性与运维、依赖与构建、文档、研究可复现性。报告每个问题需附带具体代码证据与可信后果,并按严重度分为 Critical、Important、Minor,排序为 Critical → Important → Minor,组内按代码位置排序。

使用方式:先确定质量级别,再将审查范围解析为完整文件列表并展示依据与文件数,然后加载全部八个规则包,完整阅读每个范围内文件、记录指标并追踪发现,做全范围检查(跨文件影响、重复知识、依赖方向、契约等),最后执行最终复查并输出报告。范围缺失时向用户询问并等待,这是审查中唯一的问题;目标不存在时按空范围完成审查并报告该事实。小文件集由主智能体单独处理,中等批量用一个子智能体,仅当文件组相互独立且无共享状态时才并行子智能体;每个子智能体须被指示加载并使用本技能并说明质量级别。

限制与边界:不读取被 .gitignore 忽略的路径(可能含密钥)。格式、命名约定和未使用导入交给 linter 和 formatter,除非有超出风格的具体后果。文档与代码矛盾及误导性注释属于发现项。规则冲突时优先使用最直接相关来源,仍冲突则连同冲突证据一并报告交由用户裁定。仅凭指标违规的严重度为 Important,不得仅因指标判为 Critical。除上述资料外,官方文档、收费与平台支持等信息暂未提供。