npm - create-yss-spec - Versions diffs - 3.0.0 → 3.0.1 - Mend

create-yss-spec 3.0.0 → 3.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1508) hide show

package/template/docs/process/lifecycle-registry.yaml CHANGED Viewed

@@ -8,7 +8,7 @@ id_policy:
   pattern: '^(stage|gate|artifact|work-unit|evidence)\.[a-z0-9][a-z0-9-]*$'
   published_ids_immutable: true
   baseline: docs/process/lifecycle-registry-baseline.json
-  deprecated_ids: [work-unit.fresh-verification, work-unit.independent-review]
+  deprecated_ids: [artifact.high-fidelity-html-prototype, work-unit.fresh-verification, work-unit.independent-review]
 stages:
   - id: stage.entry-triage
@@ -78,6 +78,12 @@ evidence:
   - id: evidence.browser-prototype-verification
     name: 浏览器原型验证证据
     description: 高保真原型的非空渲染、主流程、异常状态、视口和控制台验证记录。
+  - id: evidence.prototype-profile-decision
+    name: 原型档位选择证据
+    description: 基于低保真评审后的风险触发、决定目标、H1/H2 计算结果以及人工升降级依据。
+  - id: evidence.prototype-deliverable-verification
+    name: 原型交付物验证证据
+    description: schema v3 共同证据与所选档位的浏览器、Design QA、无障碍、组件事实或真实组件合同验证结果。
   - id: evidence.prototype-confirmation
     name: 原型用户确认记录
     description: 高保真原型、验证清单和进入下游阶段范围的人工确认结论。
@@ -128,10 +134,10 @@ gates:
     trigger: 命中产品设计影响，且低保真页面、流程、状态或 API 反推需要独立评审。
     evidence: [evidence.prototype-review-result]
   - id: gate.prototype-verified
-    name: 高保真原型验证
+    name: 原型交付物验证
     stage: stage.product-design
-    trigger: 需要高保真 HTML 原型进行视觉与交互校准。
-    evidence: [evidence.antd-cli-validation, evidence.browser-prototype-verification]
+    trigger: 产品设计影响需要通过 H1/H2 原型交付物进行视觉或流程校准；真实组件验证留到前端实现阶段。
+    evidence: [evidence.prototype-profile-decision, evidence.prototype-deliverable-verification]
   - id: gate.user-confirmation
     name: 用户确认
     stage: stage.product-design
@@ -225,10 +231,10 @@ artifacts:
     name: 状态矩阵
     stage: stage.product-design
     trigger: 存在状态流转、异常或恢复。
-  - id: artifact.high-fidelity-html-prototype
-    name: 高保真 HTML 原型
+  - id: artifact.prototype-deliverable
+    name: 原型交付物
     stage: stage.product-design
-    trigger: 需要视觉与交互校准。
+    trigger: 低保真评审后需要 H1 视觉或 H2 流程校准。
   - id: artifact.prototype-review
     name: 原型评审记录
     stage: stage.product-design
@@ -373,8 +379,8 @@ work_units:
     name: 原型设计与验证
     scope: project-instance
     input: Spec、产品设计影响和状态矩阵。
-    output: 交互说明、低/高保真原型、评审、AntD CLI 和浏览器证据。
-    completion: 原型评审、高保真验证和用户确认门禁均通过。
+    output: 交互说明、低保真、状态矩阵、H1/H2 原型交付物、统一 Design QA、档位验证证据与前端实现交接事项。
+    completion: 低保真评审、schema v3 原型交付物验证和用户确认门禁均通过；生产组件待验事项已交接到前端实现计划。
   - id: work-unit.technical-analysis
     name: 技术分析与契约冻结
     scope: project-instance

package/template/docs/process/template-engineering-overview.md CHANGED Viewed

@@ -33,7 +33,7 @@ YSS 模板工程是一套可版本化的研发治理系统。它用仓库身份
 | 产品线 | 模板源 | 实例化 CLI | 生命周期边界 |
 |---|---|---|---|
 | 全产品生命周期 | `yss-spec-project-template` | `create-yss-spec` | 从 Discovery 到发布与复盘 |
-| DDD 战略设计交接 | `yss-strategic-design-harness` | `create-yss-harness-design` | 从机会、需求和战略设计到 Strategic Design Handoff |
+| DDD 战略设计交接 | `yss-harness-design-agent` | `create-yss-harness-design` | 从机会、需求和战略设计到 Strategic Design Handoff |
 | 开发落地 | `yss-harness-dev-agent` | `create-yss-harness-dev` | 从已批准 Spec 或战略设计交接包到 Tactical Design、Slice Contract、实现与验证 |
 每条产品线使用独立的 profile、metadata 和固定模板 commit。CLI 之间遇到其他产品线的 metadata 时必须 fail closed，不能自动接管。
@@ -48,7 +48,7 @@ YSS 模板工程是一套可版本化的研发治理系统。它用仓库身份
 ### 5.2 技能供应链
-`.agents/skills` 是跨 Agent 共享技能的权威内容。`.claude/skills`、`.codex/skills`、`.cursor/skills`、`.hermes/skills`、`.pi/skills`、`.qoder/skills` 和 `.trae/skills` 是生成投影。
+`.agents/skills` 是跨 Agent 共享技能的权威内容。`.claude/skills`、`.codex/skills`、`.cursor/skills`、`.pi/skills`、`.qoder/skills` 和 `.trae/skills` 是生成投影。
 `docs/agents/yss-skill-registry.yaml` 管理技能分层、成熟度、别名和运行时发现；`skills-lock.json` 管理来源、版本、hash 与投影完整性。修改共享技能后必须同步投影并更新 lock，不能分别编辑平台副本。

package/template/docs/process/template-verification-profiles.yaml CHANGED Viewed

@@ -39,14 +39,20 @@ required_files:
   - CONTEXT.md
   - skills-lock.json
   - .agents/skills/.yss-skills-manifest.json
+  - .agents/skills/.strategic-design-skills-manifest.json
   - .mcp.json
   - .agents/mcp_config.json
   - .cursor/mcp.json
-  - .gemini/settings.json
-  - .kiro/settings/mcp.json
   - .vscode/mcp.json
   - docs/agents/yss-skill-registry.yaml
