Audit 是 playful-design/router 技能合集中的一个审查技能,用于对照该合集中的每一项技能规则审查工作成果,并返回一份带编号、按优先级排序的报告。
用途 该技能一次审查多项关注点,将每个关注点交给拥有对应规则的技能处理,再把结果合并为一份报告。它本身不拥有任何界面规则,只负责审查范围、审查顺序、结果整合和最终结论。每条发现必须引用所属技能中的规则编号,并且需要有来自代码、运行中的应用或对话线程的证据,不能仅凭个人偏好。报告格式定义在 report.md 中。
主要能力
- 声明范围:明确指出审查对象,如未提交的 diff、某个分支、某个拉取请求、本次会话中的请求或整个代码库。未声明范围的审查会记为 audit-state-the-scope。
- 先读项目规则:读取 AGENTS.md、CLAUDE.md 及编辑器规则目录;书面项目规则优先于这里的默认规则。对遵循书面规则的代码提出问题会记为 audit-project-rules-first。
- 运行每一项技能:对照每项技能检查范围内内容,并记录检查了什么。涉及 verify、scope、reuse、restraint、copy、prose、defaults、motion、color、gather、match、rule、viewports、ship 等检查项,例如在运行应用中打开每个改动面、核对线程中每个请求与 diff、检查新组件样式图标是否复用共享包、检查未请求的 UI 设置回退死代码等。无理由跳过某项技能会记为 audit-run-every-skill。
- 按根本原因合并:同一原因违反多项技能规则时合并为一条发现并标注多个编号;同一本地修法出现在五处调用点时合并为一条发现并列出五个位置。逐条罗列症状会记为 audit-one-row-per-cause。
- 编号并打开报告:按严重程度、再按影响范围排序并编号,方便用户回复“修复 1、2 和 5”。将 report.html 复制到 .audit/<scope>/index.html(被忽略的文件夹,绝不能是源码树),在旁边按头部注释所示结构写入 report.js,然后打开。报告外观随技能提供,因此只写数据;自带标记或样式的页面会记为 audit-shipped-report。
使用方式 用户通过 Pick 标记发现,用 Copy Picks 复制并粘贴回来;随后等待用户选择,只修复被选中的编号项。在用户挑选前修复全部问题会记为 audit-fix-what-was-picked。
适用场景 适合需要对一次改动、一个会话或整个代码库做集中、结构化审查的开发者,尤其适用于已有成文项目规则、希望审查结论可追溯、可选择性修复的团队。
限制 该技能本身不定义界面规则,结论依赖合集中其他技能的规则;必须有代码、运行应用或对话线程中的证据;报告需使用随技能提供的外观,只写数据;未打开或未阅读的工作不得给出 Approve 结论。当仍有任何 HIGH 级别问题时结论为 Block,否则为 Approve。