create-yss-spec 2.2.1 → 2.2.3

package/template/scripts/verify-digital-human-roles-scenarios

@@ -0,0 +1,147 @@
+#!/usr/bin/env node
+import { validateDefaultDigitalHumanRoles, validateDigitalHumanRoles, loadDigitalHumanRoles, skillIdsFromRegistry } from "./lib/digital-human-roles.mjs";
+import { loadRegistry } from "./lib/lifecycle-registry.mjs";
+import { loadSkillRegistry } from "./lib/skill-registry.mjs";
+import { validateApprovalRecord, validateApprovalRecordFile } from "./lib/approval-record.mjs";
+
+function clone() {
+  return structuredClone(loadDigitalHumanRoles());
+}
+
+function deps() {
+  const lifecycle = loadRegistry();
+  const skills = loadSkillRegistry();
+  const ids = (records) => new Set(records.map((record) => record.id));
+  return {
+    skillIds: skillIdsFromRegistry(skills),
+    stageIds: ids(lifecycle.stages),
+    gateIds: ids(lifecycle.gates),
+    artifactIds: ids(lifecycle.artifacts),
+    evidenceIds: ids(lifecycle.evidence),
+    workUnitIds: ids(lifecycle.work_units),
+    skillRegistry: skills
+  };
+}
+
+function mustFail(doc, pattern, label) {
+  let failed = false;
+  let message = "";
+  try {
+    validateDigitalHumanRoles(doc, deps());
+  } catch (error) {
+    failed = true;
+    message = error.message;
+  }
+  if (!failed) throw new TypeError(`错误配置未被拒绝: ${label}`);
+  if (!pattern.test(message)) throw new TypeError(`${label} 失败原因不符合预期: ${message}`);
+}
+
+validateDefaultDigitalHumanRoles();
+
+const seven = [
+  "role.lifecycle-orchestrator",
+  "role.requirements-manager",
+  "role.product-manager",
+  "role.business",
+  "role.frontend-engineer",
+  "role.backend-engineer",
+  "role.test-engineer"
+];
+
+const genericAllowsSeven = clone();
+genericAllowsSeven.stage_groups[0].members = seven;
+validateDigitalHumanRoles(genericAllowsSeven, deps());
+
+const grokForbidsSeven = clone();
+grokForbidsSeven.stage_groups[0].members = seven;
+grokForbidsSeven.runtimes.find((runtime) => runtime.id === "runtime.grok").overflow = "forbid";
+mustFail(grokForbidsSeven, /禁止超过 6 人/, "Grok 适配器在 overflow=forbid 时拒绝七人协作组");
+
+const coupled = clone();
+coupled.roles[0].grok_title = "legacy";
+mustFail(coupled, /平台耦合字段/, "角色上残留 grok_title");
+
+const unknownSkill = clone();
+unknownSkill.roles[0].core_skills = ["not-a-registered-skill"];
+mustFail(unknownSkill, /未登记技能/, "未知技能");
+
+const overlap = clone();
+overlap.roles.find((role) => role.id === "role.frontend-engineer").forbidden_skills.push("yss-ui");
+mustFail(overlap, /重叠/, "启用且禁止同一技能");
+
+const selfSign = clone();
+selfSign.gate_policy.dual_digital_human[0].countersigners = ["role.requirements-manager"];
+mustFail(selfSign, /起草者不得会签自己/, "起草者自签");
+
+const releaseByBot = clone();
+releaseByBot.gate_policy.biological_human = ["gate.architecture-reviewed"];
+releaseByBot.gate_policy.digital_human_review.push({
+  gate: "gate.release-ready",
+  countersigners: ["role.product-manager"]
+});
+mustFail(releaseByBot, /gate\.release-ready/, "数字人关闭发布门禁");
+
+const missingSigners = clone();
+missingSigners.gate_policy.digital_human_review[0].countersigners = [];
+mustFail(missingSigners, /countersigners/, "单审门禁缺 countersigners");
+
+const stringReview = clone();
+stringReview.gate_policy.digital_human_review = ["gate.prototype-reviewed"];
+mustFail(stringReview, /必须是含 gate/, "单审门禁仍用字符串名单");
+
+const missingGeneric = clone();
+missingGeneric.runtimes = missingGeneric.runtimes.filter((runtime) => runtime.id !== "runtime.generic");
+mustFail(missingGeneric, /缺少运行时绑定: runtime.generic/, "缺少通用运行时");
+
+validateApprovalRecordFile("docs/templates/approval-record-template.yaml");
+
+const rolesDoc = loadDigitalHumanRoles();
+try {
+  validateApprovalRecord({
+    schema_version: 1,
+    gate_id: "gate.spec-baseline-approved",
+    decision: "approved",
+    actor_kind: "digital-human",
+    role_id: "role.requirements-manager",
+    runtime_id: "runtime.generic",
+    principal_ref: "instance:wrong"
+  }, { rolesDoc });
+  throw new TypeError("错误配置未被拒绝: 错误角色会签");
+} catch (error) {
+  if (!/会签角色必须是/.test(error.message)) throw new TypeError(`错误角色会签 失败原因不符合预期: ${error.message}`);
+}
+
+try {
+  validateApprovalRecord({
+    schema_version: 1,
+    gate_id: "gate.spec-baseline-approved",
+    decision: "approved",
+    actor_kind: "digital-human",
+    role_id: "role.requirements-manager",
+    runtime_id: "runtime.generic",
+    principal_ref: "instance:req",
+    drafter_role_id: "role.requirements-manager"
+  }, { rolesDoc });
+  throw new TypeError("错误配置未被拒绝: 起草者自签会签记录");
+} catch (error) {
+  if (!/会签角色必须是|起草者不得会签自己/.test(error.message)) {
+    throw new TypeError(`起草者自签会签记录 失败原因不符合预期: ${error.message}`);
+  }
+}
+
+try {
+  validateApprovalRecord({
+    schema_version: 1,
+    gate_id: "gate.release-ready",
+    decision: "approved",
+    actor_kind: "digital-human",
+    role_id: "role.product-manager",
+    runtime_id: "runtime.generic",
+    principal_ref: "instance:pm"
+  }, { rolesDoc });
+  throw new TypeError("错误配置未被拒绝: 数字人关发布会签记录");
+} catch (error) {
+  if (!/必须由生物人会签/.test(error.message)) throw new TypeError(`数字人关发布会签记录 失败原因不符合预期: ${error.message}`);
+}
+
+process.stdout.write("数字人角色压力场景验证通过\n");

