@dsh-cove/dsh-web-all 0.0.0-stage → 0.4.3

package/presets/code-vibe/skills/dsh-trim-cot-leakage/references/recall-batteries.md

@@ -0,0 +1,52 @@
+# Recall batteries
+
+Probes for [the taxonomy](../SKILL.md#taxonomy), tuned during the 2026-08 purge. Every hit needs semantic judgment — the batteries over-match by design, and they under-match by nature: each review round of the purge found cases no battery caught, so pair them with an unpatterned read of the densest prose in scope.
+
+## Invocation rules
+
+- Add `--hidden --glob '!.git/**'` so `.agents/` is searched; ripgrep skips dot-directories by default and the purge's biggest miss risk was issues and pull requests.
+- Exclusions go last so a later include cannot re-admit them: `--glob '!vendor/**' --glob '!node_modules/**' --glob '!archived third-party snapshots/**' --glob '!.agents/skills/dsh-trim-cot-leakage/**'` (the skill's own files quote leaked wording as calibration), plus recorded fixture and snapshot directories in scope. The owning note（上游决策档案） also self-hits through its quoted evidence; judge it as evidence, not usage.
+- Natural-language lines carry `-i` so sentence-initial capitals hit ("This PR adds…", "Probably fine…"); the first line, which matches code patterns, stays case-sensitive — `-i` would turn `\bT\d\b` and `\bP-I\b` into noise.
+- Bound complete phrases. `\bthis PR\b` must match "this PR adds" without matching "this project", "this process", or "this provider".
+- A zero-hit pattern proves nothing until it matches a known positive, and a noisy pattern proves nothing until it rejects a near-miss negative. Calibrate both before trusting a corpus result.
+- Target authoring-language probes at the opposite-language surface: search Chinese residue in otherwise-English Markdown and code comments/JSDoc, and search Chinese change narration within `*.zh.md`. A generic ASCII search for English residue in Chinese prose is too noisy around code and identifiers; compare the prose additions against their counterpart instead.
+
+## English battery
+
+```sh
+rg -n --hidden '\(decision \d|\(audit [A-Z]\d|design §|plan §|design ledger|\(B ruling|\bP-I\b|\bW\d\b|\bT\d\b' ...
+rg -n --hidden -i '\bthis PR\b|\bthis branch\b|\bthis stack\b|\blater PRs?\b|\bprevious commits?\b|\bthis commit\b' ...
+rg -n --hidden -i '\bused to\b|\bno longer\b|\bpreviously\b|\bthe old\b|\bwas renamed\b|\bwas moved\b' ...
+rg -n --hidden -i '\bv1\b|this cut|\bcut \d|\btoday\b|\bfor now\b|roadmap' ...
+rg -n --hidden -i 'rejected in review|review round|reviewer|as of v\d' ...
+rg -n --hidden -i 'probably |should be enough|should suffice|it simply|is safe —|is safe --' ...
+rg -n --hidden '§\d' ...
+```
+
+## Chinese batteries
+
+```sh
+# Change or review narration in Chinese counterparts.
+rg -n --hidden '评审|上一?轮|旧版|老的|不再|以前|本版|遗留' --glob '*.zh.md' ...
+
+# Chinese authoring-language slips in English Markdown.
+rg -n --hidden '设计稿|评审|上一?轮|旧版|老的|不再|以前|本版|遗留|私有|(^|[^a-zA-Z])端([^a-zA-Z]|$)' --glob '*.md' --glob '!*.zh.md' ...
+
+# Chinese authoring-language slips in English code comments and JSDoc.
+rg -n --hidden '(^[[:space:]]*(//|/\*|\*)|//|/\*)[^\r\n]*(设计稿|评审|上一?轮|旧版|老的|不再|以前|本版|遗留|私有|端)' --glob '*.{ts,tsx,js,jsx,mjs,cjs,css}' ...
+rg -n --hidden '#[^\r\n]*(设计稿|评审|上一?轮|旧版|老的|不再|以前|本版|遗留|私有|端)' --glob '*.py' ...
+```
+
+## Known false-positive families
+
+Judged and kept during the purge; expect them again:
+
+- **Instrumental "used to"** — "the key used to sign requests" is instrumental, not temporal. The temporal form has a subject state before it ("colors used to come from…").
+- **Runtime old/new** — "the old connection drains before the new one accepts" names live objects during handover, not repo states.
+- **"This PR" in process docs** — documentation *about* PR workflow ("the PR body should…", templates, this repo's process notes) legitimately says "PR"; the ban is on a doc adopting one PR's vantage about the code.
+- **`v1` as protocol or path segment** — `/v1/chat` endpoints and wire-format names are identifiers, not version stamps.
+- **`§N` with a committed owner** — external standards (RFC 9110 §10.1.5) and committed docs that own their §-numbering stay citable by section.
+- **Contrastive "actually" and noun "wait"** — ordinary English, not hedging; no committed line probes them, so they surface only when you extend the battery with broader hedging patterns.
+- **Runtime "today" and recorded timestamps** — prompts or tests that ask for the current date use natural time, not a repository version stamp; recorded CLI output keeps its voice. Wording that reaches a model or user still follows the behavior-evidence rule before any edit.
+- **本版本 in zh prose** — a legitimate rendering of "this release" in versioned-artifact contexts; the banned indexical is 本版 as a bare stamp mirroring "this cut".
+- **Alternatives-considered sections** — "rejected" inside an issue or pull request's genre slot is the sanctioned home, not review choreography.

package/presets/code-vibe/skills/frontend-design/SKILL.md

@@ -0,0 +1,60 @@
+---
+name: frontend-design
+description: 前端/UX 设计标准：设计类愿望的规范单产出、字段门控、视觉/文案/交互底线；Use when 页面/前端/设计/体验/对标/重设计/IA 类任务或 wish-programming 阶段 2 之前必须加载；禁发明、组件白名单、LOAD-MAP 字段门。
+---
+
+# Frontend Design（前端/UX 设计标准）
+
+> 从 SDD 体系（sdd-vibe-coding，MIT）移植的 design-standards 全套 + design 专项 references。设计类愿望的阶段 2（设计规范单）前**必须加载**本 skill——不读 LOAD-MAP = 未执行设计标准。
+
+## 加载即执行的硬门
+
+1. **先读 `references/design-standards/LOAD-MAP.md`**（字段门控唯一真源：Job Brief 三必填未齐 → 不得定视觉、不得输出线框当定稿）——有 UI 施工必须先读本表再开写。
+2. **Job Brief 三必填**（Job / Desired outcome / Consequence）未齐 → 先问清，禁止跳视觉。
+3. **组件白名单纪律**（与 wish-programming 阶段 2/3 联动）：指定组件必须引用平台已有组件；找不到 → 标「需新建，待用户拍板」，禁止默认发明；实现阶段由 `check_whitelist.py` 机械核对。
+4. **用户视角是必选维度**：每个设计决策回答「目标用户是谁 + 做完后用户能看到/感受到什么」；Design Read 缺省按 craft-knobs 默认。
+5. **改存量页**：声明 `change: refinement|redesign`（change-control.md），material 门与 polish 轨按册执行。
+
+## 册导航（references/design-standards/ 内）
+
+| 场景 | 读什么 |
+|---|---|
+| 任务→必读路由（入口） | `LOAD-MAP.md` |
+| 交互决策层（先于视觉） | `product-judgment.md` |
+| Design Read / variance / density | `craft-knobs.md` |
+| 写页面前评审输出模板 | `ui-page-gate.md` |
+| 改存量 refinement/redesign | `change-control.md` |
+| 视觉 / 文案 / 动画 / 色角色 / 尺度 | `visual.md` · `copy.md` · `tokens/motion.md` · `tokens/color-roles.md` · `tokens/scale.md` |
+| 系统架构描述 | `system-architecture.md` |
+| UI 回归 / 错缝排查 | `debug-playbook.md` |
+| AI 味检查 | `audit/ai-tells.md` |
+| 正反例校准 | `exemplars/README.md` |
+| 用户故事包措辞/评审格式 | `references/critique-format.md` · `references/scheme-antipatterns.md` |
+
+## 术语映射（LOAD-MAP 字段 ↔ wish-programming design-spec 模板）
+
+> 本 skill 材料来自 SDD 体系；wish-programming 的 `design-spec.md.tpl` 有自己的节结构。**两套术语对照本表执行，不各写各的**——产出物只有一份（design-spec.md），字段门是检查清单。
+
+| LOAD-MAP 字段（本 skill） | design-spec 模板节（wish-programming） | 说明 |
+|---|---|---|
+| Job Brief（Job/Desired outcome/Consequence） | requirements.md 需求清单 N 编号 + 确认包场景故事 | 未齐 → 不得定视觉（先问清） |
+| UI surface | §1 页面树 | 页面/入口清单 |
+| Design Read | §2 每页区块设计 | 每块指定组件+状态样式；阶段 3 用户视角行 |
+| page_kind / motif | §1 页面树每页标注 | 页面类型（list/detail/form/…）等价 |
+| anchor + diverge | §4 共享件清单 + §3 组件白名单 | anchor 片建的样板与差异点 |
+| knobs / visitor_mode | §5 状态与响应式 | 缺省用 craft-knobs 默认 |
+| shell（产品改壳） | §1 页面树声明 | 「改壳」须显式声明 |
+| change: refinement\|redesign | §6 需求覆盖矩阵 + change-control | 改存量页必须声明，非默认 |
+| （本体系）组件白名单 | §3 组件白名单 | 实现阶段由 check_whitelist.py 机械核对 |
+
+## 与 wish-programming 的分工
+
+- 本 skill 管「设计质量」：阶段 2 规范单的正确产出姿势、字段门控、白名单、设计评审。
+- wish-programming 管「流程」：阶段顺序、人闸、机械验收；本 skill 不重复这些。
+- 设计类愿望的顺序：加载本 skill（阶段 2 前）→ 产出 design-spec.md（含备选方案节）→ 用户拍板 → 实现切片按白名单执行。
+
+## 边界
+
+- 只做设计与评审产出，不替代实现；不写业务代码。
+- 验收/走查侧（不听设计的证伪与截图验收）→ `quality-review` skill。
+- 调研/探索类任务不套本 skill（路由见 wish-programming「调研/评审模式分轨」）。

package/presets/code-vibe/skills/frontend-design/references/critique-format.md

@@ -0,0 +1,35 @@
+# Design critique format（Shape / Verify）
+
+> 蒸馏：ai-ux-skills design-critique。用于评审稿、走查意见、Repair 聚类前的结构化反馈。
+> 有 UI 时先对照 [product-judgment.md](./design-standards/product-judgment.md) 的 Job Brief / `rule/*`，再评视觉。
+
+## Presenter 先声明（30 秒）
+
+1. **Problem** — 要解决什么
+2. **User** — 谁
+3. **Job / Consequence** — 用户任务与动作后果（缺则先补 Brief，再评）
+4. **Constraints** — 时间/技术/品牌硬约束
+5. **Scope** — 评什么、不评什么
+
+## 反馈句式（二选一）
+
+**Observation → Impact → Suggestion**
+
+```text
+Observation: …
+Impact: …（对 Job / 信任 / 效率）
+Suggestion: …（可执行；尽量引用 rule/*）
+Rule: rule/… | coverage-gap
+```
+
+**I Like / I Wish / What If** — 探索阶段；收敛后改成 O→I→S。
+
+## 分流
+
+| 类型 | 处理 |
+|------|------|
+| **Actionable** | 进 P0/P1 或 Spec |
+| **Preferential** | 标偏好；不挡关版除非违反合同 |
+
+禁止只写「不够高级」「再现代一点」——无 Observation 的评价作废。
+实现黑话上屏、交互单位跟内部类型走、权限与分发揉成一团 → 按 product-judgment 对应 `rule/*` 标 **Actionable / P0–P1**。

package/presets/code-vibe/skills/frontend-design/references/design-standards/LOAD-MAP.md

@@ -0,0 +1,81 @@
+# LOAD-MAP（任务 → 必读）
+
+> **有 UI 施工时先读本表再开写。** 不读本表 = 未执行 design-standards。
+> 路径均相对 `skills/vibe-coding/references/design-standards/`。
+> **字段×Rail 强度、豁免、场景必读：只以本文件为准**；其它册/Skill 只链到这里，勿另写强度表。
+> `pages/` · `components/` · `surfaces/` 已归档（`references/_archive/design-standards/`）；施工以本表字段门 + 下列保留册为准，不再按页种/控件册展开。
+
+## 字段门控（唯一真源）
+
+| 字段 | Shape | Plan（`check_spec`） | Build |
+|------|-------|----------------------|-------|
+| **Job Brief**（见 [product-judgment.md](./product-judgment.md)） | **必须**（有 UI） | **warn** 若缺 | **必须** |
+| `UI surface` | **必须** | **fail** 若缺 | **必须** |
+| Design Read | **必须**（有 UI） | **warn** 若缺 | **必须** |
+| `page_kind` 或 `motif` | 有具体页则必须 | **warn** 若缺（二者等价） | **必须** |
+| `anchor` + `diverge` | 可后置到切片收敛 | **warn**（Build 前须补） | **必须** |
+| knobs / `visitor_mode` | 建议 | 建议（缺则用 craft-knobs 默认） | 缺则用默认 |
+| `shell`（product 改壳） | 建议 | **warn** 若疑改壳却未声明 | **必须** |
+| `change: refinement\|redesign` | 改存量时声明 | 改存量时声明 | 改存量时 **必须** |
+
+`motif:` 与 `page_kind:` **等价**（consumer 可写 `motif: growth` 或 `page_kind: growth`）。
+
+**硬门（顺序）：**
+
+1. Job Brief 三必填（Job / Desired outcome / Consequence）未齐 → **不得**定视觉、不得输出线框当定稿、不得写新页业务 UI（应先问清）。见 [product-judgment.md](./product-judgment.md)。
+2. 未声明 surface / 未写 Design Read → **不得定视觉方向、不得写新页业务 UI**。
+3. Build 前未写可用 anchor → **不得定视觉实现方向**（可先写 IA/文案结构）；见 [anchor.md](./anchor.md)。
+
+## 豁免（缩读）
+
+| 情形 | 仍须 | 可跳过 |
+|------|------|--------|
+| trivial：笔误 / 单点 CSS / 已知单控件 bug（不改合同·导航·跨面入口·权限可见性） | 输出前 [ai-tells](./audit/ai-tells.md) 抽一眼 | 完整前缀、Job Brief 重写、ui-page-gate、新 anchor |
+| **Polish / 非 material refinement**（见 [change-control.md](./change-control.md) §3；须写码硬闸 (c)） | ai-tells；声明 `change: refinement`；沿用已有 Job Brief（无则从界面推断并标假设） | 新 Spec、完整产品包、完整页面评审、重写 Design Read / Job Brief、新 anchor |
+| 已有 Spec 内的非 material UI 修补（Repair / 批内抛光） | 同上 + 对照既有 Job Brief | 新开另一份 Spec |
+
+触及导航 / 跨表面入口 / 主任务路径 / shell / visitor_mode / **权限或分发模型** 大改 → **非豁免**，走完整前缀（含 Job Brief）；不得用 Polish 话术绕过。
+
+## 每次有 UI 的固定前缀（非豁免）
+
+0. **[product-judgment.md](./product-judgment.md)** — Job Brief + 人话验收；**IA / 交互单位先于视觉**
+1. [craft-knobs.md](./craft-knobs.md) — **Design Read** 一行；建议 visitor_mode + variance/motion/density
+2. [anchor.md](./anchor.md) — 写下 anchor / diverge（Shape 可后置；**Build 前必须**）
+3. 定 `UI surface` + `page_kind`/`motif`（值写进合同；细则不再分册）
+4. [tokens/](./tokens/)（有宿主 DS 则只遵角色与禁令）
+5. [audit/ai-tells.md](./audit/ai-tells.md) — **输出前再扫一遍**
+
+改已有 UI 先读 [change-control.md](./change-control.md)。
+写页面前评审输出模板 → [ui-page-gate.md](./ui-page-gate.md)（加载义务仍以本表为准；评审块须含 Job Brief）。
+
+## 按场景加读
+
+| 你在做什么 | 必读（按序） |
+|------------|--------------|
+| 判定 B/C、写切片 | **product-judgment** → craft-knobs；声明 surface + page_kind/motif |
+| **配置 / 授权 / 分发** | **product-judgment** → [copy](./copy.md) |
+| 新建/改应用壳 | product-judgment → change-control；合同写 `shell:` |
+| **列表 / 详情 / 设置 / 看板 / 表单 / C 端主路径** | product-judgment → craft-knobs → ai-tells；合同写 `page_kind`/`motif` |
+| Modal / Sheet / Drawer / 批量 | product-judgment → copy（先定交互单位，再选容器） |
+| 文案/错误/空态 | [copy](./copy.md) |
+| UI 回归 / AI 脸 | [debug-playbook](./debug-playbook.md) → ai-tells |
+| 对照好坏 | [exemplars](./exemplars/README.md) |
+| 按需索引 | [tokens/README](./tokens/README.md) · 本表 |
+
+## 按 Rail（摘要；强度见上表）
+
+| Rail | 动作 |
+|------|------|
+| Shape | **先 Job Brief**；写 Design Read；必须 surface；有具体页则 page_kind/motif；knobs 建议；anchor 可后置 |
+| Plan | 合同写 Job Brief + surface；page_kind/motif + Design Read + anchor 建议（机检 warn）；架构边界点名服从本包 |
+| Build | **Job Brief 齐全** + **本表场景行** + 需要时 ui-page-gate 评审模板；改存量先 change-control；确认前不写页 |
+| Verify | 同 surface/page_kind；**先证伪**（testing/falsify-checklist）；对照人话验收 / Job；ai-tells + copy 抽检；有界轮次见 testing/bounded-verify；list/dashboard 须 api-diff/network-har |
+
+## 禁止
+
+- 跳过 product-judgment / Job Brief，直接 tokens 开画
+- 只读 [visual.md](./visual.md) / [ux.md](./ux.md) 开头就开写（二者是原则索引，非施工入口）
+- 跳过 Design Read / surface 用「现代干净」代替
+- Build 前跳过 anchor 用空话形容
+- 把已归档 pages/components/surfaces 当必读再展开施工
+- UI/验收使用实现黑话（主体、投影未完成、registry…）冒充产品语言

package/presets/code-vibe/skills/frontend-design/references/design-standards/README.md

@@ -0,0 +1,53 @@
+# Design Standards Pack
+
+插件默认可执行设计底线。有 UI 时**先读 [LOAD-MAP.md](./LOAD-MAP.md)**（字段门控、豁免、场景必读的**唯一真源**）。
+宿主品牌写在 `AGENTS.md` / 可选 `docs/product/DESIGN.md` + `PRODUCT.md`。
+
+## 册
+
+| 路径 | 内容 |
+|------|------|
+| **[LOAD-MAP.md](./LOAD-MAP.md)** | **任务→必读（入口）** |
+| [product-judgment.md](./product-judgment.md) | **交互决策层**：Job Brief · 人话验收 · 交互单位（先于视觉） |
+| [craft-knobs.md](./craft-knobs.md) | Design Read · variance/motion/density · visitor_mode |
+| [change-control.md](./change-control.md) | refinement/redesign · material 门 · **Polish 轨** |
+| [debug-playbook.md](./debug-playbook.md) | UI 回归 / 错缝 |
+| [anchor.md](./anchor.md) | 参考锚点（Build 前硬门；Shape 可后置） |
+| [copy.md](./copy.md) | UX Writing |
+| [tokens/](./tokens/) | 封闭尺度与色角色 |
+| [audit/](./audit/) | ai-tells |
+| [exemplars/](./exemplars/README.md) | 正反例 |
+| [ui-page-gate.md](./ui-page-gate.md) | 写页面前**评审输出模板**（加载义务见 LOAD-MAP） |
+| [visual.md](./visual.md) | 原则索引（非施工入口） |
+| [ux.md](./ux.md) | 体验启发式（非施工入口） |
+| [system-architecture.md](./system-architecture.md) | 架构通则 |
+
+> 历史 `pages/` · `components/` · `surfaces/` 在 `references/_archive/design-standards/`（非施工必读）。
+
+## 覆盖顺序
+
+```text
+Spec ≫ AGENTS.md / docs/product/{PRODUCT,DESIGN}.md ≫ docs/architecture/ ≫ 本包默认
+```
+
+## Surface + page_kind
+
+```text
+Job Brief 未齐 → 不定视觉、不输出线框定稿（product-judgment）
+未声明 surface → 不定视觉、不写新页
+未写 Design Read → 不定视觉（craft-knobs）
+合同写 UI surface + page_kind|motif；Build 前 anchor 必填；改存量先 change-control
+```
+
+场景表、Rail 强度、豁免 → **[LOAD-MAP](./LOAD-MAP.md)**（勿在本 README 复述强度表）。
+
+## 机读
+
+[ui-surface.checklist.json](./ui-surface.checklist.json) · [plan-architecture.checklist.json](./plan-architecture.checklist.json)
+`check_spec.py`：有 UI 缺 surface → fail；缺 Job Brief / Design Read / page_kind|motif / anchor → warn。
+
+## 明确不做
+
+- 不新建 Design Rail；不在 templates 复制本包长文
+- 不搬宿主组件库 API 全文 / Vercel 品牌 CSS
+- 不把已归档页种/控件册重新挂回常驻必读

package/presets/code-vibe/skills/frontend-design/references/design-standards/anchor.md

@@ -0,0 +1,51 @@
+# Anchor（参考锚点）
+
+> 蒸馏自 product-ui-design「observe before invent」。
+> **强度以 [LOAD-MAP.md](./LOAD-MAP.md) 为准：** Shape 可后置；**Build 前未写可用 anchor → 不得定视觉实现方向**（可先写 IA/文案结构）。
+
+## 合同
+
+每个有 UI 的切片在 **Build 开写前**必须出现：
+
+```text
+anchor: <真实产品名或具名 profile>
+diverge: <本产品相对锚点的 1–3 条差量>
+```
+
+写在理解卡、`plan.md` 设计边界、或页面评审块均可；PR / 文件注释须能追溯。
+
+## 合法 anchor 示例
+
+| 类型 | 例 |
+|------|-----|
+| 真产品 | Linear Issues 列表、Stripe Payments、Notion 数据库、GitHub PR、淘宝商详、微信会话 |
+| 具名 profile | `profile:linear-dense` / `profile:stripe-data` / `profile:vercel-flush` / `profile:notion-doc` / `profile:commerce-mobile` |
+
+`profile:*` 对应具名壳/ motif 约定（写进合同 `shell:` / `motif:`），不是形容词。
+
+## 非法（必须重写）
+
+- 「现代 / 干净 / 简洁 / 高级 / SaaS 风」
+- 空 anchor 或 `anchor: AI`
+- 只写竞品名却无任何可观察差量（diverge 空白）
+
+## 如何选
+
+1. 优先：**打开真实参考**（或宿主已有页面）量字体/行高/边距/行样式。
+2. 不能打开时：用具名 profile + shell/motif。
+3. diverge 只写**故意不同**之处（品牌色、密度、无侧栏…），其余跟锚点。
+
+## 与宿主
+
+若 `AGENTS.md` 或 `docs/product/DESIGN.md` 已声明默认 anchor / 品牌，本切片可写：
+
+```text
+anchor: 宿主 DESIGN.md
+diverge: 本页仅…
+```
+
+## 自检
+
+- [ ] anchor 可指认
+- [ ] diverge 非空或显式「无差量，严格跟锚点」
+- [ ] 输出未漂回 AI 紫模板（ai-tells）

package/presets/code-vibe/skills/frontend-design/references/design-standards/audit/ai-tells.md

@@ -0,0 +1,59 @@
+# AI tells（产品面输出扫描 · 蒸馏）
+
+> 来源意图：product-ui-design `ai-tells.md` + Vercel design.md reject 列表。
+> **输出完成前自扫**；命中则替换。`surface: product` 全适用；`consumer` in-product 同样禁后台味与发光点；growth 仍禁本表「模板脸」项。
+
+## 色
+
+| Tell | 替换 |
+|------|------|
+| `#6366f1` / `#818cf8` 等 AI 紫靛 accent | 宿主品牌或 `accent` 默认；单 accent |
+| 紫径向 glow / 渐变 mesh 当产品底 | 平表面；色只表状态/CTA |
+| 情绪化 token 名（`--warmth`） | 功能名（`--surface`/`--text`/`--accent`） |
+| 组件内任意 hex | tokens / 宿主变量 |
+| 纯 `#000` 大面积字或影 | near-black；影用多层淡色 |
+
+## 状态与装饰
+
+| Tell | 替换 |
+|------|------|
+| **发光/脉冲 ●** | pill + 文案 |
+| 每节强制 eyebrow pill | 有用才留；否则小字 label |
+| 彩色左边条默认刷每张卡 | 有语义才用 |
+
+## 字
+
+| Tell | 替换 |
+|------|------|
+| Mono 做 label/eyebrow | Mono 仅代码/数字/ID |
+| 产品面 `text-9xl` / 视口巨字 | 封闭 type 阶梯 |
+| `...` | `…` |
+| 数字列无 tabular-nums | 加上 |
+
+## 布局
+
+| Tell | 替换 |
+|------|------|
+| 习惯性 filled+ghost 双主钮 | 一主 CTA + 静默文字链 |
+| 无主次的四等大 KPI | 一主三从，或真对等才四等 |
+| 图标彩圆三列特性格 | 按内容挣来的块 |
+| 卡片墙替密表（product） | DataTable 合同 |
+
+## 深度 / 动效
+
+| Tell | 替换 |
+|------|------|
+| 单层纯黑 shadow | 双层、淡、贴背景色相 |
+| grain / glass / 自定义光标 / 视差 | 产品面删除 |
+| `transition: all` / 动画宽高 | 只 `opacity`/`transform`；列属性 |
+| 高频操作（Cmd+K）开合动画 | 可不动画 |
+
+## 收尾
+
+| Tell | 替换 |
+|------|------|
+| `outline:none` 无替代 | `:focus-visible` ring |
+| 任意 `p-[13px]` | 4px 封闭尺度 |
+| 「Submit / 出了点问题」 | 具体动词；错误含下一步 |
+
+全文色角色 → [../tokens/color-roles.md](../tokens/color-roles.md)。

package/presets/code-vibe/skills/frontend-design/references/design-standards/audit/web-interface.md

@@ -0,0 +1,14 @@
+# Web Interface Audit（占位/可读性准则）
+
+> 该文件目前主要用于满足 SDD 规则的“可加载依赖”与探针（skill-load probes）。
+> 若后续需要更完整的 Web 端审计 checklist，可在此补入可机检的断言与验证路径。
+
+## 适用
+
+- 网页端（web）界面在验收前的可访问性/可操作性审计。
+
+## 输出约束（给 agent）
+
+- 禁止把“看起来不错/works”当证据；
+- 若涉及用户可见通道，应给出明确的可观察结果与两态证伪口径；
+- 不写与 UI 无关的实现黑话。

package/presets/code-vibe/skills/frontend-design/references/design-standards/change-control.md

@@ -0,0 +1,62 @@
+# UI change control（Refine / Redesign · Material decision · Polish）
+
+> 蒸馏：Impeccable How-to-design、Vercel teaching-agents「material decision」。
+> 改已有界面前先分叉；禁止「半 polish 半换皮」。
+> 写码授权以当前会话的人类批准与宿主审批栈为准。
+
+## 1. Refinement vs Redesign
+
+| 分叉 | 保留 | 替换 | 禁 |
+|------|------|------|-----|
+| **Refinement** | 身份、行为、文案体系、导航心智 | 对齐、间距、状态、局部 token、可达性 | 偷偷换整套视觉世界 |
+| **Redesign** | 产品真值（Job、数据、权限） | **整套**视觉语言（旧 look 作**反参考**） | 只改几处颜色却宣称 Redesign |
+
+开改前声明一行：`change: refinement | redesign`。
+用户未说「重做视觉 / 换皮」→ 默认 **refinement**。
+
+## 2. Material decision 门
+
+改 UI 前判断是否 **material**（会影响任务、默认、后果、导航或可达状态）：
+
+| Material（升格 Shape/Plan 或写进 Spec） | 通常非 material（可局部修） |
+|----------------------------------------|------------------------------|
+| 改主任务路径 / 入口 / 权限可见性 | 文案用词微调（不改承诺） |
+| 改默认筛选、排序、空态主 CTA | token 对齐、错缝、对比度 |
+| 新增/删除导航目标或破坏性后果 | 纯装饰删除、a11y 补 label |
+| 换 shell / visitor_mode / 大面积 IA | 单控件 hover/focus 补全 |
+| 改确认/提交后果或可达业务态 | 交互五态补全（hover/focus/disabled…） |
+
+非 material → 不必新开 Spec；仍走 LOAD-MAP 相关册 + ai-tells。
+Material → 更新切片或 Spec 字段后再 Build。
+
+## 3. Polish 轨（非 material · 可跳过产品包/Spec）
+
+功能已可用、只动前端交互或抛光时走本轨，**不**开完整 Shape→Plan。
+
+| 项 | 合同 |
+|---|---|
+| 授权 | 写码硬闸 **(c)**：本轮明示 polish / 抛光 / 前端小改 / 交互微调 / 按 refinement 修 / 修本批走查（P0–P1） |
+| 范围 | 仅非 material；默认修本轮点名项或走查 **P0–P1**；**P2** 仅用户点名 |
+| 落盘 | **不**新开 Spec；**不**要求完整产品包；对话内声明 `change: refinement` + 改动清单即可 |
+| 缩读 | [LOAD-MAP](./LOAD-MAP.md) 豁免「Polish / 非 material refinement」行 |
+| 验证 | 改动面最小验证（相关控件/页面一眼 + 有 UI 时 ai-tells 抽检）；不宣称整 Spec 可交付 |
+| 升格 | 任一 material 信号 → 停 Polish，摘要差异，请用户进 Shape 或补 Spec |
+
+走查结束后交接话术示例：「按本批走查修 P0–P1」→ 进入本轨。
+
+## 4. Finding 分级（走查/自扫）
+
+| 级 | 含义 | 处置 | 与 Nielsen |
+|----|------|------|------------|
+| P0 | 挡 Job / 无障碍致命 / 数据谎言 | 必须修再关版；可走 Polish 若非 material | **严重度 4** |
+| P1 | 主路径摩擦、状态缺失、合同违反 | 本批修；非 material → Polish | **严重度 3** |
+| P2 | 偏好、抛光 | 可记后续；用户点名才进 Polish | **严重度 1–2** |
+
+映射真源：本表 ↔ [ux.md](./ux.md) 严重度 0–4。Verify 交付卡可用任一套，勿混用无映射。
+
+## 5. 自检
+
+- [ ] 已声明 refinement 或 redesign
+- [ ] material 变更已进合同；非 material 未假装大改
+- [ ] 走 Polish 时有本轮 (c) 话术
+- [ ] 无「半套新皮肤」

package/presets/code-vibe/skills/frontend-design/references/design-standards/copy.md

@@ -0,0 +1,65 @@
+# Copy（UX Writing 合同）
+
+> 蒸馏自 Vercel writing 习惯、WIG Content、空态/错误最佳实践。
+> 与 [product-judgment.md](./product-judgment.md)、[LOAD-MAP.md](./LOAD-MAP.md) 交叉。
+
+## 总则
+
+1. **具体动词**：按钮写清结果（「保存 API Key」），禁空壳「提交 / 确定 / Continue」。
+2. **第二人称**；短句；一句一个意思。
+3. **数字用数字**（「8 个部署」）。
+4. 省略号用 `…`；单位不换行可用窄不换行空格意识（`10 MB`）。
+5. 产品专有名、代码、ID：`translate="no"` 意识（i18n 时）。
+
+## 按钮与链接
+
+| 场景 | 写法 |
+|------|------|
+| 主 CTA | 动词 + 对象 |
+| 次行动 | 文字链或次钮；勿第二主色实心钮抢权 |
+| 取消 | 「取消」可；勿与主 CTA 同视觉权 |
+| 危险 | 「删除项目」含对象；确认框重复对象名 |
+
+## 错误（What / Why / Next）
+
+```text
+标题：发生了什么（人话）
+说明：为何（若可知）
+行动：下一步（重试 / 改字段 / 联系谁）
+```
+
+禁：「出错了 / Something went wrong」无下一步。
+字段错贴字段；系统错可用 toast，但仍要可行动。
+
+## 空态文案
+
+| 态 | 文案结构 |
+|----|----------|
+| First-run | 缺什么 + 为何重要 + 主 CTA 标签 |
+| 筛选为零 | 「无匹配」+「清除筛选」 |
+| 无权限 | 与空区分；谁可申请 / 如何切角色 |
+
+## 权限 / 计费 / 破坏
+
+- 权限：说明缺口，不假装空列表。
+- 计费：额度/到期静态可见，不藏悬停。
+- 破坏：确认文案含范围（「将删除 12 个成员的访问权」）。
+
+## consumer / growth
+
+- CTA = 下一动作（「领取优惠」非「立即体验」空话堆）。
+- 信任点可测、可溯；禁虚构评价。
+- 法律/隐私链接可见。
+
+## product 口径
+
+- 指标名与宿主/数据口径一致；歧义写在 caption。
+- ID 展示可读名；复制 ID 为次要。
+- **禁实现黑话上屏**（`rule/no-impl-jargon`）：主体、投影、registry、shadowing、内部风险码等 → 用人话或产品名；见 [product-judgment.md](./product-judgment.md)。
+
+## 自检
+
+- [ ] 主按钮可预测下一屏
+- [ ] 错误含下一步
+- [ ] 空态两分文案不同
+- [ ] 无 AI 套话堆砌

package/presets/code-vibe/skills/frontend-design/references/design-standards/craft-knobs.md

@@ -0,0 +1,61 @@
+# Craft knobs（Design Read · 旋钮 · Visitor mode）
+
+> 蒸馏：taste-skill §0–1、Impeccable Modes。与 `surface` / `page_kind` **正交**，写入切片或 Spec。
+
+## 1. Design Read（Shape / 写码前硬门）
+
+开写或落 UI 切片前，输出**一行**：
+
+```text
+Reading this as: <page_kind or motif> for <audience>, <vibe>, leaning <DS or aesthetic>
+```
+
+例：`Reading this as: list for ops analysts, dense/calm, leaning Stripe data-table`
+
+- 模糊时最多 **一个** 澄清问句，再定 Read。
+- 未写出 Design Read → 不得定视觉方向（与 surface 门同级；Rail 强度见 [LOAD-MAP](./LOAD-MAP.md)）。
+- Plan 合同可复述该行或写 `Design Read: …`。
+
+## 2. VARIANCE / MOTION / DENSITY
+
+三旋钮（整数 **1–10**；未声明用默认）。由 brief 推断，不平均塞满。
+
+| 旋钮 | 默认 | 含义 |
+|------|------|------|
+| `variance` | **8** consumer growth / **5** product | 布局/节奏不对称与意外程度；product 偏低 |
+| `motion` | **6** growth / **3** product | 动效预算；见 [tokens/motion.md](./tokens/motion.md) |
+| `density` | **4** growth / **7** product | 信息密度（**真源为 1–10**） |
+
+**别名（写入时归一到数字）：** `compact` → 8；`comfortable` → 5。合同优先写整数。
+
+落盘示例：
+
+```text
+variance: 5
+motion: 3
+density: 7
+```
+
+| brief 信号 | 倾向 |
+|------------|------|
+| 密表、工单、分析台 | density↑ motion↓ variance↓ |
+| 品牌落地、活动页 | variance↑ motion 中高 density↓ |
+| 已登录 C 端工具 | density 中；motion 短反馈 |
+
+## 3. Visitor mode（与 surface 正交）
+
+按**本页访客要成功什么**选一（同产品不同面可不同）：
+
+| mode | 访客成功 | 典型 |
+|------|----------|------|
+| `persuade` | 做决策并行动 | growth 落地、定价 |
+| `operate` | 完成任务 | product list/detail/settings |
+| `read` | 理解内容 | docs、帮助、长详情 |
+| `experience` | 沉浸作品/氛围 | media、品牌体验页 |
+
+未声明时：product → `operate`；`motif:growth` → `persuade`；文档型 → `read`。
+
+## 4. 与 LOAD-MAP
+
+字段何时必须 / 建议 → [LOAD-MAP.md](./LOAD-MAP.md) 字段门控表。
+Build：有 UI 时确认 knobs 与 [tokens/](./tokens/) / surfaces 一致。

package/presets/code-vibe/skills/frontend-design/references/design-standards/debug-playbook.md

@@ -0,0 +1,37 @@
+# UI debug playbook（回归 / 错缝 / AI 脸）
+
+> 有界面回归、错缝、验收 Fail 的视觉类问题用本册；不替代 Skill `debug` 的线上排障。
+> 先 [LOAD-MAP](./LOAD-MAP.md)，再对本表。
+
+## 1. 分流
+
+| 症状 | 先读 | 常见根因 |
+|------|------|----------|
+| 「像 AI 默认脸」 | [audit/ai-tells.md](./audit/ai-tells.md) | 紫/glow/四等 KPI/grain |
+| 侧栏与主区错缝、顶栏不对齐 | [anchor.md](./anchor.md) + 宿主壳量测 | 垫不同源、负 margin |
+| 空态像筛选零 / 整页转圈 | [copy.md](./copy.md) + product-judgment 交互单位 | 空态未两分 |
+| Modal/Sheet 乱用、跳动 | product-judgment（先交互单位再容器） | 未顶锚、假 dim |
+| 表列抖、筛选丢 | LOAD-MAP 列表场景 + 合同 page_kind | 非真 table / URL 未同步 |
+| 焦点看不见、表单无 label | ai-tells + 宿主 a11y 约定 | outline 被干掉 |
+| 文案含糊、错误无下一步 | [copy.md](./copy.md) | 未走 What/Why/Next |
+
+## 2. 测量步骤（product 壳）
+
+1. 固定 viewport（如 1280×800）与同一壳态（侧栏开/关各测一次）。
+2. 对顶栏、侧栏品牌行、工具首行、`--page-pl` 首列做 `getBoundingClientRect`。
+3. 偏差 ≥2px → Fail；用同源 token/`calc` 修，**禁止**负 margin 糊缝。
+4. 再测 loading→loaded：稳定锚点 centerY 应一致。
+
+可选：在 DevTools Console 注入临时测量脚本对比两态坐标；结果记入 `run.md`（通过/坐标差）。
+
+## 3. 修复纪律
+
+- 一次只修一类根因（先几何再色再文案）。
+- Hotfix UI：**refinement** 默认（见 [change-control.md](./change-control.md)）。
+- 修完：ai-tells 再扫 + LOAD-MAP 场景行 + 一次浏览器通道。
+
+## 4. 自检
+
+- [ ] 症状已映射到本表分流
+- [ ] 有测量或截图前后对比
+- [ ] 未引入第二套视觉语言