create-yss-spec 2.1.11 → 2.1.13

package/template/.trae/skills/yss-antd-design/scripts/validate-frontmatter.test.mjs

@@ -0,0 +1,27 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { validateFrontmatter, validateSetupBan } from "./validate-frontmatter.mjs";
+
+const valid = `---
+name: yss-antd-design
+description: Use when 原型设计。不用于前端代码落地（改用 yss-ui）、安装官方 antd skill，或替代 yss-prototype-stage。
+---
+
+# body
+- 禁止 \`antd setup\`、\`npx skills add ant-design/ant-design-cli\`
+`;
+
+test("accepts the required skill frontmatter", () => {
+  assert.equal(validateFrontmatter(valid), "yss-antd-design");
+});
+
+test("rejects missing exclusion branches in description", () => {
+  assert.throws(
+    () => validateFrontmatter("---\nname: yss-antd-design\ndescription: Use when querying antd.\n---\n"),
+    /exclude frontend landing/
+  );
+});
+
+test("rejects a skill that does not forbid official setup", () => {
+  assert.throws(() => validateSetupBan("# no setup ban"), /forbid antd setup/);
+});

package/template/.trae/skills/yss-design-system/SKILL.md

@@ -13,7 +13,9 @@ description: Use when YSS 产品设计系统与 Ant Design 企业级 UI 风格
 - 项目 token 快照：`docs/design/tokens/theme.json`、`docs/design/tokens/tokens.default.json`、`docs/design/tokens/tokens.dark.json`、`docs/design/tokens/tokens.compact.json`、`docs/design/tokens/variables.css`、`docs/design/tokens/variables.dark.css`。
 - 本技能执行清单：`references/design-system.md`，用于 Agent 执行和评审，不替代 `docs/design/design.md`。
 - 历史输入包：`/Users/zhudaoming/Downloads/Product-Design-System`，只用于追溯首次引入来源，不作为后续工程依赖。
-- 原型阶段合同：`yss-prototype-stage`，用于统一跨 Agent 的原型资产、AntD 事实和浏览器验证证据。
+- 默认亮色覆盖：项目 Ant Design 5 Less / `:root` 变量已裁定进 `docs/design/design.md` 与 token 快照；原始 Less 不是实现语言。
+- Codex `$design-qa` 项目对照：`references/design-qa-theme.md`，不替代官方 `design-qa` 流程，也不改上游插件正文。
+- 原型阶段合同：`yss-prototype-stage`，用于统一跨 Agent 的原型资产和浏览器验证证据。AntD 事实由 `yss-antd-design` 提供，且只用于原型设计构建。
 
 如果只需要快速判断，先读本文件。若要写 UI 规范、实现页面、评审设计或调整 token，必须读项目内 `docs/design/design.md`；若要执行评审或实现检查，再读 `references/design-system.md`。
 
@@ -29,10 +31,11 @@ description: Use when YSS 产品设计系统与 Ant Design 企业级 UI 风格
 ## 核心基线
 
 - UI 定位：中后台、数据密集、表单密集、流程密集、可扫描、低装饰。
-- 主色：`#1677ff`，用于主操作、链接、焦点、选中态和激活导航。
-- 默认字号：14px；主要字重：400 / 600。
-- 默认控件高度：32px。
+- 主色：`#3371ff`（`--primary-color` / `--brand-color-primary`），用于主操作、链接、焦点、选中态和激活导航。
+- 默认字号：14px；主要字重：400 / 600；字体栈为系统字体，不强制 `Inter`。
+- 默认控件高度：32px；默认圆角 6px。
 - 间距：4px 网格，优先使用 token，不写任意 magic number。
+- 运行时换肤：短名 CSS 变量必须指向 `--brand-*`，不要再维护第二套色值。
 - 表面层级：页面背景、内容容器、浮层三层模型。
 - 组件语言：优先 Ant Design / YSS UI 语义，不自造同类控件。
 - 状态完整性：loading、empty、error、readonly、disabled、no-permission、conflict、success 必须在设计或实现中可解释。
@@ -84,7 +87,8 @@ description: Use when YSS 产品设计系统与 Ant Design 企业级 UI 风格
 | 前端页面实现 | `yss-ui` / `yss-page-module-development` |
 | 表单 schema | `yss-formily` |
 | YTable / YTree / 高度自适应 | `yss-components` / `yss-use-table-height` / `yss-use-tree-height` |
-| Ant Design v6 组件 / token / demo 查询 | 官方 `@ant-design/cli` / `https://ant.design/docs/react/for-agents` |
+| 原型阶段的 Ant Design v6 组件 / token / demo 查询 | `yss-antd-design`（只用于原型设计构建；前端落地改用 `yss-ui`） |
+| Codex 原型交接前的视觉 QA | `design-qa`；token / 字体对照读 `references/design-qa-theme.md`，以项目覆盖为准 |
 | API 契约 / 接入 | `yss-openapi-governance` / `api-integration` |
 
 ## 更新设计系统

package/template/.trae/skills/yss-design-system/references/design-qa-theme.md

