# Release And Governance

本文件定义 `lenovo-leai-pc-5.0-design` 的版本、发布、同步和多人维护规则。

## 版本策略

建议使用三段式版本：

- `v0.x.x`: 阶段建设版，允许快速补齐规范。
- `v1.x.x`: 团队正式使用版，PM、设计、研发按流程执行。
- `v1.x.y`: 小修，例如文案、断链、说明补充。
- `v1.y.0`: 中等更新，例如新增组件、新模板、新页面规则。
- `v2.0.0`: 破坏性更新，例如 tokens、核心模板或组件结构大改。

当前阶段标记为：`v0.11.1-stage`。

## 版本号强制规则

- 只要 skill 内容发生更新，就必须同步更新版本号，不允许用旧版本号重新发布。
- 需要更新版本号的内容包括：`SKILL.md`、`standards/`、`assets/component/`、`assets/icons/`、`assets/templates/`、`references/`、`README.md`、发布页说明或下载包内容。
- 版本号必须先更新，再打包 zip、更新发布页、同步线上 active skill。
- 发布页展示版本、最新版信息、历史版本链接、zip 文件路径、changelog 标题、`SKILL.md` frontmatter version 必须保持一致。
- 如果只更新线上文件但版本号未变化，本次发布视为无效，需要重新按流程补版本、补 changelog、重新打包并同步。

## 发布节奏

| 场景 | 建议节奏 |
| --- | --- |
| POC 高频探索期 | 每周最多 1-2 次 skill 发布 |
| 上线稳定期 | 每周或双周固定发布 |
| 紧急修复 | 只修断链、错名、明显阻塞项 |
| 大组件更新 | 必须评审后发布 |

## 标准发布流程

1. 设计系统负责人从本地唯一源目录修改：
   ` /Users/guan/Desktop/2026/官网乐享/lenovo-leai-pc-5.0-design `
2. 判断变更级别并更新版本号；任何 skill 内容更新都必须升版本。
3. 更新相关文件：`SKILL.md`、`standards/design-system-complete.html`、`icon-board.html`、`leai-component.html`、templates、references。
4. 更新 release note、发布页版本信息、历史版本链接和 zip 目标路径。
5. 运行本地检查：旧命名、旧 icon、断链、模板锚点、组件依赖、版本号一致性。
6. 设计师和研发评审。
7. 重新打包 latest zip 和版本 zip。
8. 同步线上 active skill。
9. 对线上和本地做 checksum 校验。
10. 通知 PM、设计、研发本次变化。

## 线上同步目标

正式发布时同步到：

- `/opt/projects/lexiang/.codex/skills/lenovo-leai-pc-5.0-design`
- `/opt/projects/lexiang/.claude/skills/lenovo-leai-pc-5.0-design`

同步前不要直接改线上。线上只接受本地唯一源目录发布后的结果。

## Release Note 模板

```text
版本：
发布日期：
发布负责人：

本次新增：
- 

本次修改：
- 

本次修复：
- 

影响范围：
- PM：
- 设计：
- 研发：

是否需要研发调整：

是否已同步线上：

校验结果：
- 旧组件名残留：
- 旧 icon 残留：
- 资源断链：
- 本地/线上 checksum：
```

## 多人权限建议

| 人数 | 管理方式 |
| --- | --- |
| 1-3 人 | 一人维护即可，变更后口头同步。 |
| 4-10 人 | 1 名设计系统负责人合并，PM/设计/研发走评审。 |
| 10-30 人 | 固定发布窗口，变更申请进入列表，禁止随时直接改 skill。 |
| 30 人以上 | 需要版本冻结、变更评审会、上线验收人和回滚包。 |

## 回滚规则

- 每次发布前保留本地压缩包或服务器备份。
- 如果线上 skill 出现断链、组件缺失或严重样式错误，回滚到上一版本。
- 回滚后记录原因，不在业务需求中临时修补规范。

## 变更必须沉淀的位置

| 变更类型 | 必须更新 |
| --- | --- |
| 新组件 | `assets/component/leai-component.html`、`standards/design-system-complete.html`、`SKILL.md` |
| 新 icon | `assets/icons/icon-board.html`、`references/asset-inventory.md` |
| 新页面模板 | `assets/templates/*.html`、`standards/design-system-complete.html`、`SKILL.md` |
| 新交互状态 | `references/interaction-states.md`、组件库、相关模板 |
| 新页面规则 | 对应 `references/*.md`、总规范入口 |
| 发布流程变化 | `README.md`、`team-usage-workflow.md`、本文件 |
| 版本号规则变化 | `release-and-governance.md`、`design-system-governance.md`、`SKILL.md`、发布页 changelog |