create-yss-spec 3.0.0 → 3.0.1

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

@@ -15,7 +15,7 @@ description: Use when YSS 产品设计系统与 Ant Design 企业级 UI 风格
 - 历史输入包：`/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`，用于统一跨 Agent 的原型资产和浏览器验证证据。AntD 事实由 `yss-antd-design` 提供，且只用于原型设计构建。
+- 原型阶段合同：`yss-prototype-stage`，用于统一 H1/H2 原型资产和浏览器验证证据。AntD 事实由 `yss-antd-design` 条件提供，且只用于相关 H2。
 
 如果只需要快速判断，先读本文件。若要写 UI 规范、实现页面、评审设计或调整 token，必须读项目内 `docs/design/design.md`；若要执行评审或实现检查，再读 `references/design-system.md`。
 
@@ -39,8 +39,8 @@ description: Use when YSS 产品设计系统与 Ant Design 企业级 UI 风格
 - 表面层级：页面背景、内容容器、浮层三层模型。
 - 组件语言：优先 Ant Design / YSS UI 语义，不自造同类控件。
 - 状态完整性：loading、empty、error、readonly、disabled、no-permission、conflict、success 必须在设计或实现中可解释。
-- Ant Design v6 原型基线：先用语义 token 定义角色，再用组件 token 或 CSS variables 落地；不以局部硬编码替代主题层。
-- 双轨版本：主题/视觉标准为 React Ant Design v6；生产 API 为 Vue 3 + YSS UI + 实现仓 lockfile 的 Ant Design Vue 4.x。只迁移语义、Token、状态与验收行为。
+- 原型基线：先用项目语义 token 定义角色，再用组件 token 或 CSS variables 落地；不以局部硬编码替代主题层。H2 采用 React AntD 时补充 Ant Design v6 事实。
+- 档位版本边界：H1 只依赖项目 Token；H2 React AntD 精确锁版本。生产 API 只在实现阶段从目标仓 lockfile 读取 Vue 3 + YSS UI + AntDV 事实；原型只迁移语义、Token、状态与验收行为。
 
 ## 强制规则
 
@@ -83,14 +83,14 @@ description: Use when YSS 产品设计系统与 Ant Design 企业级 UI 风格
 | --- | --- |
 | Spec 后做页面 / 原型 / 交互说明 | `yss-prototype-stage` → `product-design:index` |
 | 低保真原型进入高保真前评审 | `prototype-review` |
-| 低保真评审通过后的高保真 HTML 原型 | `yss-prototype-stage`；`high-fidelity-html-prototype` 仅兼容入口 |
+| 低保真评审后的原型交付物 | `yss-prototype-stage` 选择 H1/H2；`high-fidelity-html-prototype` 仅只读迁移 |
 | 低保真线框或流程图 | `product-design:index` |
 | 前端页面实现 | `yss-ui` / `yss-ui-business-page-generation`；生命周期兼容使用 `yss-page-module-development` |
 | 表单 schema | `yss-formily` |
 | YTable / YTree / 高度自适应 | `yss-components` / `yss-use-table-height` / `yss-use-tree-height` |
-| 原型阶段的 Ant Design v6 组件 / token / demo 查询 | `yss-antd-design`（只用于原型设计构建；前端落地改用 `yss-ui`） |
+| H2 React/AntD 的组件 / token / demo 查询 | `yss-antd-design`（fact pack 优先，不用于 H1） |
 | Codex 原型交接前的视觉 QA | `design-qa`；token / 字体对照读 `references/design-qa-theme.md`，以项目覆盖为准 |
-| Product Design 通用 starter 接入 YSS | `yss-prototype-stage/references/product-design-adapter.md`；锁定 antd@6、pnpm、主题 adapter、feature 级 QA 与证据 |
+| 原型渲染适配 | `yss-prototype-stage/references/product-design-adapter.md`；H1 静态、H2 可运行流程；不得调用 `yss-ui` |
 | API 契约 / 接入 | `yss-openapi-governance` / `yss-api-integration` |
 
 ## 更新设计系统

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