@@ -0,0 +1,64 @@
+# Design QA 项目主题对照
+
+本文件给 Codex `$design-qa` 使用。官方 `design-qa` skill 仍负责截图对比流程和 `final result: passed|blocked`；本文件只提供项目视觉真相，不改上游插件正文。
+
+## Source visual truth
+
+- 规范：`docs/design/design.md`
+- Token：`docs/design/tokens/theme.json`、`docs/design/tokens/tokens.default.json`、`docs/design/tokens/variables.css`
+- 实现截图：当前原型或页面在同一 viewport / 主题 / 状态下的渲染
+
+官方 `https://ant.design/design.md` 只是上游默认。项目覆盖与官方不同时，以项目覆盖为准。
+
+## 必查 fidelity surface（项目覆盖）
+
+### Colors and visual tokens
+
+| 角色 | 必须对照 | 记为 P1 token drift |
+| --- | --- | --- |
+| 主色 | `#3371ff` | `#1677ff` 或 `#3177ff` 当默认主色 |
+| 主色 hover / active | `#4096ff` / `#0958d9` | 用算法重算替代 `:root` 显式值且未记录 |
+| 错误色 | `#f5222d` | 官方 `#ff4d4f` 当默认错误色 |
+| 成功 / 警告 | `#52c41a` / `#faad14` | 改成非功能色装饰 |
+| 页面背景 | `#f0f2f5` | `#f5f5f5` 或其它灰底当默认 layout |
+| 容器 / 浮层 | `#ffffff` | 用卡片阴影堆叠替代表面层级 |
+| 主文本 / 次文本 | `rgba(0, 0, 0, 0.88)` / `rgba(0, 0, 0, 0.65)` | `#2e2e2e` / `#646464` 当默认文本 |
+| 边框 / 分割线 | `#d9d9d9` / `#f0f0f0` | `#dbdbdb` / `#f1f1f1` 当默认边框 |
+| 运行时变量 | `--primary-color` 指向 `--brand-color-primary` | 页面另写一套 Less 色值 |
+
+`blue` 预设色板里的 `#1677ff` 不是品牌主色，不要据此判定主色漂移。
+
+### Fonts and typography
+
+| 角色 | 必须对照 | 记为 P1 token drift |
+| --- | --- | --- |
+| 默认正文字号 | 14px | 16px 营销字号当正文 |
+| 默认控件高度 | 32px | 明显偏离 32px 且未走 compact algorithm |
+| 字体栈 | 系统栈（`-apple-system, BlinkMacSystemFont, "Segoe UI", ...`） | 强制 `Inter` 或其它未登记品牌字体 |
+| 字重 | 400 / 600 | 用 700+ 表达选中或激活 |
+
+### Spacing and layout rhythm
+
+| 角色 | 必须对照 | 记为 P1 token drift |
+| --- | --- | --- |
+| 圆角 | 小控件 4px、默认 6px、容器 8px | 历史品牌 8px / 10px，或 Less 前半 4px 当全局默认 |
+| 间距网格 | 4 / 8 / 12 / 16 / 20 / 24 / 32 / 48 | 任意 magic number 撑开中后台密度 |
+| 顶栏 / 侧栏 | 顶栏 64px，深色侧栏 `#001529` | 未说明就改成营销式顶栏 |
+
+### Image quality and copy
+
+沿用官方 `design-qa` 规则。本主题不引入插画、logo 或营销文案；出现这类素材时按官方 rubric 记 finding，并同时记为偏离中后台定位。
+
+## 判定
+
+- 仍用官方 `#1677ff`、强制 `Inter` 或 8px 品牌圆角作为默认主题：P1。
+- 只改局部组件、且 `prototype-evidence.yaml` 的 `theme_override` 已记录：按官方 severity 评估，不自动升 P1。
+- 暗色模式：本轮未重派生完整暗色色板；暗色对照前若缺少新的 algorithm 派生证据，`final result: blocked`，写明 blocker。
+
+## 报告要求
+
+`design-qa.md` 必须写明：
+
+- source visual truth path：`docs/design/design.md` 与对应 token 文件
+- 已按本清单核对 Colors/tokens 与 Fonts/typography
+- 与官方默认的差异是否被接受为项目覆盖

package/template/.trae/skills/yss-design-system/references/design-system.md

@@ -39,22 +39,22 @@
 
 | Token | 值 | 用途 |
 | --- | --- | --- |
-| `colorPrimary` | `#1677ff` | 主操作、链接、焦点、选中态 |
+| `colorPrimary` | `#3371ff` | 主操作、链接、焦点、选中态 |
 | `colorPrimaryHover` | `#4096ff` | 主色 hover |
 | `colorPrimaryActive` | `#0958d9` | 主色 active |
 | `colorSuccess` | `#52c41a` | 成功状态 |
 | `colorWarning` | `#faad14` | 警告状态 |
-| `colorError` | `#ff4d4f` | 错误状态 |
-| `colorInfo` | `#1677ff` | 信息提示 |
-| `colorBgLayout` | `#f5f5f5` | 页面背景 |
+| `colorError` | `#f5222d` | 错误状态 |
+| `colorInfo` | `#3371ff` | 信息提示 |
+| `colorBgLayout` | `#f0f2f5` | 页面背景 |
 | `colorBgContainer` | `#ffffff` | 内容容器 |
 | `colorBgElevated` | `#ffffff` | 浮层容器 |
-| `colorText` | `#2e2e2e` | 主文本 |
-| `colorTextSecondary` | `#646464` | 次级文本 |
-| `colorTextTertiary` | `#949494` | 弱说明 |
-| `colorTextQuaternary` | `#c4c4c4` | placeholder / disabled |
-| `colorBorder` | `#dbdbdb` | 主边框 |
-| `colorBorderSecondary` | `#f1f1f1` | 次级分割线 |
+| `colorText` | `rgba(0, 0, 0, 0.88)` | 主文本 |
+| `colorTextSecondary` | `rgba(0, 0, 0, 0.65)` | 次级文本 |
+| `colorTextTertiary` | `#8c8c8c` | 弱说明 |
+| `colorTextQuaternary` | `#bfbfbf` | placeholder / disabled |
+| `colorBorder` | `#d9d9d9` | 主边框 |
+| `colorBorderSecondary` | `#f0f0f0` | 次级分割线 |
 
 颜色规则：
 
@@ -63,7 +63,10 @@
 - 预设色板只用于 Tag、图表、分类可视化，不用于重新定义主操作。
 - 不硬编码白色、灰色、状态色；优先引用 token、CSS variables 或 Ant Design theme。
 - semantic token 优先于色值：页面先声明背景、容器、浮层、文本、边框、状态等角色，再映射到具体 token。
+- 运行时短名 `--primary-color`、`--text-color`、`--bg-color` 必须指向 `--brand-*`，不要再维护第二套色值。
+- `blue` 等预设色板可以仍含官方 `#1677ff`；色板预设 ≠ 品牌主色。
 - accessibility contrast 不足时，通过 `ConfigProvider` 的 seed token 或组件 token 调整；不要为单个页面制造不可复用的深浅色例外。
+- Codex `$design-qa` 的 token / 字体对照读 `references/design-qa-theme.md`。
 
 ### 排版
 
@@ -81,6 +84,7 @@
 
 - UI 默认正文 14px。
 - UI 字重优先 400 / 600。
+- 字体栈使用系统字体，不强制 `Inter`。
 - 不用 700+ 粗体表达选中或激活状态。
 - 选中状态优先使用颜色、边框、下划线、背景表达。
 
@@ -93,8 +97,12 @@
 | 小控件高度 | 24px |
 | 大控件高度 | 40px |
 | 默认字号 | 14px |
