create-yss-spec 3.0.1 → 3.1.0

package/README.md

@@ -48,11 +48,11 @@ npx create-yss-spec@latest --version
 - init / sync 不把模板源治理笔记、wiki、审查证据、源仓 CI / Cloud 环境和公开发布清单写入项目实例；attach 会带上 `yss-public-skills.json` 供 `verify-template` 使用
 - 空 gitlink / detached HEAD / git-submodule 挂载点 fail closed，`--force` 也不能覆盖
 
-本次模板适配按 `2.2.6` 绑定 `yss-spec-project-template@4743a3f`（Git 源码快照；本轮不发布 npm）。`templateCommit` 会写入实例 metadata；“最新模板”指用户执行的 `npx create-yss-spec@latest` 所携带的最新已发布快照，CLI 运行时不会拉取模板仓库。实例会带上数字人角色叠加（`docs/agents/digital-human-roles.yaml`）、YSS 前端技能叠加层（如 `ytable-usage`、`formily-foundation`、`yss-page-module-development`）、DDD Tactical Design 与生命周期转换校验资产、唯一 `code-review` 入口及其 YSS / Alibaba 专项检查与 finding 分流合同、`.cursorrules` 与 `.agents/rules/yss-ai-skills.md`；审查临时目录 `docs/.scratch/` 与已退役的 `high-fidelity-html-prototype` 等独立入口不进入快照。
+本轮模板快照绑定 `yss-spec-project-template@248c1723cc0e4e88adabcf00931f78b9aa632d48`。`templateCommit` 会写入实例 metadata；“最新模板”指用户执行的 `npx create-yss-spec@latest` 所携带的最新已发布快照，CLI 运行时不会拉取模板仓库。实例会带上数字人角色叠加（`docs/agents/digital-human-roles.yaml`）、YSS 前端技能叠加层、DDD Tactical Design 与生命周期转换校验资产、唯一 `code-review` 入口及其 YSS / Alibaba 专项检查与 finding 分流合同、`.cursorrules` 与 `.agents/rules/yss-ai-skills.md`；审查临时目录 `docs/.scratch/` 与已退役的独立入口不进入快照。
 
 ## 当前版本说明
 
