五维代码技术审计
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/shipshitdev-skills-audit。
技能介绍
要解决什么问题
合并前或发版前,你往往缺一份可对照项目自身约定的技术结论:对比度、实现是否偏离 token、可访问性是否能在代码里核实。口头「大概没问题」和通用 Lighthouse 分数,都不等于「按你们 PRODUCT.md / CSS 变量 / 主题定义来说是否正确」。本技能面向的是实现层可度量项,不是视觉稿层面的设计点评。
技能如何工作
扫描前会先读取现有设计体系(CSS、tokens、主题与代表性组件),并尽力吸收仓库里的设计上下文(如 DESIGN.md、.impeccable.md 或 Copilot 指令中的 Design Context)。随后在 5 个维度上执行诊断扫描,每维按既定标准 0~4 分,汇总为结构化报告。
报告会说明问题影响、给出带文件/组件证据的修复路径建议,并做 P0~P3 优先级划分;也会记录做得好的部分,避免只列差评。默认将 P3 限于前五条(除非你要求完整 backlog)。本技能不直接改代码;修完后可再次执行审计以观察分数变化。若需求是 WCAG 全面合规、ARIA、键盘或读屏等深度议题,或 token 漂移、硬编码色值等设计一致性深挖,SKILL.md 指向可配合的 accessibility、design-consistency-auditor 等专项技能。
适用边界
这是代码级审计,不提供无证据的空泛建议,也不应在未核实情况下报假阳性。不要指望它替代人工对产品意图的判断,或在一次扫描里把所有 P3 细节穷尽列出。
使用场景
- 大改版合并前,需要按自家 CSS/token 约定核对对比度等可验证实现项并出分级清单
- 发版 checklist 缺结构化结论时,用五维 0~4 分报告替代零散人工点检记录
- 修完一批 A11y 或样式问题后重跑审计,对比各维度分数是否回升
- 仓库已有 DESIGN.md 或主题文件,希望审计结论对齐文档而非通用默认规范
适合人员
- 维护设计体系的前端,要在 MR 前拿到带文件路径与 P0~P3 的代码级问题单
- 负责发版质量的技术负责人,需要可复述的影响说明而非「感觉还行」
- 引入 Copilot/设计文档的团队,希望扫描前先读 PRODUCT/DESIGN 再打分
- 做完一轮修复的工程师,用二次审计验证分数变化而非凭印象收工