-| 当前品牌默认圆角 | 8px |
-| 大容器 / 浮层圆角 | 10px |
+| 字体栈 | 系统栈，不强制 `Inter` |
+| 小控件圆角 | 4px |
+| 默认控件圆角 | 6px |
+| 大容器 / 浮层圆角 | 8px |
+| 顶栏高度 | 64px |
+| 深色侧栏 | `#001529` |
 
 执行规则：
 

package/template/.trae/skills/yss-product-lifecycle/SKILL.md

@@ -29,7 +29,7 @@ Matt 的 `grill-with-docs`、`to-spec`、`to-tickets`、`implement` 等保留为
 | 入口分诊 | 身份、影响面、最近可信阶段 | `yss-product-lifecycle` | `yss-project.yaml` 合法且影响面可解释 |
 | 机会调研/需求分析 | Discovery、用户/MVP/非目标/成功标准、测试 seam | `work-unit.discovery-opportunity` + `work-unit.discovery-requirements`；市场/竞品事实用 `competitive-intelligence`，技术/标准事实用 `research`；`grill-with-docs` 为兼容入口 | 未决事实已 research 或 handoff，用户确认，无 runnable blocker |
 | Spec/功能架构 | Spec、产品总体设计、功能架构；必要时 Spec Delta | 原生 `work-unit.spec-synthesis`；`to-spec` 为兼容入口 | 初稿先为 `ready-for-human`；只有 Spec baseline 人工批准后资产才为 `approved` 并进入下游 |
-| 原型设计 | 交互说明、低保真、状态矩阵、高保真 HTML、评审记录 | `yss-design-system` → `yss-prototype-stage` → Codex `product-design:index`（非 Codex 交付等价合同） | `gate.prototype-reviewed`、`gate.prototype-verified`、`gate.user-confirmation` 均有证据 |
+| 原型设计 | 交互说明、低保真、状态矩阵、高保真 HTML、评审记录 | `yss-design-system` → `yss-prototype-stage` → `yss-antd-design`（仅原型事实）→ Codex `product-design:index`（非 Codex 交付等价合同）。前端落地改用 `yss-ui` | `gate.prototype-reviewed`、`gate.prototype-verified`、`gate.user-confirmation` 均有证据 |
 | 技术分析 | OpenAPI Draft/Freeze、数据架构、工程基线、架构审查 | `yss-openapi-governance` / `yss-openapi-draft-review`、`codebase-design`、`implementation-repo-onboarding`、`yss-router` | API/架构契约冻结；无 API 影响有明确记录；脚手架策略满足 |
 | Ticket 正式化 | 功能父 Ticket、垂直切片、Slice Implementation Contract | 原生 `work-unit.ticket-decomposition`；`to-tickets` 为兼容入口；生命周期复算 | 依赖、验收、测试 seam 可执行；合同已批准、持久化且为当前版本 |
 | 技术实现 | 前端/后端代码、TDD 证据、YSS Skill Execution Result | 原生 `work-unit.slice-implementation`；`implement` 为兼容入口；前端按 `yss-ui` + `yss-page-module-development`，后端按 `yss-router` 最小闭包，业务行为统一 `tdd` | 只写允许路径；业务行为用 `behavior-tdd`；UI 影响必须有还原计划 |

package/template/.trae/skills/yss-product-lifecycle/references/orchestration-contract.yaml

@@ -138,7 +138,7 @@ work_unit_routes:
     human_gate: spec-baseline
   work-unit.prototype-design:
     native: {source: yss-product-lifecycle, skill: yss-product-lifecycle, invocation_mode: model-invoked}
-    skills: [yss-design-system, yss-prototype-stage, product-design:index]
+    skills: [yss-design-system, yss-prototype-stage, yss-antd-design, product-design:index]
     human_gate: prototype-confirmation
   work-unit.technical-analysis:
     native: {source: yss-product-lifecycle, skill: yss-product-lifecycle, invocation_mode: model-invoked}

package/template/.trae/skills/yss-prototype-stage/SKILL.md

@@ -25,7 +25,9 @@ description: Use when a YSS feature has product-design impact on a primary flow,
 
 优先级固定为：官方 `design.md` 的上游默认 → `docs/design/design.md` 与项目 token 的 `project_design` 项目覆盖 → 当前功能的语义组件映射。不得用上游默认覆盖项目 token。
 
-使用官方 `antd` skill / CLI 查询事实，始终用 `--format json`，并记录实际 `antd`、CLI 和目标组件版本。至少保存 `antd design.md`、已选组件的 `info`/`demo`/`token`/`semantic` 查询和 `antd lint` 结果；目标版本存在时，将同一 `<target_antd_version>` 传给版本敏感查询，禁止在模板中固化某个 CLI 或组件版本。
+Codex `$design-qa` 仍走官方对比流程；Colors/tokens 与 Fonts/typography 必须以项目覆盖为 source visual truth。对照清单见 `yss-design-system/references/design-qa-theme.md`。仍用官方 `#1677ff`、强制 `Inter` 或历史 8px 品牌圆角当默认主题，视为项目覆盖漂移。
+
+Ant Design v6 事实由 `yss-antd-design` 查询并回写证据，不要并列调用官方 `antd` skill，也不要在前端代码落地时继续使用它。进入实现后改走 `yss-ui`。
 
 ## 验证与回流
 

package/template/.trae/skills/yss-ui/SKILL.md

@@ -30,7 +30,7 @@ pnpm why vue @yss-ui/components @yss-ui/hooks ant-design-vue vxe-table
 
 记录实际版本、lockfile、验证命令和环境阻塞。完整策略见 `references/antdv-compatibility.md`。
 
-产品设计使用的 Ant Design v6 视觉/token 语义，不等于 Vue 生产实现 API。生产代码必须使用项目安装的 Ant Design Vue 4.x API，禁止复制 React hook、props 或组件写法。
+产品设计使用的 Ant Design v6 视觉/token 语义，不等于 Vue 生产实现 API。生产代码必须使用项目安装的 Ant Design Vue 4.x API，禁止复制 React hook、props 或组件写法。`yss-antd-design` 与 `@ant-design/cli` 只用于原型设计构建，进入本技能后不得再调用。
 
 ## 3. 组件选型门禁
 

package/template/AGENTS.md

@@ -24,7 +24,7 @@
 | 技能清单、来源、版本、哈希和投影目标      | `skills-lock.json`                          |
 | 技能分层、别名、默认可发现性和运行时入口 | `docs/agents/yss-skill-registry.yaml`（当前 `status: shadow`，不作为 Router / 生命周期运行时入口） |
 
