create-yss-spec 2.1.11 → 2.1.14

package/template/docs/design/tokens/variables.css

@@ -1,47 +1,47 @@
 :root {
-  --brand-color-primary: #1677ff;
-  --brand-color-primary-bg: #e6f4ff;
-  --brand-color-primary-bg-hover: #bae0ff;
-  --brand-color-primary-border: #91caff;
-  --brand-color-primary-border-hover: #69b1ff;
+  --brand-color-primary: #3371ff;
+  --brand-color-primary-bg: #d6e4ff;
+  --brand-color-primary-bg-hover: #adc6ff;
+  --brand-color-primary-border: #85a5ff;
+  --brand-color-primary-border-hover: #597ef7;
   --brand-color-primary-hover: #4096ff;
   --brand-color-primary-active: #0958d9;
   --brand-color-primary-text: #002c8c;
   --brand-color-success: #52c41a;
   --brand-color-success-bg: #f6ffed;
-  --brand-color-success-border: #b6eb8f;
-  --brand-color-success-hover: #72d13d;
+  --brand-color-success-border: #b7eb8f;
+  --brand-color-success-hover: #73d13d;
   --brand-color-success-active: #389e0d;
   --brand-color-warning: #faad14;
   --brand-color-warning-bg: #fffbe6;
   --brand-color-warning-border: #ffe58f;
   --brand-color-warning-hover: #ffc53d;
   --brand-color-warning-active: #d48806;
-  --brand-color-error: #ff4d4f;
+  --brand-color-error: #f5222d;
   --brand-color-error-bg: #fff2f0;
   --brand-color-error-border: #ffccc7;
-  --brand-color-error-hover: #ff7875;
-  --brand-color-error-active: #d9363d;
-  --brand-color-info: #1677ff;
+  --brand-color-error-hover: #ff4d4f;
+  --brand-color-error-active: #cf1322;
+  --brand-color-info: #3371ff;
   --brand-color-info-bg: #e6f4ff;
   --brand-color-info-border: #91caff;
-  --brand-color-link: #1677ff;
+  --brand-color-link: #3371ff;
   --brand-color-link-hover: #4096ff;
   --brand-color-link-active: #0958d9;
-  --brand-color-text: #2e2e2e;
-  --brand-color-text-secondary: #646464;
-  --brand-color-text-tertiary: #949494;
-  --brand-color-text-quaternary: #c4c4c4;
-  --brand-color-fill: #dbdbdb;
-  --brand-color-fill-secondary: #f1f1f1;
+  --brand-color-text: rgba(0, 0, 0, 0.88);
+  --brand-color-text-secondary: rgba(0, 0, 0, 0.65);
+  --brand-color-text-tertiary: #8c8c8c;
+  --brand-color-text-quaternary: #bfbfbf;
+  --brand-color-fill: #d9d9d9;
+  --brand-color-fill-secondary: #f0f0f0;
   --brand-color-fill-tertiary: #f5f5f5;
   --brand-color-fill-quaternary: #fafafa;
-  --brand-color-bg-layout: #f5f5f5;
+  --brand-color-bg-layout: #f0f2f5;
   --brand-color-bg-container: #ffffff;
   --brand-color-bg-elevated: #ffffff;
-  --brand-color-border: #dbdbdb;
-  --brand-color-border-secondary: #f1f1f1;
-  --brand-font-family: 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';
+  --brand-color-border: #d9d9d9;
+  --brand-color-border-secondary: #f0f0f0;
+  --brand-font-family: -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";
   --brand-font-family-code: 'SFMono-Regular', Consolas, 'Liberation Mono', Menlo, Courier, monospace;
   --brand-font-size: 14px;
   --brand-font-size-sm: 12px;
@@ -63,10 +63,10 @@
   --brand-size-lg: 24px;
   --brand-size-xl: 32px;
   --brand-size-xxl: 48px;
-  --brand-border-radius-xs: 3px;
-  --brand-border-radius-sm: 5px;
-  --brand-border-radius: 8px;
-  --brand-border-radius-lg: 10px;
+  --brand-border-radius-xs: 2px;
+  --brand-border-radius-sm: 4px;
+  --brand-border-radius: 6px;
+  --brand-border-radius-lg: 8px;
   --brand-line-width: 1px;
   --brand-control-height-xs: 16px;
   --brand-control-height-sm: 24px;
@@ -77,12 +77,12 @@
   --brand-motion-duration-slow: 0.3s;
   --brand-motion-ease-in-out: cubic-bezier(0.645, 0.045, 0.355, 1);
   --brand-motion-ease-out: cubic-bezier(0.215, 0.61, 0.355, 1);
-  --brand-primary-palette-1: #e6f4ff;
-  --brand-primary-palette-2: #bae0ff;
-  --brand-primary-palette-3: #91caff;
-  --brand-primary-palette-4: #69b1ff;
-  --brand-primary-palette-5: #4096ff;
-  --brand-primary-palette-6: #1677ff;
+  --brand-primary-palette-1: color-mix(in srgb, var(--brand-color-primary) 10%, transparent);
+  --brand-primary-palette-2: #d6e4ff;
+  --brand-primary-palette-3: #adc6ff;
+  --brand-primary-palette-4: #85a5ff;
+  --brand-primary-palette-5: #597ef7;
+  --brand-primary-palette-6: #3371ff;
   --brand-primary-palette-7: #0958d9;
   --brand-primary-palette-8: #003eb3;
   --brand-primary-palette-9: #002c8c;
@@ -217,6 +217,31 @@
   --brand-presets-grey-8: #1a1a1a;
   --brand-presets-grey-9: #000000;
   --brand-presets-grey-10: #000000;
+  --brand-layout-header-height: 64px;
+  --brand-layout-sider-background: #001529;
+  --brand-layout-body-background: var(--brand-color-bg-layout);
+  --brand-screen-xs: 480px;
+  --brand-screen-sm: 576px;
+  --brand-screen-md: 768px;
+  --brand-screen-lg: 992px;
+  --brand-screen-xl: 1200px;
+  --brand-screen-xxl: 1600px;
+  --primary-color: var(--brand-color-primary);
+  --primary-color-hover: var(--brand-color-primary-hover);
+  --primary-color-active: var(--brand-color-primary-active);
+  --primary-1: color-mix(in srgb, var(--primary-color) 10%, transparent);
+  --primary-7: var(--primary-color-active);
+  --success-color: var(--brand-color-success);
+  --warning-color: var(--brand-color-warning);
+  --error-color: var(--brand-color-error);
+  --info-color: var(--brand-color-info);
+  --text-color: var(--brand-color-text);
+  --text-color-secondary: var(--brand-color-text-secondary);
+  --text-color-inverse: #ffffff;
+  --border-color: var(--brand-color-border);
+  --border-color-split: var(--brand-color-border-secondary);
+  --bg-color: var(--brand-color-bg-layout);
+  --bg-color-container: var(--brand-color-bg-container);
 }
 
 .dark {
@@ -262,7 +287,7 @@
   --brand-color-bg-elevated: #272727;
   --brand-color-border: #3e3e3e;
   --brand-color-border-secondary: #303030;
-  --brand-font-family: 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';
+  --brand-font-family: -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";
   --brand-font-family-code: 'SFMono-Regular', Consolas, 'Liberation Mono', Menlo, Courier, monospace;
   --brand-font-size: 14px;
   --brand-font-size-sm: 12px;
@@ -284,10 +309,10 @@
   --brand-size-lg: 24px;
   --brand-size-xl: 32px;
   --brand-size-xxl: 48px;
-  --brand-border-radius-xs: 3px;
-  --brand-border-radius-sm: 5px;
-  --brand-border-radius: 8px;
-  --brand-border-radius-lg: 10px;
+  --brand-border-radius-xs: 2px;
+  --brand-border-radius-sm: 4px;
+  --brand-border-radius: 6px;
+  --brand-border-radius-lg: 8px;
   --brand-line-width: 1px;
   --brand-control-height-xs: 16px;
   --brand-control-height-sm: 24px;

package/template/docs/design/tokens/variables.dark.css

@@ -41,7 +41,7 @@
   --brand-color-bg-elevated: #272727;
   --brand-color-border: #3e3e3e;
   --brand-color-border-secondary: #303030;
-  --brand-font-family: 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';
+  --brand-font-family: -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";
   --brand-font-family-code: 'SFMono-Regular', Consolas, 'Liberation Mono', Menlo, Courier, monospace;
   --brand-font-size: 14px;
   --brand-font-size-sm: 12px;
@@ -63,10 +63,10 @@
   --brand-size-lg: 24px;
   --brand-size-xl: 32px;
   --brand-size-xxl: 48px;
-  --brand-border-radius-xs: 3px;
-  --brand-border-radius-sm: 5px;
-  --brand-border-radius: 8px;
-  --brand-border-radius-lg: 10px;
+  --brand-border-radius-xs: 2px;
+  --brand-border-radius-sm: 4px;
+  --brand-border-radius: 6px;
+  --brand-border-radius-lg: 8px;
   --brand-line-width: 1px;
   --brand-control-height-xs: 16px;
   --brand-control-height-sm: 24px;

package/template/docs/process/implementation-repo-integration.md

@@ -23,6 +23,15 @@ apps/
 
 每个 Harness 内项目至少登记 `project_type`、`project_name`、`project_root` 和 `repository_scope`。同一 Git monorepo 下的多个项目可以共用一条仓库登记，但必须逐项目列出根路径和独立验证命令；不同 Git 仓库必须分别登记。
 
+## 1.2 前端 / 后端验证命令
+
+登记和执行测试、编译时按工程类型选择命令，不要把模板源的 Node 工具链命令套到产品运行时工程。
+
+- **frontend**：依赖安装、测试、type-check 与构建优先使用 `pnpm`（例如 `pnpm test`、`pnpm type-check`、`pnpm build`）。不要默认 `npm` 或 `yarn`。
+- **backend**：校验、测试与编译优先使用项目根 `./mvnw`（例如 `./mvnw validate`、`./mvnw test`、`./mvnw package`）。不要默认裸 `mvn`。
+- Ticket、Slice Implementation Contract、CI 和 Review 证据必须写下实际执行的上述命令。既有仓库缺少 `pnpm` 或 Maven Wrapper 时，先记录受控例外、替代命令和责任人，再执行。
+- 本模板源仓库没有产品 frontend / backend 运行时；其 Node 校验仍按 `AGENTS.md` 的 Cursor Cloud 说明使用 `pnpm --dir .template-source/tooling/node`。
+
 ## 2. 影响面路由
 
 | 影响面 | 必须绑定的记录 | 本变更结论 |

package/template/docs/templates/requirement-freeze-template.md

@@ -19,7 +19,7 @@ owner: ai
 | 产品设计 / 交互说明 |  |  |  |
 | 高保真 HTML 原型 | `docs/.scratch/<feature>/design/prototypes/index.html` |  | 有 UI 时必需；Ant Design v6 |
 | Prototype Review |  |  |  |
-| CONTEXT 术语 |  |  |  |
+| CONTEXT 术语 |  |  | 业务术语须含 PascalCase `英文标识` |
 
 ## 2. 冻结范围
 

package/template/docs/templates/review-report-template.md

@@ -66,6 +66,7 @@ Approved / Changes requested / Blocked
 | `alibaba-java-code-style` 已纳入审查，命名、异常、日志、ORM/MyBatis、Maven、MapStruct / Lombok 注解处理器配置无 blocker | pass / violation / not-applicable |  |
 | 后端构建 / 测试 / OpenAPI / CI / Release 命令使用项目根目录 `./mvnw ...`；裸 `mvn ...` 已改正或有受控例外记录 | pass / violation / not-applicable |  |
 | 持久化文档正文、章节标题、审查结论和实施说明使用中文；英文模板内容未原样落地 | pass / violation / not-applicable |  |
+| 新增或修改的业务类型 / 字段 / OpenAPI property 能追溯到 `CONTEXT.md` 业务术语的 `英文标识` 词干；未登记的新名字已回写词汇表 | pass / violation / not-applicable |  |
 | `Build Architecture Checklist` 已回勾，延期项、漂移项、违反项有明确处理结论 | pass / violation / not-applicable |  |
 
 ### 后端 smoke check

package/template/docs/templates/spec-template.md

@@ -73,7 +73,7 @@ owner: ai
 
 | 检查项 | 是 / 否 | 说明 / 处理 |
 |---|---|---|
-| 是否新增或改变统一语言 / 核心术语 |  | 需要回写 `CONTEXT.md` |
+| 是否新增或改变统一语言 / 核心术语 |  | 需要回写 `CONTEXT.md` 的中文术语和 PascalCase `英文标识` |
 | 是否新增或改变限界上下文 / 模块边界 |  | 需要在产品总体设计中完成 Strategic DDD Check |
 | 是否改变上下文间协作关系 |  | 说明上游 / 下游 / 防腐层 / 共享内核关系 |
 | 是否新增或改变聚合、不变量、状态机 |  | 需要在系统概要设计 / 数据架构中完成 Tactical DDD Check |

package/template/docs/templates/vertical-slice-ticket-template.md

@@ -129,4 +129,4 @@ Status: ready-for-human
 - [ ] 已回勾当前 `contract_id` / `contract_version`、全部工作单元和对应 `YSS Skill Execution Result`
 - [ ] 实际 changed files 均在合同允许路径内，预期证据齐全，验证结果包含执行时间
 - [ ] `new_impacts`、`drift`、`violation` 和重路由状态均有明确结论，合同未处于 `stale`
-- [ ] 如领域或架构决策变化，已更新 `CONTEXT.md` / ADR
+- [ ] 如领域或架构决策变化，已更新 `CONTEXT.md` / ADR；新增业务术语含 PascalCase `英文标识`，代码与契约字段能追溯到该词干

package/template/docs/user-guide//344/272/247/345/223/201/347/224/237/345/221/275/345/221/250/346/234/237/345/267/245/344/275/234/346/265/201.md

@@ -17,7 +17,7 @@
 
 | 资产     | 位置                                                          | 用途                                                          |
 | ------ | ----------------------------------------------------------- | ----------------------------------------------------------- |
-| 领域语言   | `CONTEXT.md`                                                | 统一产品、开发、设计、实施和 AI 的业务词汇                                     |
+| 领域语言   | `CONTEXT.md`                                                | 统一产品、开发、设计、实施和 AI 的业务词汇与英文标识词干                     |
 | 需求与验收  | `docs/.scratch/<feature>/spec.md`                                | 保存 Spec、用户故事、验收条件和边界规则                                      |
 | API 契约 | `docs/.scratch/<feature>/api/`                                    | 用 OpenAPI 3.1 约束前后端协作                                       |
 | 行为差异   | `docs/.scratch/<feature>/spec-delta/`                             | 用轻量 Spec Delta 记录中高风险变化的 ADDED / MODIFIED / REMOVED 行为和测试映射 |
@@ -77,17 +77,17 @@ CONTEXT.md
 
 ### Step 2: 建立领域词汇
 
-在 `CONTEXT.md` 中只放稳定业务语言，不放实现细节。
+在 `CONTEXT.md` 的 `## 业务术语` 中只放稳定业务语言，并填写 PascalCase `英文标识`。不放实现细节、类全名或表名。格式以根目录 `CONTEXT.md` 为准。
 
-示例：
+示例（仅用户指南；不要把虚构行写入模板源 `## 业务术语`）：
 
-| 术语 | 含义 | 备注 |
-|---|---|---|
-| 模型 | 对业务数据结构的抽象定义 | 不等同于数据库表 |
-| 字段 | 模型中的属性定义 | 包含类型、长度、是否必填、默认值 |
-| 草稿版本 | 可编辑但未发布的模型版本 | 不能被生产服务引用 |
-| 发布版本 | 已冻结的可引用版本 | 原则上不可变 |
-| 模型校验 | 发布前对字段、命名、关系和约束的检查 | 失败时需要字段级错误 |
+| 术语 | 含义 | 英文标识 | 避免 / 备注 |
+|---|---|---|---|
+| 模型 | 对业务数据结构的抽象定义 | Model | 不等同于数据库表；Table |
+| 字段 | 模型中的属性定义 | Field | SchemaColumn |
+| 草稿版本 | 可编辑但未发布的模型版本 | DraftVersion | 不能被生产服务引用 |
+| 发布版本 | 已冻结的可引用版本 | PublishedVersion | 上线、提交；Release、OnlineVersion |
+| 模型校验 | 发布前对字段、命名、关系和约束的检查 | ModelValidation | 失败时需要字段级错误 |
 
 这一步会直接影响后续 AI 生成 Spec、API、代码和测试的质量。可用 `domain-modeling` 持续维护领域语言和 ADR。
 

package/template/docs/user-guide//344/272/247/345/223/201/347/240/224/345/217/221/345/205/250/347/224/237/345/221/275/345/221/250/346/234/237/346/234/200/344/275/263/345/256/236/350/267/265.md

@@ -62,7 +62,7 @@
 | Harness 能力 | 位置 | 用法 |
 |---|---|---|
 | Agent 入口规则 | `AGENTS.md` | 约束风险 / 回滚约束、阶段门禁和默认协作流程 |
-| 领域记忆 | `CONTEXT.md` | 保存稳定业务术语，避免每轮重新解释 |
+| 领域记忆 | `CONTEXT.md` | 保存稳定业务术语和英文标识词干，避免每轮重新解释或临场翻译 |
 | 需求和规格资产 | `docs/.scratch/<feature>/discovery/`、`docs/.scratch/<feature>/spec.md`、`docs/.scratch/<feature>/api/` | 把聊天结论变成可审查文件 |
 | 产品设计资产 | `docs/.scratch/<feature>/design/` 或 Figma / 原型工具链接 | 保存页面清单、用户流、原型、交互说明和状态矩阵 |
 | 架构和决策资产 | `docs/.scratch/<feature>/architecture/`、`docs/adr/` | 保存模块边界、状态流和难回滚取舍 |
@@ -144,12 +144,12 @@ skills 是让 AI 按规程工作的“操作手册”，不是关键词装饰。
 | 目标 | 推荐入口 | 注意事项 |
 |---|---|---|
 | 不知道当前该做什么 | `yss-product-lifecycle` | 先阶段判断和资产检查，不写业务代码 |
-| 模糊需求追问 | `grill-with-docs` | 先问清，不让 AI 猜规则；稳定术语写 `CONTEXT.md` |
+| 模糊需求追问 | `grill-with-docs` | 先问清，不让 AI 猜规则；稳定术语和英文标识写 `CONTEXT.md` |
 | 生成 Spec 初稿 / 需求基线 | `to-spec` 或 Spec 模板 | 只基于已确认事实，不把待确认项写成需求 |
 | 产品总体设计 / 功能架构 | `docs/design/templates/product-overview-design-template.md`、`docs/.scratch/<feature>/design/` | Spec 初稿后的必要产物；必须包含低保真原型 / 页面草图；进入页面 / 原型 / 交互设计、Spec 校准或 OpenAPI Draft 前必须完成 |
 | 页面和交互设计 | `product-design:index`、Product Design focused skills、`docs/.scratch/<feature>/design/` | 基于 Spec 初稿和产品总体设计细化页面流、状态和交互，再回填 Spec 并反推 API |
 | 原型评审 | `prototype-review` | 未通过时回到产品设计；通过后进入高保真 HTML 原型，不直接进入 Spec 校准 / API 影响分析 / 契约草案 |
-| 高保真 HTML 原型 | `product-design:index` 路由到 Product Design focused skill；`antd` CLI | 低保真评审通过后的强制产物；必须使用 Ant Design v6，输出 `docs/.scratch/<feature>/design/prototypes/index.html`，记录 AntD CLI 校验证据并获得用户确认 |
+| 高保真 HTML 原型 | `product-design:index` 路由到 Product Design focused skill；`yss-antd-design`（仅原型） | 低保真评审通过后的强制产物；必须使用 Ant Design v6，输出 `docs/.scratch/<feature>/design/prototypes/index.html`，记录 AntD CLI 校验证据并获得用户确认。前端落地改用 `yss-ui` |
 | API 契约 | API 影响分析 / 契约草案 / OpenAPI Freeze 流程 | Draft 可讨论，Freeze 才可开发 |
 | 正式变更设计 | `to-tickets` / Matt skills | 复用 Spec，聚焦技术方案、风险和测试 seam |
 | 拆切片 | `to-tickets` | 必须是端到端垂直切片 |
@@ -361,7 +361,7 @@ docs/.scratch/data-modeling/discovery/data-modeling-opportunity.md
 - [ ] 字段级校验和错误展示规则明确。
 - [ ] API 影响已初判。
 - [ ] 风险 / 回滚约束已检查；需要人工确认的事项已记录结论。
-- [ ] 稳定术语已准备写入 `CONTEXT.md`。
+- [ ] 稳定术语已准备写入 `CONTEXT.md`，业务对象含 PascalCase `英文标识`。
 
 ## 6. 阶段 3：Spec 初稿 / 需求基线
 
@@ -478,7 +478,7 @@ docs/.scratch/data-modeling/design/data-modeling-prototype-review.md
 | 页面清单、用户流、状态矩阵、Spec 回填项、OpenAPI 反推 | `product-design:index` -> `$get-context` / `$prototype` | 基于 Spec 初稿和产品总体设计后的原型入口 |
 | 低保真线框、流程草图 | `product-design:index` -> `$ideate` / `$prototype`；Excalidraw / Markdown wireframe | 适合快速讨论，不绑定工程依赖 |
 | 高保真或设计系统协作 | Figma / Penpot，必要时使用 `figma` / `figma-use` | 适合设计团队和组件规范沉淀 |
-| 高保真可交互 HTML 原型 | `product-design:index` -> `$prototype` / `$image-to-code` / `$url-to-code`；`antd` CLI；Ant Design v6 | 低保真原型评审通过后的必需产物，用于 Spec 校准和 API 反推前的体验确认 |
+| 高保真可交互 HTML 原型 | `product-design:index` -> `$prototype` / `$image-to-code` / `$url-to-code`；`yss-antd-design`；Ant Design v6 | 低保真原型评审通过后的必需产物，用于 Spec 校准和 API 反推前的体验确认。前端落地改用 `yss-ui` |
 | 图谱、血缘、流程编排画布 | tldraw / xyflow | 适合数据血缘、任务流、关系图等画布型体验 |
 | 进入高保真前门禁 | `prototype-review` | 未通过则回到原型阶段 |
 
@@ -920,7 +920,7 @@ docs/user-guide/
 - 哪些 OpenAPI 字段在 Freeze 后仍被修改，原因是什么？
 - 哪些测试 seam 缺失导致回归风险？
 - 哪些实施问题应该写入用户指南？
-- 哪些规则应该上升到 `CONTEXT.md`、ADR 或 `AGENTS.md`？
+- 哪些规则应该上升到 `CONTEXT.md`（含英文标识）、ADR 或 `AGENTS.md`？
 
 阶段门禁：
 
@@ -1053,7 +1053,7 @@ docs/user-guide/
 基于 <Spec 路径>、`docs/.scratch/<feature>/design/<feature>-product-overview-design.md`、`docs/.scratch/<feature>/design/<feature>-interaction-spec.md`、`docs/.scratch/<feature>/design/<feature>-state-matrix.md` 和 `docs/.scratch/<feature>/design/<feature>-prototype-review.md`，
 为 <功能名> 生成 Ant Design v6 高保真可交互 HTML 原型。
 输出路径必须是 `docs/.scratch/<feature>/design/prototypes/index.html`。
-产出前必须使用 `antd` CLI 查询设计语言、组件 API、demo、token 和 semantic 信息，不要凭记忆写 Ant Design v6 组件。
+产出前必须使用 `yss-antd-design` 查询设计语言、组件 API、demo、token 和 semantic 信息，不要凭记忆写 Ant Design v6 组件。前端代码落地不要调用该技能，改用 `yss-ui`。
 请覆盖主流程、关键异常、loading/empty/error/no-permission/readonly/disabled/conflict/success 状态、表单校验、弹窗/抽屉、响应式断点。
 完成后给出 Ant Design v6 版本依据、`antd` CLI 查询过的组件 / token / demo / semantic、本地浏览器验证证据，并使用 `docs/design/templates/prototype-confirmation-template.md` 记录用户确认。
 ```

package/template/docs/user-guide//347/224/237/345/221/275/345/221/250/346/234/237/346/234/200/344/275/263/345/256/236/350/267/265.md

@@ -6,12 +6,12 @@
 
 ### 1.1 先稳定语言，再稳定实现
 
-业务系统最怕“同一个东西有三个名字”。开始写代码前，先把稳定术语写进 `CONTEXT.md`。
+业务系统最怕“同一个东西有三个名字”。开始写代码前，先把稳定术语和 PascalCase `英文标识` 写进 `CONTEXT.md` 的 `## 业务术语`。
 
 示例：
 
 ```text
-模型、字段、草稿版本、发布版本、校验错误、引用关系
+模型 / Model、字段 / Field、草稿版本 / DraftVersion、发布版本 / PublishedVersion
 ```
 
 如果一个术语还在讨论中，可以先放在 Spec 或 discovery 文档，不要急着写进 `CONTEXT.md`。
@@ -222,7 +222,7 @@ opportunity exploration
 
 | 文档 | 应该写 | 不应该写 |
 |---|---|---|
-| `CONTEXT.md` | 稳定术语 | 临时计划、代码路径 |
+| `CONTEXT.md` | 稳定术语与英文标识词干 | 临时计划、类全名、表名、代码路径 |
 | Competitive Matrix | 竞品功能、差异化机会、MVP 边界输入 | 未验证事实、营销文案堆砌 |
 | Spec | 用户问题、范围、验收 | 详细实现代码 |
 | OpenAPI | 接口契约 | 页面交互细节 |
@@ -436,7 +436,7 @@ OpenAPI Freeze
 - [ ] 如果涉及权限、认证、SQL、迁移、加密或公共 API 时，已记录风险判断和验证证据。
 - [ ] 没有调试代码。
 - [ ] 任务清单已更新。
-- [ ] 如果术语或规则变化，已更新 `CONTEXT.md` 或 Spec。
+- [ ] 如果术语或规则变化，已更新 `CONTEXT.md`（业务术语含 `英文标识`）或 Spec。
 
 ### 6.3 发布前
 
@@ -579,6 +579,6 @@ OpenAPI Freeze
 - 哪些需求被改了两次以上？
 - 哪些实现让实施解释成本变高？
 - 哪些规则应该写入 `AGENTS.md`？
-- 哪些术语应该写入 `CONTEXT.md`？
+- 哪些术语应该写入 `CONTEXT.md`，并补上英文标识词干？
 
 这样这套模板会从“文档目录”逐渐变成你的产品操作系统。

package/template/docs/user-guide//351/234/200/346/261/202/346/276/204/346/270/205/346/214/207/345/215/227.md

@@ -121,28 +121,27 @@ grill 的重点是“被问住”。遇到不确定的问题，不要让 AI 替
 
 ## 5. 与 CONTEXT.md 的关系
 
-`CONTEXT.md` 只记录稳定业务语言，不记录实现细节。
+`CONTEXT.md` 只记录稳定业务语言，不记录实现细节。格式与变形规则以根目录 `CONTEXT.md` 文首为准。
 
 应该写入：
 
 - 业务对象：模型、字段、草稿版本、发布版本。
 - 状态含义：冻结、发布、撤销、失效。
 - 角色和责任：建模人员、实施顾问、平台管理员。
-- 避免用语：同义词、容易混淆的叫法。
+- PascalCase `英文标识` 词干，供代码类型 / 字段和契约 property 变形。
+- 避免用语：禁用中文近义词和禁用英文别名。
 
 不应该写入：
 
-- Java 类名、Vue 组件名、表名、接口路径。
+- 具体类全名、Vue 组件名、表名、接口路径。
 - 临时计划。
 - 未确认猜测。
 - 具体实现方案。
 
-示例：
+示例（仅用户指南；不要把虚构行写入模板源 `## 业务术语`）：
 
 ```text
-模型发布：
-将草稿版本冻结为可被下游引用的发布版本。
-_Avoid_: 上线、提交、保存
+| 发布版本 | 已冻结的可引用版本 | PublishedVersion | 上线、提交；Release、OnlineVersion |
 ```
 
 ## 6. 与 ADR 的关系

package/template/docs/user-guide//351/234/200/346/261/202/346/276/204/346/270/205/346/234/200/344/275/263/345/256/236/350/267/265.md

@@ -236,7 +236,7 @@ Ticket 需要清晰 change 目标。如果目标还模糊，先 grill。
 |---|---|---|
 | AI 一次问十个问题 | 用户难回答，容易敷衍 | 一次聚焦一个主题，必要时一个关键问题一轮 |
 | AI 替业务做决定 | 关键规则来自猜测 | 标为待确认 |
-| 术语都写进 CONTEXT.md | 词汇表膨胀失真 | 只写稳定业务语言 |
+| 术语都写进 CONTEXT.md | 词汇表膨胀失真 | 只写已确认的业务术语，并带 PascalCase `英文标识` |
 | ADR 写成大方案 | 后续没人读 | 只记录决定和原因 |
 | grill 之后直接开发 | Spec / OpenAPI / change 丢失 | 先进入 Spec 或 Ticket |
 | 只问正常路径 | 异常场景上线后暴露 | 必问失败、并发、权限、回滚 |
@@ -255,7 +255,7 @@ Ticket 需要清晰 change 目标。如果目标还模糊，先 grill。
 ### grill 过程中
 
 - [ ] 不确定的问题标记为待确认。
-- [ ] 稳定术语及时写入 `CONTEXT.md`。
+- [ ] 稳定业务术语及时写入 `CONTEXT.md`，并填写 PascalCase `英文标识`。
 - [ ] 冲突术语被指出并解决。
 - [ ] 正常路径、异常路径、权限和边界都被问到。
 - [ ] 重大取舍按 ADR 三条件判断。
@@ -264,7 +264,7 @@ Ticket 需要清晰 change 目标。如果目标还模糊，先 grill。
 
 - [ ] 已确认范围和非目标。
 - [ ] 已列出待确认问题。
-- [ ] `CONTEXT.md` 没有实现细节。
+- [ ] `CONTEXT.md` 没有类全名、表名或接口路径；业务术语有英文标识词干。
 - [ ] ADR 只记录必要决定。
 - [ ] 已明确下一步是 discovery、Spec、OpenAPI、Ticket 还是实现路由。
 

package/template/skills-lock.json

@@ -257,7 +257,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/high-fidelity-html-prototype/SKILL.md",
-        "effectiveHash": "36828f3c5eeabd1d49e551a23f84e240f68474cdcddac22aec922cc98fac5ee6",
+        "effectiveHash": "e01474164c9f8d13ff261184196f2175bf8e66b27e7ee8153b5e1ee7269e068d",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -323,6 +323,22 @@
           ".trae/skills"
         ]
       },
