mcpField
S
spectrum-audit

spectrum-audit

github.com/zzci测试与质量262 次安装3 天前更新
代码仓库

关于 spectrum-audit

Spectrum Audit 是用于检查 React Spectrum S2 项目的审计技能，生成带评分和优先级的报告，且不会修改代码。它要求项目已安装 @react-spectrum/s2，并覆盖配置、组件、样式、无障碍、维护和测试。

主要功能

  1. 01检查 S2 配置与组件用法
  2. 02审查样式和无障碍问题
  3. 03覆盖版本维护与测试
  4. 04计算分类及总体评分
  5. 05生成优先级审计报告

适用场景

  1. 01评估项目对 Spectrum 设计系统的遵循情况
  2. 02定位 React Spectrum S2 的配置问题
  3. 03整理组件、样式或无障碍缺陷

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/zzci/skills --skill spectrum-audit

安装后在 Claude Code 中输入/spectrum-audit确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
report-template.md
scoring-rubric.md
references/checks/
01-setup-config.md
02-component-usage.md
03-styling.md
04-accessibility.md
05-versioning.md
06-testing.md

详细介绍

Spectrum 审计

审计代码库是否遵循 Spectrum 设计系统和 React Spectrum S2 最佳实践，然后生成带评分、按优先级排序的报告。此技能仅生成报告，不会修改任何文件。

适用场景

当开发者要求审计、审查、检查或 lint 项目的 Spectrum / S2 正确性、配置、样式、无障碍性或组件使用问题时使用。

要求项目已安装 @react-spectrum/s2。如果 S2 不是项目依赖，请说明并停止。

工作方式

按顺序执行以下阶段。

阶段 0 — 确定范围
  • 确定要审计的项目；如果是 monorepo，则确定要审计的具体软件包。审计软件包，而不是工作区根目录。
  • 根据锁文件检测包管理器和打包工具（Vite / webpack / Next.js / Parcel / Rollup / ESBuild），并读取 package.json 依赖。
  • 确认已安装 @react-spectrum/s2。确定要扫描的源码 glob（例如 src/**/*.{tsx,jsx,ts,js}）。
  • 检查是否可用 react-spectrum-s2 技能（列在 Agent 已安装技能中，或位于本地技能目录下，例如 .cursor/skills/ 或 .agents/skills/）。记录是否找到；报告模板会用到此信息。
阶段 1 — 执行检查

按顺序检查 references/checks/ 中的每个检查文件。对于每项违规，记录一条发现：{file:line, rule, severity, category, fix}。只引用实际读取或通过 grep 查到的行号，切勿编造位置。对于同一根本原因，在某个 file:line 处只记录一条发现；如果多个检查文件覆盖同一问题（例如缺少集合 aria-label 或使用第三方设计系统），应归入最具体的检查，不要在多个类别中重复记录。

这些检查所依据的规范规则位于 react-spectrum-s2 技能中；请根据需要阅读其 SKILL.md（实现指南）、references/guides/getting-started.md、references/guides/component-decision-tree.md 和 references/components/。如果未安装该技能，请仅使用检查文件继续，但要在报告中注明此限制（参见阶段 3）。

阶段 2 — 评分

根据记录的发现应用评分标准，计算各类别得分和整体 Spectrum 遵循度得分。分数必须根据发现数量进行计算，不要估算。

阶段 3 — 报告

按照报告模板，在已审计的项目中编写 SPECTRUM-AUDIT.md：包含醒目的得分、等级和严重程度计数；摘要；各类别得分；按严重程度分组的发现（每项均包含可点击的 file:line 和定义对应规则的检查名称）；按优先级排列的行动项；表现良好的方面；以及——如果阶段 0 未检测到 react-spectrum-s2——安装该技能的建议。

阶段 4 — 交接

此技能不会编辑代码。请推荐：

  • 使用 react-spectrum-s2 技能实施修复。如果未安装：

    npx skills add https://react-spectrum.adobe.com --skill react-spectrum-s2

  • 如果存在 Spectrum 1 软件包（@adobe/react-spectrum、@react-spectrum/*、@spectrum-icons/*），请推荐使用 migrate-react-spectrum-v3-to-s2 技能。

评论

支持 Markdown