-README、用户指南和其他说明文档只引用或解释上述事实，不重复定义同一规则。
+README、用户指南、根目录 `CLAUDE.md` 和其他说明文档只引用或解释上述事实，不重复定义同一规则。`CLAUDE.md` 是 Claude Code 入口指针，不是第二套 Agent 规则。
 
 ## 3. 标准文档语言与规范语汇
 
@@ -67,6 +67,7 @@ README、用户指南和其他说明文档只引用或解释上述事实，不
 - 无可复用工程时，先确认外部目标仓库或输出目录，再使用 `yss-ddd-scaffold-generator` / `yss-frontend-scaffold-generator`；当前仓库缺少 frontend / backend 目录不改变此路由。
 - 脚手架只在 `scaffold_status=required` 且受控生成合同已持久化、获得生命周期批准后运行；它只产生机械骨架，业务行为回到 Router 并使用 `behavior-tdd`。
 - 正式垂直切片必须消费已批准、已持久化且版本当前的 Slice Implementation Contract。Router 只生成草案，不批准合同、不设置 `ready-for-agent`、不宣布完成。合同 schema、Backend 子合同和证据字段以 `yss-router` references 为准。
+- 前端测试、type-check 与构建优先使用 `pnpm`；后端校验、测试与编译优先使用项目根 `./mvnw`。不要默认 `npm` / `yarn` 或裸 `mvn`。既有仓库确实没有 pnpm 或 Maven Wrapper 时，必须记录受控例外和实际命令。登记字段见 `docs/process/implementation-repo-integration.md`。
 - 路径越界、证据缺失、未执行验证、`drift`、`violation` 或 `new_impacts` 时停止实现并重新路由。
 
 实现细则由已批准合同、YSS skills 和实现接入文档定义；`AGENTS.md` 只保留入口与边界。
@@ -77,11 +78,12 @@ README、用户指南和其他说明文档只引用或解释上述事实，不
 |---|---|
 | 技术事实、标准、第三方 API 或框架行为影响决策 | `research` 或等价的一手资料记录 |
 | 竞品、市场或用户口碑事实 | `competitive-intelligence` |
-| UI 设计、原型、组件或主题 | `yss-design-system` 后使用 `yss-prototype-stage`；Codex 再路由 `product-design:index`，其他 Agent 交付等价合同资产；产出前后用 `antd` CLI 记录 Ant Design v6 与浏览器验证事实 |
+| UI 设计、原型、组件或主题 | `yss-design-system` 后使用 `yss-prototype-stage`；Codex 再路由 `product-design:index`，其他 Agent 交付等价合同资产；原型产出前后用 `yss-antd-design` 记录 Ant Design v6 事实与浏览器验证。前端代码落地改用 `yss-ui`，不要继续调用 `yss-antd-design` |
 | Bug、测试失败或性能回退 | `diagnosing-bugs` 建立可复现反馈，再用 `tdd` |
 | merge / rebase 冲突 | `resolving-merge-conflicts` |
 | 架构治理、难测模块或深模块设计 | `improve-codebase-architecture` / `codebase-design` |
 | 跨线程、跨仓库、上下文过长或原型结论回流 | `handoff` 或等价交接记录 |
+| 本地知识库 init / refresh / rebuild，或要把研究结果落成持久 wiki | `llm-wiki`（落成持久 wiki 用 `ingest`；已映射 live 源变了用 `refresh`） |
 
 业务行为默认按 `tdd` 使用已确认的公开 seam 逐切片实现。一次性生成、纯配置或流程文档不适用代码 TDD 时，必须记录例外理由和可执行验证方式。
 

package/template/CLAUDE.md

@@ -0,0 +1,13 @@
+# CLAUDE.md
+
+Agent 入口、硬门禁与禁止事项以仓库根 `AGENTS.md` 为准。每个任务先读 `yss-project.yaml` 识别仓库身份，再读 `CONTEXT.md`。本文件不另定义流程规则。
+
+## 前端 / 后端验证命令
+
+进入 frontend 或 backend 的实现、测试或编译时：
+
+- 前端优先使用 `pnpm` 做依赖、测试、type-check 与构建；不要默认 `npm` / `yarn`。
+- 后端优先使用项目根 `./mvnw` 做 `validate` / `test` / `package`；不要默认裸 `mvn`。
+- 既有仓库确实没有 pnpm 或 Maven Wrapper 时，记录受控例外和实际命令。
+
+登记字段与跨仓约束见 `docs/process/implementation-repo-integration.md`。

package/template/CONTEXT.md

@@ -34,6 +34,7 @@
 | YSS Skill Execution Result | YSS 专项 skill 完成工作单元后返回的结构化执行证据，记录合同版本、变更文件、证据文件、实际验证、延期 seam、偏离和新增影响。 | 实现者自报 `implemented` 不构成最终通过，必须由 Router、生命周期编排器和独立 Reviewer 复核。 |
 | ADR | 架构决策记录，用于沉淀难以回滚、非显而易见且存在真实取舍的技术决策。 | 常规实现选择不要写 ADR。 |
 | Fresh Verification | 完成前重新执行的验证证据，包括测试命令、契约校验、关键路径检查或人工审查结论。 | 不等同于“之前跑过”或实现者自述。 |
+| 实现验证命令 | 前端测试 / 构建优先 `pnpm`，后端校验 / 测试 / 编译优先 `./mvnw`。 | 不要默认 `npm`、`yarn` 或裸 `mvn`；仓库确实缺少 pnpm 或 Maven Wrapper 时记受控例外。 |
 | 测试质量基线 | 项目实例明确采纳的覆盖率阈值、关键流程清单和受控例外。 | 模板推荐值本身不构成可执行门禁；未定义关键流程时，不得声称其 E2E 覆盖率达到 100%。 |
 | 主阶段 | 对相邻研发目标、工作单元和退出条件的粗粒度生命周期分组。 | 不等同于门禁编号，也不因增加门禁而自动增加主阶段。 |
 | 生命周期门禁（条件强制门禁） | 只有当影响面命中触发条件时才必须裁决的生命周期审查点。 | 未触发时记录 `not-applicable` 及原因，不生成空文档；门禁不是产物、工作单元或证据的统称。 |
