create-yss-spec 2.1.5 → 2.1.7

package/template/docs/reviews/security-permission-lifecycle-simplification-red-green-2026-08-16.md

@@ -1,43 +0,0 @@
----
-type: template-skill-validation
-status: complete
-date: 2026-08-16
-scope: yss-product-lifecycle / yss-router / OpenAPI lifecycle simplification
----
-
-# 安全 / 权限生命周期简化 RED / GREEN / REFACTOR 记录
-
-## RED：旧规则的过度治理证据
-
-修改前的只读压力检查表明，机器契约会让普通 CRUD/API 填写结构化安全 / 权限资料、过时的继承资料、触发命中和派生影响旗标；缺少或过期的资料会阻断推进。
-
-SQL / DDL / 迁移和普通下载接口也会仅因技术载体自动升级到专属流程。明确改变认证、授权或租户隔离的需求，除了实际的 Spec、API、数据和架构影响外，还会引入专属传播和回退目的地。
-
-基线脚本 `scripts/verify-lifecycle-scenarios` 与 `scripts/verify-yss-router-scenarios` 在旧契约下通过，证明这些行为不仅存在于文档，也被自动验证锁定。
-
-## GREEN：简化后的压力场景
-
-- 普通 CRUD/API 可在不提供任何额外安全 / 权限输入、平台资料或不适用记录的情况下，通过 Router 的普通 UI/API/Backend/Data 影响分诊。
-- SQL / DDL / 迁移仅走既有数据模型和迁移规则；上传下载仅按真实 API、UI 或数据影响处理，不因关键词自动升级。
-- 显式改变认证、授权、租户隔离、敏感数据或合规行为时，按实际 UI、API、Backend、Data 和 high-risk 影响进入普通 Spec、架构、错误语义、验收标准和测试 seam。
-- 实际调用当前用户、审计或加密组件时，Router 仍选择对应 YSS skill；权限业务行为仍使用 `behavior-tdd`，受控生成仍禁止机械生成此类业务逻辑。
-
-本轮 fresh verification 结果：
-
-```text
-scripts/sync-skills --check       -> skill projections are synchronized
-scripts/update-skill-lock --check -> skills-lock.json matches distributed skills
-scripts/verify-lifecycle-scenarios -> 六类生命周期压力场景验证通过；生命周期编排器压力场景验证通过
-scripts/verify-yss-router-scenarios -> YSS Router stage 7 scenarios passed
-scripts/verify-template           -> 模板发布校验通过
-git diff --check                  -> passed
-```
-
-独立只读审查先识别出用户指南、切片 Ticket、审查报告、生命周期说明、技术设计与 OpenAPI Freeze 中的旧专项语句；修订后 Standards 与 Spec 两个审查轴均复核通过，无剩余 P0/P1/P2 finding。
-
-## REFACTOR：收敛后的长期规则
-
-- 不再主动推导或登记安全 / 权限专项影响；没有独立的姿态、平台资料、触发矩阵、派生旗标、专属传播或回退目的地。
-- 实现中发现未冻结的新事实时，统一用既有 `new_impacts` 重新分诊。
-- 保留通用 `seam-deferred` 的风险、责任人、后续 Ticket、验证计划和目标版本 / 发布日期要求；不再存在专项不可延期清单。
-- 保留真实组件选择、普通架构审查、路径边界、证据和验证要求，但不新增与本次简化无关的流程条件。

package/template/docs/reviews/template-release-review-remediation-red-green-2026-08-17.md

