SuperAPI AI 工具集

sb-audit

通用与其它

查看项目

更新于 10-16 01:13

技能介绍

用途:作为 Storybook 的周期性检查关卡,普查组件目录、播种审计台账,并指出可合并的候选对象。

主要能力:

  • 命名漂移审计:audit-drift.sh 跨 stories 检查命名漂移。
  • 归档保存监督:audit-archived.sh 做 L1/L2/L3 保存监督(HEAVY 警告)。
  • 决策复查:find-stories-by-tag.sh decision:pending 找出需提醒的过期决策。
  • 用量提取:extract-component-usage.sh 刷新真实 prop 用量到 component-usage.json,自动生成、无需手改。
  • Controls 覆盖审计:audit-controls.sh . 检查缺少 argTypes + manager showPanel 的组件故事。
  • 一键刷新:refresh-usage.sh --docs . 汇总组件、token、路由、健康 JSON 并重新生成各组件 usage MDX。
  • 应用流与组件清单:若存在 .storybook/scripts/extract-app-graph.mjs 则重新运行并校验 app-graph.json。

使用方式:命令需在相应脚本目录下运行,SKILL 与 CORE 取自 CLAUDE_PLUGIN_ROOT。不要一次冷启动全部六项:先跑 audit-drift.sh(成本低,能给出合并候选);audit-archived.sh 较重,约少于 20 个选定 stories 时可跳过;检查覆盖时跑 audit-controls.sh 与 extract-component-usage.sh;refresh-usage.sh --docs 应最后运行,不要与它已取代的单项提取器同时跑。审计结论追加写入 .storybook/audit/findings.md(带时间戳、只追加),需要时提示 git add .storybook/audit/ 提交台账;超出故事范围的真实生产问题标记为 LOG-ONLY: 仅记录。

适用场景:Storybook 目录治理、命名与决策漂移检查、Controls 覆盖检查、用量与文档自动刷新、归档候选修剪。

限制:部分能力需先存在相应脚本与文件;归档扫描成本高;未提供具体版本、收费与平台信息。