SuperAPI AI 工具集

exemplar-review

编程与开发

查看项目

更新于 10-16 05:46

技能介绍

exemplar-review 是一个用于代码 diff 审查的技能,关注本地审查者通常看不到的两个维度。

用途:一是 Prior-art(先例),判断 diff 是否重复造轮子或偏离了熟练实践者会采用的社区标准工具、库或惯用法;二是 Excellence-bar(卓越标准),判断改动是否达到公认范例所要求的水准,例如 Apple 级 UI、Stripe/Vercel 级文档、Jobs 级范围控制、Reitz 级 API 人体工学。常见的正确性、简化与可维护性审查在既定方案内优化,而它质疑方案本身并评估品味。

主要能力:先读取 diff 并按工件 × 维度分类(文件类型、导入、框架、改动内容),依据 REFERENCE.md 的路由表选取 1 到 2 个范例,并用一行说明路由依据。随后对每个范例运行两种模式:模式 A(prior-art)指名既有工具或模式,给出其规范用法,说明替换什么、删除什么;模式 B(excellence-bar)把范例标准拆解为可观察标准的量规,逐项打分并针对每个差距给出具体修复。最后按杠杆排序汇总发现,标注置信度与权衡。

使用方式:可独立运行,对当前 diff 或指定目标执行 /exemplar-review;也可嵌入编排器(例如作为 /review-fix 下的额外审查者),此时只报告不编辑,并返回每行一个带修复与置信度的 Top fixes 列表,供编排器与其他审查者一同分诊。

限制与规则:每项发现必须基于范例可引用的已发布作品或文档化原则,不得编造“X 会说”。模式 B 必须输出量规,禁止“让它更像 Apple”这类空泛表述;没有公开可观察输出的通用“天才”人设应拒绝路由。需尊重仓库约定、用户已声明的风格与既定范围,违反硬约束的修复不算修复。需防范权威偏见,不确信就说明,按技术价值辩护。在 /review-fix 下运行时只读,不得编辑、提交或推送。若一次运行只是重复正确性或风格小问题,说明路由错误或过于笼统。