+      "llm-wiki": {
+        "source": "project",
+        "sourceType": "local",
+        "skillPath": ".agents/skills/llm-wiki/SKILL.md",
+        "effectiveHash": "41a5880856745312d33a2875ce16fe321e5f326eb8e27321f96741421ffce49a",
+        "targets": [
+          ".agents/skills",
+          ".claude/skills",
+          ".codex/skills",
+          ".cursor/skills",
+          ".hermes/skills",
+          ".pi/skills",
+          ".qoder/skills",
+          ".trae/skills"
+        ]
+      },
       "lombok": {
         "source": "claude-dev-suite/claude-dev-suite",
         "sourceType": "github",
@@ -802,6 +818,22 @@
           ".trae/skills"
         ]
       },
+      "yss-antd-design": {
+        "source": "project",
+        "sourceType": "local",
+        "skillPath": ".agents/skills/yss-antd-design/SKILL.md",
+        "effectiveHash": "9ebed3a9b0ac94ecf1deafa096c1bfb999264d103d8fcd8cdf6eb4979196124c",
+        "targets": [
+          ".agents/skills",
+          ".claude/skills",
+          ".codex/skills",
+          ".cursor/skills",
+          ".hermes/skills",
+          ".pi/skills",
+          ".qoder/skills",
+          ".trae/skills"
+        ]
+      },
       "yss-api-integration": {
         "source": "project",
         "sourceType": "local",
@@ -902,7 +934,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-design-system/SKILL.md",
-        "effectiveHash": "e179989cd6db0b33739c7fa88f09010c0b4af74b4af625b0774ec5cd7c574775",
+        "effectiveHash": "afe3f9f1758bce43b82fb247f05a04aa8df0e557c7695a95fb5327dc3714773a",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1142,7 +1174,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-product-lifecycle/SKILL.md",
-        "effectiveHash": "9168ad69248554b37145d898f1b8adb7d03c62679c49f29b3494edea6ee34e7b",
+        "effectiveHash": "eaa20ca65548a0c0c4fd30f56eb8d15ec872179ea39ffd93dd64730b3dcf5301",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1158,7 +1190,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-prototype-stage/SKILL.md",
-        "effectiveHash": "a6760bc2c5b2296ad3a182838ead29502bc06eb632fa77eb7d1df531a99fc0cf",
+        "effectiveHash": "2d5665a622624c0525f41c919e69c5c0e327d1d9d678b2587cc013d491f92ff2",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1254,7 +1286,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-ui/SKILL.md",
-        "effectiveHash": "a09ba879a579fd0fe8a66743f218503bf122b7882398c0840d5759bb7a57e246",
+        "effectiveHash": "da3179da42089eca85226267c7a7597bb71f06fbf730af3652a05baaed927eca",
         "targets": [
           ".agents/skills",
           ".claude/skills",