# Lenovo LeAI PC 5.0 Design

联想乐享 PC 5.0 设计规范 Skill 的团队入口。当前版本：`v0.11.1-stage`。

## 首次调用 Skill 必须执行

首次调用 `lenovo-leai-pc-5.0-design` 生成 POC 时，必须严格执行以下规则：

1. 必须先读取并严格遵循 `standards/design-system-complete.html`。
2. 必须以 `assets/templates/home-fullscreen-dialog-template.html` 作为 POC 的唯一页面框架。
3. 生成的 POC 必须保留该模板的页面结构、布局关系、组件组织、交互链路、状态反馈、响应式和可访问性要求。
4. 需求内容只能在模板框架允许的区域内组合或替换，不得脱离模板重新设计另一套页面框架。
5. POC 必须复用 Skill 内已经登记的组件与 Icon，不得临时手绘 Icon、使用未登记组件或引入平行规范。
6. POC 只能输出到 Skill 目录之外的独立目录，不得在本 Skill 目录内新建或保存 POC。
7. 严禁修改以下 Skill 源文件和目录：
   - `assets/templates/home-fullscreen-dialog-template.html`
   - `standards/design-system-complete.html`
   - `assets/icons/`
   - `assets/component/`
   - `SKILL.md`
   - `references/`
8. 如果需求与现有模板或规范存在冲突，必须保留模板和规范不变，在交付说明中单独列出差异、限制和建议，等待设计系统负责人确认。

首次调用时使用以下强制提示：

```text
严格按照 lenovo-leai-pc-5.0-design Skill 执行。

先读取 standards/design-system-complete.html，并以
assets/templates/home-fullscreen-dialog-template.html
作为唯一 POC 页面框架。

POC 必须保留模板的布局、组件组织、交互、状态、响应式和可访问性。
只能在 Skill 目录外产出独立 POC。

严禁修改模板、规范、Icon 库、组件库、SKILL.md 和 references。
如果需求与现有规范冲突，只在交付说明中列出差异，不修改 Skill。
```

## 当前基线

- 1 份总规范：`standards/design-system-complete.html`
- 29 个正式 SVG：`assets/icons/icon-board.html`
- 12 个可调用组件：`assets/component/leai-component.html`
- 3 个页面模板：`assets/templates/`
- 13 份有效专题资料：`references/`
- 规范命名迁移日期：2026-07-31

本地唯一源目录：

`/Users/guan/Desktop/2026/官网乐享/lenovo-leai-pc-5.0-design`

## 四层调用顺序

1. 总规范：确定品牌、Token、页面家族、状态和验收原则。
2. Icon Board：选择正式 SVG、确认用途、位置和误用限制。
3. 组件库：复用 `PC-位置-功能` 组件及其 DOM、状态和交互。
4. 页面模板：从最接近的整页结构开始组合和验证。

高保真任务不能只看截图，也不能只读取其中一层。

## 三个模板

| 模板 | 使用场景 |
| --- | --- |
| `home-fullscreen-dialog-template.html` | 首页全屏欢迎、对话、历史、内容画廊 |
| `shop-chat-page-template.html` | `/shop-chat/`、`/b-chat/`、`/biz-chat/` 左助手 + 右商城 |
| `product-detail-page-template.html` | 助手商城框架内的商品详情、配置、购买和评价 |

## 快速使用

### PM

先用现有模板、组件和 Icon 做 POC，不直接修改 Skill：

```text
使用 lenovo-leai-pc-5.0-design。

请先读取总规范、Icon Board、组件库和最接近的页面模板。
先用现有资产完成 POC，不修改 Skill。

功能名称：
所在页面/入口：
用户操作流程：
展示信息：
期望输出：POC HTML / 页面方案 / 研发说明

如果现有规范不够，请完成最接近的 POC，并单独列出建议沉淀项。
```

### 设计

1. 确认模板和页面家族正确。
2. 确认组件来自组件库或标记为临时 POC。
3. 确认 Icon 来自 Icon Board。
4. 核对 `default / hover / focus / active / disabled / loading / empty / error`。
5. 检查文案、AI 免责声明、密度、响应式和可访问性。

### 研发

1. 从交付中确认模板、组件和 Icon 清单。
2. 尽量保持组件库 DOM/class 和状态命名。
3. 保留键盘操作、ARIA、异常状态与 AI 免责声明。
4. 发现可复用缺口时反馈设计系统负责人，不在业务代码中私建正式规范。

## 目录地图