@@ -22,11 +22,11 @@ description: Use when 用于 YSS 分布式 ID 组件的接入与排障。当用
 
 ## 源码索引
 
-- 源码位置不要假设固定目录；先按 `yss-source-index/references/source-location.md` 定位。
+- 源码位置不要假设固定目录；先按 `yss-skill-source-index-refresh/references/source-location.md` 定位。
 - 当前技能索引：`references/source-index.md`
 - 重点源码入口通常包括 `EnableDistributedId`、`AutoIdInterceptor`、Leaf 配置、Leaf REST/Feign/gRPC 模块、ID 策略相关类。
 
-当组件源码变化后，用 `yss-source-index` 刷新索引；刷新或读取前先按源码定位策略确认真实位置。
+当组件源码变化后，用 `yss-skill-source-index-refresh` 刷新索引；刷新或读取前先按源码定位策略确认真实位置。
 
 ## 检查清单
 

package/template/.pi/skills/yss-distributed-id/references/source-index.md

@@ -5,7 +5,7 @@ Source commit: `38b556a5081e6c66c0c538cbc1ef839b19996ed3`
 Source worktree: `dirty`
 Indexed source root: resolved at refresh time; set `YSS_SOURCE_ROOT` to reproduce or refresh.
 
-This file is generated by `yss-source-index/scripts/refresh-yss-skill-index.mjs`. Do not hand-edit generated sections.
+This file is generated by `yss-skill-source-index-refresh/scripts/refresh-yss-skill-index.mjs`. Do not hand-edit generated sections.
 
 Paths below are source path hints captured at refresh time. If they do not exist in the current workspace, locate sources using `YSS_SOURCE_ROOT`, CodeGraph, package/class names, Maven artifact names, or repository search before assuming the source is unavailable.
 

package/template/.pi/skills/yss-domain/SKILL.md

@@ -66,5 +66,5 @@ description: 用于构建或重构 YSS 领域层代码。当用户要求设计
 - 只消费生命周期已批准的 `Slice Implementation Contract` 和当前 `work_unit`；不得扩大 `allowed_write_paths`。
 - `Slice Implementation Contract` 必须引用批准且版本当前的 `tactical_design_ref`；不得在实现阶段重新批准或替换聚合、不变量和一致性策略。
 - 领域规则、状态机和不变量必须使用 `behavior-tdd`，先形成失败测试，再实现最小行为。
-- 完成后按 `yss-router/references/yss-skill-execution-result.md` 返回统一 `YSS Skill Execution Result`：changed files、领域/测试证据、实际验证结果、偏离和新增影响。
+- 完成后按 `yss-implementation-contract-compiler/references/yss-skill-execution-result.md` 返回统一 `YSS Skill Execution Result`：changed files、领域/测试证据、实际验证结果、偏离和新增影响。
 - 发现新 API、权限、状态机、数据模型或架构影响时填入 `new_impacts` 并暂停，不得静默扩张切片。

package/template/.pi/skills/yss-dto/SKILL.md

@@ -32,12 +32,12 @@ description: Use when YSS `Result`, `SingleResult`, `MultiResult`, `PageResult`,
 
 ## 源码索引
 
-- 源码位置不要假设固定目录；先按 `yss-source-index/references/source-location.md` 定位。
+- 源码位置不要假设固定目录；先按 `yss-skill-source-index-refresh/references/source-location.md` 定位。
 - 当前技能索引：`references/source-index.md`
 - OpenAPI wire profile：`references/openapi-wire-profile.yaml`
 - 重点源码入口通常包括 `CommandDTO`、`QueryDTO`、`PageQuery`、`PageRequestFactory`、`Result`、`SingleResult`、`MultiResult`、`PageResult`。
 