package/template/scripts/verify-governance-release

@@ -25,11 +25,13 @@ if (isTemplateSource(root)) {
     if (status === "proposed" && !/尚未|未实现|不构成|不能把/.test(body)) failures.push(`${relativePath} 的 proposed ADR 缺少未实施/非当前门禁说明`);
   }
 }
-for (const [relativePath, marker] of Object.entries({
-  "docs/adr/0003-machine-readable-lifecycle-registry.md": "状态：部分实施（Phase 1）",
-  "docs/adr/0006-stable-lifecycle-ids-and-generated-structure.md": "状态：部分实施（Phase 1）"
-})) {
-  if (!read(relativePath).includes(marker)) failures.push(`${relativePath} 未声明当前实现状态`);
+if (isTemplateSource(root)) {
+  for (const [relativePath, marker] of Object.entries({
+    ".template-source/adr/0003-machine-readable-lifecycle-registry.md": "状态：部分实施（Phase 1）",
+    ".template-source/adr/0006-stable-lifecycle-ids-and-generated-structure.md": "状态：部分实施（Phase 1）"
+  })) {
+    if (!read(relativePath).includes(marker)) failures.push(`${relativePath} 未声明当前实现状态`);
+  }
 }
 if (!read("scripts/verify-lifecycle-scenarios").includes("ROUTE_REGISTRY_IDS")) failures.push("生命周期场景未校验稳定 ID 映射");
 if (failures.length > 0) {

package/template/scripts/verify-lifecycle-checkpoint

@@ -5,6 +5,7 @@ import path from "node:path";
 import { parseArgs } from "node:util";
 import { fileURLToPath } from "node:url";
 import { parseDocument } from "./vendor/yaml.mjs";
+import { assertCheckpointApprovals } from "./lib/approval-record.mjs";
 
 const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
 const schemaPath = path.join(root, "docs/process/schemas/lifecycle-checkpoint.schema.json");
@@ -30,6 +31,7 @@ try {
   const value = document.toJS({ maxAliasCount: 0 });
   const result = spawnSync("python3", ["-c", validator, schemaPath], { cwd: root, encoding: "utf8", input: JSON.stringify(value) });
   if (result.status !== 0) throw new TypeError(`${result.stdout}${result.stderr}`.trim());
+  assertCheckpointApprovals(value, sourcePath);
   process.stdout.write("生命周期 checkpoint 验证通过\n");
 } catch (error) {
   process.stderr.write(`生命周期 checkpoint 验证失败: ${error.message}\n`);

package/template/scripts/verify-template

@@ -5,7 +5,7 @@ ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
 cd "$ROOT_DIR"
 node -e 'const [major]=process.versions.node.split(".").map(Number); if (major < 22 || major >= 27) { console.error("模板工具需要 Node >=22 <27"); process.exit(1); }'
 
-required_files=(yss-project.yaml AGENTS.md CONTEXT.md skills-lock.json docs/agents/yss-skill-registry.yaml docs/process/lifecycle-registry.yaml docs/process/lifecycle-registry-baseline.json docs/process/maintenance-intensity.yaml docs/process/schemas/lifecycle-checkpoint.schema.json docs/process/schemas/frontend-implementation-evidence.schema.json docs/process/templates/lifecycle-checkpoint-template.yaml docs/process/templates/frontend-implementation-plan-template.yaml docs/process/templates/frontend-implementation-verification-template.yaml scripts/repository-mode scripts/implementation-path-policy scripts/repository-scope-policy scripts/sync-skills scripts/update-skill-lock scripts/generate-lifecycle-artifacts scripts/verify-lifecycle-registry scripts/verify-lifecycle-checkpoint scripts/verify-frontend-implementation-evidence scripts/verify-maintenance-checkpoint scripts/verify-maintenance-intensity-scenarios scripts/verify-skill-registry scripts/verify-skill-governance scripts/verify-yss-dto-openapi-profile scripts/verify-yss-dto-openapi-scenarios scripts/export-yss-skills)
+required_files=(yss-project.yaml AGENTS.md CONTEXT.md skills-lock.json docs/agents/yss-skill-registry.yaml docs/agents/digital-human-roles.yaml docs/process/lifecycle-registry.yaml docs/process/lifecycle-registry-baseline.json docs/process/maintenance-intensity.yaml docs/process/schemas/lifecycle-checkpoint.schema.json docs/process/schemas/frontend-implementation-evidence.schema.json docs/process/templates/lifecycle-checkpoint-template.yaml docs/process/templates/frontend-implementation-plan-template.yaml docs/process/templates/frontend-implementation-verification-template.yaml scripts/repository-mode scripts/implementation-path-policy scripts/repository-scope-policy scripts/sync-skills scripts/update-skill-lock scripts/generate-lifecycle-artifacts scripts/verify-lifecycle-registry scripts/verify-lifecycle-checkpoint scripts/verify-frontend-implementation-evidence scripts/verify-maintenance-checkpoint scripts/verify-maintenance-intensity-scenarios scripts/verify-skill-registry scripts/verify-skill-governance scripts/verify-yss-dto-openapi-profile scripts/verify-yss-dto-openapi-scenarios scripts/verify-digital-human-roles scripts/verify-digital-human-roles-scenarios scripts/verify-approval-record scripts/export-yss-skills)
 for required in "${required_files[@]}"; do test -f "$required" || { echo "缺少模板必需文件: $required" >&2; exit 1; }; done
 
 repository_mode="$(scripts/repository-mode)"
@@ -22,6 +22,9 @@ scripts/verify-skill-registry
 scripts/verify-skill-governance
 scripts/verify-yss-dto-openapi-profile
 scripts/verify-yss-dto-openapi-scenarios
+scripts/verify-digital-human-roles
+scripts/verify-digital-human-roles-scenarios
+scripts/verify-approval-record docs/templates/approval-record-template.yaml
 scripts/verify-lifecycle-registry
 scripts/verify-lifecycle-checkpoint docs/process/templates/lifecycle-checkpoint-template.yaml
 scripts/verify-frontend-implementation-evidence --allow-template docs/process/templates/frontend-implementation-plan-template.yaml
@@ -39,7 +42,7 @@ scripts/verify-yss-ui-scenarios
 scripts/verify-openapi-yaml-first-scenarios
 scripts/verify-openapi-json-handoff-scenarios
 
-for entry in scripts/sync-skills scripts/update-skill-lock scripts/generate-lifecycle-artifacts scripts/verify-lifecycle-registry scripts/verify-lifecycle-checkpoint scripts/verify-frontend-implementation-evidence scripts/verify-maintenance-checkpoint scripts/verify-maintenance-intensity-scenarios scripts/verify-skill-registry scripts/verify-skill-governance scripts/verify-yss-dto-openapi-profile scripts/verify-yss-dto-openapi-scenarios scripts/verify-lifecycle-scenarios scripts/verify-matt-yss-integration-scenarios scripts/verify-prototype-backend-scaffold-scenarios scripts/verify-yss-router-scenarios scripts/verify-openapi-yaml-first-scenarios scripts/verify-openapi-json-handoff-scenarios scripts/verify-repository-scope-scenarios scripts/export-yss-skills; do node --check "$entry"; done
+for entry in scripts/sync-skills scripts/update-skill-lock scripts/generate-lifecycle-artifacts scripts/verify-lifecycle-registry scripts/verify-lifecycle-checkpoint scripts/verify-frontend-implementation-evidence scripts/verify-maintenance-checkpoint scripts/verify-maintenance-intensity-scenarios scripts/verify-skill-registry scripts/verify-skill-governance scripts/verify-yss-dto-openapi-profile scripts/verify-yss-dto-openapi-scenarios scripts/verify-digital-human-roles scripts/verify-digital-human-roles-scenarios scripts/verify-approval-record scripts/verify-lifecycle-scenarios scripts/verify-matt-yss-integration-scenarios scripts/verify-prototype-backend-scaffold-scenarios scripts/verify-yss-router-scenarios scripts/verify-openapi-yaml-first-scenarios scripts/verify-openapi-json-handoff-scenarios scripts/verify-repository-scope-scenarios scripts/export-yss-skills; do node --check "$entry"; done
 
 legacy_runtime="ru""by"
 script_roots=(scripts)

package/template/skills-lock.json

@@ -1398,7 +1398,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-product-lifecycle/SKILL.md",
-        "effectiveHash": "6b5ca6ad3453abf2b4794569853ffc4a1c5a625adee4428373fc690c729fee20",
+        "effectiveHash": "4c2f7c8d008397e0bfe134461e1e5ea7eadbbe91c18966bce68ae506b7166569",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1462,7 +1462,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-router/SKILL.md",
-        "effectiveHash": "f78b0264ff4e381fa5ca64b65a08de501e6f3580f00d186e7dd28d3da252769f",
+        "effectiveHash": "a43355c7d8a1a5016d75af084328a4cfbb758aa5bf022b644d215c0e868b5bfa",
         "targets": [
           ".agents/skills",
           ".claude/skills",

package/template.manifest.json

@@ -1,4 +1,31 @@
 {
+  "allowRootEntries": [
+    ".agents",
+    ".claude",
+    ".codex",
+    ".cursor",
+    ".hermes",
+    ".pi",
+    ".qoder",
+    ".trae",
+    "docs",
+    "scripts"
+  ],
+  "allowRootFiles": [
+    ".cursorrules",
+    ".gitignore",
+    ".nvmrc",
+    "AGENTS.md",
+    "CLAUDE.md",
+    "CONTEXT.md",
+    "README.md",
+    "skills-lock.json",
+    "yss-project.yaml",
+    "yss-public-skills.json"
+  ],
+  "allowFiles": [
+    "docs/adr/README.md"
+  ],
   "excludeRootEntries": [
     ".git",
     ".codegraph",
@@ -27,7 +54,8 @@
     ".pi/settings.json",
     ".cursor/environment.json",
     "docs/.scratch",
-    "docs/reviews"
+    "docs/reviews",
+    "docs/adr"
   ],
   "renderPaths": [
     "AGENTS.md",
@@ -37,13 +65,8 @@
   "exampleDocPaths": [
     "docs/discovery/IDEATION.md"
   ],
-  "initExcludeRootEntries": [
-    "scripts",
-    "wiki"
-  ],
+  "initExcludeRootEntries": [],
   "initExcludeRootFiles": [
-    ".gitignore",
-    ".nvmrc",
     "yss-public-skills.json"
   ],
   "initExcludePaths": []

package/template.snapshot.json

@@ -3,14 +3,15 @@
   "templateName": "yss-spec-project-template",
   "templateSource": "github:iloveZzz/yss-spec-project-template",
   "templateRepository": "https://github.com/iloveZzz/yss-spec-project-template.git",
-  "requestedRef": "23757463ec4b20d171a3ff57733b62322efb63f3",
-  "templateCommit": "23757463ec4b20d171a3ff57733b62322efb63f3",
+  "requestedRef": "030d8062634018880a3422fd55065d8d8e61e41e",
+  "templateCommit": "030d8062634018880a3422fd55065d8d8e61e41e",
+  "manifestHash": "10d161eb3f0e426aeefad5d0b9e6c5522d8a4dbacb9edf6ed64285dcb40b1a65",
   "encodedPaths": {
     ".codex/skills/data-analytics/.gitignore": ".codex/skills/data-analytics/__yss_dotfile__.gitignore",
     ".codex/skills/product-design/.npmignore": ".codex/skills/product-design/__yss_dotfile__.npmignore",
     ".codex/skills/product-design/templates/prototype/.npmrc": ".codex/skills/product-design/templates/prototype/__yss_dotfile__.npmrc",
     ".gitignore": "__yss_dotfile__.gitignore"
   },
-  "snapshotHash": "de73b793e4cc485b14abef0697b048c5796469ee63b028e673403168b2eb3e52",
-  "generatedAt": "2026-08-25T01:20:02.364Z"
+  "snapshotHash": "be94c1d18bbfdbf58971964288ecc5ec2fc3607e80537cb46b667d645df74006",
+  "generatedAt": "2026-08-26T10:05:21.409Z"
 }

package/template/docs/adr/0001-product-design-prototype-entrypoint.md

@@ -1,54 +0,0 @@
-# ADR-0001: 使用 product-design:index 作为产品原型主入口
-
-## 状态
-
-已接受
-
-## 日期
-
-2026-07-06
-
-## 背景
-
-YSS Harness 需要把有 UI 功能的产品原型产出收敛到一个稳定入口，同时保留需求质询、设计系统、Ant Design v6 事实校验、原型评审和用户确认门禁。原有 `product-design-prototype`、`wireframe-prototype`、`high-fidelity-html-prototype` 容易被理解为并列主入口，导致 Agent 在不同阶段选择不同原型工具，难以保证高保真 HTML 原型、AntD v6 校验证据和用户确认记录一致落地。
-
-## 决策
-
-产品原型产出统一以 `product-design:index` 为主入口。该 skill 只负责路由，实际按 Product Design plugin 规则进入 `$get-context`、`$ideate`、`$prototype`、`$image-to-code`、`$url-to-code`、`$design-qa` 或 `$share` 等 focused skill。
-
-`grill-with-docs` 保留为前置需求质询和领域边界澄清工具，不承担 HTML 原型产出。`antd` skill / `antd` CLI 作为 Ant Design v6 组件、demo、token、semantic 和 design.md 的事实来源。YSS 生命周期继续负责 `prototype-review`、用户确认、Spec 回填和 OpenAPI Draft 门禁。
-
-## 考虑的替代方案
-
-| 方案 | 优点 | 缺点 | 结论 |
-|------|------|------|------|
-| 继续使用多个原型技能并列入口 | 对旧流程改动少 | Agent 路由不稳定，难以统一 AntD v6 高保真 HTML 原型和确认记录 | 放弃 |
-| 只保留 `high-fidelity-html-prototype` | 产物目标直接 | 缺少 Product Design plugin 的上下文、视觉探索、URL / 图片 / 代码来源路由能力 | 放弃 |
-| 以 `product-design:index` 为主入口，只保留仍有迁移价值的兼容入口 | 路由统一，可复用 focused skills，并允许逐步退休冗余入口 | 需要在文档中明确 legacy 边界 | 采纳 |
-
-## 后果
-
-### 正面影响
-
-- 有 UI 的产品原型产出入口统一。
-- 高保真 HTML 原型、AntD CLI 校验证据和用户确认记录成为固定门禁。
-- Figma / Axure / Excalidraw / 截图 / URL 可作为输入来源，而不是主交付格式。
-
-### 负面影响
-
-- 需要维护完整 `.codex/skills/product-design/` 插件目录，不能只复制 `index/SKILL.md`。
-- 部分旧原型技能在过渡期仍会存在，需要通过流程文档限制使用语境；无继续维护价值的入口直接退休，不保留空壳目录。
-
-### 风险
-
-- 如果 Agent 未读取 Product Design focused skill，可能误把 `product-design:index` 当作直接产出技能。
-- 如果跳过 `antd` CLI 查询，原型可能偏离 Ant Design v6 组件 API 或 token。
-- 如果缺少用户确认记录，下游 Spec 校准和 OpenAPI Draft 会失去体验冻结依据。
-
-## 相关
-
-- `AGENTS.md`
-- `docs/design/README.md`
-- `docs/process/lifecycle-artifact-map.md`
-- `docs/design/README.md`
-- `docs/design/templates/prototype-confirmation-template.md`

package/template/docs/adr/0002-yss-project-repository-mode.md

@@ -1,3 +0,0 @@
-# ADR-0002: 使用 `yss-project.yaml` 声明仓库身份
-
-模板源仓库与模板实例仓库共享大部分目录和流程资产，仅靠目录、Git 远程或占位符推断身份会导致 Agent 选错流程。因此在根目录使用 `yss-project.yaml` 作为 CLI 与 Agent 共享的稳定契约，只声明 `schema_version` 和 `repository_mode`：模板源仓库使用 `template-source`，`create-yss-spec` 生成的仓库使用 `project-instance`。项目名称、团队规模和 Tracker 等易变信息不放入该清单，避免形成新的重复配置源。

package/template/docs/adr/0003-machine-readable-lifecycle-registry.md

@@ -1,5 +0,0 @@
-# ADR-0003: 使用机器可读生命周期注册表作为结构化事实源
-
-> 状态：部分实施（Phase 1）。本次发布只接受注册表、稳定 ID、结构表和工作单元表的 shadow 校验；数量、索引、依赖图和测试 fixture 的完整生成属于后续提案，未实现前不得作为模板发布能力宣称。
-
-YSS 研发操作系统当前在 Markdown 生命周期地图、主控 skill、机器契约、用户指南和场景测试中重复表达阶段、门禁、产物与工作单元，已经出现门禁数量和工作单元数量漂移。Phase 1 引入生命周期注册表，集中保存这些结构事实及稳定标识，并由它派生当前 Markdown 结构表；Markdown 继续承担人工解释和审查，ADR 继续记录取舍，业务语义不被压缩成难读的配置。数量、索引、依赖图和测试 fixture 的自动生成必须在独立 Phase 中与生成器和校验器一并落地，不能只通过 ADR 宣告完成。

package/template/docs/adr/0006-stable-lifecycle-ids-and-generated-structure.md

@@ -1,5 +0,0 @@
-# ADR-0006: 使用稳定命名空间 ID 并派生生命周期结构资产
-
-> 状态：部分实施（Phase 1）。稳定 ID、发布基线和两份结构视图已受管；索引、依赖图和测试 fixture 的完整生成属于后续提案，未实现前不得把人工维护的场景断言称为派生产物。
-
-生命周期对象的中文名称、展示顺序和数量会随流程演进而变化，不能继续用“第几个门禁”或表格行数作为兼容身份。Phase 1 为主阶段、门禁、产物、工作单元和证据分别使用 `stage.*`、`gate.*`、`artifact.*`、`work-unit.*`、`evidence.*` 稳定 ID，并由 `docs/process/lifecycle-registry.yaml` 生成当前结构表；用户指南、ADR 和实践说明继续人工维护并引用稳定 ID。数量、索引、依赖图和测试 fixture 必须在后续 Phase 通过同一生成器和 `--check` 一并交付。已发布 ID 不复用，语义变化通过弃用记录和 schema 迁移表达，以牺牲直接编辑派生表格的便利换取跨版本引用稳定性。

package/template/docs/adr/0007-lifecycle-native-work-units.md

@@ -1,5 +0,0 @@
-# ADR-0007: 生命周期使用原生工作单元并保留 Matt 兼容入口
-
-`yss-product-lifecycle` 作为 YSS 研发生命周期的唯一默认入口，持有阶段、产物状态、门禁和正式资产所有权。Spec 综合、Ticket 正式化和切片实现使用生命周期注册表中的原生工作单元；`to-spec`、`to-tickets`、`implement` 保留为用户显式调用的兼容输入，结果必须回交生命周期验收，生命周期不得自动调用这些 user-invoked skills。
-
-该选择避免用户手动记忆阶段切换，也避免 Matt 默认的 `ready-for-agent`、commit 等行为越过 YSS 门禁和授权。代价是生命周期需要维护原生工作单元路由和兼容适配，但两者在 `work_unit_routes` 中共享一个稳定工作单元身份、使用互斥的 `native` / `compatibility` 路由，不再形成两套执行定义。