@@ -1,41 +0,0 @@
-# 模板发布审查修复 RED / GREEN 证据
-
-## 范围
-
-- 仓库身份：`template-source`。
-- 触发：全部候选变更的独立双轴发布审查。
-- 目标：消除已明确安全/权限行为缺少普通架构承载、生命周期场景未校验稳定 ID，以及 ADR 把后续未实施能力表述为已生效能力的问题。
-
-## RED
-
-先新增 `scripts/verify-governance-release`，在不修改权威资产时得到预期失败：
-
-- 两份架构模板均缺少“已明确的认证、授权、租户隔离、敏感数据或合规行为”的条件性承载。
-- ADR-0003 / 0006 把索引、依赖图和 fixture 的完整生成写成已交付，ADR-0005 / 0007 把生态发布清单和技能路由注册表写成已生效，但相应资产、schema、消费者和校验器不存在。
-- `verify-lifecycle-scenarios` 使用人类可读 route key，却没有核验它们能映射到 `lifecycle-registry.yaml` 的稳定 ID。
-
-## GREEN
-
-- 系统概要设计和技术方案模板恢复条件性架构承载：只有明确改变认证、授权、租户隔离、敏感数据或合规行为时才填写普通架构、契约、验证与回滚约束；未触发时不新增独立门禁或登记。
-- ADR-0003 / 0006 明确为 Phase 1 部分实施，ADR-0005 / 0007 明确为 `proposed`；未实现的生态清单、技能注册表、索引、依赖图与 fixture 不再被描述为当前模板已交付能力。
-- `verify-lifecycle-scenarios` 读取 `lifecycle-registry.yaml`，并把每个当前 route key 映射、校验到稳定 ID，防止注册表删除或改名时压力场景静默漂移。
-- `verify-governance-release` 已加入 `scripts/verify-template`。
-
-## 验证
-
-```text
-scripts/verify-governance-release  PASS
-scripts/verify-lifecycle-scenarios PASS
-scripts/verify-template            PASS（记录于本节最终复审文字写入前的冻结候选）
-```
-
-后续完整生态发布清单或技能路由注册表必须从新的 RED 场景开始，且同时交付 source、schema、消费者、`--check` 和跨仓验证；不得仅更新 ADR 状态。
-
-## 独立复审
-
-两位非实现者基于同一 `yss-worktree-candidate-v1` 不可变快照复审：
-
-- Standards：条件性架构承载、稳定 ID 映射和 `candidate-manifest.yaml` 均通过。
-- Spec / Requirements：ADR-0003 / 0006 的 Phase 1 边界及 ADR-0005 / 0007 的 `proposed` 状态准确，未实施能力不再被当作本次发布交付。
-
-复审时 `drift`、`violation` 和 `new_impacts` 均为空；本节写入后必须对新的最终候选重新执行 fresh verification 并复核候选摘要，结果由本轮 Git checkpoint 记录，避免把验证结论自指为文档写入后的同一快照。

package/template/docs/reviews/yss-local-tracker-red-green-2026-08-10.md

@@ -1,50 +0,0 @@
----
-status: completed
-owner: ai
----
-
-# Local `docs/.scratch` 与 YSS 生命周期修订验证
-
-## RED 基线
-
-本轮 RED 先将压力场景目标切换为 `docs/.scratch/<feature>/`，再在权威文档修改前运行。当前根 `.scratch` 配置导致 Local root、远程 fallback、持久化 tracker root、Matt/YSS adapter 和各 feature skill 路径断言失败；这证明旧路径仍会被默认使用。
-
-迁移规则同时要求：旧根 `.scratch/` 或 `docs/requirements/tickets/` 只能被只读识别；仅有旧资产时记录 `migration_ref` 并暂停写入；新旧资产并存时返回 `conflict`。
-
-本轮开始时的仓库基线还存在独立的历史问题：`80eecb6 chore: remove local workspace directories` 删除了 `docs/process/` 下的生命周期文件，而 `scripts/verify-template`、`scripts/verify-lifecycle-scenarios` 和 `scripts/verify-yss-router-scenarios` 仍将其列为必需输入。该问题没有通过生成临时产品资产或绕过校验来隐藏。
-
-## GREEN 场景
-
-集成压力脚本现在覆盖：
-
-1. GitHub `origin` + 持久化 Local 配置仍选择 `local-markdown`，写入 `docs/.scratch`，不规划远程 Issue 命令。
-2. 显式选择 GitHub / GitLab 后，平台不可用只生成 `docs/.scratch/<feature>/` 草案，在 `parent-ticket.md` 标记 `publication: pending`，并保留原目标平台。
-3. 多个持久化配置声明不同平台时返回 `conflict`，不覆盖任何配置。
-4. 仅有旧路径资产时返回迁移所需结果；新旧路径并存时返回 `conflict`，两种情况都不写入。
-5. `template-source` 只做模板契约验证，不创建产品 `docs/.scratch`、Spec 或 Ticket。
-
-## REFACTOR 结果
-
-- `docs/agents/issue-tracker.md` 成为 tracker 单一事实来源，默认 `local-markdown`，完整功能包位于 `docs/.scratch/<feature>/`。
-- Matt Local seed、Local-aware skills 和 YSS adapter 已统一到 `docs/.scratch`；Matt 核心流程和五态语义保持不变。
-- setup-matt-pocock-skills 只提供 `local-markdown`、`github`、`gitlab` 三种显式选择；Git remote 不参与排序，unsupported tracker 不写入配置。
-- YSS 原型、OpenAPI、架构图和 Discovery 主动执行 skill 的功能资产路径已归一到 `docs/.scratch/<feature>/`；项目级设计系统仍保留在 `docs/design/`。
-- YSS active 时，`to-spec` 的独立 `ready-for-agent` 提示被适配层收敛为 `ready-for-human`。
-- `Status: claimed/resolved` 只保留为 Wayfinder 临时工作状态，交付 Ticket 必须提升为五态角色。
-- 远程降级保留 `tracker`、`publication: pending` 和 `pending_publication_to`，不自动切换平台。
-- `docs/.scratch` 不应被 `.gitignore` 忽略；模板校验现在显式检查这一契约。
-- `template-source` 模式显式拒绝非空产品 `docs/.scratch` 或根 `.scratch` 目录。
-
-## 验证证据
-
-- `ruby scripts/verify-matt-yss-integration-scenarios`：通过。
-- setup tracker choice / unsupported platform 断言：通过（集成脚本覆盖）。
-- `scripts/verify-yss-ui-scenarios`：通过。
-- `scripts/sync-skills --check`：通过。
-- `scripts/update-skill-lock --check`：通过。
-- `git diff --check`：通过。
-- `ruby -c`：同步、锁文件和两类场景脚本均通过。
-- `scripts/verify-template`：被既有缺失的 `docs/process/lifecycle-artifact-map.md` 阻断。
-- `scripts/verify-lifecycle-scenarios`：被既有缺失的 `docs/process/harness-executive-blueprint.md` 阻断。
-- `scripts/verify-yss-router-scenarios`：被既有缺失的 `docs/process/lifecycle-artifact-map.md` 阻断。
-- 上述 `docs/process` 缺失源于本轮前的 `80eecb6 chore: remove local workspace directories`，未通过生成产品资产或绕过校验来隐藏。