-当组件源码变化后，用 `yss-source-index` 刷新索引；刷新或读取前先按源码定位策略确认真实位置。
+当组件源码变化后，用 `yss-skill-source-index-refresh` 刷新索引；刷新或读取前先按源码定位策略确认真实位置。
 
 ## 使用规则
 

package/template/.pi/skills/yss-dto/references/source-index.md

@@ -5,7 +5,7 @@ Source commit: `38b556a5081e6c66c0c538cbc1ef839b19996ed3`
 Source worktree: `dirty`
 Indexed source root: resolved at refresh time; set `YSS_SOURCE_ROOT` to reproduce or refresh.
 
-This file is generated by `yss-source-index/scripts/refresh-yss-skill-index.mjs`. Do not hand-edit generated sections.
+This file is generated by `yss-skill-source-index-refresh/scripts/refresh-yss-skill-index.mjs`. Do not hand-edit generated sections.
 
 Paths below are source path hints captured at refresh time. If they do not exist in the current workspace, locate sources using `YSS_SOURCE_ROOT`, CodeGraph, package/class names, Maven artifact names, or repository search before assuming the source is unavailable.
 

package/template/.pi/skills/yss-excel-mvc/SKILL.md

@@ -23,11 +23,11 @@ description: Use when 用于 Spring MVC 下的 Excel 导入导出实现。当用
 
 ## 源码索引
 
-- 源码位置不要假设固定目录；先按 `yss-source-index/references/source-location.md` 定位。
+- 源码位置不要假设固定目录；先按 `yss-skill-source-index-refresh/references/source-location.md` 定位。
 - 当前技能索引：`references/source-index.md`
 - 重点源码入口通常包括 `RequestExcel`、`ResponseExcel`、`ExcelDynamicData`、参数解析器、返回值处理器、starter 配置。
 
-当组件源码变化后，用 `yss-source-index` 刷新索引；刷新或读取前先按源码定位策略确认真实位置。
+当组件源码变化后，用 `yss-skill-source-index-refresh` 刷新索引；刷新或读取前先按源码定位策略确认真实位置。
 
 ## 常见实现路径
 

package/template/.pi/skills/yss-excel-mvc/references/source-index.md

@@ -5,7 +5,7 @@ Source commit: `38b556a5081e6c66c0c538cbc1ef839b19996ed3`
 Source worktree: `dirty`
 Indexed source root: resolved at refresh time; set `YSS_SOURCE_ROOT` to reproduce or refresh.
 
-This file is generated by `yss-source-index/scripts/refresh-yss-skill-index.mjs`. Do not hand-edit generated sections.
+This file is generated by `yss-skill-source-index-refresh/scripts/refresh-yss-skill-index.mjs`. Do not hand-edit generated sections.
 
 Paths below are source path hints captured at refresh time. If they do not exist in the current workspace, locate sources using `YSS_SOURCE_ROOT`, CodeGraph, package/class names, Maven artifact names, or repository search before assuming the source is unavailable.
 

package/template/.pi/skills/yss-exception/SKILL.md

@@ -11,7 +11,7 @@ Use this skill for YSS 异常组件. Keep implementation grounded in the local p
 
 ## Source Index First
 
-- Backend source location is environment-specific; resolve it with `yss-source-index/references/source-location.md`.
+- Backend source location is environment-specific; resolve it with `yss-skill-source-index-refresh/references/source-location.md`.
 - Generated index: `references/source-index.md`
 - Component path hints: `yss-microservice-components/yss-component-exception`
 

package/template/.pi/skills/yss-exception/references/source-index.md

@@ -5,7 +5,7 @@ Source commit: `38b556a5081e6c66c0c538cbc1ef839b19996ed3`
 Source worktree: `dirty`
 Indexed source root: resolved at refresh time; set `YSS_SOURCE_ROOT` to reproduce or refresh.
 
