SuperAPI AI 工具集

review-storybook

测试与质量

查看项目

更新于 10-16 03:15

技能介绍

用途:审查 Paperclip 中某个功能或改动对应的故事(story),结合 Storybook 目录、生产源码和既有浏览器测试给出结论。

主要能力:读取目录契约并在生成的索引中定位目标能力;检查相关功能配方、生产对象与故事;为改动挑选有区分度的状态,包括正常动作与结果、失败/重试、门禁/权限展示,以及受影响的移动端/主题变体;记录所选文件与导出、省略范围。审查导航/索引改动时,将指南与侧边栏同由功能配方导航元数据生成的有序完整索引对比,检查能力顺序、缺口提示、分类、配方链接与实际套件导航,并比较构建前后的入口 ID 以保证既有链接存活。

使用方式:使用既有 Storybook 命令,如 pnpm build-storybook,或在可用本地端口启动自有 Storybook 开发服务器;用构建产物 ui/storybook-static/index.json 获取真实故事 ID 与链接,不要信任默认端口上的无关服务器;保留进程句柄,只停止本次审查启动的服务器。检查真实渲染对象,包括错误与浏览器控制台输出;交互故事需等待 play 断言完成并检查可观察结果,截图本身不能证明 play 通过;故事若改动 fetch 处理器、存储、查询缓存、时间或模块状态,需重访/重置以验证夹具隔离;避免真实 provider 动作,若故事依赖实时依赖需明确记录。视觉套件为 tests/storybook-visual/storybook-visual.spec.ts,使用外部基线与固定 Linux 环境,声称视觉回归前先检查 baseline-manifest.json;未发布清单会阻断比较,macOS 截图仅供检查而非 Linux 基线,不得为让审查通过而更新/发布基线。

适用场景:需要基于 Storybook 目录与生产源码审查组件、mock、导航与交互,并区分渲染、交互、视觉比较与生产验收证据时。

限制:目录状态只是先前审查上下文,不构成当前修订的证明;本技能消费 maps/catalog,修正应归 maintain-storybook 或 maintain-verification-skill;完整源码审查需覆盖每个文件,不得把抽样描述为完整渲染或交互覆盖;生成的总览页不建立新的示例覆盖;需要后端持久化、真实授权或 provider 证明时应使用生产验证技能。报告需按通过、失败、受阻或未运行列出所选用例,并注明修订、故事 ID、环境、生产与原型对象、模拟边界、动作/断言与观察结果,不得降低期望、删除失败用例或把历史行为默认为当前行为。