package/template/docs/user-guide//345/233/276/347/244/272/347/224/237/346/210/220/345/231/250/344/275/277/347/224/250/346/214/207/345/215/227.md

@@ -1,143 +0,0 @@
-# Excalidraw Diagram Generator 使用手册
-
-`excalidraw-diagram-generator` 是可视化说明与审查辅助 skill，用来把流程、架构、状态、依赖、数据流和切片关系生成 `.excalidraw` 文件。
-
-它不替代 `yss-product-lifecycle`、Spec、OpenAPI、ADR、Ticket 或测试。它的价值是让复杂关系可以被快速看见、讨论和审查。
-
-## 1. 在流程中的定位
-
-推荐使用位置：
-
-```text
-机会探索 / Discovery
-  -> 用户旅程图、机会地图、竞品流程泳道图
-
-Spec / 需求澄清
-  -> 业务流程图、角色职责泳道图、页面地图
-
-OpenAPI Draft / 工程基线 / 架构设计
-  -> 系统架构图、数据流图、序列图、ER 图、DDD 边界图
-
-系统 / 数据架构设计
-  -> 状态流、调用链、领域边界、切片依赖图
-
-设计审查 / 垂直切片前
-  -> 用图暴露边界不清、契约缺口和切片依赖
-
-复盘沉淀
-  -> 最终流程图、架构演进图、知识沉淀图
-```
-
-最有价值的阶段是 Architecture / 系统 / 数据架构设计 和 Design Review。此时图可以帮助审查 DDD 边界、状态流、接口契约、异常路径和垂直切片是否一致。
-
-## 1.1 四类架构图产物
-
-四类架构图随生命周期逐步产出，不要求一次性全部画完。
-
-| 架构产物 | 产出阶段 | 图的价值 | 常用图类型 | 保存位置 |
-|---|---|---|---|---|
-| 业务架构图 | 机会探索 / Discovery / 产品定义 | 让用户、价值流、角色协作和产品边界可视化 | 用户旅程、价值流、泳道图、能力地图、生态关系图 | `docs/.scratch/<feature>/discovery/diagrams/` 或 `docs/.scratch/<feature>/architecture/diagrams/` |
-| 功能架构图 | Spec baseline / 产品设计 / Spec 校准 | 让功能域、模块、优先级和依赖关系可审查 | 功能模块图、依赖图、页面地图、关系图 | `docs/.scratch/<feature>/design/diagrams/` 或 `docs/.scratch/<feature>/architecture/diagrams/` |
-| 系统总体架构图 | 工程基线 / 系统 / 数据架构设计 | 让服务边界、部署、集成、权限链路和 NFR 方案可审查 | C4/容器图、部署图、序列图、DFD、DDD 边界图 | `docs/.scratch/<feature>/architecture/diagrams/` |
-| 数据架构图 | 详细设计 / 持久化开发前 | 让元模型、版本、血缘、查询和存储策略在写 Repository 前被看见 | ER 图、Class/元模型图、血缘图、DFD、查询路径图 | `docs/.scratch/<feature>/architecture/diagrams/` |
-
-对于数据模型、元数据管理、模型版本或血缘分析类产品，数据架构图尤其有价值。它不能替代 `docs/.scratch/<feature>/architecture/<feature>-data-architecture.md`，但可以帮助提前发现元模型抽象不稳、版本边界不清、血缘关系无法高效查询等高成本问题。
-
-## 2. 适用与不适用
-
-适用：
-
-- 多角色、多系统、多模块协作。
-- 涉及前后端、OpenAPI、DDD、状态机。
-- 有复杂页面流、审批流、发布流、导入导出流。
-- 设计审查时理解不一致。
-- 垂直切片之间有依赖，需要解释交付顺序。
-
-不适用：
-
-- 单点文案、小样式、小 bug。
-- 已有清晰 Spec / OpenAPI / ADR，且没有理解歧义。
-- 只是为了让文档看起来更完整。
-
-## 3. 与 Agents 的协作
-
-| Agent | 使用方式 |
-|---|---|
-| Ideation / Discovery Agent | 生成机会地图、用户旅程、竞品流程泳道图 |
-| Product / Grill Agent | 把需求澄清结果画成业务流程、角色职责图 |
-| API Contract Agent | 画接口调用序列、数据流、错误流 |
-| Architecture Agent | 画系统架构、DDD 分层、模块依赖、ER / Class / DFD |
-| Design Review Agent | 对图做审查，找职责不清、循环依赖、契约缺口 |
-| Code Agent | 消费图辅助理解，不用图替代 Spec、OpenAPI 或 ADR |
-| Review Agent | 检查实现是否偏离图中的边界和流程 |
-| Knowledge / Retro Agent | 把稳定流程或架构图沉淀到 docs |
-
-## 4. 产物位置
-
-Local Markdown 主 tracker 推荐目录：
-
-```text
-docs/.scratch/<feature>/discovery/diagrams/
-docs/.scratch/<feature>/design/diagrams/
-docs/.scratch/<feature>/architecture/diagrams/
-```
-
-示例：
-
-```text
-docs/.scratch/model-management/discovery/diagrams/model-management-opportunity-map.excalidraw
-docs/.scratch/model-management/design/diagrams/model-management-user-flow.excalidraw
-docs/.scratch/model-management/architecture/diagrams/model-publishing-sequence.excalidraw
-docs/.scratch/model-management/architecture/diagrams/model-ddd-boundary.excalidraw
-```
-
-在对应 Markdown 文档中引用：
-
-```markdown
-相关图：`docs/.scratch/model-management/architecture/diagrams/model-publishing-sequence.excalidraw`
-```
-
-## 5. 实践方式
-
-推荐三步法：
-
-1. 先有文字事实。
-   来源应该是 Discovery、Spec、OpenAPI Draft、Architecture、系统 / 数据架构设计 或 Ticket。
-2. 再生成图。
-   根据用途选择 Flowchart、Swimlane、Relationship、Class、ER、Sequence、DFD、Architecture 或 Mind Map。
-3. 最后回写审查结论。
-   图里暴露的问题要回写到 Spec、OpenAPI、ADR、系统 / 数据架构设计 或 Ticket。
-
-常用提示词：
-
-```text
-使用 excalidraw-diagram-generator，基于 `docs/.scratch/<feature>/spec.md`
-和 `docs/.scratch/<feature>/api/<feature>.yaml`，生成 <feature> 的接口调用序列图。
-保存到 `docs/.scratch/<feature>/architecture/diagrams/<feature>-sequence.excalidraw`。
-```
-
-```text
-使用 excalidraw-diagram-generator，基于当前 `docs/.scratch/<feature>/architecture/` 系统 / 数据架构设计，
-生成 DDD 边界和模块依赖图，突出 Domain、Application、Infrastructure、Adapter 的依赖方向。
-保存到 `docs/.scratch/<feature>/architecture/diagrams/<feature>-ddd-boundary.excalidraw`。
-```
-
-```text
-使用 excalidraw-diagram-generator，基于 `docs/.scratch/<feature>/architecture/<feature>-data-architecture.md`，
-生成元模型 ER 图和血缘关系图，突出 Model、Entity、Attribute、Relationship、Version、LineageEdge 的关系。
-保存到 `docs/.scratch/<feature>/architecture/diagrams/<feature>-data-model.excalidraw`。
-```
-
-```text
-使用 excalidraw-diagram-generator，把这些垂直切片画成依赖关系图。
-要求标出每个 slice 的用户动作、API、后端行为、前端入口和验证点。
-```
-
-## 6. 审查清单
-
-- 图是否引用了明确的上游资产。
-- 图是否帮助回答一个具体问题，而不是装饰文档。
-- 节点数量是否可读，复杂图是否拆成高层图和子图。
-- DDD、API、状态流、权限和错误路径是否表达清楚。
-- 图中发现的问题是否回写到文本资产。
-- `.excalidraw` 文件是否放在合适目录，并被相关文档引用。