- `SKILL.md`：Codex 的完整执行规则和资源路由。
- `pc.html`：可视化团队调用、协作、模板选择与发布说明页。
- `agents/openai.yaml`：Skill 在 Codex 中的展示、默认提示和隐式调用策略。
- `standards/`：完整设计规范。
- `assets/icons/`：29 个正式 SVG 和 Icon Board。
- `assets/component/`：12 个可调用组件。
- `assets/templates/`：3 个当前页面模板。
- `assets/img/`、`assets/logos/`、`assets/fonts/`：正式图片、品牌与字体资源。
- `references/`：布局、组件、交互、文案、资产、模板、验收和发布资料。

## 资产规则

- 正式 Icon 只能从 `assets/icons/` 选择。
- 禁止内联 SVG、base64 SVG、emoji、文本符号 Icon 和 `media/` Icon 依赖。
- Icon 的文件由 Icon Board 决定，尺寸和状态由所属组件决定。
- 相对路径必须按 HTML 的 `<base>` 解析；不能直接在三个模板之间复制路径。
- 商品图优先使用 `assets/img/` 中现有正式图片，不以空白、破图或临时色块代替。

## 什么时候更新 Skill

| 情况 | 动作 |
| --- | --- |
| 文案、排序、业务入口或一次性流程变化 | 只更新业务 POC |
| 现有模板和组件可以完成 | 不更新 Skill |
| 多页面会复用的新组件、新状态、新 Icon 或新页面家族 | 评审后更新 Skill |
| 资源断链、错误命名、验收阻塞 | 按修复版本更新 |

任何 Skill 内容变化都必须升版本，并同步 `SKILL.md`、总规范、模板头、references、README 和发布说明。

## 严格禁止

- 只按截图实现，不读取四层来源。
- 绕过组件库自造正式组件。
- 新增 Icon 但不登记 Icon Board。
- 新增模板但不登记总规范和 SKILL。
- 使用旧快照覆盖当前页面行为。
- 让 `media/`、内联 SVG 或 base64 SVG 重新进入模板。
- 用骨架屏、破图或占位色块作为默认商品状态。
- 删除 AI 生成内容的免责声明。

## 交付前验收

完整清单见 `references/acceptance-checklist.md`。最低要求：

- 29 个 Icon、12 个组件、3 个模板的登记数量一致。
- 所有显式本地路径存在。
- 无废弃 references、旧版本入口和旧组件名。
- 三个模板无 `media/` 依赖、内联 SVG、base64 SVG。
- Icon、图片、交互状态、本地打开和关键脚本均可用。
- 当前版本在入口、规范、模板和治理资料中一致。

## 团队治理

- 多人流程：`references/team-usage-workflow.md`
- 四层治理：`references/design-system-governance.md`
- 验收清单：`references/acceptance-checklist.md`
- 发布与回滚：`references/release-and-governance.md`

## v0.11.1-stage

- `pc.html` 的 PM 标准提示词精简为可直接替换需求内容的一句话调用模板。

## v0.11.0-stage

- 将 Skill、目录、调用名和发布标识统一迁移为 `lenovo-leai-pc-5.0-design`。
- 同步 README、Agent 配置、总规范、模板声明、references、`pc.html` 和下载包之间的名称、版本与路径关系。
- 首次调用继续强制使用首页全屏模板，并仅允许在 Skill 目录外产出独立 POC。

## v0.10.6-stage

- 移除 `pc.html` 首屏重复的“复制 PM 提示词”跳转按钮。
- 保留下方提示词卡片内的实际复制控件。

## v0.10.5-stage

- 将 `pc.html` 主标题更新为“PC 5.0 设计规范调用与发布说明”。
- 重新生成与当前版本一致的下载包。

## v0.10.4-stage

- `pc.html` 首屏增加“下载规范 Skill”主按钮。
- 生成与页面版本一致的完整 ZIP 发布包。

## v0.10.3-stage

- 新增 `pc.html` 可视化说明入口，对齐附件说明页的信息架构。
- 登记当前四层体系、角色流程、模板选择、12 个组件和最低验收。
- 页面资源、链接与脚本完成静态校验，无断链或禁用 Icon 依赖。

## v0.10.2-stage

- 完善 `agents/openai.yaml`、README 和 SKILL 三个调用入口。
- 明确四层调用顺序、当前资产基线、模板路由和最终验收。
- 增加 Icon、图片、`<base>` 路径及禁止 `media/`/内联 SVG/base64 SVG 的硬规则。
- 将入口层和全部版本标记同步到 `v0.10.2-stage`。

## v0.10.1-stage

- 全量治理 `references/`，保留 13 份有效资料。
- 删除两份已被当前模板替代的历史 PC 对话参考。
- 同步 2026-07-30 模板基线、资源版本、菜单文案、Icon 路径与验收口径。

## v0.10.0-stage

- Icon Board 补充位置、关联组件、调用方式和误用限制，并新增 `smart-cursor.svg`。
- 组件库登记商品悬停智能鼠标，补充统一依赖与状态矩阵。
- 三份模板补充上游、组件、Icon、验证和版本声明。