-当前 CLI 版本为 `3.0.1`，模板固定到 `f454f08950cad6acc6cba2e413e62a3e942677fe`。该主版本将 Web 生成升级为批准的 schema v2 合同，绑定 `yss-dto` wire profile，并要求通过完整首切片验证器后才能声明 `first-slice-verified`。
+当前 CLI 版本为 `3.1.0`，模板固定到 `248c1723cc0e4e88adabcf00931f78b9aa632d48`。本版本同步可离线核验的战略交接快照包、受控导入与逐条战术追溯，并强化关键决定的真实用户回复校验。
 
 ## 接管已有项目
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-yss-spec",
-  "version": "3.0.1",
+  "version": "3.1.0",
   "description": "Initialize a YSS spec project template repository",
   "repository": {
     "type": "git",

package/template/.agents/rules/yss-ai-skills.md

@@ -2,60 +2,8 @@
 trigger: always_on
 ---
 
-# YSS AI Skills Entry
+# YSS UI 实现入口
 
-本项目使用 YSS UI 业务页面开发规范。处理 Vue3 业务页面、CRUD、列表、表单、抽屉、YTable、YEditTable、YFormily、YTree、API 对接任务时，必须先读取匹配的 SKILL.md，再写计划或代码。
+仅在生产前端或 YSS UI 实现影响命中时使用本入口。先按当前 Slice Implementation Contract 与 `docs/agents/yss-skill-registry.yaml` 选择最小技能集，再进入 `.agents/skills/yss-ui/SKILL.md`；完整业务页面使用 `.agents/skills/yss-ui-business-page-generation/SKILL.md`，并按任务触发读取其引用的 canonical `SKILL.md`。原型阶段使用 `yss-prototype-stage`，不得调用生产实现技能 `yss-ui`。
 
-## Available Skills
-
-- yss-ui-business-page-generation: .agents/skills/yss-ui-business-page-generation/SKILL.md
-- yss-page-module-development: .agents/skills/yss-page-module-development/SKILL.md
-- theme-token-usage: .agents/skills/theme-token-usage/SKILL.md
-- component-selection-imports: .agents/skills/component-selection-imports/SKILL.md
-- page-skeleton: .agents/skills/page-skeleton/SKILL.md
-- page-list-module: .agents/skills/page-list-module/SKILL.md
-- page-form-module: .agents/skills/page-form-module/SKILL.md
-- ytable-usage: .agents/skills/ytable-usage/SKILL.md
-- yedit-table-usage: .agents/skills/yedit-table-usage/SKILL.md
-- ytree-usage: .agents/skills/ytree-usage/SKILL.md
-- prototype-page-acceptance: .agents/skills/prototype-page-acceptance/SKILL.md
-- yss-api-integration: .agents/skills/yss-api-integration/SKILL.md
-- file-export-download: .agents/skills/file-export-download/SKILL.md
-- vue3-best-practices: .agents/skills/vue3-best-practices/SKILL.md
-- frontend-commit: .agents/skills/frontend-commit/SKILL.md
-- java-backend-commit: .agents/skills/java-backend-commit/SKILL.md
-- yss-use-table-height: .agents/skills/yss-use-table-height/SKILL.md
-- yss-use-tree-height: .agents/skills/yss-use-tree-height/SKILL.md
-- yss-formily: .agents/skills/yss-formily/SKILL.md
-- formily-foundation: .agents/skills/formily-foundation/SKILL.md
-- formily-linkage-effects: .agents/skills/formily-linkage-effects/SKILL.md
-- formily-mode-slot-detail: .agents/skills/formily-mode-slot-detail/SKILL.md
-- formily-step-flow: .agents/skills/formily-step-flow/SKILL.md
-
-## Mandatory Workflow
-
-1. 业务页面/CRUD/列表/表单/树表生成主入口：先读 `.agents/skills/yss-ui-business-page-generation/SKILL.md`（旧触发词读 `.agents/skills/yss-page-module-development/SKILL.md`）。
-2. 新增或修改页面、组件、Less、内联样式、TS 渲染配置、SVG 色值：必须读 `.agents/skills/theme-token-usage/SKILL.md`。
-3. 导出、报表、模板、附件、Excel、CSV、PDF、ZIP、Blob 下载任务：必须读 `.agents/skills/file-export-download/SKILL.md`。
-4. 列表或表格任务：同时读 `.agents/skills/page-list-module/SKILL.md`、`.agents/skills/ytable-usage/SKILL.md`、`.agents/skills/yss-use-table-height/SKILL.md`。
-5. 新增/编辑/查看/抽屉表单：同时读 `.agents/skills/yss-formily/SKILL.md`、`.agents/skills/page-form-module/SKILL.md`。
-6. 可编辑表格、扩展属性、添加行/删除行：必须读 `.agents/skills/yedit-table-usage/SKILL.md`。
-7. 用户给原型截图或旧项目路径：必须读 `.agents/skills/prototype-page-acceptance/SKILL.md`，先生成验收清单，再实现。
-
-## Hard Stops
-
-- 模板已预置 yss-ui 项目级 MCP 配置；当前会话可用时，生成业务代码前必须先调用一次 `get_codegen_rules`。不确定导出时用 `list_components`，配置组件/Hook/Utils 前用 `get_component_docs`，复杂场景用 `get_demo`，不确定归属时用 `search_docs`。需要全局配置的客户端按 `docs/user-guide/yss-ui-mcp.md` 人工安装，不自动修改用户主目录。
-- 禁止使用 YTable 不存在的 `request`、`search-params` Props 和 `actionConfig.actions`；实例 `refresh()` 只刷新当前表格数据，不得当作远程重新查询。
-- 标准列表必须使用 `:data`、`:columns`、`:loading`、`pageable`、`v-model:pagination`、`@page-change`。
-- 表格主操作必须放入 `#toolbar-right`；只有确实需要列设置时才使用 `:toolbar-config="{ custom: true }"`。
-- 业务列表查询区默认将查询/重置按钮放在 YFormily 外部独占一行并右对齐；`AutoButtonGroup + Submit + Reset` 仅用于纯 Formily 提交表单。
-- 所有 YFormily 横向业务表单必须使用 `FormLayout(labelWidth, labelAlign: 'right') -> FormGrid -> 字段`，不得省略固定 label 宽度和右对齐。
-- FormGrid 必须保持响应式：默认 `minColumns: 1`，通过 `maxColumns`、`minWidth` 控制宽屏列数；禁止 `minColumns` 等于 `maxColumns` 固定列数，除非用户明确要求不响应式。
-- 抽屉/弹窗编辑表单默认 `labelWidth: 140`、`FormGrid { maxColumns: 2, minColumns: 1, minWidth: 320~360 }`；备注/长文本字段必须用 `gridSpan` 占满整行。
-- 可编辑表格必须优先使用 `YEditTable`，禁止用 `a-table` 手搓。
-- 抽屉表单必须有响应式宽度，查看态不显示保存按钮。
-- 页面和组件禁止硬编码品牌色及 hover/active/selected/focus 色阶；主色透明态必须从真实动态 Token 派生，不得依赖未同步变量的固定色 fallback。
-- 导出下载必须优先调用 `handleBlobResponse(res.data, res.headers)`；生成方法缺少 Blob 配置时，第二参数必须传 `{ responseType: 'blob' }`，禁止手改 Orval 生成文件。
-- Orval 请求失败由 `mutator.ts` 统一提示并 reject；业务 Hook 禁止 `if (res?.success)` 冗余判断，也禁止在 `else`/`catch` 重复 `message.error`，除非请求显式跳过了全局处理。
-- 调用 Orval API 前必须检查当前生成文件；存在具名导出时直接导入，只有工厂导出时在模块顶层创建一次实例，禁止猜测 `getApi()` 名称。
-- 有截图/旧项目参考时，交付前必须逐项对照查询区、表格工具栏、分页高度、抽屉、label、字段控件类型。
+YTable 使用真实 API：不得臆造 `request`、`search-params` 或 `actionConfig.actions`；主操作必须放入 `#toolbar-right`，只有确实需要列设置时才使用 `toolbar-config.custom`。其余组件、表单、主题、API 与导出细则以下沉技能为准。

package/template/.agents/skills/.strategic-design-skills-manifest.json

@@ -3,33 +3,38 @@
   "source": "iloveZzz/yss-harness-design-agent",
   "source_type": "git-submodule",
   "source_root": ".agents/skills",
-  "source_revision": "c93911622e1ada4a42ec5b0781f6cd06b504977c",
+  "source_revision": "31189d2b4b78821ea8bef202d8516ac85b7a3c79",
   "adaptation_ref": "docs/agents/strategic-design-skills-integration.md",
   "skills": [
     {
       "upstream": "prototype-review",
       "canonical": "prototype-review",
-      "upstream_hash": "92ab63f2c9aabf81580bd80d1a96a6174c9d4808f893a06a5180413af381e291"
+      "upstream_hash": "2e77b3093a758bb692fb3bda453c5c020d0523f875975e17e2731365f67432e1"
     },
     {
       "upstream": "yss-prototype-stage",
       "canonical": "yss-prototype-stage",
-      "upstream_hash": "bb8835942c113cb754e34cbb5b192d14191903460cbfe7c7fe321f8e798cb5be"
+      "upstream_hash": "e8f2f3a507da6bf7be0582e4a4dd9659381da8e291755070698a1f51a4e33808"
     },
     {
       "upstream": "yss-design-system",
       "canonical": "yss-design-system",
-      "upstream_hash": "54ab669e04c8eddb278cf52fe174878cd4797ef8fdf8546f41e1a59c6fb434ba"
+      "upstream_hash": "90aaf06b2514353152464a4d032076fa9d5ef56272d8ad526f5544f3c22a2b00"
     },
     {
       "upstream": "yss-antd-design",
       "canonical": "yss-antd-design",
-      "upstream_hash": "917099caa9b76ca3cfd1d0f81f61b28111c1c54ed93e92891f81012dcd0662e2"
+      "upstream_hash": "08ce99d45586d5ea19e25fdd9e9a6ede16e66f18992b70b87e0cd23f92343b16"
+    },
+    {
+      "upstream": "yss-antdv-next-design",
+      "canonical": "yss-antdv-next-design",
+      "upstream_hash": "2942ed52dd58a38e51f09eb11254809334aeaed08f21cd081f09f35e6647a68c"
     },
     {
       "upstream": "yss-stage-decision",
       "canonical": "yss-stage-decision",
-      "upstream_hash": "3a8a49a8d006543788023dc24764188a29863bb1a1a5af30e5a57a536e75f4f6"
+      "upstream_hash": "1eadf230f0e17bf6d209c1df1249acef3520ab29c26a80c476a2a557a224c10a"
     }
   ]
 }

