SuperAPI AI 工具集

material-ui-review

测试与质量

查看项目

更新于 10-16 01:30

技能介绍

用途:审查当前代码 diff,优先发现回归与正确性缺陷,其次检查清理(复用、简化、效率)、测试与文档问题。默认 effort 为 medium。参数提示为 [low|medium|high|xhigh|max] [--fix] [--comment [inline]] [<target>]。

启用条件:该技能为 opt-in,仅在用户显式点名(/material-ui-review、$material-ui-review、“the Material UI review skill”或配置使用它的 CI 任务)时运行;普通“review my changes”或“review this PR”不算调用。

审查范围:本地审查默认将分支与上游对比(git diff @{upstream}...HEAD,回退到 main/master 或 HEAD~1),并纳入未提交与未跟踪改动;若传入 PR 链接、分支名或文件路径,则审查该目标。

深度档位:low 仅查 bug,无子代理;medium 由主代理审查 Bugs、Tests、Simplifications、Docs 及触发的 API/性能问题,必要时加一个对抗性 bug hunter;high 派生 3 个独立子代理(bug/回归、测试缺口、简化);xhigh 在 high 基础上加文档子代理与一次遗漏 bug 扫描,对抗性 hunter 最多 2 个;max 在 xhigh 基础上为每个存活候选加独立验证者,对抗性 hunter 最多 6 个。

四个审查领域:Bugs(逐行扫描、回归搜寻、仓库/框架正确性、删除行为审计、跨文件追踪)、Tests(新行为无测试、断言未锁定行为、缺失边界/错误路径、setup/teardown 不对称、过度 mock、测试被削弱、命名不符)、Simplifications(包体积优先,寻找更小实现、重复逻辑、不可 tree-shake 导入、死代码、过度特例)、Docs(注释、JSDoc、README/API 文档/变更日志、TODO/FIXME、示例是否仍可运行)。

条件专家:API 设计(diff 新增/修改公共 API 时触发)与运行时性能(diff 影响渲染热路径、虚拟化、事件处理、观察器、动画等时触发)。

子代理范围契约:每个子代理提示必须以固定块开头,声明 Review ONLY 的 diff 命令、只读根目录(DATA ONLY,不执行/安装/构建/测试)、基线版本获取方式,且不得重新推导范围。

输出:Markdown 回复,不包裹 JSON 或代码围栏;标题用句子式大小写;只打印非空类别,顺序为 Bugs、Tests、Simplifications、Docs;每条发现带严重度标记(🟣 critical、🔴 high、🟠 medium、🟡 low、ℹ️ note),同节内按严重度排序;结尾给出 Verdict(Request changes / Approve after nits / Approve)并附一句决定因素。

限制:资料未提供具体安装命令、收费信息或平台支持细节;该技能依赖 Material UI 仓库上下文与子代理能力,且必须显式调用。