-This file is generated by `yss-source-index/scripts/refresh-yss-skill-index.mjs`. Do not hand-edit generated sections.
+This file is generated by `yss-skill-source-index-refresh/scripts/refresh-yss-skill-index.mjs`. Do not hand-edit generated sections.
 
 Paths below are source path hints captured at refresh time. If they do not exist in the current workspace, locate sources using `YSS_SOURCE_ROOT`, CodeGraph, package/class names, Maven artifact names, or repository search before assuming the source is unavailable.
 

package/template/.pi/skills/yss-implementation-contract-compiler/SKILL.md

@@ -0,0 +1,55 @@
+---
+name: yss-implementation-contract-compiler
+description: Use when a YSS vertical slice is entering implementation, spans multiple frontend/backend/API areas, needs implementation readiness checked, or requires a minimal YSS skill set, Slice Implementation Contract, TDD mode, evidence plan, or reroute decision.
+---
+
+# YSS Implementation Contract Compiler
+
+阶段 7 的实现合同编译器。它把已批准的生命周期资产、垂直切片、capability 和窄 Recipe 编译为 `Slice Implementation Contract` v2 草案；不批准合同、不写业务代码、不设置 `ready-for-agent`。
+
+## 输入
+
+先读取 Spec、切片 Ticket、需求冻结、适用的原型确认、OpenAPI Freeze/no-impact、系统/数据架构、Design Review、Build Architecture Checklist、实现仓库和验证命令。输入缺失、未批准或 `stale` 时输出 `blocked`，交回 `yss-product-lifecycle`。
+
+## 编译循环
+
+1. 判断 frontend/backend/API/data/domain/cross-repo 影响，并按 [compiler-contract.yaml](references/compiler-contract.yaml) 把 impact 映射为入口 capability；逐项填写 backend `component_impacts`。
+2. 检查工程存在性和核心/长尾 skill 可用性。
+3. 从 `docs/agents/yss-skill-registry.yaml` 选择一个或多个窄 Recipe，合并 `required_capabilities`；Recipe 不得直接引用 skill。
+4. 由 capability 解析入口 skill，只递归 `context-required`；`context-conditional` 仅在显式 condition 命中时加载，其他依赖类型只进入原因链，不扩张执行上下文。
+5. 按“Recipe 声明顺序 → 依赖拓扑 → skill ID”确定性排序，去重 skill 并保留全部原因；冻结 Registry 与编译器合同 SHA-256。
+6. 为切片生成基线合同；为当前行为生成工作单元增量路由。
+7. 选择 `behavior-tdd` 或 `controlled-generation`。
+8. 输出 `draft`、`blocked` 或 `ready-for-lifecycle-review`，交生命周期编排器核验和持久化。
+
+合同结构见 [slice-implementation-contract.md](references/slice-implementation-contract.md)，专项返回协议见 [yss-skill-execution-result.md](references/yss-skill-execution-result.md)。前端、后端和测试子任务必须由生命周期主控从批准的 Slice Contract 编译任务包；任务包 schema 为 `docs/process/schemas/subagent-task-package.schema.json`，技能列表必须来自 `taskPackageDefaults`，不能由编译器或执行 Agent 另行手写。
+
+## 硬规则
+
+- 编译器不得输出 `approved`、`ready-for-agent` 或 `completed`。
+- Registry、Slice Contract 或编译器合同 schema v1 一律拒绝并给出迁移到 v2 的提示；不自动升级，不提供旧技能名兼容。
+- `required_capabilities` 与 `required_skills` 必须同时冻结；Registry 或编译器摘要变化后合同立即 `stale`，重新编译后仍须交生命周期重新批准。
+- UI 影响缺少正式原型确认时，不得路由页面实现。
+- Repository/数据模型影响缺少数据架构时，不得路由持久化实现。
+- 领域影响缺少批准且版本当前的 tactical-design contract 时，不得路由 Domain 实现；无领域影响必须记录 `not-applicable`。
+- API 变化必须回到生命周期 Draft/Review/Freeze；半成品 backend 不得冒充稳定 source of truth。
+- 后端端到端切片必须包含 Application；对象/POJO 影响按契约自动补 `mapstruct`、`lombok`、`alibaba-java-code-style`。
+- Harness 内实现路径必须落在 `apps/backend/<project>/` 或 `apps/frontend/<project>/` 的具体项目目录；`apps/backend/`、`apps/frontend/` 只能作为容器，`app/backend/`、`app/frontend/` 及其子路径一律阻断。外部实现仓库使用其登记的真实项目根路径。`git-submodule` 使用 `implementation_path_policy: git-submodule-harness-apps`，空 gitlink、detached HEAD 或 `--force` 覆盖挂载点不得脚手架；`inspectWorkingTreeScope.writable` 必须为显式布尔值。
+- 当前用户、缓存、审计、Excel、分布式 ID、请求校验、错误映射、加解密或网关韧性命中时，必须按 `compiler-contract.yaml` 的 `impact_to_capabilities` 补齐入口 capability；不能只在 `boundaries.md` 中提及。仅复用已经验证的平台认证 / 授权能力不算 component impact，不自动增加权限专项 skill。
+- 业务行为使用 `behavior-tdd`；只有机械脚手架/生成物可用 `controlled-generation`，并记录例外和验证。
+- 原型确认后若 backend `scaffold_status=required`，先由本编译器按 `scaffold_contract_schema` 编译 `yss-ddd-scaffold-generator` 的 `controlled-generation` 工作单元合同 draft；合同必须带 `contract_id`、`contract_version`、compiler draft、生命周期批准、持久化引用、允许写路径、预期证据和验证命令。经生命周期编排器批准并持久化后才能运行生成器，再由受控工作单元实际执行固定的 `./mvnw validate`、`./mvnw test`、`./mvnw package` 并记录逐条结果，随后加载 `yss-backend-scaffold-parent` 并重新编译业务合同；脚手架不承载业务行为。
+- 脚手架合同在编译阶段只能是 `draft` / `ready-for-lifecycle-review` / `blocked`；只有生命周期编排器可以把已持久化脚手架合同标记为 `approved`。脚手架合同只覆盖业务代码前的工程骨架工作单元；生成、基线校验和合同重编译完成后，它不能替代脚手架后的 Slice Implementation Contract。
+- 脚手架输出消费批准的脚手架合同；脚手架后的所有生成后端代码都必须绑定当前批准且版本当前的 Slice Implementation Contract、主 YSS skill、依赖闭包、允许写路径、预期证据和 YSS Skill Execution Result。打印命令、`./mvnw validate` 单项通过或脚手架成功不能替代合同批准；生成范围从机械内容变成业务行为时触发完整重路由。
+- 专项结果中的越界路径、缺失证据、`drift`、`violation` 或 `new_impacts` 必须阻断或重路由。
+- 前后端子任务必须使用同一 `contract_id/contract_version`，并在任务包中记录 `role_id`、`runtime_id`、`execution_state`、`allowed_write_paths`、`downstream_consumers` 和 `convergence_ref`；版本不一致或汇合引用缺失时输出 `blocked`。
+- 长尾 skill 不可用时显式 `blocked`，不得用通用知识假装已应用 YSS 规范。
+
+## 三级编译模式
+
+- 切片基线编译：生成完整合同和技能闭包。
+- 工作单元增量编译：绑定一个行为、主/辅 skills、TDD 模式、路径和证据。
+- 完整重编译：API/schema、状态机、数据模型、仓库、写路径、skill、测试 seam 或架构约束发生实质变化时触发。实现中出现未冻结的新行为（包括明确的权限业务行为）统一写入 `new_impacts`，由生命周期按普通影响面重新分诊。
+
+## 输出
+
+输出合同草案、capability/Recipe 解析记录、技能依赖闭包、不适用理由、阻塞项、TDD 模式、工作单元、预期证据、验证命令、人工审查点、完整重路由触发器，以及建议的 `suggested_owner_role_id`（UI 影响 → `role.frontend-engineer`，后端影响 → `role.backend-engineer`，测试/审查 → `role.test-engineer`）。自然语言说明不能替代结构化合同字段。编译器不得自行批准合同、设置 `ready-for-agent` 或关闭会签门禁；owner 建议只供主控派活。

