用途：shadscan 是针对 shadcn/React 应用的确定性静态分析器，用于衡量并提升 shadcn 组件质量，并可在 CI 中以最低分作为合并门禁。每次运行结果一致，面向终端与 CI 设计。此 skill 本身是驱动器，实际修复由具备 shadcn 能力的智能体完成。
评分维度：给出一个 0–100 总分和字母等级，覆盖六类：foundation（基础组件设置、tokens、结构正确性）、interaction（指针/键盘交互接线）、states（hover/focus/active/disabled/loading/error 覆盖）、accessibility（标签、角色、ARIA、对比度、键盘可达性）、forms（表单组合、校验、字段与标签关联）、production-polish（空状态、响应式、收尾细节）。
常用命令：审计项目或路径用 npx @shadscan/cli [path]；机器可读报告（schema v4）用 npx @shadscan/cli --json；供 AI 智能体粘贴的 Markdown 交接用 npx @shadscan/cli --format prompt；直接启动已安装的编码智能体用 npx @shadscan/cli --apply --agent claude（或 codex | grok）；只审计某一类用 --category accessibility；CI 门禁用 --fail-under 85；CI/日志中立文案用 --json --no-roast；安装 pre-commit 钩子用 npx @shadscan/cli setup --pre-commit。其他标志：--no-interactive（脚本中始终使用）、--roast、--version、--help。
使用方式：采用 审计→修复→重评分 循环。先跑基线并记录分数、等级和分类明细；再用 --format prompt 获取交接内容；按分数最低的类别优先修复，不要直接编辑 components/ui/*.tsx 源码，应通过 className/props 定制或用 shadcn@latest add <c> --overwrite 重新添加；只重扫改动过的路径或类别，确认分数上升，重复直到达到目标分数或 --fail-under 通过；最后报告前后分数差与变动类别。类别与修复者知识映射：accessibility、states、forms 对应 Ridd 的清单与表单模式；foundation、interaction、production-polish 属组合与应用集成，结构性或数据绑定问题交给 nextjs（Theo），表现层保留给 Ridd。
适用场景与限制：适合需要可重复 UI 质量评估的 shadcn/React 项目、CI 门禁与本地 pre-commit 检查。交接模式分建议式（默认 --format prompt）与直接式（--apply --agent）。CI 由测试方拥有门禁。详细标志列表、JSON schema 说明、可直接使用的 Action 工作流和分类修复手册见 references/reference.md。是否收费、价格、平台要求等资料暂未提供。