stories

前置条件：

1. 项目中必须已安装 Storybook。只有在用户明确调用此技能并批准安装 Storybook 时，才调用 /storybook-init 技能来设置 Storybook。
2. Storybook 版本必须至少为 10.6。（10.6 尚未发布时，next 即符合要求——10.6.0-alpha.x。任何 canary 构建（0.0.0-pr-*）也符合要求。）将设置或安装 Storybook 的请求视为批准执行任何必要的 Storybook 升级。对于其他请求，只有在用户明确批准升级后，才调用 /storybook-upgrade 技能。
3. 确保已安装 @storybook/addon-mcp。如果缺少，请运行 npx storybook add @storybook/addon-mcp 进行安装。

运行 Storybook 开发服务器和所有 Storybook CLI 命令时，必须使用同一工作目录：即安装了 Storybook 的包所在目录（在 monorepo 中通常是 packages/ui 这样的叶子包）。

对于文档、属性或用法问题，在检查源文件之前，先运行 npx storybook tools docs list，再运行 npx storybook tools docs show。只有当文档命令不可用或未返回相关文档时，才检查源文件。

运行 npx storybook skills stories，并完整阅读其输出，以获取处理 UI 更改、编写故事以及确保故事与所创建、修改或删除的每个前端组件保持同步的强制有序工作流。此工作流说明了如何编写故事、预览故事，以及展示精选的 Storybook 审查。

在本次会话中首次运行任何 npx storybook tools 命令前，先在命令末尾追加 --help 并完整阅读输出。工作流只会列出命令名称；每个命令的参数格式和使用规则（哪些情况下需要包含哪些字段）都在各自的帮助输出中。切勿根据命令名称猜测其参数——验证错误只会报告缺少的必填字段，不会报告工作流要求你提供的可选字段。

部分命令需要运行中的 Storybook 开发服务器。如果可以使用 Claude 预览工具，请通过该工具启动开发服务器：

1. 确保 .claude/launch.json 中有 Storybook 启动项（preview_start 工具说明中记录了该文件的格式），并设置 autoPort: true 和 port: 6006。尽可能使用项目首选的包管理器和现有的 package.json Storybook 脚本，不要自行编造新命令。
2. 使用 preview_start 工具启动 Storybook 启动项。