@@ -57,6 +58,7 @@
 | 显式兼容入口 | 为已有用户操作习惯保留的 user-invoked 工作流入口，写入前由生命周期编排器预检，结果回交其验收。 | 不是默认路径、过时别名或可以越过门禁的第二套生命周期。 |
 | 技能成熟度 | 描述技能从 `draft`、`verified`、`supported` 到 `deprecated` 的治理状态。 | 不等同于文件存在、已被投影或能够安装。 |
 | 技能注册表 | 记录技能身份、别名、分层、适用影响面、成熟度、默认可发现性和 Agent 运行时入口的机器可读路由资产。 | 不替代 `skills-lock.json` 的来源、hash 和投影完整性职责。当前 `docs/agents/yss-skill-registry.yaml` 为 `shadow`，Router 与生命周期不得按其裁剪发现面。 |
+| LLM Wiki | 由 `raw/`、`wiki/` 与 `.wiki-manifest.json` 组成的本地持久知识库。 | 不是 `research` 一次性笔记，也不替代权威源。`ingest` 只把用户点名的外源或已落盘研究笔记编进 IR，不改 live 权威文件。 |
 | 生态发布清单 | 关联模板 schema 与 commit、CLI 版本与快照、公开技能来源与导出 hash 的跨仓发布证据。 | 不要求尚未生成的仓库 commit 互相循环引用。 |
 | 研发管理仓库 | 承载 Spec、OpenAPI、架构、Ticket、验证、发布和复盘等研发管理资产的仓库。 | 不等同于前端 / 后端代码 monorepo。 |
 | 实现仓库 | 承载前端、后端或其他运行时代码及其 Git、CI、MR / PR、测试命令和发布流水线的仓库。 | 不要把实现仓库的源码所有权混入研发管理仓库。 |

package/template/docs/agents/yss-skill-registry.yaml

@@ -121,6 +121,12 @@ skills:
     instance_default_discoverable: true
     aliases: []
     impacts: [quality]
+  - id: llm-wiki
+    layer: core
+    maturity: verified
+    instance_default_discoverable: true
+    aliases: []
+    impacts: [quality]
   - id: lombok
     layer: specialist
     maturity: supported
@@ -277,6 +283,12 @@ skills:
     instance_default_discoverable: false
     aliases: []
     impacts: [writing]
+  - id: yss-antd-design
+    layer: specialist
+    maturity: supported
+    instance_default_discoverable: false
+    aliases: []
+    impacts: [prototype]
   - id: yss-api-integration
     layer: specialist
     maturity: supported

package/template/docs/design/README.md

@@ -4,8 +4,8 @@
 
 设计系统基线：
 
-- `docs/design/design.md`：从本地 `Product-Design-System` 引入并整理的 Ant Design 企业级设计系统说明，后续页面设计、交互说明、原型评审和前端实现默认引用该文件；官方 `design.md` 是上游默认，项目 token 是项目覆盖，优先级以该文件为准。
-- `docs/design/tokens/`：随仓库保存的主题、亮色 / 暗色 / 紧凑 token 和 CSS 变量快照，后续实现不得依赖本机 Downloads 目录。
+- `docs/design/design.md`：项目设计系统说明。默认亮色覆盖来自项目 Ant Design 5 `:root` / Less 裁定（主色 `#3371ff`、系统字体、6px 圆角），不再只沿用历史 `Product-Design-System` 包；官方 `design.md` 是上游默认，项目 token 是项目覆盖，优先级以该文件为准。
+- `docs/design/tokens/`：随仓库保存的主题、亮色 / 暗色 / 紧凑 token 和 CSS 变量快照，后续实现不得依赖本机 Downloads 目录或原始 Less。
 
 产品原型产出默认以 `product-design:index` 为主入口。该 skill 只负责路由，实际按 Product Design plugin 规则进入 `$get-context`、`$ideate`、`$prototype`、`$image-to-code`、`$url-to-code`、`$share` 或 `$design-qa` 等 focused skill；YSS 生命周期仍负责校验低保真评审、高保真 HTML 原型、AntD CLI 校验证据、用户确认和 Spec / OpenAPI 回填。
 
@@ -20,7 +20,7 @@
 - 表单、表格、弹窗、抽屉、步骤流等交互说明。
 - loading、empty、error、readonly、disabled、no-permission、conflict 等状态矩阵。
 - 页面字段、筛选条件、操作按钮和权限规则。
-- 低保真原型评审通过后的 Ant Design v6 高保真可交互 HTML 原型，默认路径为 `docs/.scratch/<feature>/design/prototypes/index.html`；该产物可由系统 / Agent 自动生成，不要求用户手工提供，产出前必须使用 `antd` CLI 查询设计语言、组件 API、demo、token 和 semantic 信息，产出后必须记录 AntD v6 校验证据并获得用户确认。
+- 低保真原型评审通过后的 Ant Design v6 高保真可交互 HTML 原型，默认路径为 `docs/.scratch/<feature>/design/prototypes/index.html`；该产物可由系统 / Agent 自动生成，不要求用户手工提供，产出前必须使用 `yss-antd-design` 查询设计语言、组件 API、demo、token 和 semantic 信息，产出后必须记录 AntD v6 校验证据并获得用户确认。前端代码落地改用 `yss-ui`。
 
 这些资产用于反推 API 影响、契约草案、OpenAPI 请求 / 响应字段、错误结构、分页筛选、权限状态和前端验收标准。
 
@@ -35,11 +35,11 @@
 
 推荐技能：
 
-- `yss-design-system`：项目设计系统与 Ant Design 企业级 UI 风格基线；页面设计、原型评审、UI 实现和主题 token 落地时默认先引用。
+- `yss-design-system`：项目设计系统与 Ant Design 企业级 UI 风格基线；页面设计、原型评审、UI 实现和主题 token 落地时默认先引用。Codex `$design-qa` 的 token / 字体对照读该技能的 `references/design-qa-theme.md`，以项目覆盖为准，不改上游 `design-qa` 插件。
 - `yss-prototype-stage`：跨 Agent 的原型阶段合同，固定资产、证据、设计优先级与生命周期回流；Codex 的主路由为 `product-design:index`。
 - `product-design:index`：Codex 产品原型产出的主路由；根据输入是否有 URL、截图、Figma、代码目标或视觉方向，进入 `$get-context`、`$ideate`、`$prototype`、`$image-to-code`、`$url-to-code`、`$share` 或 `$design-qa` 等 focused skill。
 - Product Design focused skills：基于 Spec 初稿和产品总体设计 / 功能架构，产出低保真 / 高保真页面、原型、交互设计资产和可分享原型；高保真 HTML 原型默认由该路由链路产出。