package/template/scripts/implementation-path-policy.rb

@@ -1,50 +0,0 @@
-# frozen_string_literal: true
-
-require "pathname"
-
-# Harness 内运行时代码路径的机器可执行策略。
-module YssImplementationPathPolicy
-  PROJECT_NAME = /\A[a-z][a-z0-9-]*\z/
-  IMPLEMENTATION_KINDS = %w[backend frontend].freeze
-  CONTAINER_ROOTS = %w[apps/backend apps/frontend].freeze
-  FORBIDDEN_ROOTS = %w[app/backend app/frontend].freeze
-
-  module_function
-
-  def normalize(path)
-    return nil unless path.is_a?(String) && !path.empty?
-
-    candidate = path.sub(%r{/$}, "")
-    clean = Pathname.new(candidate).cleanpath.to_s
-    return nil if clean != candidate || Pathname.new(clean).absolute? || clean.start_with?("../")
-
-    clean
-  rescue ArgumentError
-    nil
-  end
-
-  def violation(path, enforce_harness: true)
-    clean = normalize(path)
-    return "implementation path must be a clean relative path" unless clean
-    return nil unless enforce_harness
-
-    parts = clean.split("/")
-    root = parts.take(2).join("/")
-
-    if parts.length >= 2 && parts[0] == "app" && IMPLEMENTATION_KINDS.include?(parts[1])
-      return "singular app implementation root is forbidden: #{root}/"
-    end
-
-    return nil unless parts[0] == "apps" && IMPLEMENTATION_KINDS.include?(parts[1])
-    return "implementation container root is not a project root: #{root}/" if parts.length < 3
-
-    project = parts[2]
-    return "implementation project segment must be a concrete project name: #{project}" unless project.match?(PROJECT_NAME)
-
-    nil
-  end
-
-  def valid?(path, enforce_harness: true)
-    violation(path, enforce_harness: enforce_harness).nil?
-  end
-end