package/template/.agents/skills/.yss-skills-manifest.json

@@ -5,7 +5,7 @@
   "source_root": "packages/skills",
   "source_category": "app",
   "excluded_categories": ["library"],
-  "excluded_skills": ["java-backend-commit"],
+  "excluded_skills": ["java-backend-commit", "page-module-development", "prototype-page-acceptance"],
   "source_revision": "c4d958f18cc947cb91cbe1bd48783fa4601cc18f",
   "adaptation_ref": "docs/agents/yss-ui-skills-integration.md",
   "package": {
@@ -23,9 +23,7 @@
     { "upstream": "frontend-commit", "canonical": "frontend-commit", "upstream_hash": "ffc1c7813607705c7c1158f4c5d3111aca79e73f1843e33bbc95eda9b5c726de" },
     { "upstream": "page-form-module", "canonical": "page-form-module", "upstream_hash": "4df686c7267c6be00680ea1faa908e0cf02e59bfe01c8111bbcaa80dea63c9b8" },
     { "upstream": "page-list-module", "canonical": "page-list-module", "upstream_hash": "303d8fc2161465ec3e81692c7b750ed814307ccf65f4fb51e0de69fe7af38d4f" },
-    { "upstream": "page-module-development", "canonical": "yss-page-module-development", "upstream_hash": "5f917ca85e522ddf2bf5a149db1c51e2e1b64b21e4fd6d7f8d3378177184244d" },
     { "upstream": "page-skeleton", "canonical": "page-skeleton", "upstream_hash": "d82c44770054d9bb0bc17849c25675e5672f01144614b3ffb846ec575ac19dec" },
-    { "upstream": "prototype-page-acceptance", "canonical": "prototype-page-acceptance", "upstream_hash": "bc5d75925ac8d7a2cbc38a0d65383faa4e8384c64be3d98b9994a506f50d6003" },
     { "upstream": "theme-token-usage", "canonical": "theme-token-usage", "upstream_hash": "b38acb4caf5012c9134df16a312b6be31b2b5d3fd6b976cfccee8d845f27c0ef" },
     { "upstream": "use-table-height", "canonical": "yss-use-table-height", "upstream_hash": "8a5baa8ca6a8dd2b2ed123391838b1a13e3f5cab8196225ed3429ca5b513d43f" },
     { "upstream": "use-tree-height", "canonical": "yss-use-tree-height", "upstream_hash": "2a9265cc997c2c20b6cfebbdc19b66b04450278fca5d5db252a5d855b2d95bed" },

package/template/.agents/skills/alibaba-java-code-style/SKILL.md

@@ -20,6 +20,7 @@ This skill distills the provided `阿里巴巴 Java 开发手册` 1.4.0 PDF into
 
 ## Core Priorities
 
+- 先消费 architecture_identity 与工程 Java/数据库基线。MVC 分层按 `docs/agents/backend-architecture-profiles.md`；MySQL 专属方言规则仅对批准的 MySQL 存储生效，不能要求 H2 骨架引入 MySQL 驱动。YSS 包装、命名及处理器差异逐项记录基线例外，安全、权限、敏感信息与 SQL 参数绑定不得豁免。
 - Keep names readable, English, and consistent with Java layer conventions.
 - Avoid null, equality, wrapper comparison, collection, and concurrency traps that compile cleanly but fail at runtime.
 - Make logs useful without wasting CPU, disk, or alert budget.

package/template/.agents/skills/code-review/references/yss-review-standards.md

@@ -12,7 +12,7 @@
 2. Slice Implementation Contract 的 `required_skills`：对每个技能读取 `.agents/skills/<id>/SKILL.md` 及该 skill 指明的 references。
 3. 影响面专项检查输入（与合同并集，不得互相替代）：
    - 后端：`alibaba-java-code-style`、`yss-domain`、`yss-application`、`yss-repository`、`yss-web-controller`、`yss-dto`、`mapstruct`、`lombok`
-   - UI：`yss-ui`、`yss-design-system`、`yss-ui-business-page-generation`、`yss-page-module-development`
+   - UI：`yss-ui`、`yss-design-system`、`yss-ui-business-page-generation`
 4. 报告模板中的后端 / 前端门禁表。空着的适用行视为 `missing_evidence`。
 
 YSS 页面模块约定（YTable、YFormily、页面骨架等）走 Standards，不并入 UI fidelity。UI fidelity 只核原型与状态矩阵。

package/template/.agents/skills/domain-modeling/CONTEXT-FORMAT.md

@@ -1,60 +1,55 @@
-# CONTEXT.md Format
+# YSS 业务词汇表合同
 
-## Structure
+## 位置与版本
 
-```md
-# {Context Name}
-
-{One or two sentence description of what this context is and why it exists.}
-
-## Language
+每个 YSS Git 仓库只允许一个大小写精确的根目录 `CONTEXT.md`。禁止嵌套 `CONTEXT.md`、`CONTEXT-MAP.md`、跨仓相对路径和绝对路径引用。独立仓库各自拥有自己的根词汇表，通过结构化 handoff 同步，不共同写一个文件。
 
-**Order**:
-{A one or two sentence description of the term}
-_Avoid_: Purchase, transaction
+文件顶部必须声明：
 
-**Invoice**:
-A request for payment sent to a customer after delivery.
-_Avoid_: Bill, payment request
-
-**Customer**:
-A person or organization that places orders.
-_Avoid_: Client, buyer, account
+```yaml
+---
+context_schema_version: 1
+---
 ```
 
-## Rules
+缺失或不支持的版本必须返回 `migration-required`，不得猜测格式。
 
-- **Be opinionated.** When multiple words exist for the same concept, pick the best one and list the others under `_Avoid_`.
-- **Keep definitions tight.** One or two sentences max. Define what it IS, not what it does.
-- **Only include terms specific to this project's context.** General programming concepts (timeouts, error types, utility patterns) don't belong even if the project uses them extensively. Before adding a term, ask: is this a concept unique to this context, or a general programming concept? Only the former belongs.
-- **Group terms under subheadings** when natural clusters emerge. If all terms belong to a single cohesive area, a flat list is fine.
+## 标准结构
 
-## Single vs multi-context repos
+```md
+# 业务上下文
 
-**Single context (most repos):** One `CONTEXT.md` at the repo root.
+本文档只记录稳定业务语言，不记录实现细节、计划草稿或架构说明。
 
-**Multiple contexts:** A `CONTEXT-MAP.md` at the repo root lists the contexts, where they live, and how they relate to each other:
+## 流程术语
 
-```md
-# Context Map
+| 术语 | 含义 | 英文标识 | 避免 / 备注 |
+|---|---|---|---|
+| Spec | 产品研发规格。 | — |  |
+
+## 业务术语
 
-## Contexts
+| 术语 | 含义 | 英文标识 | 适用业务责任区 | 避免 / 备注 |
+|---|---|---|---|---|
+| 准入决定 | 合规审查形成的准入结论。 | AdmissionDecision | ComplianceReview | 避免：`审批结果` |
+```
 
-- [Ordering](./src/ordering/CONTEXT.md) — receives and tracks customer orders
-- [Billing](./src/billing/CONTEXT.md) — generates invoices and processes payments
-- [Fulfillment](./src/fulfillment/CONTEXT.md) — manages warehouse picking and shipping
+## 术语身份
 
-## Relationships
+- 业务术语的稳定身份是 `<ContextId>/<EnglishIdentifier>`，例如 `ComplianceReview/AdmissionDecision`。
+- 跨业务责任区共享且含义完全一致的术语使用 `Global/<EnglishIdentifier>`。
+- `英文标识` 与 `ContextId` 使用 PascalCase；非 `Global` 的 ContextId 必须来自当前业务边界与规则设计的内部 `contexts[].context_id`。
+- 同一业务责任区内中文术语、英文标识和禁用别名不得冲突。不同责任区可以拥有同名局部术语，但引用必须带 ContextId。
+- `Global` 术语不得被局部上下文用相同中文术语或英文标识重新定义；语义不同的词不应声明为 Global。
+- 流程术语的 `英文标识` 固定为 `—`，只由 `template-source` 维护；`project-instance` 只维护业务术语。
 
-- **Ordering → Fulfillment**: Ordering emits `OrderPlaced` events; Fulfillment consumes them to start picking
-- **Fulfillment → Billing**: Fulfillment emits `ShipmentDispatched` events; Billing consumes them to generate invoices
-- **Ordering ↔ Billing**: Shared types for `CustomerId` and `Money`
-```
+## 内容边界
 
-The skill infers which structure applies:
+- 只写已经确认、稳定且未来资产需要复用的业务语言。候选、猜测和未决术语保留在 Discovery、业务边界与规则设计或 `context_delta`。
+- 定义保持一到两句，说明概念是什么；不要写类全名、表名、接口路径、实现步骤或计划。
+- 禁用别名使用 `避免：别名一、别名二`；需要补充说明时追加 `；备注：...`。
+- 术语稳定时立即回写。工作单元完成、门禁批准或阶段转换前仍须执行 context reconciliation。
 
-- If `CONTEXT-MAP.md` exists, read it to find contexts
-- If only a root `CONTEXT.md` exists, single context
-- If neither exists, create a root `CONTEXT.md` lazily when the first term is resolved
+## 机器验证
 
-When multiple contexts exist, infer which one the current topic relates to. If unclear, ask.
+使用根目录 `scripts/verify-context-contract` 校验位置、版本、表格、术语身份、适用业务责任区和引用。业务资产只使用结构化 `context_ref: CONTEXT.md` 与 `term_refs`，不得使用 `CONTEXT.md#Term` 或 `contexts/<ContextId>/CONTEXT.md`。校验器兼容旧项目的 `适用限界上下文` 表头，但新模板只写 `适用业务责任区`。

package/template/.agents/skills/domain-modeling/SKILL.md

@@ -1,15 +1,15 @@
 ---
 name: domain-modeling
-description: Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a CONTEXT.md, or recording or editing an ADR.
+description: 梳理项目的业务词汇、责任范围和关键决策；讨论术语、编辑 CONTEXT.md 或记录 ADR 时使用。
 ---
 
-# Domain Modeling
+# 业务词汇与关键决策
 
-Actively build and sharpen the project's domain model as you design. This is the *active* discipline — challenging terms, inventing edge-case scenarios, and writing the glossary and decisions down the moment they crystallise. (Merely *reading* `CONTEXT.md` for vocabulary is not this skill — that's a one-line habit any skill can do. This skill is for when you're changing the model, not just consuming it.)
+在设计过程中主动澄清业务词汇、责任范围和关键决策：质疑含糊说法，用边界与失败场景检验规则，并在结论稳定时写入词汇表或决策记录。仅仅读取 `CONTEXT.md` 不需要调用本技能；只有准备改变业务语言或关键决策时才使用。
 
 ## File structure
 
-Most repos have a single context:
+YSS repositories use exactly one root context file:
 
 ```
 /
@@ -21,37 +21,21 @@ Most repos have a single context:
 └── src/
 ```
 
-If a `CONTEXT-MAP.md` exists at the root, the repo has multiple contexts. The map points to where each one lives:
-
-```
-/
-├── CONTEXT-MAP.md
-├── docs/
-│   └── adr/                          ← system-wide decisions
-├── src/
-│   ├── ordering/
-│   │   ├── CONTEXT.md
-│   │   └── docs/adr/                 ← context-specific decisions
-│   └── billing/
-│       ├── CONTEXT.md
-│       └── docs/adr/
-```
-
-Create files lazily — only when you have something to write. If no `CONTEXT.md` exists, create one when the first term is resolved. If no `docs/adr/` exists, create it when the first ADR is needed.
+不要创建嵌套 `CONTEXT.md` 或 `CONTEXT-MAP.md`。多个业务责任区统一记录在根词汇表的 `适用业务责任区` 列中；内部仍使用稳定 `ContextId`。第一次确有必要记录 ADR 时再创建 `docs/adr/`。YSS 仓库缺少根 `CONTEXT.md` 属于合同错误，必须先修复再继续生命周期工作。
 
 ## During the session
 
-### Challenge against the glossary
+### 对照词汇表检查冲突
 
 When the user uses a term that conflicts with the existing language in `CONTEXT.md`, call it out immediately. "Your glossary defines 'cancellation' as X, but you seem to mean Y — which is it?"
 
-### Sharpen fuzzy language
+### 澄清含糊语言
 
 When the user uses vague or overloaded terms, propose a precise canonical term. "You're saying 'account' — do you mean the Customer or the User? Those are different things."
 
-### Discuss concrete scenarios
+### 讨论具体业务故事
 
-When domain relationships are being discussed, stress-test them with specific scenarios. Invent scenarios that probe edge cases and force the user to be precise about the boundaries between concepts.
+讨论业务关系时，用具体故事和失败案例检验它们，促使用户明确概念边界、规则责任和例外结果。
 
 ### Cross-reference with code
 
@@ -61,7 +45,7 @@ When the user states how something works, check whether the code agrees. If you
 
 When a term is resolved, update `CONTEXT.md` right there. Don't batch these up — capture them as they happen. Use the format in [CONTEXT-FORMAT.md](./CONTEXT-FORMAT.md).
 
-`CONTEXT.md` should be totally devoid of implementation details. Do not treat `CONTEXT.md` as a spec, a scratch pad, or a repository for implementation decisions. It is a glossary and nothing else.
+`CONTEXT.md` 不得包含实现细节。不要把它当作 Spec、草稿区或实现决策仓库；它只是一份稳定业务词汇表。
 
 ### Offer ADRs sparingly
 

package/template/.agents/skills/grill-with-docs/SKILL.md

@@ -4,16 +4,17 @@ description: Use when the user explicitly requests a relentless design interview
 disable-model-invocation: true
 ---
 
-Call the Skill tool with `grilling`, then call it separately with `domain-modeling`.
+Call the Skill tool with `grilling`, then call it separately with `domain-modeling`. This compatibility entry does not define a second glossary format: it consumes `domain-modeling/CONTEXT-FORMAT.md`, the repository Context Contract validator, and the lifecycle reconciliation contract.
 
 ## Output Contract
 
-1. Read the repository identity and current glossary before the first round.
+1. Read `yss-project.yaml` and the root glossary before the first round, then run `scripts/verify-context-contract --root . --json`. Missing or lowercase root files, nested `CONTEXT.md`, `CONTEXT-MAP.md`, unsupported schema, absolute/cross-repository references, and Markdown pseudo-anchors are `blocked` or `migration-required`.
 2. Separate discoverable facts from user decisions; investigate facts instead of asking the user.
 3. Ask the entire current decision frontier, with a recommendation for every question, then wait.
-4. Record resolved stable terms in the authoritative `CONTEXT.md` only when they are true glossary entries.
+4. Keep candidate or disputed terms in the Discovery decision frontier. Only after confirmation, use `domain-modeling` to record true stable glossary entries in the repository root's single, case-sensitive `CONTEXT.md`; business rows use the five-column format and `<ContextId>/<EnglishIdentifier>` identity. Non-`Global` Context IDs must come from the approved business responsibility areas in the business-boundary asset.
 5. Create an ADR only when the decision is hard to reverse, surprising without context, and a real trade-off.
 6. Persist factual research/validation records in the repository's existing review or research convention.
-7. Do not modify implementation skills, contracts, or code until the user confirms shared understanding and the intended change scope.
+7. For `project-instance`, before requesting approval or returning a next work unit, generate and validate `context_reconciliation` with a readable ref, `document_digest`, `referenced_terms_digest`, and `term_refs`. Unresolved candidates, scope conflicts, aliases, or digest drift are `blocked`; reconciliation does not create another gate. For `template-source`, do not add fictional business terms and return a reasoned `not-applicable` after validating the template contract.
+8. Do not modify implementation skills, contracts, or code until the user confirms shared understanding and the intended change scope.
 
-The final grilling round must list confirmed decisions, unresolved assumptions, documents changed, and the next authorized action. A research note is evidence, not an architecture approval or release claim.
+The final grilling round must list confirmed decisions, unresolved assumptions, documents changed, `context_reconciliation` status/ref, and the next authorized action, then return control to `yss-product-lifecycle` (or the active YSS lifecycle orchestrator). It cannot approve an asset or advance a stage itself. A research note is evidence, not an architecture approval or release claim.

package/template/.agents/skills/lombok/SKILL.md

@@ -19,6 +19,7 @@ allowed-tools: Read, Grep, Glob, Write, Edit
 
 ## YSS 阶段 7 执行结果
 
+- 消费工程 Java 与处理器基线；三个新后端 Profile 为 Java 8。MapStruct binding 进入 annotationProcessorPaths，不作为业务依赖单独引入；示例不授权升级依赖。MVC PO 的身份/敏感字段风险与 DDD 相同，不能默认全量 @Data。
 - 消费批准后的 Slice Contract/work unit，只在允许路径内调整 POJO 样板和注解处理器配置。
 - 受控生成必须记录对象类型、选用/排除注解、实体关系和敏感字段风险、编译/测试实际结果。
 - 按 `yss-implementation-contract-compiler` 的统一 Execution Result 返回 changed files、证据、偏离和新增影响；`@Data` 实体风险、处理器配置缺失或越界路径返回 `violation`。
@@ -258,7 +259,7 @@ public void readFile(String path) throws IOException {
 ```java
 @SneakyThrows  // Wraps checked exception
 public String readConfig() {
-    return Files.readString(Path.of("config.json"));
+    return new String(Files.readAllBytes(Paths.get("config.json")), StandardCharsets.UTF_8);
 }
 ```
 

package/template/.agents/skills/mapstruct/SKILL.md

@@ -19,6 +19,7 @@ allowed-tools: Read, Grep, Glob, Write, Edit
 
 ## YSS 阶段 7 执行结果
 
+- Java、依赖与处理器版本来自工程基线，不从下面通用示例推断。三个新后端 Profile 为 Java 8；MVC 的 wire/internal 转换在 server，core/service 不依赖 client，Repository 不依赖上层 DTO。采用 Spring Bean 和构造器注入，显式映射或忽略字段；禁止通过全局 IGNORE 掩盖合同字段遗漏。
 - 消费批准后的 Slice Contract/work unit，只为合同中的 DTO/VO/PO/Domain 转换生成 Mapper/Convertor。
 - 受控生成必须记录 source/target、忽略字段、更新语义、Lombok processor 配置和 mapper 行为测试。
 - 按 `yss-implementation-contract-compiler` 的统一 Execution Result 返回生成/源文件、测试和实际验证；未映射字段、反射/BeanUtils 退化或越界路径返回 `violation`。
@@ -230,8 +231,8 @@ public abstract class UserMapper {
             <artifactId>maven-compiler-plugin</artifactId>
             <version>3.13.0</version>
             <configuration>
-                <source>17</source>
-                <target>17</target>
+                <source>${maven.compiler.source}</source>
+                <target>${maven.compiler.target}</target>
                 <annotationProcessorPaths>
                     <!-- Order matters: Lombok first -->
                     <path>

package/template/.agents/skills/setup-matt-pocock-skills/SKILL.md

@@ -22,19 +22,18 @@ Look at the current repo to understand its starting state. Read whatever exists;
 
 - `git remote -v` and `.git/config` — is this a GitHub repo? Which one?
 - `AGENTS.md` and `CLAUDE.md` at the repo root — does either exist? Is there already an `## Agent skills` section in either?
-- `CONTEXT.md` and `CONTEXT-MAP.md` at the repo root
+- The case-sensitive `CONTEXT.md` at the Git repository root; also detect lowercase, nested, or duplicate context files as migration problems
 - `docs/adr/` and any `src/*/docs/adr/` directories
 - `docs/agents/` — does this skill's prior output already exist?
 - `docs/.scratch/` — sign that the canonical local-markdown issue tracker convention is already in use
 - `.scratch/` and `docs/requirements/tickets/` — legacy local-tracker roots; inspect them read-only for migration and never use them as new write targets
 - Is the `triage` skill installed? (a `triage` skill folder alongside this one, or `triage` in your available skills.) This decides whether Section B runs at all.
-- Monorepo signals — a `pnpm-workspace.yaml`, a `workspaces` field in `package.json`, or a populated `packages/*` with its own `src/`. Present only in a genuinely large multi-package repo; their absence means single-context, which is almost every repo.
 
 ### 2. Present findings and ask
 
 Summarise what's present and what's missing. Then take the sections in order — one section, one answer, then the next.
 
-Lead each section with the recommended answer so the user can accept it in a word. Give a one-line explainer only when the choice genuinely branches; skip the section entirely when exploration already settled it (Section B when `triage` isn't installed, Section C when there's no monorepo).
+Lead each section with the recommended answer so the user can accept it in a word. Give a one-line explainer only when the choice genuinely branches; skip Section B entirely when `triage` isn't installed.
 
 **Section A — Issue tracker.**
 
@@ -65,9 +64,9 @@ If it is installed, ask exactly one question:
 
 The defaults are the five canonical roles, each label string equal to its name: `needs-triage`, `needs-info`, `ready-for-agent`, `ready-for-human`, `wontfix`. On **yes**, write them as-is. Only if the user says no — usually because their tracker already uses other names (e.g. `bug:triage` for `needs-triage`) — collect the overrides so `triage` applies existing labels instead of creating duplicates.
 
-**Section C — Domain docs.** Default to **single-context** — one `CONTEXT.md` + `docs/adr/` at the repo root. This fits almost every repo; write it without asking.
+**Section C — Business vocabulary and decisions.** The layout does not branch: every YSS Git repository has exactly one case-sensitive `CONTEXT.md` at its root. Multiple business responsibility areas share that glossary and are distinguished by each business term's `适用业务责任区` and stable `<ContextId>/<EnglishIdentifier>` reference. ADRs live under root `docs/adr/` and are created lazily when the first qualifying decision is accepted.
 
-Offer **multi-context** — a root `CONTEXT-MAP.md` pointing to per-context `CONTEXT.md` files — only when exploration found monorepo signals. Then confirm which layout they want.
+If the root `CONTEXT.md` is missing, initialize it with `context_schema_version: 1`, the process-term table (`术语 | 含义 | 英文标识 | 避免 / 备注`) and the business-term table (`术语 | 含义 | 英文标识 | 适用业务责任区 | 避免 / 备注`). Do not invent business terms during setup. If a lowercase, nested, duplicate, or mapped context layout exists, stop and report `migration-required`; do not preserve or extend it as a second supported layout.
 
 ### 3. Confirm and edit
 
@@ -105,7 +104,7 @@ The block:
 
 ### Domain docs
 
-[one-line summary of layout — "single-context" or "multi-context"]. See `docs/agents/domain.md`.
+[one-line summary: one root `CONTEXT.md`, with bounded contexts represented inside its business glossary]. See `docs/agents/domain.md`.
 ```
 
 Include the `### Triage labels` sub-block, and write `docs/agents/triage-labels.md`, only when `triage` is installed and Section B ran. When it isn't, both are omitted.

package/template/.agents/skills/setup-matt-pocock-skills/domain.md

@@ -4,15 +4,14 @@ How the engineering skills should consume this repo's domain documentation when
 
 ## Before exploring, read these
 
-- **`CONTEXT.md`** at the repo root, or
-- **`CONTEXT-MAP.md`** at the repo root if it exists — it points at one `CONTEXT.md` per context. Read each one relevant to the topic.
-- **`docs/adr/`** — read ADRs that touch the area you're about to work in. In multi-context repos, also check `src/<context>/docs/adr/` for context-scoped decisions.
+- **`CONTEXT.md`** — the single case-sensitive glossary at the Git repository root. Its `context_schema_version` must be supported. A missing root file, lowercase or nested replacement, duplicate, or map-based layout is `blocked` / `migration-required`, not an optional omission.
+- **`docs/adr/`** — if it exists, read ADRs that touch the area you're about to work in. This directory is created lazily when the first qualifying decision is accepted.
 
-If any of these files don't exist, **proceed silently**. Don't flag their absence; don't suggest creating them upfront. The `/domain-modeling` skill (reached via `/grill-with-docs` and `/improve-codebase-architecture`) creates them lazily when terms or decisions actually get resolved.
+When the repository exposes `scripts/verify-context-contract`, run it before creating or changing stable domain, product, architecture, implementation, review, release, or retrospective assets.
 
 ## File structure
 
-Single-context repo (most repos):
+Every YSS Git repository:
 
 ```
 /
@@ -23,24 +22,11 @@ Single-context repo (most repos):
 └── src/
 ```
 
-Multi-context repo (presence of `CONTEXT-MAP.md` at the root):
-
-```
-/
-├── CONTEXT-MAP.md
-├── docs/adr/                          ← system-wide decisions
-└── src/
-    ├── ordering/
-    │   ├── CONTEXT.md
-    │   └── docs/adr/                  ← context-specific decisions
-    └── billing/
-        ├── CONTEXT.md
-        └── docs/adr/
-```
+Multiple business responsibility areas do not create additional glossary files. Each stable business term records its approved PascalCase `适用业务责任区`, and consumers reference it as `<ContextId>/<EnglishIdentifier>`. Use `Global/<EnglishIdentifier>` only for language that is genuinely shared across responsibility areas.
 
 ## Use the glossary's vocabulary
 
-When your output names a domain concept (in an issue title, a refactor proposal, a hypothesis, a test name), use the term as defined in `CONTEXT.md`. Don't drift to synonyms the glossary explicitly avoids.
+When your output names a domain concept (in an issue title, a refactor proposal, a hypothesis, a test name), use the term and stable reference defined in `CONTEXT.md`. Don't drift to synonyms the glossary explicitly avoids.
 
 If the concept you need isn't in the glossary yet, that's a signal — either you're inventing language the project doesn't use (reconsider) or there's a real gap (note it for `/domain-modeling`).
 

package/template/.agents/skills/wait-what/SKILL.md

@@ -4,4 +4,4 @@ description: "Stop. That last message did not land: re-pitch it."
 disable-model-invocation: true
 ---
 
-Wait, I don't understand where you've got to here. Re-pitch that: give me a little bit of context, talk in ASD-STE100 Simplified Technical English, and use the ubiquitous language from `CONTEXT.md` (follow `CONTEXT-MAP.md` to the right one if the repo has more than one).
+Wait, I don't understand where you've got to here. Re-pitch that: give me a little bit of context, talk in ASD-STE100 Simplified Technical English, and use the ubiquitous language from the repository-root `CONTEXT.md`. When the repository has multiple bounded contexts, resolve the term by its `<ContextId>/<EnglishIdentifier>` reference and the `适用限界上下文` column in that single glossary.

package/template/.agents/skills/yss-antdv-next-design/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: yss-antdv-next-design
+description: Use when the default H2 Vue prototype needs versioned Antdv Next component facts or a fact-pack refresh. Not for H1, production frontend implementation, lifecycle approval, or replacing yss-prototype-stage.
+---
+
+# YSS Antdv Next Provider
+
+作为 H2 `flow-review` 的默认组件事实 Provider，为 `vue-antdv-next` 原型提供 Vue-native API、SFC demo、token 与 semantic facts。阶段合同、Vue/Vite starter 和页面流仍由 `yss-prototype-stage` 持有，项目视觉与 Token 仍由 `yss-design-system` 持有。本技能不生成页面、不批准门禁，也不代表生产 YSS UI 已迁移到 Antdv Next。
+
+## 适用条件
+
+- 原型已进入 `yss-prototype-stage`，档位为 H2，默认或显式选择组件基座 `vue-antdv-next`。
+- 需要创建或增量刷新 `docs/design/facts/antdv-next/<exact-version>/manifest.json`。
+- 目标库版本、CLI 版本、组件集合或项目 Token digest 变化，已有 fact pack 不再 fresh。
+
+H1、React AntD 兼容原型、生产前端实现、组件库迁移、门禁批准和页面流生成均不适用。显式选择 `react-antd-6` 时使用 `yss-antd-design`；生产落地仍进入 `yss-ui`。
+
+## 执行
+
+1. 按 `DESIGN.md`（规范 Token / 组件变体）→ `docs/design/design.md`（治理解释）→ `docs/design/tokens/*`（派生快照）的顺序读取项目基线；三者任一 digest 变化都使旧 fact pack 失效。
+2. 选择精确的 `antdv-next` 与 `@antdv-next/cli` 版本；禁止 dist-tag、caret、tilde 或空版本。当前受支持组合见 `references/cli-matrix.md`。
+3. 优先复用 fresh fact pack；否则运行 `scripts/collect-antdv-next-facts.mjs`。采集器只调用允许的只读查询，并先执行 exact-version resolution probe。
+4. resolution probe 的 `from` 或 `to` 与请求版本不一致时立即失败；不得继续采集或把同 minor / major 回退写成精确事实。
+5. 使用 `scripts/validate-fact-pack.mjs <manifest>` 复核文件摘要、Vue SFC demo、组件覆盖和项目 Token baseline。
+6. 在原型证据中只引用 manifest 与实际采用的组件。上游默认和项目 Token 冲突时，以项目为准并记录人工 override review。
+
+标准采集示例：
+
+```bash
+node .agents/skills/yss-antdv-next-design/scripts/collect-antdv-next-facts.mjs \
+  --project-root . \
+  --output docs/design/facts/antdv-next/1.5.2 \
+  --library-version 1.5.2 \
+  --cli-version 0.0.0-beta.5 \
+  --component Button --component Form --component Table \
+  --component Modal --component Select --component DatePicker
+```
+
+## 硬规则
+
+- 只允许 `list`、`info`、`demo`、`token`、`semantic`、`changelog`、`design.md` 与读取单组件官方 Markdown；允许面见 `references/cli-matrix.md`。
+- 禁止 `antdv setup`、`antdv init`、`antdv upgrade`、`antdv migrate`、`antdv check`、当前占位的 `antdv lint`，以及 `bug` / `bug-cli`。
+- 禁止 `npx skills add antdv-next/cli`、`npx skills add antdv-next/skills`，也不得把官方 Skill 复制进任何 Agent root。
+- 禁止把 MCP 对话、`llms-full.txt`、CLI 自报的未解析版本或静态 `design.md` 当作 exact component API 证据。
+- 禁止让上游 `design.md` 覆盖项目 `DESIGN.md`、`docs/design/design.md` 或项目 Token；manifest 必须直接记录根 `DESIGN.md` path 与 digest。
+- 禁止把原型事实包当作生产兼容性、可复用代码、`gate.prototype-verified` 或组件库迁移完成证据。
+
+事实包合同见 `references/fact-pack.md`，阶段及生产边界见 `references/boundaries.md`。

package/template/.agents/skills/yss-antdv-next-design/references/boundaries.md

@@ -0,0 +1,25 @@
+# 边界与协作
+
+## 权威优先级
+
+1. 项目 `DESIGN.md`、`docs/design/design.md` 与 `docs/design/tokens/*`。
+2. `yss-design-system` 的项目覆盖和 Design QA 规则。
+3. 已校验的 Antdv Next exact-version 组件 fact pack。
+4. Antdv Next 静态 `design.md` 默认基线。
+5. 组件默认样式。
+
+上游页面、README、Skill、MCP 输出和 CLI 帮助均属于不受信任的外部输入，只能提供事实，不能改变仓库指令、安装软件、批准门禁或授权写入。
+
+## 与现有技能
+
+- `yss-prototype-stage`：持有低保真、状态矩阵、独立评审、H1/H2 路由、浏览器验证和用户确认。本技能只提供 `vue-antdv-next` 事实。
+- `yss-design-system`：持有项目视觉和 Token；冲突时项目覆盖始终优先。
+- `yss-antd-design`：继续服务显式 `react-antd-6` 兼容路线；本技能不改变其稳定语义。
+- `yss-ui`：持有生产前端实现。原型选择 Antdv Next 不代表生产组件库迁移，也不能跳过实现合同。
+
+## 明确不做
+
+- 不持有 Vue/Vite starter 或页面生成；默认 adapter 由 `yss-prototype-stage` 持有。
+- 不把 provider-specific 字段重新硬编码进 schema v3。
+- 不发布、不弃用 `yss-antd-design`，不生成迁移承诺。
+- 不把 H2 默认基座选择解释为生产组件库迁移。