create-yss-spec 3.3.1 → 3.3.3

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

@@ -1,108 +0,0 @@
----
-name: yss-design-system
-description: Use when YSS 产品设计系统与 Ant Design 企业级 UI 风格基线。涉及页面设计、原型评审、UI 实现、组件选型、主题 token、颜色排版间距、响应式验收、Ant Design/YSS UI 风格一致性、docs/design/design.md 更新或从外部设计系统引入规范时必须使用。
----
-
-# YSS Design System
-
-本技能用于把项目 UI 统一到一套可执行的设计系统基线：Ant Design 企业后台风格、YSS 页面工程习惯、设计 token、组件语义、交互状态和响应式验收。
-
-## 权威资料
-
-- 规范源：根 `DESIGN.md`，是项目视觉 Token 与组件视觉变体的唯一事实来源，使用 Google `design.md` alpha canonical H2 章节。
-- 团队治理说明：`docs/design/design.md`，解释 YSS 生命周期、组件路线、状态与验收，不重新定义 `DESIGN.md` 中的具体值。
-- 项目 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`，只用于追溯首次引入来源，不作为后续工程依赖。
-- 默认亮色覆盖：项目 Ant Design 5 Less / `:root` 变量已裁定进 `docs/design/design.md` 与 token 快照；原始 Less 不是实现语言。
-- Codex `$design-qa` 项目对照：`references/design-qa-theme.md`，不替代官方 `design-qa` 流程，也不改上游插件正文。
-- 原型阶段合同：`yss-prototype-stage`，用于统一 H1/H2 原型资产和浏览器验证证据。H2 默认由 `yss-antdv-next-design` 提供 Vue/Antdv Next 事实；显式 React 兼容路线由 `yss-antd-design` 提供事实。
-
-如果只需要快速判断，先读本文件。若要写 UI 规范、实现页面、评审设计或调整 Token，必须按 `DESIGN.md` → `docs/design/design.md` → `docs/design/tokens/*` 顺序读取；若要执行评审或实现检查，再读 `references/design-system.md`。
-
-## 使用流程
-
-1. 先判断任务阶段：设计系统引入 / 产品设计 / 原型评审 / 前端实现 / UI 改造 / 主题 token 落地。
-2. 读取已有资产：先读根 `DESIGN.md`，再读 `docs/design/design.md` 和 Token 派生快照，最后按任务读取相关 Spec、交互说明、状态矩阵、OpenAPI Draft、现有页面代码。
-3. 按设计系统基线约束输出或修改产物：颜色、排版、间距、圆角、动效、组件、状态、响应式。
-4. 若是产品设计阶段，先使用 `yss-prototype-stage`；Codex 以 `product-design:index` 为主入口，其他 Agent 必须交付等价合同资产和证据。
-5. 若是前端实现阶段，配合 `yss-ui`、`yss-ui-business-page-generation`、`yss-components`、`yss-formily`，但本技能负责风格与体验一致性门禁。
-6. 若发现视觉 Token 或组件变体不足，先更新根 `DESIGN.md` 并重新生成投影；只有治理、流程或验收说明不足时才更新 `docs/design/design.md`。
-
-## 核心基线
-
-- UI 定位：中后台、数据密集、表单密集、流程密集、可扫描、低装饰。
-- 颜色：使用 `DESIGN.md` 的 `colors.*`；品牌 seed 与高对比主控件变体是不同角色，不得用 seed 绕过 `components.button-primary*`。
-- 排版：使用 `DESIGN.md` 的 `typography.*`，状态不能只靠字重表达。
-- 密度：使用 `DESIGN.md` 的组件高度与 `spacing.*`；默认工作界面只应用一次 compact algorithm，不手工二次压缩。
-- 圆角：使用 `rounded.*`，控件、容器和 pill 角色不得用页面级 magic number 替代。
-- 运行时换肤：短名 CSS 变量必须指向 `--brand-*`，不要再维护第二套色值。
-- 表面层级：页面背景、内容容器、浮层三层模型。
-- 组件语言：优先 Ant Design / YSS UI 语义，不自造同类控件。
-- 状态完整性：loading、empty、error、readonly、disabled、no-permission、conflict、success 必须在设计或实现中可解释。
-- 原型基线：先用项目语义 token 定义角色，再用组件 token 或 CSS variables 落地；不以局部硬编码替代主题层。H2 默认 Vue/Antdv Next 只消费精确版本且 digest 新鲜的 fact pack；React AntD 只用于显式兼容路线。
-- 档位版本边界：H1 只依赖项目 Token；H2 Vue/Antdv Next 默认路线与 React AntD 兼容路线分别精确锁版本。两条原型路线都不改变生产实现边界；生产 API 只在实现阶段从目标仓 lockfile 读取 Vue 3 + YSS UI + AntDV 事实。
-
-## 强制规则
-
-- 不把该系统改造成营销落地页风格；业务应用首屏应直接进入可用工作界面。
-- 不用大面积渐变、装饰插画、夸张 hero、过度卡片化或单色系视觉堆叠替代信息结构。
-- 不在同一决策区域放两个 primary 按钮。
-- 每个页面或决策区域只保留一个 single primary action；其余动作降级为默认、链接或危险操作。
-- 不硬编码表面色、边框色、状态色；优先使用 token 或主题变量。
-- 交互原型中的每个可点击主动作都必须给出 interaction feedback：状态变化、禁用原因、成功或失败反馈至少覆盖其一。
-- accessibility：品牌 Seed 保持 `colors.primary`；实际文字/背景组合不满足 WCAG 2.2 AA 时，优先使用 `components.*` 中的高对比变体或 `ConfigProvider` component token 调整，并验证 default/hover/active/disabled/focus、键盘焦点、200% zoom、reduced motion 与目标尺寸，不新增页面级特例色。
-- Antdv Next 默认路线与 React Ant Design 兼容路线的暗色或紧凑密度必须使用各自精确版本支持的 theme algorithm；基础 seed 和 compact 结果均从规范源/派生快照读取，不手工反转颜色、逐控件压缩或重复 compact。
-- 不依赖 Ant Design v6 / Antdv Next 的内部 DOM、生成类名或未记录 API；只使用公开 API、semantic token 与项目主题变量。
-- 不用 Tag 表达关键错误、阻断或审批状态；关键状态必须有可读文本和语义反馈。
-- 不让按钮、标签、表头、弹窗、卡片中的文字溢出或遮挡。
-- 不在表格 / 筛选 / 批量操作密集页面使用松散营销式布局。
-
-## 产出要求
-
-设计类任务至少输出：
-
-- 设计系统引用：明确引用 `docs/design/design.md`。
-- 页面和模块：页面清单、布局结构、主路径、异常路径。
-- 组件选择：YSS UI / Ant Design 组件映射。
-- 状态矩阵：加载、空、错、禁用、只读、无权限、冲突、成功。
-- API 反推：字段、筛选、分页、动作、错误码、权限、并发或幂等规则。
-- 响应式要求：关键断点和窄屏替代形态。
-
-实现类任务至少检查：
-
-- 是否通过 `ConfigProvider`、CSS variables 或项目 token 消费主题。
-- 是否将颜色、圆角、阴影和状态样式绑定到 semantic token，而不是复制表面色和交互色。
-- 是否使用当前 `DESIGN.md` 和 compact 派生快照中的控件、排版与间距值，且没有重复 compact。
-- 是否使用 YSS UI / Ant Design 的语义组件，而不是自造同类组件。
-- 是否保留 hover、focus、active、disabled、loading、error、empty 状态。
-- 是否为可提交、导出、保存、发布、审批等操作提供明确的 interaction feedback 与不可逆操作确认。
-- 是否在核心视口无横向溢出；表格横向滚动必须被限定在表格容器内。
-
-## 与其他技能的关系
-
-| 场景 | 配合技能 |
-| --- | --- |
-| Spec 后做页面 / 原型 / 交互说明 | `yss-prototype-stage` → `product-design:index` |
-| 低保真原型进入高保真前评审 | `prototype-review` |
-| 低保真评审后的原型交付物 | `yss-prototype-stage` 选择 H1/H2；`high-fidelity-html-prototype` 仅只读迁移 |
-| 低保真线框或流程图 | `product-design:index` |
-| 前端页面实现 | `yss-ui` / `yss-ui-business-page-generation` |
-| 表单 schema | `yss-formily` |
-| YTable / YTree / 高度自适应 | `yss-components` / `yss-use-table-height` / `yss-use-tree-height` |
-| H2 Vue/Antdv Next 默认原型的组件 / token / demo 查询 | `yss-antdv-next-design`（精确版本 fact pack，不用于 H1） |
-| H2 React/AntD 显式兼容原型的组件 / token / demo 查询 | `yss-antd-design`（fact pack 优先，不用于 H1） |
-| Codex 原型交接前的视觉 QA | `design-qa`；token / 字体对照读 `references/design-qa-theme.md`，以项目覆盖为准 |
-| 原型渲染适配 | `yss-prototype-stage/references/product-design-adapter.md`；H1 静态、H2 可运行流程；不得调用 `yss-ui` |
-| API 契约 / 接入 | `yss-openapi-governance` / `yss-api-integration` |
-
-## 更新设计系统
-
-当用户要求“引入设计系统”“形成项目规范”“更新设计系统 skill”时：
-
-1. 分析来源设计系统，不原样堆拷贝。
-2. 将稳定视觉 Token 与组件变体先落到根 `DESIGN.md`；治理、流程和验收说明再落到 `docs/design/design.md`。
-3. 运行 `node .template-source/tooling/node/scripts/design-md.mjs export dtcg --write --write-manifest` 更新派生视图，并更新 `docs/design/design-system-sync.yaml` 的规范源摘要。
-4. 将 Agent 执行入口落到 `.agents/skills/yss-design-system/SKILL.md`，执行清单落到 `references/design-system.md`；两者只引用 Token 名和角色，不复制具体值。
-5. 更新 `docs/design/README.md` 和必要的 `AGENTS.md` 入口规则。
-6. 运行 frontmatter、对应 `node --test`、`design-md lint/drift`、技能投影与 lock 校验。

package/template/.claude/skills/yss-design-system/agents/openai.yaml

@@ -1,5 +0,0 @@
-version: 1
-interface:
-  display_name: "YSS Design System"
-  short_description: "YSS 产品设计系统与 Ant Design 风格基线"
-  default_prompt: "Use $yss-design-system to design or review a YSS UI against the project design system."

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

@@ -1,62 +0,0 @@
-# Design QA 项目主题对照
-
-本文件给 Codex `$design-qa` 使用。官方 `design-qa` skill 仍负责截图对比流程和 `final result: passed|blocked`；本文件只提供项目视觉真相，不改上游插件正文。
-
-## Source visual truth
-
-- 规范：根 `DESIGN.md`
-- 治理说明：`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` 只是上游默认。项目覆盖与官方不同时，以根 `DESIGN.md` 为准；本清单不复制规范值。
-
-## 必查 fidelity surface（项目覆盖）
-
-### Colors and visual tokens
-
-| 角色 | 必须对照 | 记为 P1 Token drift |
-| --- | --- | --- |
-| 品牌 seed | `colors.primary` | 使用上游默认或历史值覆盖根规范 |
-| 主控件 default / hover / active / disabled | `components.button-primary*` | 用品牌 seed 代替高对比组件变体 |
-| 功能状态 | `colors.success*` / `warning*` / `error*` / `info-bg` | 改成非功能色装饰 |
-| 页面 / 容器 / 浮层 | `colors.canvas-layout` / `surface*` | 用阴影或局部硬编码堆叠表面层级 |
-| 主次文本 | `colors.text*` | 使用历史文本值或页面特例 |
-| 运行时变量 | `docs/design/tokens/variables.css` 必须与根规范 digest 同步 | 页面另写一套 Less/CSS 色值 |
-
-上游预设色板不是品牌 seed，不要据此判定规范漂移。
-
-### Fonts and typography
-
-| 角色 | 必须对照 | 记为 P1 token drift |
-| --- | --- | --- |
-| 正文与标题 | `typography.*` | 使用未登记的营销字号或字体 |
-| 控件高度 | `components.button-*` / `input-*` | 用 seed 或页面硬编码替代组件变体 |
-| 字体栈 | `typography.*.fontFamily` | 强制未登记品牌字体 |
-| 字重 | `typography.*.fontWeight` | 用额外重粗表达选中或激活 |
-
-### Spacing and layout rhythm
-
-| 角色 | 必须对照 | 记为 P1 token drift |
-| --- | --- | --- |
-| 圆角 | `rounded.*` 与组件变体 | 页面级 magic number 或历史品牌圆角 |
-| 间距 | `spacing.*` 与组件变体 padding | 未登记的中间值撑开中后台密度 |
-| 布局 | `components.page-shell` 与治理说明 | 未说明就改成营销式布局 |
-
-### Image quality and copy
-
-沿用官方 `design-qa` 规则。本主题不引入插画、logo 或营销文案；出现这类素材时按官方 rubric 记 finding，并同时记为偏离中后台定位。
-
-## 判定
-
-- 使用上游默认、历史品牌值或未登记字体/圆角覆盖根 `DESIGN.md`：P1。
-- 只改局部组件、且 `prototype-evidence.yaml` 的 `theme_override` 已记录：按官方 severity 评估，不自动升 P1。
-- 暗色模式：本轮未重派生完整暗色色板；暗色对照前若缺少新的 algorithm 派生证据，`final result: blocked`，写明 blocker。
-
-## 报告要求
-
-`design-qa.md` 必须写明：
-
-- source visual truth path：根 `DESIGN.md`、治理说明与对应 Token 投影文件
-- 已按本清单核对 Colors/tokens 与 Fonts/typography
-- 与官方默认的差异是否被接受为项目覆盖

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

@@ -1,228 +0,0 @@
-# YSS 设计系统执行规范
-
-本文件是 YSS 设计系统的 skill 侧执行清单，面向 Agent 执行、设计评审和前端实现，不单独承载新的 Token 决策或具体值。
-
-权威资料：
-
-- 规范源：根 `DESIGN.md`（项目视觉 Token 与组件视觉变体）
-- 治理说明：`docs/design/design.md`（生命周期、组件路线、状态与验收）
-- 派生快照：`docs/design/tokens/*`（实现映射，不得反向覆盖规范源）
-- Skill 入口：`.agents/skills/yss-design-system/SKILL.md`
-
-## 设计定位
-
-本项目 UI 默认采用 Ant Design 企业级中后台风格，而不是营销站、品牌官网或概念展示风格。
-
-关键词：
-
-- 数据密集
-- 表单密集
-- 流程密集
-- 可扫描
-- 状态确定
-- 低装饰
-- 组件一致
-
-页面首屏应优先呈现实际业务界面。除非需求明确要求 Landing Page，不要创建营销式 hero、过度装饰、全屏宣传页或卡片堆叠式介绍页。
-
-## 设计原则
-
-| 原则 | 执行要求 |
-| --- | --- |
-| Natural | 使用熟悉的中后台模式，如筛选区、表格、详情抽屉、Modal、Tabs、左树右表 |
-| Certain | 每个操作都有明确状态反馈，加载、错误、权限、只读、冲突不靠猜 |
-| Meaningful | 视觉强调只服务于主操作、状态和层级，不做无意义装饰 |
-| Growing | 支持从简单表单扩展到复杂表格、审批流、控制台和多模块页面 |
-
-## Token 基线
-
-### 颜色
-
-| 角色 | 规范源 | 运行时映射 |
-| --- | --- | --- |
-| 品牌 seed | `colors.primary` | `colorPrimary` / `--brand-color-primary` |
-| 高对比主控件 | `components.button-primary*` | `--yss-color-primary-control*` 或组件 Token |
-| 页面 / 容器 / 浮层 | `colors.canvas-layout` / `surface` / `surface-elevated` | 对应 `colorBg*` / `--brand-color-bg-*` |
-| 主次文本 | `colors.text*` | 对应 `colorText*` / `--brand-color-text*` |
-| 功能状态 | `colors.success*` / `warning*` / `error*` / `info-bg` | 对应状态 semantic Token |
-| 边框 | `colors.border-secondary` | 对应边框 semantic Token |
-
-颜色规则：
-
-- 主色只用于主操作、链接、焦点、选中态和激活导航。
-- `success`、`warning`、`error`、`info` 只表达功能状态。
-- 预设色板只用于 Tag、图表、分类可视化，不用于重新定义主操作。
-- 不硬编码白色、灰色、状态色；优先引用 token、CSS variables 或 Ant Design theme。
-- semantic token 优先于色值：页面先声明背景、容器、浮层、文本、边框、状态等角色，再映射到具体 token。
-- 运行时短名 `--primary-color`、`--text-color`、`--bg-color` 必须指向 `--brand-*`，不要再维护第二套色值。
-- 上游预设色板与项目品牌 seed 是不同角色；色板预设 ≠ 品牌主色。
-- accessibility contrast 不足时，通过 `ConfigProvider` 的 seed token 或组件 token 调整；不要为单个页面制造不可复用的深浅色例外。
-- Codex `$design-qa` 的 token / 字体对照读 `references/design-qa-theme.md`。
-
-### 排版
-
-| 角色 | 规范源 | 用途 |
-| --- | --- | --- |
-| 正文 | `typography.body` | 默认正文、控件、表格 |
-| 强调正文 | `typography.body-strong` | 表头与必要强调 |
-| 大 / 中标题 | `typography.heading-lg` / `heading-md` | 页面与分区层级 |
-| 辅助文本 | `typography.caption` | 说明、Tag 与次级信息 |
-| 按钮 | `typography.button` | 控件文字 |
-
-排版规则：
-
-- 正文、标题、辅助文本和按钮的字号、字重、行高均从 `DESIGN.md` 对应角色读取。
-- 字体栈使用系统字体，不强制 `Inter`。
-- 不用 700+ 粗体表达选中或激活状态。
-- 选中状态优先使用颜色、边框、下划线、背景表达。
-
-### 间距、尺寸、圆角
-
-| 类型 | 规范源 |
-| --- | --- |
-| 间距 | `spacing.*` 与组件变体的 `padding` |
-| 控件高度 | `components.button-*` / `input-*` 的 `height`；算法 seed 见治理说明 |
-| 控件 / 容器圆角 | `rounded.*` 与组件变体的 `rounded` |
-| 页面 / Card 内边距 | `components.page-shell` / `card-compact` |
-
-执行规则：
-
-- 间距只使用 `spacing.*`，不要补写未登记的中间值。
-- 默认工作界面叠加一次 compact algorithm；seed 与计算结果从规范源和派生快照读取，不得二次 compact。
-- 表单、筛选区、工具栏、表格、详情页使用密集但有节奏的布局。
-- 控件圆角不得明显大于容器圆角。
-- 不使用任意 magic number；确需新增尺寸时，先说明为什么 token 不够。
-
-### 动效
-
-动效只服务于状态反馈、层级变化和空间关系。使用目标 Provider 的 semantic motion Token，不在页面或本执行清单中自造 duration/easing；项目需要稳定覆盖时先登记到根 `DESIGN.md`。
-
-## 组件规则
-
-| 组件 | 规则 |
-| --- | --- |
-| Button Primary | 每个决策区域只保留一个主按钮 |
-| Button Default | 次级动作默认使用默认按钮或描边按钮 |
-| Input / Select | 使用 `components.input-*` 高度和圆角，focus 可见；不得以算法 seed 冒充 compact 结果 |
-| Card | 只用于真实内容容器，不做卡片套卡片 |
-| Modal | 用于阻断式决策和关键表单 |
-| Drawer | 用于详情、编辑、辅助流程，不打断主列表上下文 |
-| Menu | 选中态使用淡蓝背景和主色文本 |
-| Tabs | 激活态使用主色文本和下划线，不加背景块 |
-| Table | 表头浅表面色 + 600 字重；hover 再强调行 |
-| Tag | 表达分类，不表达关键阻断状态 |
-| Alert | 表达成功、警告、错误、信息等语义反馈 |
-| Badge | 只做紧凑状态提示，不能替代文本 |
-| Tooltip | 只提供补充解释，不承载关键业务信息 |
-
-交互规则：
-
-- 每个决策区域只保留一个 single primary action；危险操作和次级动作必须在视觉层级上降级。
-- 保存、提交、审批、发布、导出等可点击动作必须产生 interaction feedback，包括结果消息、行内状态变化、禁用原因或确认弹窗。
-- 风险或不可逆动作使用 Modal 二次确认；禁止将“已发布”误表示为“已执行数据库变更”。
-
-## 页面规则
-
-- 后台页面优先使用：Header / 查询区 / 工具栏 / 表格 / 详情抽屉 / 弹窗。
-- 主从关系优先使用：左树右表、列表 + 详情、Tabs + 分区。
-- 表格密集场景优先保证列可读、操作稳定、横向滚动受控。
-- 筛选区要支持重置、提交、默认值和窄屏重排。
-- 空态要说明下一步，不只显示“暂无数据”。
-- 无权限态要说明权限缺失，不假装是空数据。
-
-## 状态矩阵
-
-设计、原型或实现至少考虑：
-
-- loading
-- empty
-- error
-- readonly
-- disabled
-- no-permission
-- conflict
-- dirty / unsaved
-- success
-
-关键业务流还要补充：
-
-- optimistic update
-- idempotency
-- concurrent modification
-- partial success
-- retryable failure
-- audit-visible action
-
-## 响应式验收
-
-核心视口：
-
-| 名称 | 尺寸 |
-| --- | --- |
-| mobile compact | 360 × 800 |
-| mobile standard | 390 × 844 |
-| mobile large | 430 × 932 |
-| foldable / small tablet | 600 × 960 |
-| tablet portrait | 820 × 1180 |
-| tablet landscape | 1024 × 768 |
-| laptop | 1366 × 768 |
-| desktop | 1440 × 900 |
-| wide desktop | 1920 × 1080 |
-
-验收规则：
-
-- 页面整体不出现意外横向滚动。
-- 表格横向滚动必须限定在表格容器内。
-- 工具栏、筛选区、批量操作区在窄屏下重排或折叠。
-- 长文本、按钮、标签、表头、弹窗内容不得溢出。
-- 移动端表格需要说明替代形态，如卡片列表、关键列优先或详情抽屉。
-
-## 前端落地
-
-React + Ant Design：
-
-- 使用 `ConfigProvider` 注入主题。
-- 默认工作界面使用 `theme.compactAlgorithm`；暗色紧凑模式组合 `theme.darkAlgorithm` 与 `theme.compactAlgorithm`，不手工反转色值或逐组件压缩。
-- seed 与 compact 计算值以 `DESIGN.md` / `tokens.compact.json` 为准；不要重复 compact。
-- 优先通过 token、component token、CSS variables、theme algorithm 实现样式。
-- 静态反馈 API 使用 `App`、hook API 或 context holder，避免主题上下文丢失。
-- 暗色模式使用 `darkAlgorithm` 或 `variables.dark.css`。
-- 紧凑模式使用 `compactAlgorithm` 或 `tokens.compact.json`。
-
-实验 Vue + Antdv Next：
-
-- H2 默认先使用 `yss-antdv-next-design` 校验精确版本 fact pack、组件集合与项目 baseline digest。
-- 共享本规范的 semantic token、紧凑密度和验收语义；props、events、slots 与主题 API 只从 Antdv Next fact pack 读取。
-- `yss-antd-design` 只保留为显式 React/AntD 兼容路线；默认 Provider 与兼容 Provider 都不替换生产 `yss-ui` 路线。
-
-YSS UI / Vue：
-
-- 业务页面实现与生命周期编排统一走 `yss-ui` 和 `yss-ui-business-page-generation`。
-- 新业务表单使用 `YFormily` schema；`YssFormily` 仅用于历史兼容。
-- 表格使用 `YTable`，列定义使用项目约定字段。
-- 高度自适应使用 `useTableHeight` / `useTreeHeight`。
-- 请求、分页、筛选参数下沉到 Hook。
-
-## 评审清单
-
-设计评审时检查：
-
-- 是否引用 `docs/design/design.md`。
-- 是否符合中后台定位。
-- 页面清单、主路径、异常路径是否清楚。
-- 状态矩阵是否完整。
-- 组件选择是否复用 YSS UI / Ant Design。
-- API 反推字段、筛选、分页、动作、错误、权限是否完整。
-- 主操作是否唯一，次级操作是否降级。
-- 响应式断点和窄屏替代形态是否清楚。
-
-实现评审时检查：
-
-- 是否消费 token，而不是硬编码颜色和尺寸。
-- 是否以 semantic token 表达颜色、圆角、阴影和状态层级。
-- 是否使用当前 `DESIGN.md` 与 `tokens.compact.json` 的排版、控件和间距值，且没有重复 compact。
-- 是否保留 hover、focus、active、disabled、loading、empty、error 状态。
-- 是否只保留一个 single primary action，并让每个关键操作提供 interaction feedback。
-- 是否在目标字号和背景下复核 accessibility contrast。
-- 是否存在卡片套卡片、营销式 hero、装饰性渐变或无意义插画。
-- 是否存在横向溢出、文本遮挡或按钮文字溢出。

package/template/.claude/skills/yss-design-system/scripts/validate-frontmatter.mjs

@@ -1,36 +0,0 @@
-#!/usr/bin/env node
-import { readFile } from "node:fs/promises";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-
-export function validateFrontmatter(text) {
-  const match = /^---\n([\s\S]*?)\n---/.exec(text);
-  if (!match) throw new Error("Invalid SKILL.md frontmatter block");
-  const fields = new Map();
-  for (const line of match[1].split("\n")) {
-    if (!line.trim()) continue;
-    const index = line.indexOf(":");
-    if (index < 0) throw new Error(`Invalid frontmatter line: ${line}`);
-    fields.set(line.slice(0, index).trim(), line.slice(index + 1).trim());
-  }
-  const keys = [...fields.keys()].sort();
-  if (keys.join(",") !== "description,name") throw new Error(`Expected keys ['description', 'name'], got ${JSON.stringify(keys)}`);
-  const name = fields.get("name");
-  const description = fields.get("description");
-  if (!/^[a-z0-9-]+$/.test(name)) throw new Error("Invalid skill name: " + name);
-  if (!description || description.length > 1024) throw new Error("Description must be present and <= 1024 chars");
-  return name;
-}
-
-async function main() {
-  const skill = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "SKILL.md");
-  try {
-    const name = validateFrontmatter(await readFile(skill, "utf8"));
-    console.log(`${name} frontmatter ok`);
-  } catch (error) {
-    console.error(error.message);
-    process.exitCode = 1;
-  }
-}
-
-if (process.argv[1] === fileURLToPath(import.meta.url)) await main();

package/template/.claude/skills/yss-design-system/scripts/validate-frontmatter.test.mjs

@@ -1,12 +0,0 @@
-import assert from "node:assert/strict";
-import test from "node:test";
-import { validateFrontmatter } from "./validate-frontmatter.mjs";
-
-test("accepts the required skill frontmatter", () => {
-  assert.equal(validateFrontmatter("---\nname: yss-design-system\ndescription: Use when validating a skill.\n---\n"), "yss-design-system");
-});
-
-test("rejects missing and unsupported frontmatter fields", () => {
-  assert.throws(() => validateFrontmatter("# no frontmatter"), /Invalid SKILL/);
-  assert.throws(() => validateFrontmatter("---\nname: bad\nextra: x\n---"), /Expected keys/);
-});

package/template/.claude/skills/yss-distributed-id/SKILL.md

@@ -1,69 +0,0 @@
----
-name: yss-distributed-id
-description: Use when 用于 YSS 分布式 ID 组件的接入与排障。当用户提到 Leaf、CosId、号段模式、雪花算法、AutoIdInterceptor、MyBatis 自动注入 ID 或主键生成策略时调用。
----
-
-# yss-distributed-id
-
-用于处理 `yss-component-distributed-id` 的配置、接入和问题定位。
-
-## 何时使用
-
-- 用户要启用分布式 ID。
-- 用户提到 Leaf Segment、Snowflake、CosId、UUID。
-- 用户反馈批量插入未自动注入 ID、ID 冲突、ID 类型不匹配。
-
-## 工作方式
-
-1. 先识别项目用的是哪种 ID 策略。
-2. 涉及真实类名、配置项、Leaf 服务或批量插入排障时，先读 `references/source-index.md`，再定位源码或文档。
-3. 再看实体注解、拦截器配置和底层表或注册中心依赖是否齐全。
-4. 修改时优先保持现有策略，不轻易切换算法。
-
-## 源码索引
-
-- 源码位置不要假设固定目录；先按 `yss-skill-source-index-refresh/references/source-location.md` 定位。
-- 当前技能索引：`references/source-index.md`
-- 重点源码入口通常包括 `EnableDistributedId`、`AutoIdInterceptor`、Leaf 配置、Leaf REST/Feign/gRPC 模块、ID 策略相关类。
-
-当组件源码变化后，用 `yss-skill-source-index-refresh` 刷新索引；刷新或读取前先按源码定位策略确认真实位置。
-
-## 检查清单
-
-- 启动类是否启用了分布式 ID 能力。
-- 当前策略是否与部署条件匹配。
-- 批量插入链路是否会经过拦截器。
-- 实体主键类型与生成策略是否兼容。
-- Leaf Segment 场景下 `leaf_alloc` 是否已初始化。
-- MyBatis/MyBatis-Plus 的插入方法是否绕过了自动 ID 拦截逻辑。
-- 多服务共享号段时，业务 tag/key 是否唯一且稳定。
-
-## 策略建议
-
-- 追求稳定和趋势递增时，优先 Leaf Segment。
-- 依赖 ZooKeeper 且要求高吞吐时，可考虑 Snowflake。
-- 若项目已有 CosId 统一方案，沿用现有生态。
-- 除非业务明确允许，否则不要把 Long 主键切到 String UUID。
-
-## 修改约束
-
-- 不要混用多种主键生成策略而不说明边界。
-- 不要仅改实体注解而忽略底层配置和依赖。
-- 如果用户只是在做普通 MyBatis-Plus 主键配置，不要过度引入新组件。
-- 不要在已有 Long 主键生态里随意改成 String UUID，除非调用方和数据库约束都确认兼容。
-
-## 排障顺序
-
-1. 确认启用注解和 starter 依赖。
-2. 确认实体主键类型、注解和插入方法。
-3. 确认拦截器是否参与 MyBatis 调用链。
-4. Leaf 场景确认服务、号段表和业务 key。
-5. Snowflake/CosId 场景确认机器号、时钟、注册中心或 worker 分配。
-6. 批量插入失败时确认是否调用了项目推荐批量方法。
-
-## 按需读取
-
-- 源码索引：`references/source-index.md`
-- 拦截器与自动注入：`assets/AutoIdInterceptor.java`
-- 启用注解：`assets/EnableDistributedId.java`
-- Leaf 配置相关：`assets/LeafConf.java`

package/template/.claude/skills/yss-distributed-id/agents/openai.yaml

@@ -1,5 +0,0 @@
-version: 1
-interface:
-  display_name: "YSS Distributed ID"
-  short_description: "Leaf、CosId 与分布式 ID 接入与配置规范"
-  default_prompt: "Use $yss-distributed-id to configure or debug distributed ID generation, Leaf, CosId, and MyBatis ID injection."