package/template/scripts/lifecycle-registry.rb

@@ -1,194 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-require "pathname"
-require "json"
-require "digest"
-require "yaml"
-
-module LifecycleRegistry
-  ROOT = Pathname.new(__dir__).join("..").realpath
-  DEFAULT_REGISTRY = ROOT.join("docs/process/lifecycle-registry.yaml")
-  DEFAULT_BASELINE = ROOT.join("docs/process/lifecycle-registry-baseline.json")
-  ID_PATTERN = /\A(stage|gate|artifact|work-unit|evidence)\.[a-z0-9][a-z0-9-]*\z/
-
-  module_function
-
-  def load_registry(path = DEFAULT_REGISTRY)
-    YAML.safe_load(Pathname.new(path).read, permitted_classes: [], aliases: false)
-  rescue Psych::Exception => error
-    raise ArgumentError, "无法解析生命周期注册表: #{error.message}"
-  end
-
-  def validate!(registry, baseline: DEFAULT_BASELINE)
-    required_top_level = %w[schema_version registry_id status id_policy stages gates artifacts work_units evidence]
-    missing = required_top_level - registry.keys
-    raise ArgumentError, "生命周期注册表缺少字段: #{missing.join(', ')}" unless missing.empty?
-    raise ArgumentError, "仅支持 lifecycle registry schema_version: 1" unless registry["schema_version"] == 1
-    raise ArgumentError, "registry_id 必须为 yss.lifecycle" unless registry["registry_id"] == "yss.lifecycle"
-    raise ArgumentError, "status 必须为 shadow 或 active" unless %w[shadow active].include?(registry["status"])
-
-    policy = registry.fetch("id_policy")
-    %w[pattern published_ids_immutable baseline deprecated_ids].each do |key|
-      raise ArgumentError, "id_policy 缺少字段: #{key}" unless policy.key?(key)
-    end
-    raise ArgumentError, "published_ids_immutable 必须为 true" unless policy["published_ids_immutable"] == true
-    raise ArgumentError, "id_policy.pattern 不符合固定命名空间" unless policy["pattern"] == "^(stage|gate|artifact|work-unit|evidence)\\.[a-z0-9][a-z0-9-]*$"
-    raise ArgumentError, "id_policy.baseline 必须指向发布基线" unless policy["baseline"] == "docs/process/lifecycle-registry-baseline.json"
-    raise ArgumentError, "deprecated_ids 必须是数组" unless policy["deprecated_ids"].is_a?(Array)
-
-    ids = {}
-    %w[stages gates artifacts work_units evidence].each do |collection|
-      records = registry.fetch(collection)
-      raise ArgumentError, "#{collection} 必须是非空数组" unless records.is_a?(Array) && !records.empty?
-      records.each do |record|
-        id = record["id"]
-        raise ArgumentError, "#{collection} 中存在无效 ID: #{id.inspect}" unless id.is_a?(String) && id.match?(ID_PATTERN)
-        raise ArgumentError, "生命周期 ID 重复: #{id}" if ids.key?(id)
-        expected_prefix = collection == "work_units" ? "work-unit." : collection.delete_suffix("s") + "."
-        raise ArgumentError, "#{id} 与 #{collection} 类型不匹配" unless id.start_with?(expected_prefix)
-        raise ArgumentError, "#{id} 缺少名称" unless record["name"].is_a?(String) && !record["name"].empty?
-        ids[id] = collection
-      end
-    end
-
-    registry.fetch("gates").each do |gate|
-      require_reference!(ids, gate.fetch("stage"), "#{gate["id"]}.stage")
-      unless ids[gate.fetch("stage")] == "stages"
-        raise ArgumentError, "#{gate["id"]}.stage 必须引用 stage.*"
-      end
-      evidence = gate.fetch("evidence")
-      raise ArgumentError, "#{gate["id"]}.evidence 必须是非空数组" unless evidence.is_a?(Array) && !evidence.empty?
-      evidence.each do |reference|
-        require_reference!(ids, reference, "#{gate["id"]}.evidence")
-        raise ArgumentError, "#{gate["id"]}.evidence 必须引用 evidence.*" unless ids[reference] == "evidence"
-      end
-    end
-
-    registry.fetch("artifacts").each do |artifact|
-      require_reference!(ids, artifact.fetch("stage"), "#{artifact["id"]}.stage")
-      raise ArgumentError, "#{artifact["id"]}.stage 必须引用 stage.*" unless ids[artifact.fetch("stage")] == "stages"
-    end
-    validate_baseline!(registry, ids, Pathname.new(baseline)) if baseline
-    registry
-  end
-
-  def require_reference!(ids, reference, field)
-    raise ArgumentError, "#{field} 引用了不存在的引用: #{reference}" unless ids.key?(reference)
-  end
-
-  def semantic_projection(registry)
-    %w[stages gates artifacts work_units evidence].flat_map do |collection|
-      registry.fetch(collection).map do |record|
-        {
-          "kind" => collection,
-          "record" => canonicalize(record)
-        }
-      end
-    end.sort_by { |entry| entry.fetch("record").fetch("id") }
-  end
-
-  def canonicalize(value)
-    case value
-    when Hash
-      value.keys.sort.to_h { |key| [key, canonicalize(value.fetch(key))] }
-    when Array
-      value.map { |item| canonicalize(item) }
-    else
-      value
-    end
-  end
-
-  def semantic_digest(registry)
-    Digest::SHA256.hexdigest(JSON.generate(semantic_projection(registry)))
-  end
-
-  def validate_baseline!(registry, ids, baseline_path)
-    raise ArgumentError, "缺少生命周期已发布基线: #{baseline_path.relative_path_from(ROOT)}" unless baseline_path.file?
-    baseline = JSON.parse(baseline_path.read)
-    unless baseline["schema_version"] == 1 && baseline["registry_id"] == registry["registry_id"]
-      raise ArgumentError, "生命周期已发布基线版本或 registry_id 不匹配"
-    end
-    published_ids = baseline["published_ids"]
-    raise ArgumentError, "生命周期已发布基线缺少 published_ids" unless published_ids.is_a?(Array) && published_ids.uniq == published_ids
-    published_ids.each do |id|
-      raise ArgumentError, "生命周期已发布基线包含无效 ID: #{id.inspect}" unless id.is_a?(String) && id.match?(ID_PATTERN)
-    end
-
-    active_ids = ids.keys.sort
-    deprecated_ids = registry.fetch("id_policy").fetch("deprecated_ids")
-    unless deprecated_ids.uniq == deprecated_ids && deprecated_ids.all? { |id| published_ids.include?(id) } && (deprecated_ids & active_ids).empty?
-      raise ArgumentError, "deprecated_ids 必须唯一、来自已发布 ID，且不得仍为活跃对象"
-    end
-    expected_active_ids = (published_ids - deprecated_ids).sort
-    raise ArgumentError, "生命周期活跃 ID 与已发布基线不一致；新增、移除或弃用必须先更新发布基线" unless active_ids == expected_active_ids
-    raise ArgumentError, "生命周期稳定 ID 的语义快照已变化；不得复用已发布 ID" unless baseline["semantic_sha256"] == semantic_digest(registry)
-  rescue JSON::ParserError => error
-    raise ArgumentError, "无法解析生命周期已发布基线: #{error.message}"
-  end
-
-  def render_lifecycle_structure(registry)
-    lines = []
-    lines << "<!-- lifecycle-registry:structure:start -->"
-    lines << "> 此结构区由 `docs/process/lifecycle-registry.yaml` 生成。当前为 `#{registry.fetch("status")}` 模式：它校验结构和派生文档，不改变运行时状态 schema 或人工批准语义。"
-    lines << ""
-    lines << "## 1. 主阶段"
-    lines << ""
-    lines << "| 稳定 ID | 阶段 | 目标 | 退出标准 |"
-    lines << "|---|---|---|---|"
-    registry.fetch("stages").each { |stage| lines << "| `#{stage["id"]}` | #{stage["name"]} | #{stage["goal"]} | #{stage["exit_criteria"]} |" }
-    lines << ""
-    lines << "## 2. 生命周期对象"
-    lines << ""
-    lines << "门禁是需要裁决的审查点；产物、工作单元和证据不是门禁的同义词。未命中条件的门禁记录 `not-applicable` 及原因，不生成空文档。"
-    lines << ""
-    lines << "### 2.1 条件门禁"
-    lines << ""
-    lines << "| 稳定 ID | 门禁 | 所属阶段 | 触发条件 | 必须留下的证据 |"
-    lines << "|---|---|---|---|---|"
-    registry.fetch("gates").each do |gate|
-      evidence = gate.fetch("evidence").map { |id| "`#{id}`" }.join("、")
-      lines << "| `#{gate["id"]}` | #{gate["name"]} | `#{gate["stage"]}` | #{gate["trigger"]} | #{evidence} |"
-    end
-    lines << ""
-    lines << "### 2.2 生命周期产物"
-    lines << ""
-    lines << "| 稳定 ID | 产物 | 所属阶段 | 触发条件 |"
-    lines << "|---|---|---|---|"
-    registry.fetch("artifacts").each { |artifact| lines << "| `#{artifact["id"]}` | #{artifact["name"]} | `#{artifact["stage"]}` | #{artifact["trigger"]} |" }
-    lines << ""
-    lines << "### 2.3 执行证据"
-    lines << ""
-    lines << "| 稳定 ID | 证据 | 说明 |"
-    lines << "|---|---|---|"
-    registry.fetch("evidence").each { |evidence| lines << "| `#{evidence["id"]}` | #{evidence["name"]} | #{evidence["description"]} |" }
-    lines << "<!-- lifecycle-registry:structure:end -->"
-    lines.join("\n") + "\n"
-  end
-
-  def render_work_units(registry)
-    lines = []
-    lines << "<!-- lifecycle-registry:work-units:start -->"
-    lines << "> 此表由 `docs/process/lifecycle-registry.yaml` 生成；它只描述 `template-source` 的 Harness 工作单元。"
-    lines << ""
-    lines << "| 稳定 ID | 工作单元 | 输入 | 输出 | 完成条件 |"
-    lines << "|---|---|---|---|---|"
-    registry.fetch("work_units").each do |unit|
-      lines << "| `#{unit["id"]}` | #{unit["name"]} | #{unit["input"]} | #{unit["output"]} | #{unit["completion"]} |"
-    end
-    lines << "<!-- lifecycle-registry:work-units:end -->"
-    lines.join("\n") + "\n"
-  end
-
-  def replace_region!(path, start_marker, end_marker, replacement, check: false)
-    body = path.read
-    expression = /#{Regexp.escape(start_marker)}.*?#{Regexp.escape(end_marker)}\n?/m
-    raise ArgumentError, "派生文档缺少生成区: #{path.relative_path_from(ROOT)}" unless body.match?(expression)
-    expected = body.sub(expression, replacement)
-    if check
-      raise ArgumentError, "派生文档与注册表漂移: #{path.relative_path_from(ROOT)}；运行 scripts/generate-lifecycle-artifacts --write" unless expected == body
-    else
-      path.write(expected)
-    end
-  end
-end