package/template/.pi/skills/yss-implementation-contract-compiler/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "YSS Implementation Contract Compiler"
+  short_description: "Compile capabilities into a minimal implementation contract"
+  default_prompt: "Use yss-implementation-contract-compiler to compile the approved slice capabilities, deterministic skill closure, evidence plan, and v2 contract draft."

package/template/.pi/skills/yss-implementation-contract-compiler/references/boundaries.md

@@ -0,0 +1,134 @@
+# YSS Skill Boundaries
+
+> Generated by `scripts/generate-yss-skill-boundaries` from `docs/agents/yss-skill-registry.yaml` and `compiler-contract.yaml`. Do not hand-edit.
+
+实现入口先选择 capability 或窄 Recipe，再由实现合同编译器计算最小 skill 闭包。下面是派生阅读视图，不是第二套路由事实源。
+
+## Dependency Semantics
+
+| Type | Compiler behavior |
+| --- | --- |
+| `context-required` | 自动递归加入执行上下文。 |
+| `context-conditional` | 仅当显式 condition 命中时递归加入。 |
+| `coordination-only` | 记录协作原因，不扩张执行上下文。 |
+| `review-only` | 仅作为审查输入记录，不扩张实现上下文。 |
+| `component-dependency` | 记录组件关系；由 capability/Recipe 显式选择，不自动加载。 |
+
+## Capability Catalog
+
+| Capability | Primary skill | Task modes |
+| --- | --- | --- |
+| `governance.implementation-contract` | `yss-implementation-contract-compiler` | `contract-compilation`, `reroute`, `result-validation` |
+| `maintenance.skill-source-index` | `yss-skill-source-index-refresh` | `component-maintenance`, `source-index-refresh` |
+| `architecture.tactical-domain` | `yss-tactical-design` | `guidance`, `integration`, `slice-implementation`, `review-input` |
+| `layer.domain` | `yss-domain` | `guidance`, `integration`, `slice-implementation`, `troubleshooting`, `review-input` |
+| `layer.application` | `yss-application` | `guidance`, `integration`, `slice-implementation`, `troubleshooting`, `review-input` |
+| `layer.persistence` | `yss-repository` | `guidance`, `integration`, `slice-implementation`, `troubleshooting`, `review-input` |
+| `layer.web-adapter` | `yss-web-controller` | `guidance`, `integration`, `slice-implementation`, `troubleshooting`, `review-input` |
+| `contract.dto-wire` | `yss-dto` | `guidance`, `integration`, `slice-implementation`, `troubleshooting`, `review-input` |
+| `contract.request-validation` | `yss-validation` | `guidance`, `integration`, `slice-implementation`, `troubleshooting`, `review-input` |
+| `contract.error-mapping` | `yss-exception` | `guidance`, `integration`, `slice-implementation`, `troubleshooting`, `review-input` |
+| `framework.mybatis` | `yss-mybatis` | `guidance`, `integration`, `slice-implementation`, `troubleshooting`, `review-input` |
+| `quality.java-code-style` | `alibaba-java-code-style` | `guidance`, `slice-implementation`, `review-input` |
+| `codegen.mapstruct` | `mapstruct` | `integration`, `slice-implementation`, `troubleshooting`, `review-input` |
+| `codegen.lombok` | `lombok` | `integration`, `slice-implementation`, `troubleshooting`, `review-input` |
+| `component.cache` | `yss-cache` | `guidance`, `integration`, `slice-implementation`, `troubleshooting`, `component-maintenance`, `review-input` |
+| `component.current-user-context` | `yss-userinfo` | `guidance`, `integration`, `slice-implementation`, `troubleshooting`, `component-maintenance`, `review-input` |
+| `component.audit-log` | `yss-audit-log` | `guidance`, `integration`, `slice-implementation`, `troubleshooting`, `component-maintenance`, `review-input` |
+| `component.excel-import-export` | `yss-excel-mvc` | `guidance`, `integration`, `slice-implementation`, `troubleshooting`, `component-maintenance`, `review-input` |
+| `component.distributed-id` | `yss-distributed-id` | `guidance`, `integration`, `slice-implementation`, `troubleshooting`, `component-maintenance`, `review-input` |
+| `component.security-algorithm` | `yss-security-algorithm` | `guidance`, `integration`, `slice-implementation`, `troubleshooting`, `component-maintenance`, `review-input` |
+| `component.gateway-resilience` | `yss-resilience4j` | `guidance`, `integration`, `slice-implementation`, `troubleshooting`, `component-maintenance`, `review-input` |
+| `scaffold.ddd` | `yss-ddd-scaffold-generator` | `integration`, `component-maintenance` |
+| `scaffold.mvc` | `yss-mvc-scaffold-generator` | `integration`, `component-maintenance` |
+| `migration.springboot3` | `yss-up-springboot3` | `guidance`, `integration`, `troubleshooting`, `component-maintenance`, `review-input` |
+
+## Narrow Recipes
+
+一个切片可以组合多个 Recipe，但只计算一次闭包。Recipe 仅引用 capability。
+
+| Recipe | Capabilities |
+| --- | --- |
+| `backend.domain-behavior` | `layer.domain`, `layer.application`, `quality.java-code-style` |
+| `backend.persistence-mybatis` | `layer.persistence`, `framework.mybatis`, `codegen.mapstruct`, `codegen.lombok`, `quality.java-code-style` |
+| `backend.http-api` | `layer.web-adapter`, `contract.dto-wire`, `contract.request-validation`, `contract.error-mapping`, `codegen.mapstruct`, `codegen.lombok`, `quality.java-code-style` |
+| `backend.current-user-context` | `component.current-user-context`, `contract.dto-wire` |
+| `backend.cached-current-user` | `component.current-user-context`, `component.cache`, `contract.dto-wire` |
+| `backend.audit-event` | `component.audit-log`, `component.current-user-context`, `contract.dto-wire` |
+| `backend.excel-import-export` | `component.excel-import-export`, `contract.dto-wire`, `contract.request-validation`, `contract.error-mapping` |
+| `backend.gateway-resilience` | `component.gateway-resilience`, `contract.error-mapping` |
+| `backend.security-algorithm` | `component.security-algorithm`, `contract.error-mapping` |
+| `backend.distributed-id` | `component.distributed-id` |
+| `backend.ddd-scaffold` | `scaffold.ddd`, `quality.java-code-style` |
+| `backend.mvc-scaffold` | `scaffold.mvc`, `quality.java-code-style` |
+| `backend.springboot3-migration` | `migration.springboot3`, `quality.java-code-style` |
+
+## Impact Entry Mapping
+
+| Impact | Entry capabilities |
+| --- | --- |
+| `domain-impact` | `layer.domain`, `layer.application` |
+| `tactical-domain-impact` | `architecture.tactical-domain` |
+| `persistence-impact` | `layer.persistence` |
+| `mybatis-framework-impact` | `framework.mybatis` |
+| `web-adapter-impact` | `layer.web-adapter` |
+| `dto-wire-impact` | `contract.dto-wire` |
+| `request-validation` | `contract.request-validation` |
+| `error-mapping` | `contract.error-mapping`, `contract.dto-wire` |
+| `cache` | `component.cache` |
+| `current-user-context` | `component.current-user-context` |
+| `user-cache-lookup` | `component.current-user-context`, `component.cache` |
+| `audit-event` | `component.audit-log`, `component.current-user-context`, `contract.dto-wire` |
+| `excel-import-export` | `component.excel-import-export` |
+| `distributed-id` | `component.distributed-id` |
+| `encryption-or-signing` | `component.security-algorithm` |
+| `gateway-resilience` | `component.gateway-resilience` |
+| `ddd-scaffold` | `scaffold.ddd` |
+| `mvc-scaffold` | `scaffold.mvc` |
+| `springboot3-migration` | `migration.springboot3` |
+
+## Typed Skill Dependencies
+
+| Skill | Dependency | Type | Condition |
+| --- | --- | --- | --- |
+| `yss-prototype-stage` | `prototype-review` | `review-only` | — |
+| `yss-prototype-stage` | `yss-design-system` | `coordination-only` | — |
+| `yss-prototype-stage` | `yss-antd-design` | `context-conditional` | `h2-react-antd` |
+| `yss-ddd-scaffold-generator` | `yss-backend-scaffold-parent` | `context-required` | — |
+| `yss-ddd-scaffold-generator` | `alibaba-java-code-style` | `context-required` | — |
+| `yss-domain` | `alibaba-java-code-style` | `context-required` | — |
+| `yss-domain` | `domain-modeling` | `coordination-only` | — |
+| `yss-domain` | `yss-tactical-design` | `context-conditional` | `tactical-domain` |
+| `yss-domain` | `lombok` | `context-conditional` | `pojo` |
+| `yss-tactical-design` | `domain-modeling` | `coordination-only` | — |
+| `yss-tactical-design` | `yss-openapi-draft-review` | `review-only` | `api-impact` |
+| `yss-tactical-design` | `yss-repository` | `component-dependency` | `data-impact` |
+| `yss-application` | `alibaba-java-code-style` | `context-required` | — |
+| `yss-application` | `mapstruct` | `context-conditional` | `conversion` |
+| `yss-application` | `lombok` | `context-conditional` | `pojo` |
+| `yss-repository` | `yss-mybatis` | `context-conditional` | `mybatis` |
+| `yss-repository` | `mapstruct` | `context-conditional` | `conversion` |
+| `yss-repository` | `lombok` | `context-conditional` | `pojo` |
+| `yss-repository` | `alibaba-java-code-style` | `context-required` | — |
+| `yss-web-controller` | `yss-dto` | `context-required` | — |
+| `yss-web-controller` | `yss-validation` | `context-conditional` | `request-validation` |
+| `yss-web-controller` | `yss-exception` | `context-conditional` | `error-mapping` |
+| `yss-web-controller` | `mapstruct` | `context-conditional` | `conversion` |
+| `yss-web-controller` | `lombok` | `context-conditional` | `pojo` |
+| `yss-web-controller` | `alibaba-java-code-style` | `context-required` | — |
+| `yss-userinfo` | `yss-dto` | `component-dependency` | — |
+| `yss-userinfo` | `yss-cache` | `context-conditional` | `cache-lookup` |
+| `yss-audit-log` | `yss-userinfo` | `component-dependency` | — |
+| `yss-audit-log` | `yss-dto` | `component-dependency` | — |
+| `yss-validation` | `yss-exception` | `component-dependency` | — |
+| `yss-security-algorithm` | `yss-exception` | `component-dependency` | — |
+| `yss-exception` | `yss-dto` | `context-required` | — |
+| `yss-ui-business-page-generation` | `yss-components` | `context-conditional` | `components` |
+| `yss-ui-business-page-generation` | `yss-hook` | `context-conditional` | `hooks` |
+| `yss-ui-business-page-generation` | `yss-formily` | `context-conditional` | `form` |
+| `yss-ui-business-page-generation` | `yss-api-integration` | `context-conditional` | `api` |
+| `yss-page-module-development` | `yss-components` | `context-conditional` | `components` |
+| `yss-page-module-development` | `yss-hook` | `context-conditional` | `hooks` |
+| `yss-page-module-development` | `yss-formily` | `context-conditional` | `form` |
+| `yss-page-module-development` | `yss-api-integration` | `context-conditional` | `api` |
+| `yss-api-integration` | `yss-openapi-governance` | `context-conditional` | `regeneration` |