Back to Ui Ux Pro Max Skill

三处 data / scripts / templates 的区别

docs/三个 data-scripts-templates 的区别.md

2.15.01.7 KB
Original Source

三处 data / scripts / templates 的区别

三处分别是什么

位置作用能删吗
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-cliuipro init 时,安装的是这里打包的 data/scripts/templates 和子 Skill。❌ 不能删;发布前用脚本同步。

可以只保留一个吗?

  • 不能只保留一个“物理目录”:三处用途不同,都要存在。
  • 只手工维护一份内容:在 src/ui-ux-pro-max/ 修改 data、scripts 和 templates,再用 cli/scripts/sync-assets.mjs 将它们复制到 cli/assets/,并将 data、scripts 复制到本地 Claude Skill 目录。
  • .claude/skills/ui-ux-pro-max/SKILL.md 是例外:它不由模板生成,需要直接维护。

这样 data、scripts 和 templates 只在 src 维护,镜像目录由同步脚本更新。

推荐工作流

  1. 只改 src/ui-ux-pro-max/data/scripts/templates/

  2. 不要直接修改 cli/assets/data/cli/assets/scripts/.claude/skills/ui-ux-pro-max/{data,scripts}/

  3. 提交或发布 npm 前执行:

    bash
    cd cli
    npm run sync:assets
    npm run check:assets
    

    check:assets 也由 “Check asset sync” CI 工作流执行。