# SKILL · 邬晓峰品牌约束层入口（Agent Skill）

**用途**：任何 AI 工具（Claude Code / Stitch / 其它代码或设计生成器）在为「邬晓峰个人品牌」生成物料时，读取本文件与 `_ds_manifest.json` + `tokens/`，据此施加品牌约束。

---

## 1. 先读什么 · Read Order
1. `_ds_manifest.json` —— 机器可读清单，定位每个 token / 徽章 / 规范卡 / 物料 / 模板。
2. `tokens/*.css` —— 令牌的**单一权威源**（色值 / 字体 / 字号 / 间距）。
3. `readme.md` —— 规范本体与目录地图（人可读补充）。
4. 需要样例时再看 `guidelines/`（规则）、`ui_kits/`（成品）、`templates/`（起稿）。

## 2. 硬约束 · Hard Constraints
- **颜色**：只用 `tokens/colors.css` 里的值。墨 `#12110E`、米纸 `#F7F4EC`、品牌红 `#C4362A`（≤5% 用量）、暖灰 `#9A968C`、次文本 `#403D36`、分隔线 `rgba(18,17,14,.14)`、成功 `#3B7A57`。**禁止**引入色板外颜色或第二强调色。
- **字体**：西文标题/UI = Space Grotesk；中文正文 = Noto Sans SC；中文标题 = Noto Serif SC；编号/标注 = Space Mono。加载方式统一在 `tokens/fonts.css`（Google Fonts CDN）。**禁止**用 Inter / Roboto / Arial 等替代。
- **徽章**：只用 `assets/` 中的 4 个 SVG，文件名与几何路径不可改；遵守安全间距（≥1/4 高）与最小尺寸（数字 24px / 印刷 8mm）；禁止改色、变形、旋转、加特效。
- **基调**：极简、克制、留白、编号秩序感。朱红点睛，不铺陈。圆角接近 0。

## 3. 引用而非硬编码 · Reference, Don't Hardcode
- 生成静态 HTML/CSS 时：`<link rel="stylesheet" href="styles.css">`（按层级调整相对路径），然后一律 `var(--color-*)` / `var(--font-*)` / `var(--space-*)`。
- 生成其它技术栈（React/Tailwind 等）时：从 `tokens/*.css` 抽取变量名与值映射为该栈的 token，保持**同一套值**，不要另起色板。
- 改品牌 = 改 `tokens/`。切勿在业务代码里复制色值/字号。

## 4. 离线与运行时 · Offline & Runtime
- 展示层为纯静态 HTML，离线可用，唯一联网例外是 Google Fonts CDN。生成新展示页请沿用此模式。
- 交互式 `.dc.html` 共享根目录的 `support.js` / `deck-stage.js` / `image-slot.js`（`../` 相对引用），**不要**为每个页面复制运行时。

## 5. 三层信息架构 · Three Layers
`01 设计系统 (guidelines/) → 02 品牌应用 (ui_kits/) → 03 模板库 (templates/)`。
新增规则放 `guidelines/`，新增成品物料放 `ui_kits/`，新增可起稿模板放 `templates/`，并在 `_ds_manifest.json` 登记。

## 6. 产出去向
生成的成品（PDF/PPTX/DOCX/PNG）放 `exports/`；原始素材放 `uploads/`。