-- `antd`：Ant Design v6 组件、demo、token、semantic 和 design.md 查询工具；生成或修改高保真 HTML 原型前后必须留下 CLI 校验证据。
+- `yss-antd-design`：仅用于原型设计构建的 Ant Design v6 事实技能；生成或修改高保真 HTML 原型前后必须留下 CLI 校验证据。前端代码落地改用 `yss-ui`。
 - `prototype-review`：原型阶段评审门禁；未通过则不要进入 Spec 校准 / API 影响分析 / 契约草案。
 - 兼容入口：`product-design-prototype`、`high-fidelity-html-prototype` 仅作为历史兼容或产物门禁名称保留；新的产品原型产出默认使用 `product-design:index`，已退休技能不再提供兼容路由。
 

package/template/docs/design/design.md

@@ -2,20 +2,35 @@
 
 ## 来源与定位
 
-本文件基于本地设计系统包 `/Users/zhudaoming/Downloads/Product-Design-System` 首次分析整理。自本文件落地后，项目内设计系统的权威来源为 `docs/design/design.md` 与 `docs/design/tokens/*`，外部 Downloads 目录仅作为历史输入记录，不作为后续执行依赖。
+本文件基于本地设计系统包 `/Users/zhudaoming/Downloads/Product-Design-System` 首次分析整理，并在后续用项目 Ant Design 5 Less / `:root` CSS 变量覆盖默认亮色主题。自本文件落地后，项目内设计系统的权威来源为 `docs/design/design.md` 与 `docs/design/tokens/*`，外部 Downloads 目录和原始 Less 文件仅作为历史输入记录，不作为后续执行依赖，也不作为实现语言。
 
-本次分析的关键来源：
+关键来源：
 
-| 来源文件 | 作用 | 采用结论 |
+| 来源 | 作用 | 采用结论 |
 | --- | --- | --- |
-| `assets/design.md` | 完整 Ant Design 设计系统说明，包含颜色、排版、布局、组件、动效和定制规则 | 作为主要设计系统语义来源 |
+| 历史 `Product-Design-System` 包 | 首次引入 Ant Design 企业级语义、状态矩阵和验收习惯 | 保留原则、组件规则和审查清单 |
+| 项目 Ant Design 5 Less / `:root` 变量 | 默认亮色主题、运行时切换别名、色板与布局 token | **默认主题权威**；冲突时以 `:root` 为准 |
 | `docs/design/tokens/tokens.default.json` | 默认亮色主题派生 token | 作为实现 token 基线 |
-| `docs/design/tokens/tokens.dark.json` | 暗色主题派生 token | 作为后续暗色模式扩展来源 |
-| `docs/design/tokens/tokens.compact.json` | 紧凑密度主题派生 token | 作为后台密集表格 / 表单场景扩展来源 |
-| `docs/design/tokens/variables.css` | `--brand-*` CSS 变量 | 前端实现时优先转换为项目 token |
+| `docs/design/tokens/tokens.dark.json` | 暗色主题派生 token | 暗色仍走 `darkAlgorithm`；本轮未按新 seed 重派生完整暗色色板 |
+| `docs/design/tokens/tokens.compact.json` | 紧凑密度主题派生 token | 共享亮色 seed，紧凑高度算法保持现状 |
+| `docs/design/tokens/variables.css` | `--brand-*` 与运行时别名 | 前端实现时优先转换为项目 token |
 | `docs/design/tokens/theme.json` | Ant Design `ConfigProvider` theme 配置 | React + Ant Design 项目可直接参考 |
-| `DESIGN-HANDOFF.md` | 设计交付约束、响应式验证矩阵和实现顺序 | 作为 UI 实现验收补充 |
-| `DESIGN.md` | 品牌生成器输出的简要索引 | 仅作品牌包索引，不作为完整规范 |
+
+同份 Less 输入存在两套互相覆盖的默认值。项目裁定如下，并已写入 token 快照：
+
+| 项 | 采用 | 丢弃 |
+| --- | --- | --- |
+| 主色 | `#3371ff`（`--primary-color`） | `#3177ff` fallback、历史 `#1677ff` |
+| 信息色 | `#3371ff` | 历史 `#1677ff` |
+| 错误色 | `#f5222d` | 历史 `#ff4d4f` |
+| 页面背景 | `#f0f2f5` | 历史 `#f5f5f5` |
+| 主文本 / 次文本 | `rgba(0, 0, 0, 0.88)` / `rgba(0, 0, 0, 0.65)` | `#2e2e2e` / `#646464` |
+| 边框 / 分割线 | `#d9d9d9` / `#f0f0f0` | `#dbdbdb` / `#f1f1f1` |
+| 默认圆角 | `6px` | Less 前半 `4px`、历史品牌 `8px` |
+| 字体栈 | 系统栈 | 强制 `Inter` |
+| hover / active | `#4096ff` / `#0958d9`（`:root` 显式值） | 由新主色算法重算 |
+
+`.m-1` / `.flex-*` 等 utility class、`::-webkit-scrollbar` 定制和原始 `.less` 文件不纳入规范正文，只可作为可选实现备注。
 
 结论：这不是营销型视觉系统，而是面向中后台、数据密集、表单密集、流程密集产品的 Ant Design 风格企业级设计系统。项目内 UI 默认应以“清晰、确定、低装饰、可扫描、高一致性”为目标。
 
@@ -23,6 +38,10 @@
 
 原型使用 Ant Design 时，`https://ant.design/design.md` 与官方 `antd` CLI 提供的是**上游默认**和组件事实；项目的 `docs/design/design.md`、`docs/design/tokens/*` 是经过确认的**项目覆盖**。当前功能只能在这两层之下完成语义组件映射。若上游默认与项目 token 不同，以项目覆盖为准，并在 `prototype-evidence.yaml` 中记录差异；不得把上游默认直接写回项目实现。
 
+当前项目覆盖与官方默认的主要差异：主色 `#3371ff` ≠ 官方 `#1677ff`，错误色 `#f5222d` ≠ 官方 `#ff4d4f`，页面背景 `#f0f2f5`，文本使用 Ant Design 透明度阶，默认圆角 `6px`。`blue` 等预设色板仍可保留官方蓝谱；**色板预设 ≠ 品牌主色**。
+
+Codex `$design-qa` 的 Colors/tokens 与 Fonts/typography 对照必须以本文件和 `docs/design/tokens/*` 为 source visual truth，而不是官方默认或历史 `#1677ff` / `Inter` / `8px` 品牌圆角。执行清单见 `.agents/skills/yss-design-system/references/design-qa-theme.md`。
+
 ## 设计原则
 
 本项目采用该设计系统时，优先遵循四个原则：
