create-yss-spec 3.5.3 → 3.5.4

package/template/.template-spec/design/tokens/variables.css

@@ -1,4 +1,166 @@
 :root {
+  --yss-components-workspace-detail-background-color: #ffffff;
+  --yss-components-workspace-detail-width: 384px;
+  --yss-components-workspace-tabs-background-color: #ffffff;
+  --yss-components-workspace-tabs-height: 32px;
+  --yss-components-workspace-sidebar-collapsed-width: 64px;
+  --yss-components-workspace-sidebar-background-color: #ffffff;
+  --yss-components-workspace-sidebar-width: 240px;
+  --yss-components-workspace-header-background-color: #ffffff;
+  --yss-components-workspace-header-height: 48px;
+  --yss-components-card-compact-padding: 16px;
+  --yss-components-card-compact-rounded: 8px;
+  --yss-components-card-compact-text-color: rgba(0, 0, 0, 0.88);
+  --yss-components-card-compact-background-color: #ffffff;
+  --yss-components-button-large-height: 40px;
+  --yss-components-button-small-height: 24px;
+  --yss-components-button-compact-height: 28px;
+  --yss-components-card-default-padding: 20px;
+  --yss-components-card-default-rounded: 8px;
+  --yss-components-card-default-text-color: rgba(0, 0, 0, 0.88);
+  --yss-components-card-default-background-color: #ffffff;
+  --yss-components-secondary-copy-text-color: rgba(0, 0, 0, 0.65);
+  --yss-components-badge-error-solid-padding: 4px 8px;
+  --yss-components-badge-error-solid-rounded: 4px;
+  --yss-components-badge-error-solid-text-color: #000000;
+  --yss-components-badge-error-solid-background-color: #f5222d;
+  --yss-components-badge-warning-solid-padding: 4px 8px;
+  --yss-components-badge-warning-solid-rounded: 4px;
+  --yss-components-badge-warning-solid-text-color: #000000;
+  --yss-components-badge-warning-solid-background-color: #faad14;
+  --yss-components-badge-success-solid-padding: 4px 8px;
+  --yss-components-badge-success-solid-rounded: 4px;
+  --yss-components-badge-success-solid-text-color: #000000;
+  --yss-components-badge-success-solid-background-color: #52c41a;
+  --yss-components-badge-processing-solid-padding: 4px 8px;
+  --yss-components-badge-processing-solid-rounded: 4px;
+  --yss-components-badge-processing-solid-text-color: #000000;
+  --yss-components-badge-processing-solid-background-color: #3371ff;
+  --yss-components-alert-info-padding: 8px 12px;
+  --yss-components-alert-info-rounded: 4px;
+  --yss-components-alert-info-text-color: rgba(0, 0, 0, 0.88);
+  --yss-components-alert-info-background-color: #e6f4ff;
+  --yss-components-alert-error-padding: 8px 12px;
+  --yss-components-alert-error-rounded: 4px;
+  --yss-components-alert-error-text-color: rgba(0, 0, 0, 0.88);
+  --yss-components-alert-error-background-color: #fff2f0;
+  --yss-components-alert-warning-padding: 8px 12px;
+  --yss-components-alert-warning-rounded: 4px;
+  --yss-components-alert-warning-text-color: rgba(0, 0, 0, 0.88);
+  --yss-components-alert-warning-background-color: #fffbe6;
+  --yss-components-alert-success-padding: 8px 12px;
+  --yss-components-alert-success-rounded: 4px;
+  --yss-components-alert-success-text-color: rgba(0, 0, 0, 0.88);
+  --yss-components-alert-success-background-color: #f6ffed;
+  --yss-components-page-shell-padding: 16px;
+  --yss-components-page-shell-text-color: rgba(0, 0, 0, 0.88);
+  --yss-components-page-shell-background-color: #f0f2f5;
+  --yss-components-button-primary-active-height: 32px;
+  --yss-components-button-primary-active-padding: 4px 12px;
+  --yss-components-button-primary-active-rounded: 6px;
+  --yss-components-button-primary-active-text-color: #ffffff;
+  --yss-components-button-primary-active-background-color: #0958d9;
+  --yss-components-modal-default-padding: 16px;
+  --yss-components-modal-default-rounded: 8px;
+  --yss-components-modal-default-text-color: rgba(0, 0, 0, 0.88);
+  --yss-components-modal-default-background-color: #ffffff;
+  --yss-components-table-row-selected-padding: 8px 12px;
+  --yss-components-table-row-selected-text-color: rgba(0, 0, 0, 0.88);
+  --yss-components-table-row-selected-background-color: #e6f4ff;
+  --yss-components-table-header-padding: 8px 12px;
+  --yss-components-table-header-text-color: rgba(0, 0, 0, 0.88);
+  --yss-components-table-header-background-color: #fafafa;
+  --yss-components-input-error-height: 32px;
+  --yss-components-input-error-padding: 4px 8px;
+  --yss-components-input-error-rounded: 6px;
+  --yss-components-input-error-text-color: rgba(0, 0, 0, 0.88);
+  --yss-components-input-error-background-color: #ffffff;
+  --yss-components-input-default-height: 32px;
+  --yss-components-input-default-padding: 4px 8px;
+  --yss-components-input-default-rounded: 6px;
+  --yss-components-input-default-text-color: rgba(0, 0, 0, 0.88);
+  --yss-components-input-default-background-color: #ffffff;
+  --yss-components-button-default-height: 32px;
+  --yss-components-button-default-padding: 4px 12px;
+  --yss-components-button-default-rounded: 6px;
+  --yss-components-button-default-text-color: rgba(0, 0, 0, 0.88);
+  --yss-components-button-default-background-color: #ffffff;
+  --yss-components-button-primary-disabled-height: 32px;
+  --yss-components-button-primary-disabled-padding: 4px 12px;
+  --yss-components-button-primary-disabled-rounded: 6px;
+  --yss-components-button-primary-disabled-text-color: rgba(0, 0, 0, 0.45);
+  --yss-components-button-primary-disabled-background-color: #f0f0f0;
+  --yss-components-button-primary-hover-height: 32px;
+  --yss-components-button-primary-hover-padding: 4px 12px;
+  --yss-components-button-primary-hover-rounded: 6px;
+  --yss-components-button-primary-hover-text-color: #ffffff;
+  --yss-components-button-primary-hover-background-color: #2f68eb;
+  --yss-components-button-primary-height: 32px;
+  --yss-components-button-primary-padding: 4px 12px;
+  --yss-components-button-primary-rounded: 6px;
+  --yss-components-button-primary-text-color: #ffffff;
+  --yss-components-button-primary-background-color: #245bdb;
+  --yss-components-separator-height: 1px;
+  --yss-components-separator-background-color: #d9d9d9;
+  --yss-spacing-xxl: 48px;
+  --yss-spacing-xl: 32px;
+  --yss-spacing-lg: 24px;
+  --yss-spacing-card: 20px;
+  --yss-spacing-md: 16px;
+  --yss-spacing-sm: 12px;
+  --yss-spacing-xs: 8px;
+  --yss-spacing-xxs: 4px;
+  --yss-rounded-pill: 9999px;
+  --yss-rounded-lg: 8px;
+  --yss-rounded-md: 6px;
+  --yss-rounded-sm: 4px;
+  --yss-rounded-none: 0px;
+  --yss-typography-button-line-height: 1.571;
+  --yss-typography-button-font-weight: 600;
+  --yss-typography-button-font-size: 14px;
+  --yss-typography-button-font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif;
+  --yss-typography-caption-line-height: 1.571;
+  --yss-typography-caption-font-weight: 400;
+  --yss-typography-caption-font-size: 12px;
+  --yss-typography-caption-font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif;
+  --yss-typography-heading-md-line-height: 1.333;
+  --yss-typography-heading-md-font-weight: 600;
+  --yss-typography-heading-md-font-size: 18px;
+  --yss-typography-heading-md-font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif;
+  --yss-typography-heading-lg-line-height: 1.333;
+  --yss-typography-heading-lg-font-weight: 600;
+  --yss-typography-heading-lg-font-size: 24px;
+  --yss-typography-heading-lg-font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif;
+  --yss-typography-body-strong-line-height: 1.571;
+  --yss-typography-body-strong-font-weight: 600;
+  --yss-typography-body-strong-font-size: 14px;
+  --yss-typography-body-strong-font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif;
+  --yss-typography-body-line-height: 1.571;
+  --yss-typography-body-font-weight: 400;
+  --yss-typography-body-font-size: 14px;
+  --yss-typography-body-font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif;
+  --yss-colors-info-bg: #e6f4ff;
+  --yss-colors-error-bg: #fff2f0;
+  --yss-colors-error: #f5222d;
+  --yss-colors-warning-bg: #fffbe6;
+  --yss-colors-warning: #faad14;
+  --yss-colors-success-bg: #f6ffed;
+  --yss-colors-success: #52c41a;
+  --yss-colors-border-secondary: #f0f0f0;
+  --yss-colors-border: #d9d9d9;
+  --yss-colors-surface-subtle: #fafafa;
+  --yss-colors-surface-elevated: #ffffff;
+  --yss-colors-surface: #ffffff;
+  --yss-colors-canvas-layout: #f0f2f5;
+  --yss-colors-text-tertiary: rgba(0, 0, 0, 0.45);
+  --yss-colors-text-secondary: rgba(0, 0, 0, 0.65);
+  --yss-colors-text: rgba(0, 0, 0, 0.88);
+  --yss-colors-on-primary: #ffffff;
+  --yss-colors-primary-bg: #e6f4ff;
+  --yss-colors-primary-active: #0958d9;
+  --yss-colors-primary-control-hover: #2f68eb;
+  --yss-colors-primary-control: #245bdb;
+  --yss-colors-primary: #3371ff;
   --yss-card-padding: 20px;
   --yss-control-height: 32px;
   --yss-color-primary-control: #245bdb;

package/template/.template-spec/plan/templates/plan-template.md

@@ -1,4 +1,5 @@
 ---
+content_profile: plan-spec-v1
 pipeline: <feature-id>
 stage: plan
 status: draft
@@ -20,6 +21,20 @@ owner: <负责人>
 - 期望结果、成功标准及验证方式：
 - 约束、假设及事实证据：
 
+### 成功标准
+
+命中方案决策包时，把指标定义、基线或未知原因、目标及确认状态、观测窗口、数据来源、验证方式和补齐动作写入现有 `success_criteria[].statement`；本 Plan 仅在下表引用其稳定 ID。诊断读取 statement 原文，完整性由人工审阅，不扩展 YAML schema。未命中该合同时采用下方轻量表，两种形式按实际情况选用。
+
+| ID | 权威引用 |
+|---|---|
+| success-criterion.<稳定标识> | <项目根相对路径> :: id:success-criterion.<稳定标识> |
+
+轻量表（仅未命中方案决策包时填写）：
+
+| ID | 指标定义 | 基线或未知原因 | 目标 | 确认状态 | 观测窗口 | 数据来源 | 验证方式 | 未决项 |
+|---|---|---|---|---|---|---|---|---|
+| SC-001 | <填写> | <填写> | <填写或未知> | 候选 / 已确认 | <填写> | <资产路径> :: heading:<准确章节名> | <填写> | Q-001 / 无 |
+
 ## 2. 输入与复用依据
 
 | 资产 / 证据引用 | 版本 | 本次仍有效的依据 | 需要重新探索的部分 |
@@ -40,6 +55,13 @@ owner: <负责人>
 | 能力 / 范围 | MVP / 非目标 | 优先级及依据 | 成功信号 |
 |---|---|---|---|
 
+### 关键取舍
+
+影响 MVP、业务边界或难以逆转的决定，记录真实候选、选择理由、主要代价和重新考虑条件；不凑固定数量。已有决策包时复用 `decision.*` 引用，仅在未命中时直接记录下表。
+
+| 决定 / 权威引用 | 真实候选 | 本期选择及理由 | 主要代价 | 重新考虑条件 |
+|---|---|---|---|---|
+
 ## 5. 下游影响与交接
 
 | 下游阶段 / 接收方 | 输入引用 | 责任人 | 待细化内容 | 命中门禁 |
@@ -49,7 +71,7 @@ owner: <负责人>
 
 ## 6. 未决项
 
-| 问题 | 是否影响业务边界 / 关键规则 / MVP | 判断依据 | 责任人 | 解决时点 | 接收方 / 解决证据 |
+| ID | 问题 | 是否影响业务边界 / 关键规则 / MVP | 判断依据 | 责任人 | 解决时点 | 接收方 / 解决证据 |
 |---|---|---|---|---|---|
 
 ## 7. 退出核查与用户决定
@@ -60,3 +82,5 @@ owner: <负责人>
 - 当前资产版本、确认范围和原始用户决定引用：
 - 结论：ready-for-human / blocked / 已满足进入 Spec 的条件（附证据）。
 - 下一工作单元：
+
+表达约定与只读诊断见 [Plan / Spec 内容诊断](../../process/plan-spec-quality.md)。`content_profile` 可选，仅声明创作格式；检查结果不改变既有门禁或批准。

package/template/.template-spec/process/business-tickets.md

@@ -0,0 +1,48 @@
+# Spec 业务拆分与实现 Slice 衔接
+
+结构化阶段、产物和工作单元以 `lifecycle-registry.yaml` 为准。本协议不新增主阶段、Skill 或常规人工批准节点。
+
+## 流程与职责
+
+Spec 综合同时起草业务 Ticket；完成条件是可读取的集合和 FR/AC 覆盖。Design 按页面流、状态、失败与恢复路径校准原 Ticket，保持稳定 ID。无产品设计影响时记录不适用依据并进入业务正式化，不生成空原型。尚未批准、尚未冻结、缺工程是待满足前置，不能写为不适用。
+
+业务正式化消费当前 Spec、适用的产品设计批准和独立专业审查。语义不变按现有授权延续协议核验；范围、规则、验收或风险实质变化交回原决定边界。全生命周期随后进入技术分析；本地已确认资产直接消费，无需导出再导入自己。独立 Design profile 到战略交接结束。
+
+研发可以在技术分析期间形成实现 Slice 草案。正式实现 Slice 仍需当前工程契约、实现仓库准备、Slice 合同批准和完整就绪检查。业务票只能为 `draft` 或 `ready-for-human`，不能授予实现权限。业务票与阶段工作项即使移动到 `issues/` 仍不能作为实现票。
+
+## 文件合同
+
+功能包中每票一份 `business-tickets/BT-<id>.md`，集合为 `business-ticket-set.yaml`；实现票保留 `issues/`。使用共享 business-ticket、business-ticket-set、business-ticket-review 模板及 `schemas/business-tickets-v1.schema.json`。集合只保存引用、版本、原字节 SHA-256 和覆盖处置；Spec、map、父 Ticket、checkpoint 均引用同一集合。先固定 Spec 内容再计算其摘要；Spec 只写集合路径，不能嵌入集合摘要造成循环。
+
+业务票按用户行为与可验收结果划分，不机械地每条 FR 一票，也不按 Controller、Service、Repository 分票。每票关联原始 FR/NFR、AC 和 Spec 版本/摘要。适用规则、场景、设计放入 source_refs，包含 ref/version/digest 以及精确 locator 和 locator_kind（id 或 heading）；不适用需在正文说明并由专业审查判定。版本是作者登记的稳定版本，digest 校验实际字节，二者不能互相替代。
+
+草案可有具名未决项，但不得静默漏掉需求。暂不能分票的需求在 coverage_deferred 记录 reason、risk、owner、target_version、followup_ticket_ref、verification_plan；正式化还需绑定已有有效决定，不补造历史批准。专业审查检查业务粒度、行为完整性、语义保真和延期授权；校验器仅证明结构、引用与摘要，不用文本相似度判断业务正确性。
+
+```sh
+node scripts/verify-business-tickets docs/.scratch/<feature>/business-ticket-set.yaml --root . --mode draft --json
+node scripts/verify-business-tickets docs/.scratch/<feature>/business-ticket-set.yaml --root . --mode formal --json
+```
+
+命令只读，0 表示所选结构检查通过，1 表示阻断，2 表示命令错误；任何结果都不批准资产、不设置 ready-for-agent。正式检查需要绑定当前集合摘要的独立专业审查；真实批准仍由生命周期原验证器核验。
+
+## 实现承接与变化
+
+实现票 frontmatter 声明 `kind: vertical-slice-ticket`、`business_ticket_set_ref`、`business_ticket_refs`（稳定 ID 数组）、`acceptance_refs`（原始 AC 数组）。编译器将集合加入 Slice v3 既有 basis.business_ticket_set；acceptance 必须仍指向原始 Spec 的 AC，且属于所引用业务票。一个业务票可对应多个 Slice，汇总时按 AC 覆盖集合计算，不能把一个子 Slice 完成当成业务票全部完成。
+
+接收方保留既有战略交接、词汇对账以及规则/场景到技术设计的映射。来源变化沿已登记依赖影响 Ticket/Slice；依赖缺失或未知时阻断相关整个范围。集合、Spec 或其他全局依据变化尚不能确定局部影响时保守阻断，不能无依据缩小。
+
+## 批准与交接兼容
+
+Handoff v5 外层结构不变。新 Design 源角色策略声明 required_capabilities: [business-ticket-approval-v1]，最终业务集合绑定 `gate.strategic-design-handoff-approved` 的当前资产批准；不能借用更早的 Plan 批准。旧工具拒绝未知能力。无能力声明的历史包沿原策略只读核验，不能补写历史 Plan 回复。包导出必须包含集合、票据、专业审查、原始来源和延期证据闭包。
+
+## 启用、迁移与回退
+
+新项目 tracker frontmatter 默认 `business_ticket_version: 1`。旧项目缺失配置时状态显示 legacy-unassessed，不自动判断已拆分，也不自动启用。显式迁移时保留原资产与批准，补齐当前业务草案、校准/审查及引用，再启用版本配置；同步工具不得覆盖用户 tracker。旧 Spec 格式不能机械解析时报告 unassessed，先显式适配内容格式，不能推断覆盖为空或已完成。
+
+回退可停用新规则入口但保留业务资产和读取能力。类型隔离、显式来源绑定与新能力拒绝始终有效；不得把业务票降格解释为旧实现票。
+
+## 状态投影
+
+`lifecycle-status` 分别展示业务拆分、实现拆分、实现就绪与批准未验证状态。阶段工作项 completed 仅表示该工作项完成。map/父 Ticket 引用集合，不复制正文；声明已同步时绑定当前集合 digest，过期则报告 sync-stale，不能改写历史批准。缺业务拆分、缺工程前置、tracker 状态过期和 checkpoint 失败分别报告。
+
+实现映射汇总可在上述命令追加多个 `--slice-ticket <issues/ref.md>`，输出每个业务票的 AC→Slice 引用和未映射 AC；covered 仅指映射覆盖，不代表任何实现已完成。接收方可直接使用既有导入协议下的 `docs/handoffs/<id>/<version>/package/payload/files/` 业务集合引用，校验器在不可变源根内解析绑定，并继续保留目标仓的批准/接收门禁。

package/template/.template-spec/process/checkpoint-boundary.yaml

@@ -0,0 +1,73 @@
+{
+  "schema_version": 1,
+  "derived_from": ".agents/skills/yss-product-lifecycle/references/orchestration-contract.yaml",
+  "phase_boundary": {
+    "choices": [
+      "continue",
+      "clear",
+      "handoff",
+      "subagent",
+      "compact"
+    ],
+    "precedence": [
+      "continue",
+      "clear",
+      "handoff",
+      "subagent",
+      "compact"
+    ],
+    "invariants": [
+      "does-not-force-clear",
+      "preserves-lifecycle-state"
+    ],
+    "evidence": {
+      "required": [
+        "decision",
+        "reason"
+      ],
+      "conditional": {
+        "handoff": [
+          "source_ref",
+          "destination_ref"
+        ],
+        "subagent": [
+          "task_package_ref",
+          "convergence_ref"
+        ],
+        "compact": [
+          "next_phase"
+        ]
+      }
+    },
+    "preserves": [
+      "lifecycle.status",
+      "gate.status",
+      "ticket.role"
+    ]
+  },
+  "checkpoint_policy": {
+    "strategy": "consolidated",
+    "flush_on": [
+      "stage_exit",
+      "human_pause",
+      "handoff",
+      "implementation_entry",
+      "merge",
+      "release"
+    ],
+    "flush_immediately_on": [
+      "blocked",
+      "responsibility_changed",
+      "asset_approval"
+    ],
+    "preserve_stage_causality": true,
+    "required_stage_trace_fields": [
+      "stage",
+      "upstream_refs",
+      "artifact_refs",
+      "gate_decisions",
+      "downstream_impacts"
+    ],
+    "project_instance_stage_exit_requires_context_reconciliation": true
+  }
+}

package/template/.template-spec/process/contract-reading.md

@@ -68,3 +68,38 @@ scripts/contract prepare-review <前资产> <后资产> --kind <类型> [--unit
 前端 verification schema v2 保留读取历史交互文字；正式完成校验要求 `implementation_plan: {ref, digest}` 绑定当前批准计划，`interaction_results` 使用 `{case_id, state, result, evidence_ref, evidence_digest}`，覆盖计划全部 state_cases 和选定 case_id。只有 `result: pass` 可继续。console、实现截图、视觉差异与实际命令日志均须绑定当前字节摘要，命令必须覆盖计划中的 pnpm_commands。
 
 历史文字报告返回 `legacy-interaction-binding-missing`；先重验计划与批准，再真实执行交互、console、截图及适用命令并另存新报告，不给旧报告补造通过记录。摘要校验不证明交互语义，实际浏览器轨迹和独立前端审查仍按既有边界执行。
+
+## 首批中文阅读页与显式托管
+
+`domain-strategy`、`stage-decision-package`、`checkpoint`、`tracking-migration` 提供专用中文 Markdown。业务原文、稳定 ID、枚举、失败条件、零值、未知字段均保留；旧类型继续使用原有兼容布局。`--json` 保留原接口字段，首批四类可用 `--model --json` 显式获取 `reading_model`；默认不附逐字段索引以减少 Agent 读取成本；`source_pointer` 只用于可直接对应原字段的条目，其他条目使用 `content_pointer`，不冒充原文位置。
+
+源文件是唯一可编辑事实。阅读页是来源快照，不证明当前批准或执行权；`blockers: []` 只表示未登记阻塞。检查点阶段和工作项进度分别展示。原始 Markdown 文档仍由作者维护，JSON/YAML 的机器绑定不因阅读层改写。
+
+```sh
+# 只读预览；只读检查不创建文件
+scripts/contract view <原资产> --kind domain-strategy
+scripts/contract view <历史迁移plan.json> --kind tracking-migration
+scripts/contract check-views --checkpoint docs/.scratch/<feature>/checkpoint.yaml
+
+# 先审阅启用计划，再显式应用；不覆盖已有计划
+scripts/contract plan-enable --checkpoint docs/.scratch/<feature>/checkpoint.yaml --output reading-enable.json
+scripts/contract apply-enable reading-enable.json
+
+# 手动重建，或完成直接源编辑后调用
+scripts/contract render --checkpoint docs/.scratch/<feature>/checkpoint.yaml
+
+# 正式差异记录可明确保存；相同内容幂等，历史报告不追随源覆盖
+scripts/contract prepare-review <旧资产> <新资产> --kind domain-strategy --checkpoint docs/.scratch/<feature>/checkpoint.yaml --json
+```
+
+策略由 `reading-policy.yaml` 持有；缺失或 `manual` 保留旧行为。实际人工阅读试验通过前，模板默认 `manual`。`apply-enable` 只将计划绑定的 checkpoint 登记为托管；其他功能不会被自动接管。领域与阶段决策页消费 checkpoint.artifacts 中对应 `artifact.domain-strategy`、`artifact.stage-decision-package` 的明确 ref；不扫描目录推断资产。其他未来资产保留原入口。
+
+输出放在功能目录 `reading/`：`status.review.md`、对应合同审阅页、`.manifest.json`；正式差异放在 `reading/changes/`。`map.md` 只维护 `YSS-READING:BEGIN/END` 标记范围，保留外部人工正文。manifest 只存依赖、代码与输出摘要和生成诊断，不保存可复用批准。
+
+`check-views` 核对源字节、明确引用、术语、schema、生成器依赖、输出和导航块；只读且不重建。`current` 表示呈现一致性，不代表业务门禁通过；`diagnostics` 中原资产的阻断仍由资产所有者处理。正式准备 API 对托管过期包返回缺口；CLI `prepare-review` 在准备前重建，实际流转代码再次只读检查。`lifecycle-status` 只报告阅读可用性。
+
+生成使用排他锁、恢复日志、逐文件原子替换，manifest 最后提交。人工改动、同名非托管文件、符号链接、坏 manifest 或导航块会保留并报冲突。先保存人工改动，再恢复对应旧生成物及 manifest 后重建；不提供覆盖式 force。检测到历史输出已不再登记时要求人工确认处置，不静默删除。
+
+阶段追踪事务成功后调用共同 `finalizeReading`；`source_operation: applied` 与 `reading_update.status: failed` 可以同时出现。此时源已应用，只修复阅读冲突并运行 render，不能为了补阅读页重做源事务。进程中断后的生成日志只恢复仍匹配本轮字节的派生文件；他人改动会留下恢复冲突。
+
+迁移预览核对计划、内嵌 after 和 Base64 备份摘要；缺少匹配备份时显示“无法比较旧内容”，不以当前文件替代。单文件解码预览上限 2 MiB，超出时返回诊断，不截断或执行内容。receipt 只说明原事务状态。差异按已有稳定 ID 对齐，数组重排独立显示；`binding-change` 和 `unclassified` 仍须审阅，不自动沿用批准。

package/template/.template-spec/process/document-writing.md

@@ -79,3 +79,5 @@
 4. 检查正文、摘要、表格和状态是否一致；验证适用的引用、结构和合同。自检结论不代替独立审查或批准。
 
 规则、例外、证据或状态变化属于实质差异，不能被“字数减少”抵消。不要只用禁用词扫描或模型给自己的分数判断效果。
+
+生成阅读材料使用 [合同阅读入口](contract-reading.md)。业务解释写入权威资产或人工 Markdown；不要手改 `reading/*.review.md`、manifest 或 map 的工具标记块。源编辑完成后更新已启用的阅读包，批准仍引用原资产及其摘要。

package/template/.template-spec/process/feature-assets.md

@@ -0,0 +1,38 @@
+# 功能资产受控整理
+
+目标是移除可重建缓存、归档未引用的旧草稿。不会批准合同、推进阶段、改写 checkpoint 或重算业务状态。父 Ticket 保留五态、业务说明与资产 / 会签入口，阶段、阻塞和下一工作单元引用实际 checkpoint 并按需查询；阅读包保持显式启用、默认 `manual`。
+
+## 命令
+
+```sh
+scripts/feature-assets inspect --root <项目绝对路径> --checkpoint docs/.scratch/<feature>/checkpoint.yaml --json
+scripts/feature-assets plan --root <项目绝对路径> --checkpoint docs/.scratch/<feature>/checkpoint.yaml \
+  --candidate docs/.scratch/<feature>/verification/prototype-evidence-draft.yaml \
+  --archive-dir <项目外全新归档绝对路径> > <项目外计划.json>
+scripts/feature-assets apply --root <项目绝对路径> --plan <项目外计划.json>
+scripts/feature-assets restore --root <项目绝对路径> --receipt <归档绝对路径>/receipt.json
+```
+
+路径必须显式给出，候选使用根相对路径。inspect / plan 只输出 JSON，不写项目。计划展示删除、归档、保留、理由、引用和内容 / 权限摘要，绑定项目身份、工具实现与引用扫描输入。apply 重新生成判定并检查输入；漂移后重新计划，不强行继续。退出码 0 为操作完成，1 为缓存占用或不可判定而部分保留，2 为输入 / 冲突 / 执行错误。
+
+## 分类与引用
+
+- 仅登记 `verification/browser/.chrome-profile` 与 `.chrome-baseline-profile` 两种可重建测试缓存允许删除；`ps` 或 `lsof` 不可用、诊断异常、占用信息出现时保留，不终止进程。
+- `verification/prototype-evidence-draft.yaml` 已有正式对应资产、`plan/stage-items.yaml` 已有 checkpoint 工作项、`verification/browser/summary.json` 已有详细结果时可作为归档候选。
+- `gates/captures/*-question.yaml` 仅全为数字人提问、具有 message ID 且无决定字段时可作为归档候选；原始人工回复保持保护。
+- 合同、批准、任务包、正式验证、迁移回执、冻结交接及未知类别默认保留。重复字节只是统计信息，不是删除依据。
+- 按文件名、根相对路径、提问 message ID 扫描引用，直接写入摘要的语句只记生产者。可识别但无法确定的动态消费、符号链接和过大文本会阻止候选处理；无引用本身不构成许可。扫描范围与边界见下节。
+
+## 执行与恢复
+
+归档按“复制 → 校验 SHA-256、大小和权限 → 移除原件”执行。外部目录内统一 `receipt.json` 保存逐项执行态，不为项目资产增加 sidecar。中断后用同一计划继续：复制结果先复核；删除缓存仅接受原树的未改变剩余子集。已处理计划返回原结果，不重复操作。不要将归档目录放进被扫描项目。
+
+restore 先校验所有备份和目标，再逐项恢复；目标已有不同内容或权限则拒绝覆盖。缓存不参与恢复。来源父目录保留，恢复文件内容与权限。执行期间避免其他进程编辑同一功能包；再次检测到输入漂移即停止，已完成项由回执恢复，不覆盖后续人工修改。
+
+旧父 Ticket 只对明确指定文件制作迁移差异，保存完整原文；状态冲突同时列出父票与 checkpoint 原值，保持冲突待处理，不改变 checkpoint、批准记录、Ticket 五态或执行权限。批准 / 冻结摘要绑定父 Ticket 时，先报告引用并保留原件，不能当作普通阅读页改写。
+
+## 扫描边界
+
+本工具用于受控的本地功能包，不证明任意外部系统或动态程序不存在引用。扫描项目内文本资产及本地脚本，排除版本控制、依赖、图索引、运行时投影及已登记浏览器缓存。模板 / canonical Skill / 工具文件仅在与安装元数据摘要一致时按通用框架跳过引用解释；本地新增或修改内容继续扫描。整理工具自身与本文不作为功能消费方，仍绑定其摘要。外部 tracker、运行中的 Agent 上下文、任意反射或网络引用需要操作者确认；已知动态来源不能解析时保留候选。不要在未知引用环境自动批量 apply。
+
+首次实例迁移在完整副本验证，正式执行前保存项目外完整备份。对相同门禁做前后验证，正式资产摘要保持一致；既有失败原样报告，整理完成不代表阶段通过。

package/template/.template-spec/process/lifecycle-artifact-map.md

@@ -88,6 +88,7 @@
 | `artifact.frontend-implementation-plan` | 前端实现还原计划 | `stage.ticket-formalization` | UI 影响切片提升 ready-for-agent 前。 |
 | `artifact.frontend-implementation-verification` | 前端实现还原验证记录 | `stage.verification-release-retrospective` | UI 影响切片完成实现并准备合并、发布或阶段完成。 |
 | `artifact.retrospective` | 复盘记录 | `stage.verification-release-retrospective` | 发布后或阶段性完成后满足复盘触发条件。 |
+| `artifact.business-ticket-set` | 业务 Ticket 集 | `stage.spec-architecture` | Spec 同步起草、Design 校准和战略业务正式化；不依赖实现工程，不授予实现资格。 |
 
 ### 2.3 执行证据
 

package/template/.template-spec/process/lifecycle-registry-baseline.json

@@ -5,6 +5,7 @@
   "historical_sha256": "5aa3194ec5b8d781a7705b049359644c3f18e09c33b9383d19675c5d0e2ab9bc",
   "published_ids": [
     "artifact.architecture-review",
+    "artifact.business-ticket-set",
     "artifact.data-architecture",
     "artifact.discovery-record",
     "artifact.domain-strategy",
@@ -108,6 +109,7 @@
     "stage.vertical-slice-implementation",
     "work-unit.attach-sync-integration",
     "work-unit.backend-delivery",
+    "work-unit.business-ticket-formalization",
     "work-unit.code-review",
     "work-unit.discovery-opportunity",
     "work-unit.discovery-requirements",
@@ -147,6 +149,7 @@
   },
   "semantic_sha256_by_id": {
     "artifact.architecture-review": "55e32428ee07475ac57f91f53f410dcf182ddaa3aa56187e8f4ba56968142e08",
+    "artifact.business-ticket-set": "662bb45eddfa31e9ec72ea44c4fd59559c0941e09992edd61ebc9f02bdafd2c3",
     "artifact.data-architecture": "6ed995295f4e99f953d90d739e9a6d1fc36cc0a50757ec34da39165872ca8731",
     "artifact.domain-strategy": "3eb281af20f0106d836ec2816f0e524754f4f49e24abc2deb1c0daed1d9a918d",
     "artifact.engineering-baseline": "0706c5d26e062fe33324e2cedaf50887cb4618770dddb1802d4f8cf80dfbb330",
@@ -229,6 +232,7 @@
     "stage.vertical-slice-implementation": "a24a5a6e2d5a6ccf0561f43818883cd285a42e209a4f47509b6f18e7ced68344",
     "work-unit.attach-sync-integration": "b57d0324e98146e834ba04e05c364b3cb107753ea2f31ae22560932c1dc3c0d9",
     "work-unit.backend-delivery": "7d800c190102c66b782179c1985d0f470b47b940549d90eb3103aee02acb0230",
+    "work-unit.business-ticket-formalization": "88a8283c96a03d45fb6a805c6300f0def6019aad57759b654b173867e28c1f82",
     "work-unit.code-review": "40371458e91f90995f87c2a15f09117b0971d16baf6471089a20a215020acb01",
     "work-unit.domain-strategy-design": "748a901446f94c6b5226266e0e21d700e46629826c141bc9527c32619f563b4a",
     "work-unit.entry-triage": "4735f7b335ce72b602890aab470ef1dfc40f574802bc236db8fc18976da81fed",
@@ -236,20 +240,20 @@
     "work-unit.implementation-repository-preparation": "c2f930ed2f5bb76214fa520d967eca47a44f003894ed971479ab0ced77b9007f",
     "work-unit.intensity-aware-review-v2": "be0c488ff39c192c8724395ee224844c9f68cddb749c6335255e226759103e59",
     "work-unit.intensity-aware-verification-v2": "3747058bc5574521bd8317c62d4684867de8a27a21e3471e42dcb9f226e05524",
+    "work-unit.maintenance-research": "ee03d6217e4225b453fe9a7f55718c3403769aa3b3993c28e8aedc6c6a3febec",
     "work-unit.plan-opportunity": "3953e4b05794038237c698bfd7233a90d4bd0ea904c22718f399ad6dc00dbfb3",
     "work-unit.plan-requirements": "ce9a5d6b59d501c09851e60426294c5ad47dd2ae6b4019b867d80a162bb213d2",
-    "work-unit.prototype-design-v2": "f40355b838f3a2926513ac42f44e2eb5e854a3e28f9d8f83fd1f0e5c9ca44293",
+    "work-unit.prototype-design-v2": "5389f7dd306998cc463f91d4c4f97644b15ff37388397bc82d4ce37e2bb284bd",
     "work-unit.release-and-retrospective": "a87cdd47918a249629f7cdc9874420b441bd64c28860dc3910ca217be7ebaad6",
     "work-unit.release-and-rollback": "2c26da7b1133a588e1d098a91aad399c270dab12224c3b1c12a4c79e99da5905",
     "work-unit.service-project-initialization": "a2142c0555f1ba54e888e9daa21ee36cfaead8444eb8255003031bb22cf5636b",
     "work-unit.skill-projection-sync": "da8bb5f347cc01d56bd85e9eecdaf1c2a33584ed040239672b2e6cf973f4dd6a",
     "work-unit.slice-implementation": "c33b625587d636afa47142862df003d704f82b4ee4e8f79f5bf6a6c3747fcee4",
-    "work-unit.spec-synthesis": "ce6c6d556dec93517ac525be6bbf59f4e0962f0882378b785b84db75b41a0527",
+    "work-unit.spec-synthesis": "e31e02b837fc8eaf36b376794c02663ac19a8224946213733bac7b4d801fc9ac",
     "work-unit.ssot-update": "f52e42205478e19529746af16aa75f863d2a238f481cebb157192bdf928ca27f",
     "work-unit.stage-decision": "9a43c029438849337d1ddead2b4f0ca1d1c3482c279265e2b1db3088cbff6048",
-    "work-unit.technical-analysis": "57bb8cab7b0ef2eff43d848914bdd9297ec582570d11c0639dda3227a383726a",
+    "work-unit.technical-analysis": "665c362d0c6a53bbfee1fd8505a410dbb427eb73b099842630b39f9b2dfdf2d6",
     "work-unit.template-snapshot-build": "48463092d1c644f5a5fc4f1c188ba662d7984085b8b04b1fbff450ef8c682939",
-    "work-unit.ticket-decomposition": "d239bd6855ea3cc8d448892af8bff62f5531499774eed58761288374b4c3d2cc",
-    "work-unit.maintenance-research": "ee03d6217e4225b453fe9a7f55718c3403769aa3b3993c28e8aedc6c6a3febec"
+    "work-unit.ticket-decomposition": "ba60f023386e394a82283dd54eff5b8cfa88b7c52a395f04975d670811a8662f"
   }
 }

package/template/.template-spec/process/lifecycle-registry.yaml

@@ -338,6 +338,10 @@ artifacts:
     name: 复盘记录
     stage: stage.verification-release-retrospective
     trigger: 发布后或阶段性完成后满足复盘触发条件。
+  - id: artifact.business-ticket-set
+    name: 业务 Ticket 集
+    stage: stage.spec-architecture
+    trigger: Spec 同步起草、Design 校准和战略业务正式化；不依赖实现工程，不授予实现资格。
 
 work_units:
   - id: work-unit.maintenance-research
@@ -428,18 +432,18 @@ work_units:
     name: Spec 综合
     scope: project-instance
     input: 已确认的 Plan 记录和测试 seam。
-    output: Spec、产品总体设计和功能架构。
-    completion: Spec 内容完整并进入 ready-for-human；下游推进仍需 gate.spec-baseline-approved。
+    output: Spec、产品总体设计、功能架构及业务 Ticket 草案集合。
+    completion: Spec 和业务 Ticket 草案可审查，FR/AC 覆盖与依赖可读取；进入 ready-for-human，下游推进仍需 gate.spec-baseline-approved。
   - id: work-unit.prototype-design-v2
     name: 原型设计与验证
     scope: project-instance
     input: Spec、产品设计影响和状态矩阵。
     output: 交互说明、低保真、状态矩阵、H1/H2 原型交付物、统一 Design QA、档位验证证据与前端实现交接事项。
-    completion: 低保真评审、schema v4 原型交付物验证和用户确认门禁均通过；Visual Baseline Bundle 和生产组件待验事项已交接到前端实现计划。
+    completion: 低保真评审、schema v4 原型交付物验证和用户确认门禁均通过；Visual Baseline Bundle 和生产组件待验事项已交接到前端实现计划。 同步校准业务 Ticket，复用稳定 ID，随后进入业务正式化。
   - id: work-unit.technical-analysis
     name: 技术分析与契约冻结
     scope: project-instance
-    input: Spec、原型、API/数据/工程影响面；新建后端的架构与平台候选，或既有工程当前登记的架构与平台配置。
+    input: 已正式化业务 Ticket 集及 Spec、原型、API/数据/工程影响面；新建后端的架构与平台候选，或既有工程当前登记的架构与平台配置。
     output: 新建后端的 DDD / MVC 与精确 Spring Boot 版本用户决定，或既有工程复用核验；OpenAPI、数据架构、按确认架构形成的 DDD / MVC 技术设计合同、工程基线、架构审查和 Slice 合同草案。
     completion: 新建后端的 gate.backend-architecture-platform-approved 已通过，既有工程已核验复用并记录该门禁不适用；命中契约已冻结；无 API 影响有可读记录；所有后端交付均有批准且当前的 Technical Design；数据影响为真时数据架构已批准，否则有可核验的不适用记录；架构、规则与场景承接无未解释冲突；gate.engineering-contract-approved 通过。
   - id: work-unit.implementation-repository-preparation
@@ -457,7 +461,7 @@ work_units:
   - id: work-unit.ticket-decomposition
     name: 垂直切片 Ticket 正式化
     scope: project-instance
-    input: 冻结 Spec、设计、契约和阻塞关系。
+    input: 已正式化业务 Ticket、冻结 Spec、设计、契约、当前实现仓库准备和阻塞关系。
     output: 更新既有功能父 Ticket 的关联、形成垂直切片和批准的 Slice Implementation Contract。
     completion: 切片可独立验证；生命周期复算后才能 ready-for-agent。
   - id: work-unit.slice-implementation
@@ -490,6 +494,12 @@ work_units:
     input: 已审查候选、发布窗口和回滚点。
     output: 发布/回滚证据和复盘记录。
     completion: 人工发布裁决、fresh verification 和治理回流均完成。
+  - id: work-unit.business-ticket-formalization
+    name: 业务 Ticket 正式化
+    scope: project-instance
+    input: 当前 Spec、适用的产品设计批准、业务 Ticket 草案集合和独立专业审查。
+    output: 可追溯 FR/AC、规则、场景与设计的业务 Ticket 集；保持 ready-for-human。
+    completion: 当前业务覆盖完整，无阻断未决项；既有批准或授权延续有效，专业审查当前。战略交接或技术分析可继续，不授予 ready-for-agent。
 checks:
   - id: check.frontend-delivery-inputs-verified
     name: 前端联合输入核验

package/template/.template-spec/process/plan-spec-quality.md

@@ -0,0 +1,69 @@
+# Plan / Spec 内容诊断
+
+本说明持有可选创作格式 `content_profile: plan-spec-v1` 与只读诊断用法。生命周期阶段、门禁、批准及工作单元仍引用 [生命周期注册表](lifecycle-registry.yaml)，中文写作仍引用 [文档规范](document-writing.md)。本工具不修改文档、状态、批准或就绪结果，不输出流转许可。
+
+## 起草与单一事实来源
+
+Plan 使用 [权威 Plan 模板](../plan/templates/plan-template.md)，Spec 使用 [权威 Spec 模板](../templates/spec-template.md)，常规入口与 `to-spec` 共用它们。Plan 负责战略决策，Spec 定义可观察行为；技术架构、OpenAPI Freeze、切片实现由现有下游阶段承接。
+
+新文档默认带 `content_profile`；它不是生命周期 schema 或批准状态。既有文档无需批量迁移，历史批准、交接快照与 YAML 合同保持兼容。明确选择的存量功能可以改用新格式，实质变化按原有用户决定协议处理。
+
+已有决策包时，成功标准的指标定义、基线或未知原因、目标及确认状态、观测窗口、数据来源、验证方式和补齐动作写入现有 `success_criteria[].statement`，Plan 使用 `success-criterion.*` 的权威引用表。关键取舍复用 `decision.*`，无需新 schema，也不凑固定数量候选。该 statement 的内容完整性由人工审阅；工具只核验引用。未命中决策包的轻量场景使用 Plan 直接填写表。
+
+## 可机械读取的约定
+
+正式条目放在 Markdown 根层级表中，第一列表头为 `ID`，位于模板的“功能需求”“非功能需求”“验收标准”“未决项”“成功标准”章节内（支持章节数字前缀）。表头使用模板原文；一张表对应一类条目。代码块、引用块、列表内示例，以及“示例 / example”标题下的表不会计入正式条目。未支持的表达会报告未评估，不根据关键词数量推断覆盖率。
+
+- FR / NFR / AC ID 在同一功能内稳定，重排不重新编号，删除后不复用。Q 为当前文档的未决项 ID，SC 为轻量成功标准 ID。工具只识别显式基线，无法证明全部历史中从未复用 ID。
+- 需求的“验收引用”填 AC ID；AC 的“需求引用”反向填 FR/NFR ID。多个 ID 可用逗号分隔。验收待补时填写 `待补 Q-001`，未决项登记负责人、补齐动作、时点、接收方和影响依据；工具报告“未评估验收覆盖”，是否可延期仍由现有门禁决定。
+- NFR 可用数值及单位，也可用定性判断依据；测试、检查、分析、演示都是合法方法。未知目标保持候选状态并关联 Q，工具不判断目标是否合理。
+- 没有适用约束的条件章节写 `not-applicable：具体原因`。不保留空白占位行。确定性诊断只检查支持的章节和字段，其他条件项由人工核对。
+
+“来源引用”“数据来源”“权威引用”使用项目根相对路径和定位器：
+
+```text
+docs/input.md :: id:rule.submit
+docs/input.md :: heading:原始需求
+contracts/decision.yaml :: id:success-criterion.attachments
+[S1](docs/input.md)
+[输入](docs/input.md#heading:原始需求)
+```
+
+多个来源用 `；` 分隔。Markdown `id:` 匹配根层级表第一列已有 ID，`heading:` 精确匹配实际标题文字，不生成锚点。YAML/JSON 的 `id:` 匹配已有对象 `id` 字段或映射键，匹配多处即歧义。Markdown 链接以明确 locator / 标签定位，普通网页 slug 不自动推断。链接仅用于读取，不执行内容。来源文件最多 8 MiB、UTF-8、真实路径须在项目根内；外部 URL 不联网，提示补充本地证据快照。不递归追踪来源中的更多链接，不扫描整个仓库猜关联。
+
+## 命令与报告
+
+```bash
+node scripts/inspect-plan-spec check --root . --plan docs/feature/plan.md --spec docs/feature/spec.md --json
+node scripts/inspect-plan-spec check --root . --spec docs/feature/spec.md --slice docs/feature/slice.yaml
+node scripts/inspect-plan-spec diff --root . --before docs/baseline/spec.md --after docs/feature/spec.md --json
+```
+
+`check` 至少指定 Plan、Spec 之一，`--slice` 可重复且需要 `--spec`。默认向 stdout 输出文本；`--json` 输出 JSON。文本和 JSON 绑定相同工具版本与所有实际读取文件的 SHA-256，报告包含发现、位置、条目 ID、恢复建议、未评估项和人工审阅范围。无发现只表示支持范围内未发现机械问题。
+
+| 退出码 | 含义 |
+|---|---|
+| 0 | 诊断执行完成，可有重复 ID、断链、内容缺漏等发现 |
+| 2 | 输入缺失 / 不可读、解析未完成或输入在读取期间漂移；需恢复并重跑 |
+
+主要规则：`DUPLICATE_ID`、`INVALID_ID`、`DANGLING_REFERENCE`、`REFERENCE_KIND`、`REFERENCE_MISMATCH`、`AC_MISSING`、`REQUIREMENT_MISSING`、`REQUIRED_FIELD`、`PLACEHOLDER`、`UNKNOWN_TARGET`、`UNKNOWN_BASELINE`、`TARGET_STATUS`、`NA_REASON`、`SOURCE_FORMAT`、`SOURCE_LOCATOR`、`INPUT_UNREADABLE`、`PARSE_ERROR`、`INPUT_DRIFT`。缺少结构的章节使用 `SECTION_MISSING` / `SECTION_UNPARSED`，旧格式使用 `LEGACY_OR_UNKNOWN_PROFILE` 标记部分未评估。
+
+问题真实性、方案优劣、目标合理性、验收场景充分性、原规则保真与语义等价均为人工审查事项。全文正文、风险和非目标仍必须审阅，不能只读结构化表。输入新鲜度是本次读取前后字节与真实路径一致，不等于未来仍有效。
+
+## 差异与下游追溯
+
+`diff` 按稳定 ID 展示新增、修改、删除及引用字段变化；ID 重复时该条目无法唯一比较。原始差异同时提供共同前缀 / 后缀字节数、被替换字节和新增字节的 Base64，结合旧基线可精确还原新文件；章节正文、换行、重排和格式变化不会丢失。它不声称文本变化一定改变语义。旧基线缺失显示“无法比较旧内容”，不得用空文档冒充旧版本。
+
+章节缺失、表头无法识别或格式未支持时，差异状态为 `partially-compared`，明确列出未评估范围；提取缺口不能直接解释为新增或删除，受影响条目标记 `unassessed`。仍保留完整原始字节差异。显式 Slice YAML 解析失败与其他输入解析失败一样返回 `2`；YAML 可解析但 schema 不支持时，保留未评估说明。
+
+Spec Delta 仍只处理既有冻结基线的适用高风险变化，引用 FR/NFR/AC 与旧 / 新文件。新增 diff 不扩大 Delta 适用范围，不自动延续批准或缩小验证。
+
+可选 `--slice` 读取既有 Slice schema v3 的 `acceptance.<ID>.source` 与 `locator`（AC ID 或 `id:AC-001`），沿 `verification.*.acceptance_refs` 和 `work_units.*.acceptance_refs` 生成追溯视图。该视图展示验证命令和预期证据引用，不执行命令、不核验批准或证据结果，也不替代 Slice schema 检查。未映射需求、失效定位、缺验证映射和未提供的依赖显示缺口；不得解释为“未受影响”。没有第二份手工追溯合同。
+
+## 样本、分发与回退
+
+[贯穿案例](../templates/examples/lifecycle-writing-examples.md) 关联三类虚构固定样本及预登记反例。确定性 fixture 仅证明诊断行为；人工填写、审阅时间、澄清轮次、遗漏、返工和 Token 必须有实际记录才统计。未取得人工反馈时，效果保持待验证；不恢复已取消的跨平台 Agent 评测。
+
+解析采用 [unified](https://github.com/unifiedjs/unified)、[remark-parse](https://github.com/remarkjs/remark/tree/main/packages/remark-parse)、[remark-gfm](https://github.com/remarkjs/remark-gfm)；frontmatter 使用现有 YAML 工具。维护侧由 pnpm 精确锁定和 vendor 构建分发；实例运行无须安装依赖。
+
+本轮始终为独立诊断，不接入阶段阻断。回退时停用诊断调用和新模板默认入口，保留已生成文档、格式读取能力及证据；不回写历史资产或恢复过期批准。升级门禁须另立变更。