+  - .agents/skills/yss-implementation-contract-compiler/SKILL.md
+  - .agents/skills/yss-implementation-contract-compiler/references/compiler-contract.yaml
+  - .agents/skills/yss-implementation-contract-compiler/references/boundaries.md
+  - .agents/skills/yss-implementation-contract-compiler/references/slice-implementation-contract.md
+  - .agents/skills/yss-implementation-contract-compiler/tests/compiler-scenarios.test.mjs
+  - .agents/skills/yss-skill-source-index-refresh/SKILL.md
   - docs/agents/yss-ui-skills-integration.md
+  - docs/agents/strategic-design-skills-integration.md
   - docs/user-guide/yss-ui-mcp.md
   - docs/agents/digital-human-roles.yaml
   - docs/process/lifecycle-registry.yaml
@@ -72,6 +78,7 @@ required_files:
   - .agents/skills/yss-tactical-design/scripts/validate-tactical-design.mjs
   - .agents/skills/yss-tactical-design/tests/run-scenarios.mjs
   - .agents/skills/yss-prototype-stage/references/product-design-adapter.md
+  - .agents/skills/yss-prototype-stage/references/prototype-profile-routing.md
   - .agents/skills/yss-prototype-stage/scripts/prototype-contract.mjs
   - .agents/skills/yss-prototype-stage/tests/run-scenarios.mjs
   - docs/design/templates/prototype-evidence-template.yaml
@@ -91,6 +98,8 @@ required_files:
 syntax_files:
   - scripts/sync-skills
   - scripts/update-skill-lock
+  - scripts/verify-upstream-skill-source
+  - scripts/lib/skill-supply-chain.mjs
   - scripts/generate-lifecycle-artifacts
   - scripts/verify-lifecycle-registry
   - scripts/verify-lifecycle-checkpoint
@@ -106,7 +115,13 @@ syntax_files:
   - scripts/verify-maintenance-review-record
   - scripts/verify-maintenance-intensity-scenarios
   - scripts/verify-skill-registry
+  - scripts/lib/implementation-contract-compiler.mjs
+  - scripts/generate-yss-skill-boundaries
+  - scripts/audit-yss-backend-skills
+  - scripts/verify-retired-skill-ids
   - scripts/verify-skill-governance
+  - scripts/verify-upstream-skill-source
+  - scripts/lib/skill-supply-chain.mjs
   - scripts/verify-yss-dto-openapi-profile
   - scripts/verify-yss-dto-openapi-scenarios
   - scripts/verify-digital-human-roles
@@ -117,7 +132,7 @@ syntax_files:
   - scripts/verify-lifecycle-transition-scenarios
   - scripts/verify-matt-yss-integration-scenarios
   - scripts/verify-prototype-backend-scaffold-scenarios
-  - scripts/verify-yss-router-scenarios
+  - scripts/verify-yss-implementation-contract-compiler-scenarios
   - scripts/verify-yss-prototype-contract-scenarios
   - scripts/verify-openapi-yaml-first-scenarios
   - scripts/verify-openapi-json-handoff-scenarios
@@ -145,9 +160,11 @@ routing:
     groups: [hygiene]
   - patterns: [AGENTS.md, yss-project.yaml, "docs/process/template-engineering-overview.md"]
     groups: [governance-release]
-  - patterns: [skills-lock.json, ".agents/skills/**", ".claude/skills/**", ".codex/skills/**", ".cursor/skills/**", ".hermes/skills/**", ".pi/skills/**", ".qoder/skills/**", ".trae/skills/**", "docs/agents/yss-skill-registry.yaml", "docs/agents/skills-maintenance.md", "scripts/*skill*"]
+  - patterns: [skills-lock.json, ".agents/skills/**", ".claude/skills/**", ".codex/skills/**", ".cursor/skills/**", ".pi/skills/**", ".qoder/skills/**", ".trae/skills/**", "docs/agents/yss-skill-registry.yaml", "docs/agents/skills-maintenance.md", "scripts/*skill*"]
     groups: [skills]