@@ -40,29 +59,54 @@
 
 | Token | 值 | 用途 |
 | --- | --- | --- |
-| `colorPrimary` | `#1677ff` | 主按钮、链接、焦点、选中态、激活导航 |
+| `colorPrimary` | `#3371ff` | 主按钮、链接、焦点、选中态、激活导航 |
 | `colorPrimaryHover` | `#4096ff` | 主色 hover |
 | `colorPrimaryActive` | `#0958d9` | 主色 active |
 | `colorSuccess` | `#52c41a` | 成功状态 |
 | `colorWarning` | `#faad14` | 警告状态 |
-| `colorError` | `#ff4d4f` | 错误状态 |
-| `colorInfo` | `#1677ff` | 信息提示 |
-| `colorBgLayout` | `#f5f5f5` | 页面背景 |
+| `colorError` | `#f5222d` | 错误状态 |
+| `colorInfo` | `#3371ff` | 信息提示 |
+| `colorBgLayout` | `#f0f2f5` | 页面背景 |
 | `colorBgContainer` | `#ffffff` | 卡片、表格、表单、面板容器 |
 | `colorBgElevated` | `#ffffff` | 弹窗、下拉、浮层 |
-| `colorText` | `#2e2e2e` | 主文本 |
-| `colorTextSecondary` | `#646464` | 次级文本 |
-| `colorTextTertiary` | `#949494` | 说明 / 弱提示 |
-| `colorTextQuaternary` | `#c4c4c4` | placeholder / disabled |
-| `colorBorder` | `#dbdbdb` | 主边框 |
-| `colorBorderSecondary` | `#f1f1f1` | 次级分割线 |
+| `colorText` | `rgba(0, 0, 0, 0.88)` | 主文本 |
+| `colorTextSecondary` | `rgba(0, 0, 0, 0.65)` | 次级文本 |
+| `colorTextTertiary` | `#8c8c8c` | 说明 / 弱提示 |
+| `colorTextQuaternary` | `#bfbfbf` | placeholder / disabled |
+| `colorBorder` | `#d9d9d9` | 主边框 |
+| `colorBorderSecondary` | `#f0f0f0` | 次级分割线 |
 
 颜色使用规则：
 
 - 主色只表达全局主操作、链接、选中态和焦点态，不作为大面积背景装饰。
 - `success`、`warning`、`error`、`info` 只用于功能状态，不与品牌强调混用。
-- 预设色板如 `blue`、`purple`、`cyan`、`green`、`magenta`、`red`、`orange`、`yellow`、`volcano`、`geekblue`、`gold`、`lime` 主要用于 Tag、图表和分类可视化。
+- 预设色板如 `blue`、`purple`、`cyan`、`green`、`magenta`、`red`、`orange`、`yellow`、`volcano`、`geekblue`、`gold`、`lime` 主要用于 Tag、图表和分类可视化；其中 `blue-6` 仍可能是官方 `#1677ff`，不得当作品牌主色。
 - 产品代码中不要硬编码 `#ffffff`、`#fafafa` 等表面色，应引用语义 token。
+- 主色浅阶 `primary-1` 使用 `color-mix(in srgb, var(--primary-color) 10%, transparent)`，不要对 CSS 变量调用 Less `fade()`。
+
+### 运行时主题变量
+
+默认亮色支持运行时切换。`:root` 中的短名别名必须指向 `--brand-*`，不要再维护第二套色值。
+
+| 运行时别名 | 指向 | 默认值 |
+| --- | --- | --- |
+| `--primary-color` | `--brand-color-primary` | `#3371ff` |
+| `--primary-color-hover` | `--brand-color-primary-hover` | `#4096ff` |
+| `--primary-color-active` | `--brand-color-primary-active` | `#0958d9` |
+| `--primary-1` | `color-mix(in srgb, var(--primary-color) 10%, transparent)` | 主色 10% 透明 |
+| `--primary-7` | `--primary-color-active` | `#0958d9` |
+| `--success-color` | `--brand-color-success` | `#52c41a` |
+| `--warning-color` | `--brand-color-warning` | `#faad14` |
+| `--error-color` | `--brand-color-error` | `#f5222d` |
+| `--info-color` | `--brand-color-info` | `#3371ff` |
+| `--text-color` | `--brand-color-text` | `rgba(0, 0, 0, 0.88)` |
+| `--text-color-secondary` | `--brand-color-text-secondary` | `rgba(0, 0, 0, 0.65)` |
+| `--border-color` | `--brand-color-border` | `#d9d9d9` |
+| `--border-color-split` | `--brand-color-border-secondary` | `#f0f0f0` |
+| `--bg-color` | `--brand-color-bg-layout` | `#f0f2f5` |
+| `--bg-color-container` | `--brand-color-bg-container` | `#ffffff` |
+
+切换主题时只改 `--brand-*` 或同步改短名别名；不要在页面里另写一套 Less 变量。
 
 ### 排版
 
@@ -80,7 +124,7 @@
 字体栈：
 
 ```text
-Inter, system-ui, -apple-system, Segoe UI, Helvetica Neue, Arial, sans-serif
+-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"
 ```
 
 排版规则：
@@ -88,6 +132,7 @@ Inter, system-ui, -apple-system, Segoe UI, Helvetica Neue, Arial, sans-serif
 - 中后台产品默认正文使用 14px，以保证信息密度和可扫描性。
 - UI 字重优先使用 400 和 600，不使用 700+ 的重粗字作为状态强调。
 - 选中 / 激活状态优先通过颜色、边框、下划线和背景表达，不通过突然加粗制造跳动。
+- 不把 `Inter` 或其他品牌字体写成强制默认栈；项目若要引入品牌字体，必须先更新本文件和 token 快照。
 
 ### 间距与尺寸
 
@@ -111,16 +156,32 @@ Inter, system-ui, -apple-system, Segoe UI, Helvetica Neue, Arial, sans-serif
 - 表单、筛选区、工具栏、表格和详情页应优先使用密集但有节奏的布局。
 - 不使用任意 magic number；如确需新增尺寸，应先判断是否要扩展 token。
 
