scaffolding-components
使用正确的文件结构、CSS 模块、音频集成和 Storybook 故事搭建新的 React 组件。在创建新组件、搭建 UI 或当用户说“创建组件”、“新组件”、“脚手架”、“生成组件”或“添加组件”时使用。
📖 中文导读:使用正确的文件结构、CSS 模块、音频集成和 Storybook 故事搭建新的 React 组件。在创建新组件、搭建 UI 或当用户说“创建组件”、“新组件”、“脚手架”、“生成组件”或“添加组件”时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: scaffolding-components description: | Scaffold new React components with proper file structure, CSS modules, audio integration, and Storybook stories. Use when creating new components, scaffolding UI, or when user says "create component", "new component", "scaffold", "generate component", or "add component".
Component Scaffolding
Generate properly structured React components following project conventions.
Workflow
Copy and track progress:
- [ ] Step 1: Create component directory
- [ ] Step 2: Create main component file (.tsx)
- [ ] Step 3: Create CSS module (.module.css)
- [ ] Step 4: Create barrel export (index.ts)
- [ ] Step 5: Create Storybook story (.stories.tsx) - if major component
- [ ] Step 6: Verify audio integration
- [ ] Step 7: Add responsive styles
Directory Structure
src/components/ComponentName/
├── ComponentName.tsx # Main component
├── ComponentName.module.css # Scoped styles
├── ComponentName.stories.tsx # Storybook (optional)
└── index.ts # Barrel export
Component Template
See TEMPLATES.md for ready-to-use templates.
Quick Generation
For a component named FeatureCard:
- Create directory:
src/components/FeatureCard/ - Use template: Copy from TEMPLATES.md, replace
ComponentNamewithFeatureCard - Add audio: Import
useAudioManager, add to all interactions - Add responsive: Include 768px media query
- Create story: If user-facing, create Storybook story
Audio Integration Checklist
Every interactive element needs audio:
| Interaction | Sound Type |
|---|---|
| Button click | click |
| Card hover | hover |
| Navigation | navigation |
| Back action | back |
| Panel open | panel |
| Success | achievement |
File Naming Rules
- Component:
PascalCase.tsx - CSS Module:
PascalCase.module.css - Story:
PascalCase.stories.tsx - Index:
index.ts(lowercase)