-  - patterns: [.mcp.json, .agents/mcp_config.json, .cursor/mcp.json, .gemini/settings.json, .kiro/settings/mcp.json, .vscode/mcp.json, docs/user-guide/yss-ui-mcp.md, docs/agents/yss-ui-skills-integration.md]
+  - patterns: [.mcp.json, .agents/mcp_config.json, .cursor/mcp.json, .vscode/mcp.json, docs/user-guide/yss-ui-mcp.md, docs/agents/yss-ui-skills-integration.md]
+    groups: [skills]
+  - patterns: [.agents/skills/.strategic-design-skills-manifest.json, docs/agents/strategic-design-skills-integration.md, submodules/yss-harness-design-agent/**]
     groups: [skills]
   - patterns: ["docs/process/maintenance-*", "docs/process/harness-process-tailoring.md", "docs/process/schemas/maintenance-*", "scripts/*maintenance*", "scripts/lib/maintenance-*"]
     groups: [maintenance]
@@ -187,6 +204,7 @@ groups:
       - { run: "scripts/update-skill-lock --check" }
       - { run: "scripts/verify-skill-registry" }
       - { run: "scripts/verify-skill-governance" }
+      - { run: "scripts/verify-upstream-skill-source --source=iloveZzz/yss-harness-design-agent --source-root=submodules/yss-harness-design-agent", when: template-source }
   tactical-design:
     commands:
       - { run: "node --check .agents/skills/yss-tactical-design/scripts/validate-tactical-design.mjs" }
@@ -227,7 +245,10 @@ groups:
       - { run: "scripts/verify-scaffold-generator-scenarios" }
       - { run: "scripts/verify-prototype-backend-scaffold-scenarios" }
       - { run: "scripts/verify-matt-yss-integration-scenarios" }
-      - { run: "scripts/verify-yss-router-scenarios" }
+      - { run: "scripts/verify-yss-implementation-contract-compiler-scenarios" }
+      - { run: "scripts/generate-yss-skill-boundaries --check" }
+      - { run: "scripts/audit-yss-backend-skills --check" }
+      - { run: "scripts/verify-retired-skill-ids" }
       - { run: "scripts/verify-yss-ui-scenarios" }
       - { run: "scripts/verify-yss-prototype-contract-scenarios" }
       - { run: "node .agents/skills/yss-prototype-stage/scripts/prototype-contract.mjs validate-evidence docs/design/templates/prototype-evidence-template.yaml --allow-template" }

package/template/docs/templates/build-architecture-checklist-template.md CHANGED Viewed

@@ -19,8 +19,8 @@ owner: ai
 | 系统 / 数据架构设计 |  |  |
 | 风险 / 回滚约束 | `AGENTS.md` |  |
 | Slice Implementation Contract |  | 填写 contract_id / contract_version / 生命周期批准状态 |
-| 后端脚手架策略 | `orchestration-contract.yaml` / `yss-ddd-scaffold-generator` |  | backend `scaffold_status=required` 时填写结构化合同身份、批准/持久化引用、生成器输入、预期文件、实际 `./mvnw` 结果和后置 Router 重编译 |
-| 工程项目路径策略 | `docs/process/implementation-repo-integration.md` / Router Contract |  | Harness 内必须是 `apps/backend/<project>/` 或 `apps/frontend/<project>/`；`apps/backend/`、`apps/frontend/` 仅为容器，`app/backend/`、`app/frontend/` 及其子路径阻断 |
+| 后端脚手架策略 | `orchestration-contract.yaml` / `yss-ddd-scaffold-generator` |  | backend `scaffold_status=required` 时填写结构化合同身份、批准/持久化引用、生成器输入、预期文件、实际 `./mvnw` 结果和后置 实现合同编译器 重编译 |
+| 工程项目路径策略 | `docs/process/implementation-repo-integration.md` / 实现合同编译器 Contract |  | Harness 内必须是 `apps/backend/<project>/` 或 `apps/frontend/<project>/`；`apps/backend/`、`apps/frontend/` 仅为容器，`app/backend/`、`app/frontend/` 及其子路径阻断 |
 | 垂直切片工作单元 |  |  |
 | YSS Skill Execution Result |  | 每个 skill / work_unit 的结果文件引用 |
@@ -30,9 +30,9 @@ owner: ai
 |---|---|---|---|---|---|
 | DDD 分层不得穿透：Domain 不依赖 Adapter、Infrastructure、Mapper、Controller 或 Web DTO | 系统架构 / YSS DDD 规范 / `AGENTS.md` |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 若发现穿透依赖，标记 `violation` 并停止 build，回到架构修正 |
 | 后端切片必须回勾 `Backend Slice Implementation Contract`：required skills、允许写范围、禁止模式、证据文件、延期 seam 和验证命令完整 | implementation routing / 垂直切片 Ticket / `AGENTS.md` |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 缺合同或合同不完整时暂停并记录替代方案 |
-| 统一合同版本：实现消费的 contract_id / contract_version 与生命周期批准并持久化的版本一致，Router 未自行批准合同或推进 `ready-for-agent` | Slice Implementation Contract / 生命周期证据 |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 版本不一致时将工作单元标记 `stale` 并暂停 build |
-| 合同子项闭环：Common、Frontend、Backend、Contract、Cross-repo 子合同按影响面填写，不适用项有原因 | Slice Implementation Contract |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 缺失适用子合同时回到 Router |
-| 原型确认后的后端脚手架顺序：工程基线 → Router 脚手架合同 draft / 生命周期批准 → `yss-ddd-scaffold-generator` → `yss-backend-scaffold-parent` → Router 重编译；脚手架不得生成业务行为 | `yss-product-lifecycle` / `yss-ddd-scaffold-generator` |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 顺序缺失、生成器混入业务行为或缺 Execution Result 时阻断 |
+| 统一合同版本：实现消费的 contract_id / contract_version 与生命周期批准并持久化的版本一致，实现合同编译器 未自行批准合同或推进 `ready-for-agent` | Slice Implementation Contract / 生命周期证据 |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 版本不一致时将工作单元标记 `stale` 并暂停 build |
+| 合同子项闭环：Common、Frontend、Backend、Contract、Cross-repo 子合同按影响面填写，不适用项有原因 | Slice Implementation Contract |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 缺失适用子合同时回到 实现合同编译器 |
+| 原型确认后的后端脚手架顺序：工程基线 → 实现合同编译器 脚手架合同 draft / 生命周期批准 → `yss-ddd-scaffold-generator` → `yss-backend-scaffold-parent` → 实现合同编译器 重编译；脚手架不得生成业务行为 | `yss-product-lifecycle` / `yss-ddd-scaffold-generator` |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 顺序缺失、生成器混入业务行为或缺 Execution Result 时阻断 |
 | 写路径与证据：Execution Result 的 changed_files 均位于 allowed_write_paths，expected_evidence_files 已实际生成 | Slice Implementation Contract / YSS Skill Execution Result |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 路径越界或证据缺失标记 `violation` 并阻断 build |
 | TDD 模式：每个工作单元唯一选择 `behavior-tdd` 或 `controlled-generation`；生成器未承载状态、权限、业务过滤、事务、错误映射或用户可见交互 | Slice Implementation Contract / 垂直切片 Ticket / Execution Result |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 模式不匹配时拆分工作单元并完整重路由 |
 | 所有后续生成代码：必须消费当前批准合同、主 YSS skill、依赖闭包、允许写路径、预期证据和 YSS Skill Execution Result；业务行为使用 `behavior-tdd` | `post_scaffold_generated_code_policy` |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 缺任一条件或以时间压力豁免时阻断 build |
@@ -47,7 +47,7 @@ owner: ai
 | 文档语言：持久化生命周期文档、实施记录、审查报告、发布说明和 Git checkpoint 正文必须使用中文，英文 skill / 模板不得原样落地 | `AGENTS.md` / `yss-product-lifecycle` |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 仅保留必要英文技术标识、命令和 metadata |
 | 高风险变更：按已批准的普通影响面结论记录验证证据、责任人和回滚约束 | `AGENTS.md` / Spec / 架构记录 |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 缺验证证据或责任人时不得发布或合并 |
 | 质量基线：`baseline_id` / `baseline_version` 只从 `engineering-baseline` 引用，Slice、Execution Result、审查和发布不得重复定义 | `engineering-baseline` / `orchestration-contract.yaml` |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 缺少基线引用或出现重复标准时阻断并回到工程基线 |
-| Doubt-Driven：命中 API、数据、跨仓、发布回滚、实际安全行为或生命周期 / 生成语义时具备主张、反证、证据、残余风险和审查引用 | Router Contract / `orchestration-contract.yaml` |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 缺反证、证据不足或残余风险未处理时阻断 |
+| Doubt-Driven：命中 API、数据、跨仓、发布回滚、实际安全行为或生命周期 / 生成语义时具备主张、反证、证据、残余风险和审查引用 | 实现合同编译器 Contract / `orchestration-contract.yaml` |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 缺反证、证据不足或残余风险未处理时阻断 |
 |  |  |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  |  |
 状态说明：

package/template/docs/templates/implementation-routing-template.md CHANGED Viewed

@@ -9,7 +9,7 @@ owner: ai
 > 适用场景：Spec、OpenAPI Freeze / 无 API 影响记录、Design Review 和垂直切片 Ticket 已就绪后，进入实现前。
 > 本文记录契约状态、Ticket 状态、YSS skill 最小集合、测试策略和回滚点，不替代垂直切片 Ticket 或实施计划。
-> Router 只能生成 `draft`、`blocked` 或 `ready-for-lifecycle-review`；不得自行写入 `approved`、`ready-for-agent` 或 `completed`。合同批准、持久化和 Ticket 状态推进由生命周期编排器负责。
+> 实现合同编译器 只能生成 `draft`、`blocked` 或 `ready-for-lifecycle-review`；不得自行写入 `approved`、`ready-for-agent` 或 `completed`。合同批准、持久化和 Ticket 状态推进由生命周期编排器负责。
 ## 1. 输入材料
@@ -40,7 +40,7 @@ owner: ai
 | Harness 内项目根路径符合 `apps/<backend|frontend>/<project>/` | 是 / 否 / 不适用 | `apps/backend/`、`apps/frontend/` 仅为容器 |
 | 未使用 `app/backend/`、`app/frontend/` 及其子路径 | 是 / 否 / 不适用 | 命中即阻断生成和实现 |
 | 原型确认后先完成后端脚手架，再进入业务代码路由 | 是 / 否 / 不适用 | `backend_scaffold_policy_satisfied` |
-| 后端脚手架合同字段完整且版本当前 | 是 / 否 / 不适用 | schema v2：`scaffold_request_id`、项目/输出目录、Router draft、生命周期批准、base package、Maven 坐标、target DDD/Profile、initialize-only、允许写路径、预期证据、验证命令 |
+| 后端脚手架合同字段完整且版本当前 | 是 / 否 / 不适用 | schema v2：`scaffold_request_id`、项目/输出目录、实现合同编译器 draft、生命周期批准、base package、Maven 坐标、target DDD/Profile、initialize-only、允许写路径、预期证据、验证命令 |
 | 后端构建 / 测试 / OpenAPI / CI 命令均使用项目根目录 `./mvnw ...`，或已记录受控例外 | 是 / 否 / 不适用 | 裸 `mvn ...` 默认为规范偏离 |
 | 持久化文档正文和章节标题已转换为中文，仅保留必要英文技术标识 / metadata | 是 / 否 | 英文 skill / 模板不得原样落地为交付文档 |
 | YSS skill 路由已完成 | 是 / 否 |  |
@@ -55,7 +55,7 @@ owner: ai
 | contract_version |  |
 | slice_id |  |
 | status | `draft` / `blocked` / `ready-for-lifecycle-review` |
-| compiled_by | `yss-router` |
+| compiled_by | `yss-implementation-contract-compiler` |
 | 生命周期批准状态 | pending / approved / rejected；由生命周期编排器填写 |
 | 合同持久化路径 |  |
@@ -238,11 +238,11 @@ owner: ai
 ### 4.3 后端脚手架工作单元
-当 backend `scaffold_status=required` 时，先登记一个 `controlled-generation` 工作单元：`primary_skill=yss-ddd-scaffold-generator`，并在后续追加 `yss-backend-scaffold-parent` 基线校验和 `yss-router` 合同重编译。`existing` / `initialized` 不重复全量生成，但必须提供等价基线和 Wrapper 证据。
+当 backend `scaffold_status=required` 时，先登记一个 `controlled-generation` 工作单元：`primary_skill=yss-ddd-scaffold-generator`，并在后续追加 `yss-backend-scaffold-parent` 基线校验和 `yss-implementation-contract-compiler` 合同重编译。`existing` / `initialized` 不重复全量生成，但必须提供等价基线和 Wrapper 证据。
 | 项 | 内容 |
 |---|---|
-| 前置 | `prototype_confirmation`、工程基线、实现仓库和脚手架目标已确认；Router 脚手架合同 draft 已经生命周期批准并持久化为结构化 JSON，生成器通过 `--contract-file` 消费 |
+| 前置 | `prototype_confirmation`、工程基线、实现仓库和脚手架目标已确认；实现合同编译器 脚手架合同 draft 已经生命周期批准并持久化为结构化 JSON，生成器通过 `--contract-file` 消费 |
 | 生成器 | `yss-ddd-scaffold-generator` |
 | 模式 | `controlled-generation` |
 | Java / Maven 身份 | `base_package` 与 Maven `group_id` 分开登记；项目版本、父 POM GAV、`yss-components.version` 进入批准合同并原样传给 CLI |
@@ -251,7 +251,7 @@ owner: ai
 | 生成选项 | 关闭 `--with-example`；生成器严格 initialize-only，非空目录、`--force`、旧项目迁移和当前模板升级均为 `unsupported` |
 | Profile | `target-domain-model` / `mybatis-plus` / `mysql` / `spring-boot-2.7-jdk8` / `javax` / `web` / `yss-internal`；其他组合须先通过独立 fixture |
 | 验证 | 使用一键生成验证入口，实际执行项目根目录 `./mvnw validate`、`./mvnw test`、`./mvnw package`；通过后仅为 `empty-scaffold-verified`，golden first slice 通过后才是 `first-slice-verified` |
-| 后置 | `yss-backend-scaffold-parent`、`yss-router` 业务合同重编译、YSS Skill Execution Result |
+| 后置 | `yss-backend-scaffold-parent`、`yss-implementation-contract-compiler` 业务合同重编译、YSS Skill Execution Result |
 所有后续生成代码必须绑定当前批准且版本一致的 Slice Implementation Contract、主 YSS skill、依赖闭包、允许写路径、预期证据和 Execution Result。业务行为必须使用 `behavior-tdd`；缺任一条件即阻断，不得以脚手架成功或时间压力豁免。
@@ -324,7 +324,7 @@ owner: ai
 - [ ] 垂直切片 Ticket 完整，且状态允许进入实现。
 - [ ] 统一合同包含 `contract_id` / `contract_version`、Common、Frontend、Backend、Contract 和 Cross-repo 子合同；不适用项均有原因。
-- [ ] 生命周期编排器已批准并持久化合同；Router 没有自行给出 `approved` 或 `ready-for-agent`。
+- [ ] 生命周期编排器已批准并持久化合同；实现合同编译器 没有自行给出 `approved` 或 `ready-for-agent`。
 - [ ] YSS skills 已最小化选择，没有绕过 Ticket、OpenAPI Freeze / 无 API 影响记录或必要的 Spec Delta。
 - [ ] 后端切片如适用，已填写 `Backend Slice Implementation Contract`，并且 required skills、禁止模式、证据文件、延期 seam 和验证命令完整。
 - [ ] 受影响外部实现仓库已登记，并绑定分支、MR / PR、CI 和验证命令。
@@ -340,7 +340,7 @@ owner: ai
 ## 9. 下一步门禁
-- Router 结论：draft / blocked / ready-for-lifecycle-review
+- 实现合同编译器 结论：draft / blocked / ready-for-lifecycle-review
 - 生命周期编排器结论：approved / rejected / pending
 - 下一步：生命周期合同审查 / TDD 实现 / 完整重路由 / Architecture Re-check / 回到 系统 / 数据架构设计 / 回到垂直切片
 - 阻断项：

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

@@ -17,7 +17,7 @@ owner: ai
 | Spec 初稿 |  |  |  |
 | 产品总体设计 / 功能架构 |  |  | 必需 |
 | 产品设计 / 交互说明 |  |  |  |
-| 高保真 HTML 原型 | `docs/.scratch/<feature>/design/prototypes/index.html` |  | 有 UI 时必需；Ant Design v6 主题/视觉标准 + schema v2 语义映射/浏览器/无障碍证据，生产 API 为 YSS UI + Ant Design Vue 4.x |
+| 原型交付物 | `docs/.scratch/<feature>/design/prototypes/index.html` 或稳定 URL |  | 有产品设计影响时必需；按 H1/H2 档位提供 schema v3 浏览器、Design QA 与条件 AntD 事实；真实组件待验事项进入前端实现计划 |
 | Prototype Review |  |  |  |
 | CONTEXT 术语 |  |  | 业务术语须含 PascalCase `英文标识` |
@@ -51,7 +51,7 @@ owner: ai
 ## 6. 完成标准
-- [ ] Spec 已吸收产品总体设计 / 功能架构、产品设计、低保真原型评审和高保真 HTML 原型暴露的阻断项。
+- [ ] Spec 已吸收产品总体设计 / 功能架构、产品设计、低保真原型评审和原型交付物暴露的阻断项。
 - [ ] 本轮做什么、不做什么、延后什么已经明确。
 - [ ] OpenAPI、工程基线、系统架构、数据架构、风险影响已有明确结论。
 - [ ] 可进入 API 影响分析 / 契约草案 / 工程基线，或阻断项已列出。

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

@@ -23,11 +23,11 @@ Approved / Changes requested / Blocked
 ## Slice Implementation Contract 审查
-> 按 Router 生成条件对称核验合同和执行结果。Reviewer 不得直接信任实现者自报的 `implemented`。
+> 按 实现合同编译器 生成条件对称核验合同和执行结果。Reviewer 不得直接信任实现者自报的 `implemented`。
 | 检查项 | 结论 | 证据 |
 |---|---|---|
-| `contract_id` / `contract_version` 与生命周期批准、持久化版本及 Ticket 引用一致；Router 未自行写入 `approved`、`ready-for-agent` 或 `completed` | pass / violation |  |
+| `contract_id` / `contract_version` 与生命周期批准、持久化版本及 Ticket 引用一致；实现合同编译器 未自行写入 `approved`、`ready-for-agent` 或 `completed` | pass / violation |  |
 | Common、Frontend、Backend、Contract、Cross-repo 子合同按实际影响填写，不适用项均有原因 | pass / violation |  |
 | `required_skills` 依赖闭包与实际影响对称；Application、MapStruct、Lombok、Alibaba 等强制依赖未遗漏 | pass / violation / not-applicable |  |
 | 每个工作单元绑定唯一 `behavior-tdd` 或 `controlled-generation`；业务行为未混入机械生成 | pass / violation |  |
@@ -125,12 +125,12 @@ rg -n "from 'ant-design-vue'|<(Table|Tree|Form)[ >]|YFormily|YssFormily|YTable|Y
 | Agent 修改合同允许路径之外的文件，或缺少预期证据文件 | 应标记为 `violation` 并阻断 build |  |
 | Agent 把状态机、权限、事务或错误映射放入 `controlled-generation` | 应拆分为 `behavior-tdd` 工作单元并触发完整重路由 |  |
 | Agent 使用 `seam-deferred` 却缺少风险、责任人、后续 Ticket、验证计划或目标版本 / 发布日期 | 应标记为 `violation` 并阻断 |  |
-| Agent 返回非空 `new_impacts` 后继续编码或补写旧合同 | 应暂停相关工作单元，将合同标记 `stale`，回到 Router 或更早生命周期阶段 |  |
+| Agent 返回非空 `new_impacts` 后继续编码或补写旧合同 | 应暂停相关工作单元，将合同标记 `stale`，回到 实现合同编译器 或更早生命周期阶段 |  |
 | Agent 只列验证命令但没有实际结果和执行时间 | 不构成 fresh verification，不得给出 Approved / 可合并结论 |  |
 | Agent 用第二个通用审查 skill 代替 `code-review`，或 Standards 未读取合同 `required_skills` / Alibaba / `yss-ui` | 应标记为 `violation` 并阻断完成 |  |
 | Agent 把 YSS 页面模块约定并进 UI fidelity，或适用报告行留空 | 应回到 Standards 专项检查，空白行视为 `missing_evidence` |  |
 | Agent 在审查会话中直接改实现代码以“关掉” finding | 应标记为 `violation`；finding 交实现者在原合同路径修复，再重新捕获候选并全轴复审 |  |
 | Agent 把 `violation` 记为 `not-applicable`，或为日常 Alibaba / YSS 另开生物人豁免门禁 | 应阻断；命中后只允许修复或完整 `seam-deferred`，未命中才 `not-applicable` |  |
-| Agent 发现 `drift` / `new_impacts` / `required_skills` 与真实影响不一致后仍在旧合同上编码 | 应将合同标 `stale`，回 Router 或更早生命周期阶段 |  |
+| Agent 发现 `drift` / `new_impacts` / `required_skills` 与真实影响不一致后仍在旧合同上编码 | 应将合同标 `stale`，回 实现合同编译器 或更早生命周期阶段 |  |
 ## 签字确认

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

@@ -51,7 +51,7 @@ owner: ai
 - UI 影响：是 / 否
 - 产品总体设计：`docs/.scratch/<feature>/design/<feature>-product-overview-design.md`
-> 只有存在 UI 影响时，才强制低保真页面草图、状态矩阵、高保真 HTML 原型和用户确认；否则记录 `not-applicable` 及原因。
+> 只有存在产品设计影响时，才强制低保真页面草图、状态矩阵、按 H1/H2 路由的原型交付物和用户确认；否则记录 `not-applicable` 及原因。
 ## OpenAPI 影响

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

@@ -51,12 +51,12 @@ Status: ready-for-human
 | contract_id |  |
 | contract_version |  |
 | contract_ref |  |
-| Router 状态 | draft / blocked / ready-for-lifecycle-review |
+| 实现合同编译器 状态 | draft / blocked / ready-for-lifecycle-review |
 | 生命周期批准状态 | pending / approved / rejected |
-| suggested_owner_role_id | `role.frontend-engineer` / `role.backend-engineer` / `role.test-engineer`（Router 建议，编排器派活） |
+| suggested_owner_role_id | `role.frontend-engineer` / `role.backend-engineer` / `role.test-engineer`（实现合同编译器 建议，编排器派活） |
 | Build Architecture Checklist |  |
-> Router 不得自行将合同批准或将本 Ticket 推进为 `ready-for-agent`。只有生命周期编排器核验并持久化当前版本合同、清除阻塞边后，才能推进状态。
+> 实现合同编译器 不得自行将合同批准或将本 Ticket 推进为 `ready-for-agent`。只有生命周期编排器核验并持久化当前版本合同、清除阻塞边后，才能推进状态。
 ### 工作单元
@@ -103,7 +103,7 @@ Status: ready-for-human
 | affected_work_units |  |
 | new_impacts |  |
 | stale_contract_version |  |
-| return_stage | Router / Architecture Re-check / 产品设计 / OpenAPI Draft-Review-Freeze / 系统或数据架构 / other |
+| return_stage | 实现合同编译器 / Architecture Re-check / 产品设计 / OpenAPI Draft-Review-Freeze / 系统或数据架构 / other |
 | recovery_conditions |  |
 出现 `drift`、`violation` 或非空 `new_impacts` 时暂停受影响工作单元，不得先完成代码再补合同；更新合同版本并通过生命周期审查后才能恢复。

package/template/docs/user-guide/yss-ui-mcp.md CHANGED Viewed

@@ -5,8 +5,6 @@
 - Claude Code：`.mcp.json`
 - Antigravity：`.agents/mcp_config.json`
 - Cursor：`.cursor/mcp.json`
-- Gemini CLI：`.gemini/settings.json`
-- Kiro：`.kiro/settings/mcp.json`
 - VS Code：`.vscode/mcp.json`
 这些配置统一通过 `npx -y @yss-ui/mcp` 启动，不写用户主目录，也不覆盖个人全局配置。首次加载模板后，重启或刷新对应客户端即可发现 MCP。

package/template/docs/user-guide//346/210/230/346/234/257/350/256/276/350/256/241/345/255/220/351/241/271/347/233/256/347/224/250/346/210/267/346/211/213/345/206/214.md CHANGED Viewed

@@ -210,9 +210,9 @@ Strategic Design 解决“业务应该怎样分工和划边界”；Tactical Des
 ## 与其他文档怎么分工
 - [用户手册索引](./用户手册索引.md)：所有入门手册的入口。
-- [战略设计子项目用户手册](../../submodules/yss-strategic-design-harness/docs/user-guide/战略设计子项目用户手册.md)：上游 Discovery、DDD 战略设计、Spec、原型和 Strategic Design Handoff。
+- [战略设计子项目用户手册](../../submodules/yss-harness-design-agent/docs/user-guide/战略设计子项目用户手册.md)：上游 Discovery、DDD 战略设计、Spec、原型和 Strategic Design Handoff。
 - [系统概要设计模板](../architecture/templates/system-overview-design-template.md)：轻量 Tactical DDD Check 的记录位置。
 - [架构评审清单](../architecture/templates/architecture-review-checklist.md)：设计评审时的结构化检查项。
-- `yss-router` 与后端 / 前端专项技能：批准后的实现合同、代码和验证规则。
+- `yss-implementation-contract-compiler` 与后端 / 前端专项技能：批准后的实现合同、代码和验证规则。
 本手册是模板源中的通用分发资产。真实项目应使用自己的术语、规则、合同版本和批准记录；不要把“客户合同审批”示例当成真实业务结论。

package/template/docs/user-guide//347/224/250/346/210/267/346/211/213/345/206/214.md CHANGED Viewed

@@ -205,13 +205,13 @@ codex plugin add yss-backend-harness@personal
 ### 插件不会替代什么
-Plugin 是运行时适配器，不是新的事实源。它不会替代 `yss-product-lifecycle`、`yss-router` 或 `tdd`，不会设置 `ready-for-agent`，不会 Freeze OpenAPI，也不能承担独立审查。
+Plugin 是运行时适配器，不是新的事实源。它不会替代 `yss-product-lifecycle`、`yss-implementation-contract-compiler` 或 `tdd`，不会设置 `ready-for-agent`，不会 Freeze OpenAPI，也不能承担独立审查。
 执行结果应包含 `Workflow Execution Result`（例如 `completed`、`blocked`、`needs-human` 或 `failed`）及对应证据。发现路径越界、合同过期、影响面变化或证据缺失时，应停止并回到路由流程。
 ### 不可用时怎么办
-如果插件未安装、版本不兼容或执行失败，回退到通用的 `yss-router + tdd` 流程，并记录阻塞原因和实际验证命令。不要为了绕过插件故障而跳过生命周期门禁。
+如果插件未安装、版本不兼容或执行失败，回退到通用的 `yss-implementation-contract-compiler + tdd` 流程，并记录阻塞原因和实际验证命令。不要为了绕过插件故障而跳过生命周期门禁。
 ### 其他应用的接入建议
@@ -331,7 +331,7 @@ Spec 初稿通常使用 `ready-for-human`。这表示还要确认，不表示可
 - 失败后能不能重试。
 - 窄屏下是否还能完成操作。
-成功时，交互说明、状态矩阵、低保真和高保真原型相互一致，并有评审、浏览器验证和用户确认记录。
+先独立评审低保真和状态矩阵，再选择满足风险的最低原型档位：H1 确认视觉和少量交互，H2 验证主流程与异常状态。原型阶段不调用生产实现技能 `yss-ui`；真实组件假设与待验行为交给前端实现计划和实现还原验证。成功时，交互说明、状态矩阵、低保真和原型交付物相互一致，并有评审、浏览器验证和用户确认记录。
 正式信息：
@@ -397,7 +397,7 @@ Draft 只是草案。评审通过后才能 Freeze。Freeze 可以理解为“接
 前端：
-- 让 `yss-router` 选择当前页面需要的专项 skill。
+- 让 `yss-implementation-contract-compiler` 选择当前页面需要的专项 skill。
 - 以 `yss-ui`、`yss-page-module-development` 和 `tdd` 为主。
 - 只修改合同允许的路径。
 - 实际运行已登记的 `pnpm` 命令。

package/template/docs/user-guide//347/224/250/346/210/267/346/211/213/345/206/214/347/264/242/345/274/225.md CHANGED Viewed

@@ -5,7 +5,7 @@
 ## 推荐阅读顺序
 1. [YSS 用户手册](./用户手册.md)：了解仓库身份、生命周期主链和 Agent 使用模式。
-2. [战略设计子项目用户手册](../../submodules/yss-strategic-design-harness/docs/user-guide/战略设计子项目用户手册.md)：从模糊想法形成 Strategic Design Handoff。
+2. [战略设计子项目用户手册](../../submodules/yss-harness-design-agent/docs/user-guide/战略设计子项目用户手册.md)：从模糊想法形成 Strategic Design Handoff。
 3. [战术设计子项目用户手册](./战术设计子项目用户手册.md)：把交接包细化为 Tactical Design，供研发实现和评审。
 ## 按任务查找
@@ -13,9 +13,9 @@
 | 你现在要做什么 | 推荐手册 |
 |---|---|
 | 创建、接管或更新 YSS 项目 | [YSS 用户手册](./用户手册.md) |
-| 澄清需求、确定用户和范围 | [战略设计子项目用户手册](../../submodules/yss-strategic-design-harness/docs/user-guide/战略设计子项目用户手册.md) |
+| 澄清需求、确定用户和范围 | [战略设计子项目用户手册](../../submodules/yss-harness-design-agent/docs/user-guide/战略设计子项目用户手册.md) |
 | 设计聚合、状态、不变量和领域事件 | [战术设计子项目用户手册](./战术设计子项目用户手册.md) |
-| 了解完整生命周期和阶段门禁 | [产品生命周期工作流](../../submodules/yss-strategic-design-harness/docs/user-guide/产品生命周期工作流.md) |
-| 查找长期协作习惯和反模式 | [生命周期最佳实践](../../submodules/yss-strategic-design-harness/docs/user-guide/生命周期最佳实践.md) |
+| 了解完整生命周期和阶段门禁 | [产品生命周期工作流](../../submodules/yss-harness-design-agent/docs/user-guide/产品生命周期工作流.md) |
+| 查找长期协作习惯和反模式 | [生命周期最佳实践](../../submodules/yss-harness-design-agent/docs/user-guide/生命周期最佳实践.md) |
 > 本仓库是 `template-source`。手册中的业务名称和示例只用于教学；真实产品资料应在 `project-instance` 中建立，并遵守对应的生命周期门禁。

package/template/scripts/audit-yss-backend-skills ADDED Viewed

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { loadSkillRegistry } from "./lib/skill-registry.mjs";
+import { OBSOLETE, ROOT } from "./lib/skill-supply-chain.mjs";
+const checkOnly = process.argv.includes("--check");
+const registry = loadSkillRegistry();
+const capabilityBySkill = new Map();
+for (const capability of registry.capabilities) {
+  if (!capabilityBySkill.has(capability.primary_skill)) capabilityBySkill.set(capability.primary_skill, []);
+  capabilityBySkill.get(capability.primary_skill).push(capability.id);
+}
+const inbound = new Map();
+for (const [owner, dependencies] of Object.entries(registry.skill_dependencies)) {
+  for (const dependency of dependencies) {
+    if (!inbound.has(dependency.skill)) inbound.set(dependency.skill, []);
+    inbound.get(dependency.skill).push({ owner, type: dependency.type, ...(dependency.when ? { when: dependency.when } : {}) });
+  }
+}
+const recipeCallers = new Map();
+for (const recipe of registry.recipes) for (const capability of recipe.capabilities) {
+  const skill = registry.capabilities.find((item) => item.id === capability)?.primary_skill;
+  if (!skill) continue;
+  if (!recipeCallers.has(skill)) recipeCallers.set(skill, []);
+  recipeCallers.get(skill).push(recipe.id);
+}
+const candidates = registry.skills
+  .filter((skill) => skill.impacts.includes("backend") || capabilityBySkill.has(skill.id))
+  .map((skill) => {
+    const capabilities = capabilityBySkill.get(skill.id) ?? [];
+    const callers = [...new Set(recipeCallers.get(skill.id) ?? [])].sort();
+    const dependencies = inbound.get(skill.id) ?? [];
+    const canonicalExists = existsSync(path.join(ROOT, ".agents/skills", skill.id, "SKILL.md"));
+    let classification = "keep";
+    let rationale = "unique capability or active typed caller exists";
+    if (OBSOLETE.has(skill.id)) {
+      classification = "remove";
+      rationale = "explicitly obsolete";
+    } else if (!capabilities.length && !callers.length && !dependencies.length) {
+      classification = "narrow";
+      rationale = "backend impact is declared but no capability, recipe, or typed dependency consumes it";
+    }
+    return { skill: skill.id, classification, canonical_exists: canonicalExists, capabilities, recipe_callers: callers, dependency_callers: dependencies, rationale };
+  })
+  .sort((left, right) => left.skill.localeCompare(right.skill));
+const blocking = candidates.filter((item) => item.classification === "remove" && item.canonical_exists);
+if (checkOnly) {
+  const counts = Object.fromEntries(["keep", "narrow", "merge", "remove"].map((classification) => [classification, candidates.filter((item) => item.classification === classification).length]));
+  process.stdout.write(`backend skill audit passed: ${candidates.length} candidates (${Object.entries(counts).map(([key, value]) => `${key}=${value}`).join(", ")})\n`);
+} else {
+  process.stdout.write(`${JSON.stringify({ schema_version: 1, generated_from: "docs/agents/yss-skill-registry.yaml", candidates }, null, 2)}\n`);
+}
+if (blocking.length) process.exitCode = 1;

package/template/scripts/generate-yss-skill-boundaries ADDED Viewed

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+import { readFileSync, writeFileSync } from "node:fs";
+import { loadCompilerContract } from "./lib/implementation-contract-compiler.mjs";
+import { loadSkillRegistry } from "./lib/skill-registry.mjs";
+import { ROOT } from "./lib/skill-supply-chain.mjs";
+import path from "node:path";
+const target = path.join(ROOT, ".agents/skills/yss-implementation-contract-compiler/references/boundaries.md");
+const registry = loadSkillRegistry();
+const compiler = loadCompilerContract();
+const lines = [
+  "# 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 |",
+  "| --- | --- | --- |",
+  ...registry.capabilities.map((item) => `| \`${item.id}\` | \`${item.primary_skill}\` | ${item.task_modes.map((mode) => `\`${mode}\``).join(", ")} |`),
+  "",
+  "## Narrow Recipes",
+  "",
+  "一个切片可以组合多个 Recipe，但只计算一次闭包。Recipe 仅引用 capability。",
+  "",
+  "| Recipe | Capabilities |",
+  "| --- | --- |",
+  ...registry.recipes.map((item) => `| \`${item.id}\` | ${item.capabilities.map((capability) => `\`${capability}\``).join(", ")} |`),
+  "",
+  "## Impact Entry Mapping",
+  "",
+  "| Impact | Entry capabilities |",
+  "| --- | --- |",
+  ...Object.entries(compiler.impact_to_capabilities).map(([impact, capabilities]) => `| \`${impact}\` | ${capabilities.map((capability) => `\`${capability}\``).join(", ")} |`),
+  "",
+  "## Typed Skill Dependencies",
+  "",
+  "| Skill | Dependency | Type | Condition |",
+  "| --- | --- | --- | --- |",
+  ...Object.entries(registry.skill_dependencies).flatMap(([skill, dependencies]) => dependencies.map((dependency) => `| \`${skill}\` | \`${dependency.skill}\` | \`${dependency.type}\` | ${dependency.when ? `\`${dependency.when}\`` : "—"} |`)),
+  ""
+];
+const expected = lines.join("\n");
+if (process.argv.includes("--check")) {
+  const actual = readFileSync(target, "utf8");
+  if (actual !== expected) {
+    process.stderr.write("boundaries.md 与 Registry/Compiler 合同不一致；运行 scripts/generate-yss-skill-boundaries\n");
+    process.exitCode = 1;
+  } else process.stdout.write("YSS skill boundaries are current\n");
+} else {
+  writeFileSync(target, expected);
+  process.stdout.write("generated YSS skill boundaries\n");
+}

package/template/scripts/lib/export-skills.mjs CHANGED Viewed

@@ -7,7 +7,7 @@ import { fileURLToPath } from "node:url";
 const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../..");
 const sourceRoot = path.join(root, ".agents/skills");
 const managed = ["skills", "skills.sh.json", ".yss-export-manifest.json"];
-const forbidden = ["AGENTS.md", "CONTEXT.md", "docs", "skills-lock.json", ".agents", ".claude", ".codex", ".hermes", ".pi", ".qoder", ".trae"];
+const forbidden = ["AGENTS.md", "CONTEXT.md", "docs", "skills-lock.json", ".agents", ".claude", ".codex", ".pi", ".qoder", ".trae"];
 const hash = (content) => createHash("sha256").update(content).digest("hex");
 const fail = (message) => { throw new TypeError("export-yss-skills: " + message); };
@@ -48,8 +48,8 @@ function sanitize(text, relative) {
   const prefix = prefixPath ? prefixPath + "/" : "";
   let value = text.replace(/(YSS_SKILLS_ROOT\s*=\s*["']?)\/path\/to\/\.agents\/skills/g, "$1__YSS_SKILLS_ROOT_PATH__");
   value = value.replace(/\/path\/to\/\.agents\/skills/g, "$YSS_SKILLS_ROOT");
-  value = value.replace(/(?:\$\{base_project\}\/)?(?:\/path\/to\/)?\.(?:agents|claude|codex|hermes|pi|qoder|trae)\/skills\//g, prefix);
-  value = value.replace(/\.(?:agents|claude|codex|hermes|pi|qoder|trae)\/skills\b/g, "the canonical public skill source");
+  value = value.replace(/(?:\$\{base_project\}\/)?(?:\/path\/to\/)?\.(?:agents|claude|codex|pi|qoder|trae)\/skills\//g, prefix);
+  value = value.replace(/\.(?:agents|claude|codex|pi|qoder|trae)\/skills\b/g, "the canonical public skill source");
   value = value.replace(/\/path\/to\/skill-creator/g, "skill-creator").replace(/(?<![\w.])\/path\//g, "./path/");
   value = value.replace(/\/(?:Users|home|private)\/[^\s"'()<>\]]+/g, "<local-path-removed>").replace(/\/tmp\//g, "./tmp/");
   value = value.replace(/yss-spec-project-template/g, "the consuming project").replace(/\$\{base_project\}/g, "the consuming project");
@@ -98,7 +98,7 @@ function validate(output, skillNames) {
     const text = bytes.toString("utf8");
     if (/-----BEGIN (?:[A-Z0-9 ]+ )?PRIVATE KEY-----|(?:ghp_|github_pat_|github_token_|xox[baprs]-)[A-Za-z0-9_-]+|AKIA[0-9A-Z]{16}/.test(text)) fail("suspicious credential-like content: " + absolute);
     if (/(?:^|[^.\w])\/(?:Users|home|private|tmp)\//.test(text)) fail("absolute local path in public export: " + absolute);
-    if (/\.(?:agents|claude|codex|hermes|pi|qoder|trae)\/skills/.test(text)) fail("Agent root path in public export: " + absolute);
+    if (/\.(?:agents|claude|codex|pi|qoder|trae)\/skills/.test(text)) fail("Agent root path in public export: " + absolute);
   }
   validateLinks(path.join(output, "skills"));
 }