Agent Skills
返回列表
💻

五维代码技术审计

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 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 再打分
  • 做完一轮修复的工程师,用二次审计验证分数变化而非凭印象收工