+### 布局 token
+
+| Token | 值 | 用途 |
+| --- | --- | --- |
+| `layoutHeaderHeight` | `64px` | 顶栏高度 |
+| `layoutSiderBackground` | `#001529` | 深色侧栏背景 |
+| `layoutBodyBackground` | `#f0f2f5` | 与 `colorBgLayout` 对齐的页面背景 |
+| `screenXS` | `480px` | 布局断点 |
+| `screenSM` | `576px` | 布局断点 |
+| `screenMD` | `768px` | 布局断点 |
+| `screenLG` | `992px` | 布局断点 |
+| `screenXL` | `1200px` | 布局断点 |
+| `screenXXL` | `1600px` | 布局断点 |
+
+这些断点用于栅格、隐藏工具类和布局折叠，不替换下方截图验收视口矩阵。
+
 ### 圆角
 
 | Token | 值 | 用途 |
 | --- | --- | --- |
-| `borderRadiusXS` | 3 | 极小元素 |
-| `borderRadiusSM` | 5 | 小标签、小控件 |
-| `borderRadius` | 8 | 当前品牌包默认圆角 |
-| `borderRadiusLG` | 10 | 大容器 / 浮层 |
+| `borderRadiusXS` | 2 | 极小元素 |
+| `borderRadiusSM` | 4 | 小标签、小控件 |
+| `borderRadius` | 6 | 默认控件圆角 |
+| `borderRadiusLG` | 8 | 大容器 / 浮层 |
 
-注意：`assets/design.md` 中 Ant Design 语义说明以 6px 控件圆角、8px 容器圆角为基准；当前品牌 token 派生结果将 `borderRadius` 设为 8px、`borderRadiusLG` 设为 10px。项目实现时以 `system/tokens.default.json` 为准，但应保持“控件圆角小于或等于容器圆角”的层级关系。
+保持“控件圆角小于或等于容器圆角”：默认控件 `6px`，小控件 `4px`，容器 `8px`。实现时以 `docs/design/tokens/tokens.default.json` 为准。
 
 ### 动效
 
@@ -181,6 +242,8 @@ Inter, system-ui, -apple-system, Segoe UI, Helvetica Neue, Arial, sans-serif
 | desktop | 1440 × 900 |
 | wide desktop | 1920 × 1080 |
 
+布局 CSS 断点补充：`480 / 576 / 768 / 992 / 1200 / 1600`。它们用于栅格和显示/隐藏，不替代上表截图验收尺寸。
+
 验收规则：
 
 - 不允许出现横向滚动，除非是明确设计的表格横向滚动容器。
@@ -195,7 +258,7 @@ Inter, system-ui, -apple-system, Segoe UI, Helvetica Neue, Arial, sans-serif
 - 使用 `ConfigProvider` 注入 `docs/design/tokens/theme.json` 中的 theme 配置。
 - 组件样式优先通过 Ant Design token、component token、CSS variables 或主题算法表达。
 - 消息、通知、Modal 静态方法应使用 `App`、hook API 或 context holder，避免主题上下文丢失。
-- 暗色模式使用 `darkAlgorithm` 或 `docs/design/tokens/variables.dark.css`，不要手工反转颜色。
+- 暗色模式使用 `darkAlgorithm` 或 `docs/design/tokens/variables.dark.css`，不要手工反转颜色。本轮只同步了暗色的字体栈和圆角 seed；完整暗色色板仍是历史算法结果，启用暗色前应再派生一次。
 - 紧凑模式使用 `compactAlgorithm` 或 `docs/design/tokens/tokens.compact.json`，不要逐组件压缩高度。
 
 如果前端不是 Ant Design：
@@ -203,6 +266,7 @@ Inter, system-ui, -apple-system, Segoe UI, Helvetica Neue, Arial, sans-serif
 - 先把 `docs/design/tokens/tokens.default.json` 转为项目设计 token，再映射到目标 UI 库。
 - 保留组件语义和状态语义，不要只复制颜色。
 - 尽量保持 32px 默认控件高度、14px 默认字号、4px 间距网格和三层表面模型。
+- 运行时动态换肤使用 `--primary-color` 等短名别名，或直接改 `--brand-*`。
 
 ## 设计审查清单
 
@@ -215,12 +279,13 @@ Inter, system-ui, -apple-system, Segoe UI, Helvetica Neue, Arial, sans-serif
 - 主操作是否唯一且清楚，次级操作是否降级。
 - 是否存在硬编码颜色、任意间距、重复自造控件或与系统冲突的交互。
 - 是否覆盖关键响应式断点。
+- Codex `$design-qa` 是否按项目覆盖对照主色、错误色、背景、文本、圆角和字体栈。
 
 ## 后续落地 TODO
 
 - 将 `docs/design/tokens/theme.json` 接入前端工程主题配置。
-- 将 `docs/design/tokens/variables.css` 中的 `--brand-*` 变量纳入项目 token 管理。
-- 如果项目启用暗色模式，补充 `docs/design/tokens/tokens.dark.json` 的使用规范和截图验收。
+- 将 `docs/design/tokens/variables.css` 中的 `--brand-*` 与运行时别名纳入项目 token 管理。
+- 如果项目启用暗色模式，用 `darkAlgorithm` 按新 seed 重派生 `docs/design/tokens/tokens.dark.json`，并补充截图验收。
 - 如果项目存在高密度表格 / 审批 / 运营台，补充 `docs/design/tokens/tokens.compact.json` 的适用边界。
 
 ## Ant Design v6 原型补充基线

package/template/docs/design/templates/prototype-evidence-template.yaml

@@ -9,7 +9,16 @@ design_baseline:
   upstream_design_md_source: https://ant.design/design.md
   upstream_design_md_record_ref: <path-to-json-output-or-summary>
   project_override_reviewed: false
+  theme_override:
+    color_primary: "#3371ff"
+    color_error: "#f5222d"
+    color_bg_layout: "#f0f2f5"
+    border_radius: 6
+    font_family: system-stack
+    recorded: false
+    note: 与官方 #1677ff / Inter / 8px 的差异必须记录；无差异则 recorded=false 并说明沿用项目默认。
 antd:
+  fact_skill: yss-antd-design
   cli_command: antd
   cli_version: <actual-cli-version>
   target_antd_version: <project-selected-v6-version>
@@ -21,7 +30,9 @@ antd:
         demo_ref: <path-to-json-output>
         token_ref: <path-to-json-output>
         semantic_ref: <path-to-json-output>
-  lint_ref: <path-to-json-output>
+  lint_applicable: not-applicable
+  lint_reason: html-prototype
+  lint_ref: <path-to-json-output-or-none>
   lint_passed: false
 browser_verification:
   executor: <browser-or-automation-name>