用途:该技能用于在组件库中强制实施可扩展、可维护的 Storybook 组织模式,让 Storybook 文件结构随项目规模增长仍保持清晰。
主要能力:文件结构上,将 story 与组件同目录放置,采用 stories/component.stories.js、stories/template.js,以及可选的 component.docs.mdx;模板组合上,导入子组件模板而非复制标记,保持每个组件单一事实来源;控件与 args 上,采用渐进式披露,提供合理默认值并为边界情况保留可选控件,包含 argTypes 与描述;视觉回归上,提供 Chromatic 集成模式与快照测试策略;CSF 约定上,使用 Component Story Format 3.0,包括默认导出元数据与具名 story 导出;文档上,支持 MDX 文档页、组件 API 表格、用法示例和 do/don't 模式。
使用方式:先判断技能是否已安装。全局检查:grep -q "^das:" ~/.agents/skills/format-storybook/SKILL.md 2>/dev/null && echo "pointer" || echo "installed";项目检查:grep -q "^das:" .agents/skills/format-storybook/SKILL.md 2>/dev/null && echo "pointer" || echo "installed"。若无 das: 块表示完整技能已安装,直接调用;若有 das: 块则进入安装步骤。检测范围:[ -e ~/.agents/skills/format-storybook ] && echo "global" || echo "project"。全局安装:npx skills add mikemai2awesome/agent-skills --skill format-storybook -g -y;项目安装:npx skills add mikemai2awesome/agent-skills --skill format-storybook -y。在 Claude Code 中,可将命令作为以 ! 开头的聊天消息发送以直接运行。
适用场景与限制:适用于需要统一 Storybook 结构、提升组件库可维护性的前端项目。不适用于 React Native Storybook stories(用 storybook-rn-skill)、设计 token 生成(用 design-tokens-skill)以及从零实现组件(用 shadcn-ui 或 baseline-ui)。