设计文件/组件库/设计 token 版本历史混乱时，用分支…

当设计文件、组件库或设计资产的版本历史混乱、协作与变更追踪困难时，制定并执行设计资产版本控制策略。

适用场景

解决思路

1. 定义设计工作的版本控制策略，让团队可以协作、追踪变更并保持一致。
2. 版本化设计文件（Figma、Sketch 等）。
3. 版本化组件库。
4. 版本化设计 token。
5. 版本化图标集和资产。
6. 版本化文档。
7. 设计文件：在关键里程碑创建命名版本，例如 v1-exploration、v2-refinement、v3-final。
8. 设计文件：采用基于分支的方式，main 分支存放已批准内容，feature branches 存放进行中的工作。
9. 设计文件：采用基于页面的方式，在文件内用 pages 维护版本历史。
10. 组件库：采用语义化版本控制（major.minor.patch）。
11. 组件库：major 表示破坏性变更，例如重命名组件、移除 props。
12. 组件库：minor 表示新增组件或功能，且向后兼容。
13. 组件库：patch 表示缺陷修复和优化。
14. 设计 token：与组件库一起进行版本控制。
15. 设计 token：用 changelog 记录 token 的新增、变更、移除。
16. 设计 token：为破坏性变更提供迁移指南。
17. 分支策略：main 存放生产可用、已批准的设计。
18. 分支策略：feature branches 存放进行中的设计。
19. 分支策略：合并到 main 前走评审流程。
20. 分支策略：归档旧版本，不要删除。
21. Changelog 实践：记录改了什么以及为什么改。
22. Changelog 实践：链接到相关设计决策。
23. Changelog 实践：显著标注破坏性变更。
24. Changelog 实践：包含迁移说明。
25. 最佳实践：只在有意义的里程碑创建版本，不要每次保存都建版本。
26. 最佳实践：用描述性名称命名版本。
27. 最佳实践：维护 changelog。
28. 最佳实践：向消费者（开发者、其他设计师）沟通变更。
29. 最佳实践：归档旧版本，而不是删除旧版本。

适用边界 · 注意事项

• 需要设计系统贡献规则时，改用 design-system-governance（design-systems）技能，而不是本策略。
• 不涉及设计文件、组件库、设计 token、图标/资产或文档的版本管理时，本策略不适用。