package/template/scripts/test-export-yss-skills.rb

@@ -1,132 +0,0 @@
-# frozen_string_literal: true
-
-require "json"
-require "minitest/autorun"
-require "open3"
-require "pathname"
-require "tmpdir"
-
-ROOT = Pathname.new(__dir__).parent.expand_path
-EXPORTER = ROOT.join("scripts", "export-yss-skills")
-REMOVED_SKILLS = %w[
-  yss-dir
-  yss-duckdb
-  yss-file
-  yss-filerunner
-  yss-mail
-  yss-mapper-dynamic
-  yss-quality
-  yss-sql-condition
-  yss-sql-tpl
-  yss-openapi
-].freeze
-
-class ExportYssSkillsTest < Minitest::Test
-  def run_export(output, *arguments)
-    Open3.capture3("ruby", EXPORTER.to_s, "--output", output.to_s, *arguments, chdir: ROOT.to_s)
-  end
-
-  def test_exports_manifest_groups_and_portable_content
-    Dir.mktmpdir("yss-export-test-") do |directory|
-      output = Pathname.new(directory)
-      stdout, stderr, result = run_export(output)
-
-      assert result.success?, "#{stdout}\n#{stderr}"
-      assert_equal 45, Dir.glob(output.join("skills", "*").to_s).count { |path| File.directory?(path) }
-
-      manifest = JSON.parse(output.join(".yss-export-manifest.json").read)
-      assert_equal 45, manifest.fetch("skills").length
-      assert_operator manifest.fetch("generated_files_sha256").length, :>, 45
-      assert output.join("skills", "yss-prototype-stage", "SKILL.md").file?, "prototype stage contract was not exported"
-      REMOVED_SKILLS.each do |skill_name|
-        refute output.join("skills", skill_name).exist?, "removed skill was exported: #{skill_name}"
-      end
-
-      page = JSON.parse(output.join("skills.sh.json").read)
-      grouped = page.fetch("groupings").flat_map { |group| group.fetch("skills") }
-      assert_equal 45, grouped.uniq.length
-      assert_equal 45, grouped.length
-      assert_includes grouped, "yss-prototype-stage"
-
-      exported_text = Dir.glob(output.join("skills", "**", "*").to_s)
-        .select { |path| File.file?(path) }
-        .map { |path| File.binread(path).force_encoding(Encoding::UTF_8) }
-        .select(&:valid_encoding?)
-        .join("\n")
-      REMOVED_SKILLS.each do |skill_name|
-        pattern = Regexp.new("(?<![a-z0-9-])#{Regexp.escape(skill_name)}(?![a-z0-9-])")
-        refute_match(pattern, exported_text, "removed skill is still referenced: #{skill_name}")
-      end
-
-      formily_examples = output.join("skills", "yss-formily", "references", "examples.md").read
-      assert_includes formily_examples, "../../yss-ui/assets/docs/components/formily.md"
-      refute_includes formily_examples, ".trae/skills"
-      refute_includes formily_examples, "${base_project}"
-
-      datasource = output.join("skills", "yss-db2mybatis", "references", "datasource-config.example.json").read
-      assert_includes datasource, '"password": "CHANGE_ME"'
-      refute_includes datasource, '"password": "root"'
-
-      _, check_stderr, check_result = run_export(output, "--check")
-      assert check_result.success?, check_stderr
-    end
-  end
-
-  def test_check_detects_drift
-    Dir.mktmpdir("yss-export-test-") do |directory|
-      output = Pathname.new(directory)
-      stdout, stderr, result = run_export(output)
-      assert result.success?, "#{stdout}\n#{stderr}"
-
-      skill = output.join("skills", "yss-validation", "SKILL.md")
-      assert_match(/\A---\r?\nname:\s+\S+\r?\ndescription:\s+\S+/, skill.read)
-      skill.open("a") { |file| file.puts("\n<!-- drift -->") }
-      _, check_stderr, check_result = run_export(output, "--check")
-      refute check_result.success?
-      assert_includes check_stderr, "out of date"
-    end
-  end
-
-  def test_rejects_output_that_overlaps_canonical_source
-    source_skill = ROOT.join(".agents", "skills", "yss-validation", "SKILL.md")
-    original = source_skill.binread
-    stdout, stderr, result = run_export(ROOT.join(".agents"))
-
-    refute result.success?
-    assert_includes stderr, "overlap canonical skills"
-    assert_equal original, source_skill.binread
-  end
-
-  def test_check_rejects_template_assets_in_public_root
-    Dir.mktmpdir("yss-export-test-") do |directory|
-      output = Pathname.new(directory)
-      stdout, stderr, result = run_export(output)
-      assert result.success?, "#{stdout}\n#{stderr}"
-
-      output.join("AGENTS.md").write("must not be published\n")
-      _, check_stderr, check_result = run_export(output, "--check")
-      refute check_result.success?
-      assert_includes check_stderr, "forbidden project file"
-    end
-  end
-
-  def test_preserves_executable_source_index_paths
-    Dir.mktmpdir("yss-export-test-") do |directory|
-      output = Pathname.new(directory)
-      stdout, stderr, result = run_export(output)
-      assert result.success?, "#{stdout}\n#{stderr}"
-
-      source_index = Dir.glob(output.join("skills", "yss-source-index", "**", "*").to_s)
-        .select { |path| File.file?(path) }
-        .map { |path| File.binread(path).force_encoding(Encoding::UTF_8) }
-        .select(&:valid_encoding?)
-        .join("\n")
-
-      refute_includes source_index, "/absolute./path"
-      refute_includes source_index, "YSS_SKILLS_ROOT=$YSS_SKILLS_ROOT"
-      refute_match(/YSS_SKILLS_ROOT=(?:[\"']?)\$YSS_SKILLS_ROOT/, source_index)
-      assert_includes source_index, 'export YSS_SKILLS_ROOT="./path/to/yss-skills"'
-      assert_includes source_index, "YSS_SOURCE_ROOT=/absolute/path/to/yss-cloud-microservice"
-    end
-  end
-end