仓库结构

huashu-design/
├── SKILL.md                 # Agent 首先读取的主指令
├── README.md                # 中文项目介绍
├── README.en.md             # 英文项目介绍
├── references/              # 按任务读取的深度知识
├── assets/                  # 组件、框架、音乐、音效和展示样例
├── scripts/                 # 验证、视频、PDF、PPTX 与旁白工具
├── demos/                   # 可运行能力演示
├── test-prompts.json        # 测试提示词
├── package.json             # Node 依赖与文档命令
└── docs/                    # VitePress 文档站

SKILL.md

定义触发范围、核心原则、设计方向顾问、任务路由、实现要求和交付检查。Agent 应先完整读取它，再按任务进入对应 reference。

references/

每份文档解决一个专门问题。主 Skill 不应把所有 reference 一次加载，而应根据交付物读取最小集合。本站的 深度参考 直接包含这些上游文件。

assets/

包含设备框架、动画引擎、deck 工具、设计画布、BGM、SFX 和多组 HTML / PNG 展示样例。资产用于加速实现，不代表每个任务都应使用相同视觉。

scripts/

用于浏览器验证、录制、确定性逐帧渲染、格式转换、混音、旁白、PDF 和 PPTX 导出。详见 脚本命令。

demos/

提供原型、幻灯片、动画、Tweaks、信息图、评审与工作流的中文和英文展示。详见 Demo 画廊。