SuperAPI AI 工具集

maintain-storybook

写作与研究

查看项目

更新于 10-16 03:15

技能介绍

用途:维护 Paperclip 的 Storybook 故事及其下游目录,使其与功能地图和生产 UI 对齐。适用于核对故事漂移、对原型分类、更新目录索引。该技能拥有故事、其 fixtures/support 以及 maps/storybook-map/,但不编辑功能地图或 agent-access 地图;上游漂移需报告给 maintain-verification-skill 并附来源证据。

主要能力:按能力 ID 将功能/变更关联到目录条目与共享依赖;对全量清单覆盖每个已配置故事文件(含历史示例)。比较受影响故事的渲染主体、props、fixture 响应、动作与断言和生产实现及配方。检查 mock 方法/路径、载荷形状、错误、身份、门控与重置行为。对当前示例、提案、历史探索和未解决案例显式分类,证据不足时使用 unreviewed。保留被取代的有用工作及其理由与替代引用。

使用方式:从 node scripts/storybook-catalog.mjs 开始;故事放在 ui/storybook/stories/<primary-feature-area>/,共享 fixture 模块放在 ui/storybook/support/。保持 CSF meta ID 稳定,即使标题变化。运行 node scripts/storybook-catalog.mjs 重新生成被忽略的索引、功能页与预览顺序;Storybook 启动/构建也会生成。不要手工编辑或提交生成输出。检查命令:node scripts/storybook-catalog.mjs --check 和 node --test scripts/check-maps.test.mjs scripts/storybook-catalog.test.mjs scripts/storybook-feature-index.test.mjs。受影响渲染与交互使用 review-storybook。

限制:检查只验证本地注解、发现的清单与引用,不验证语义一致性或运行时健康。清单完整性不等于行为覆盖。不要将定向维护请求扩大为全产品审计。不要用通用成功 mock 替换错误以通过。不要接受新的截图基线作为目录清理的一部分。测试存在不等于通过证据。完整通过不得隐藏未审查故事,也不得声称 fixture 交互确立了生产 API、权限或提供方行为。