docs/三个 data-scripts-templates 的区别.md
| 位置 | 作用 | 能删吗 |
|---|---|---|
| src/ui-ux-pro-max/ | 唯一源码。所有 CSV、脚本、模板都在这里改,是“唯一真相来源”。 | ❌ 不能删,这是你要维护的那一份。 |
| .claude/skills/ui-ux-pro-max/ | 给 Claude Code 使用的 Skill。SKILL.md 手工维护;data/ 和 scripts/ 是从 src 同步的真实文件副本。 | ❌ 不能删,也不要改成符号链接;符号链接会在 Windows 的 Git 检出中失效。 |
| cli/assets/ | 给 npm 包 ui-ux-pro-max-cli 打包用。用户执行 npm i -g ui-ux-pro-max-cli 再 uipro init 时,安装的是这里打包的 data/scripts/templates 和子 Skill。 | ❌ 不能删;发布前用脚本同步。 |
cli/scripts/sync-assets.mjs 将它们复制到 cli/assets/,并将 data、scripts 复制到本地 Claude Skill 目录。.claude/skills/ui-ux-pro-max/SKILL.md 是例外:它不由模板生成,需要直接维护。这样 data、scripts 和 templates 只在 src 维护,镜像目录由同步脚本更新。
只改 src/ui-ux-pro-max/data/、scripts/、templates/。
不要直接修改 cli/assets/data/、cli/assets/scripts/ 或 .claude/skills/ui-ux-pro-max/{data,scripts}/。
提交或发布 npm 前执行:
cd cli
npm run sync:assets
npm run check:assets
check:assets 也由 “Check asset sync” CI 工作流执行。