create-yss-spec 3.5.3 → 3.5.5

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

@@ -1,6 +1,6 @@
 # 合同阅读、准备与显式迁移
 
-本文件描述工具入口；阶段、批准和执行门禁仍由 `.template-spec/process/lifecycle-registry.yaml` 及资产所有者定义。YAML 是权威文件，视图不能编辑、批准合同或授予执行权限。
+本文件描述工具入口；阶段、批准和执行门禁仍由 `.template-spec/process/lifecycle-registry.yaml` 及资产所有者定义。显式引用的源资产是权威文件，视图不能编辑、批准合同或授予执行权限。五类生命周期资产的新建 JSON 与旧 YAML 兼容规则见 [结构化资产](structured-assets.md)；Slice 等本轮未迁移合同继续使用原格式。
 
 ```sh
 scripts/contract view <资产> --kind <类型> [--profile review|task|full] [--unit <ID>] [--json]
@@ -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

@@ -61,6 +61,18 @@
 
 ## 4. 进度与会签提示
 
+### 将流程编号转成读者能理解的说明
+
+面向用户的正文先写中文名称和具体动作。名称读取当前项目的生命周期注册表（`public_name` 优先，其次 `name`），角色读取 `digital-human-roles.yaml` 的 `name`；输入、产出和完成条件同样优先使用对应 `public_*` 字段。可以消费查询结果的 `presentation.names`，不得另建手工翻译表。
+
+`stage.*`、`work-unit.*`、`gate.*`、`check.*`、`artifact.*`、`evidence.*`、`role.*` 属于追踪编号。聊天正文不直接串接这些编号；需要追踪时放在名称后的括号、详情或证据引用里。JSON / YAML 字段、命令参数、路径、批准记录仍保存原值；阅读视图可用“名称（编号）”逐项对照。未知编号写“名称未识别”并保留原值，不能猜名称、静默省略或改写旧资产。
+
+说明应回答“目前什么情况、谁负责、接下来做什么、形成什么材料”。状态必须来自当前登记及验证，编号以 `approved` 结尾只表示检查身份；不能据此写“已批准”。负责人未登记时明确写出缺口，不能把角色候选当作实际指派。待核验、草案、批准、可实现分别表达，所有实质阻塞都要保留。
+
+例如，只有已登记需求经理负责且检查状态待核验时，才可表述：“方案决策包评审状态待核验。下一步由需求经理汇总已确认的规划、业务边界和商业约束，形成供评审和后续 Spec 使用的方案决策包。”具体材料的版本、证据和批准状态继续引用原资产。不能把这个例子当成真实项目状态。
+
+状态阅读可用 `scripts/lifecycle-status --root <项目> --checkpoint <ref> --format text`；默认 JSON 继续供工具读取。该查询及其中文展示均不授予执行或批准权限。
+
 仅在用户询问状态、阶段切换或出现阻塞时，简短展示四项信息：**当前阶段、当前阻塞、谁处理、下一动作**。可以用一句话或四行表达，不要求表格。普通问题直接回答；其他进度更新只说明本轮有意义的变化，状态未变时不重复整套说明。
 
 状态读取已有 checkpoint 和适用验证结果，不建立或要求用户填写另一套状态文件。未核验的阶段或阻塞情况写“待核验”；只有当前适用证据支持时才能写“无阻塞”。证据过期应明确指出过期输入及恢复动作，不能沿用历史通过结论。责任人按已有登记填写，缺失写“未登记”，不自行指派；下一动作说明如何补齐登记或核验。
@@ -79,3 +91,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/harness-upgrade.md

@@ -0,0 +1,40 @@
+# YSS 模板实例升级协议
+
+本协议定义 `yss-harness-upgrade` 与四类 YSS CLI 的同家族实例升级。技能负责判断、冲突方案和授权范围；CLI 负责计划校验、候选验证、持久归档、事务和恢复。历史批准及 Ticket 状态仍由各自权威协议管理。
+
+## 输入与接口
+
+固定精确 CLI 版本、包内容及模板快照，确认真实项目根、metadata/schema、profile、受管基线和 Git 状态。旧版本缺少受支持的基线/schema 时停止，不重新初始化。目标模板使用所执行 CLI 的内置快照；不在 apply 阶段查询 latest 或运行外部计划提供的脚本。
+
+- `migrate plan --target-dir <绝对目录> --output <项目外全新文件> [--archive-dir <项目外全新目录>] [--migrate-layout] [--prune] [--resolutions <文件>]`：项目只读，在项目外生成固定计划；冲突返回机器可读诊断。
+- `migrate apply --plan <文件> [--target-dir <同一目录>]`：显式执行。
+- `migrate status --target-dir <目录>`：只读状态。
+- `migrate recover|rollback --target-dir <目录> [--apply]`：默认只读预览，显式写入。
+
+所有命令接受 `--json`，输出 schemaVersion 1 JSON。失败非零退出；区分 `CONFLICT`、`STALE_PLAN`、`EXECUTOR`、`PLAN`、`ARCHIVE`、`INTERRUPTED`、`CONCURRENT`、`RECOVERY_FAILED` 等。原 CLI 命令及错误协议保持兼容。
+
+## 计划与冲突
+
+计划绑定 schemaVersion、事务 ID、时间、项目根、家族、执行器摘要、目标模板、归档位置、迁移选项、输入清单、Git HEAD/index/gitlink、规则 ID、操作前后内容/权限摘要和候选内容。整体 planDigest 检测意外修改；执行器还重新生成候选操作，不信任手改计划或重新计算摘要。摘要不等于授权。
+
+版本化规则 `managed-sync.v1`、`layout-migration.v1`、`retirement.v1` 复用各 CLI 原有身份/schema 范围和可信文件基线判定；后两者分别要求显式布局迁移与 prune。不凭名称或目录推断旧资产属于模板，不提供未知旧版本的猜测迁移。
+
+`resolutions` 为路径到决议的 JSON 映射。每项包含 `action: preserve|merge`、`beforeDigest`、`templateDigest`；merge 另含候选字节的 `contentBase64`。只接受确实存在、有可信基线且可合并的受管冲突；未知路径、受保护资产、过期摘要或未消费决议拒绝。技能在项目外起草合并差异，新增语义决定取得用户回复后重新生成计划。CLI 不把决议文件当成人工批准。
+
+未修改受管文件自动更新。修改过的退出分发文件保留；`--prune` 只删除仍匹配旧基线的文件。项目拥有的 tracker、业务文档和已批准资产按现有保护规则保留；历史冻结和批准不会因路径移动获得新的有效性。
+
+## 归档、执行与恢复
+
+默认归档位置为 `~/.yss-harness/archives/<项目路径与家族摘要>/<事务ID>/`，可显式改为项目外全新目录。保存 plan.json、before/ 原字节与权限、receipt.json；首版不自动清理归档。布局迁移额外保存 project-copy/ 项目内容副本；不跟随符号链接，排除 Git 内部数据、依赖、索引缓存及事务状态，这些排除项不是迁移写入范围。Git 工作区和索引不重建、不 reset、不 stash。
+
+候选操作先在隔离副本中完成生成锁文件与实例校验。真实执行前重新核验输入，先归档并校验，再在互斥锁下写入。内部事务日志预写并持久化，文件、生成锁及 metadata 属于同一事务。既有业务文件和无关未提交/未跟踪工作保持；输入漂移要求新计划。
+
+内部 `.yss-harness-state/upgrade.json` 索引关联外部回执与事务。失败自动恢复本次写入；进程中断后 recover 校验事务和备份再恢复。成功提交但回执尚未完成的情况依据持久日志收敛状态。保留损坏、冲突及未恢复路径，不把恢复失败写成成功。
+
+rollback 只针对索引中最近一次成功迁移，完整预检全部原件和升级后状态后才开始。任何后续修改、丢失或损坏备份都会阻断；不提供忽略冲突的 force。回退使用新的可恢复事务，不更改 CLI 安装版本。重复 apply 只有在同一计划已成功且结果仍匹配时才返回原回执；恢复或回退后的旧计划不复用。
+
+## 验证与结论
+
+校验身份、布局、Context、Skill 锁和投影等各家族现有实例合同；有失败不跳过。对未迁移资产与 Git index/HEAD/gitlink 做并发检查。迁移完成再规划，证明不会重复执行；计划保留项不是自动消失的冲突。
+
+回执说明实际版本、范围、归档、事务状态和验证结果。原有失败与新增失败分别说明；升级成功不表示产品阶段批准或发布就绪。提交、推送、发布及真实项目迁移均按会话授权，不由技能或计划摘要授予。

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

@@ -43,7 +43,7 @@
 | `check.frontend-delivery-inputs-verified` | 前端联合输入核验 | `stage.system-data-engineering` | 专职前端 profile 或显式 frontend_delivery 绑定的任务启动、恢复、合同编译、实现和验证；实际执行 scripts/verify-frontend-delivery，输入就绪不等于实现获批。 |
 | `check.repository-identity-valid` | 仓库身份校验 | `stage.entry-triage` | 每次进入流程。 |
 | `check.domain-strategy-approved` | 业务边界与规则评审 | `stage.plan` | 需要确定业务板块、业务责任区、统一业务词汇、协作关系或关键规则。 |
-| `check.stage-decision-package-approved` | 阶段决策包评审 | `stage.plan` | Plan 到 Spec 入口需要稳定的阶段决策合同。 |
+| `check.stage-decision-package-approved` | 方案决策包评审 | `stage.plan` | Plan 到 Spec 入口需要稳定的阶段决策合同。 |
 | `check.prototype-reviewed` | 原型评审 | `stage.product-design` | 命中产品设计影响，且低保真页面、流程、状态或 API 反推需要独立评审。 |
 | `check.prototype-verified` | 原型交付物验证 | `stage.product-design` | 产品设计影响需要通过 H1/H2 原型交付物进行视觉或流程校准；真实组件验证留到前端实现阶段。 |
 | `check.openapi-draft-reviewed` | OpenAPI Draft Review | `stage.system-data-engineering` | 有 API 影响且 Draft 已生成。 |
@@ -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 执行证据
 
@@ -98,7 +99,7 @@
 | `evidence.domain-strategy-review` | 业务边界与规则评审证据 | 业务板块、业务责任区、统一业务词汇、协作与交接关系、关键场景和不可违反规则的结构化评审结果。 |
 | `evidence.technical-design-review` | 技术设计评审证据 | 按已确认 DDD 或 MVC 架构审查规则与场景承接、分层、行为、一致性和测试边界。 |
 | `evidence.tactical-design-review` | DDD 战术设计评审证据 | 聚合、Entity、Value Object、不变量、状态机、一致性、Gateway 与 API 隔离的结构化评审结果。 |
-| `evidence.stage-decision-package` | 阶段决策包验证证据 | 阶段决策包的 Schema、引用、语义一致性、影响传播和下游消费验证结果。 |
+| `evidence.stage-decision-package` | 方案决策包验证证据 | 阶段决策包的 Schema、引用、语义一致性、影响传播和下游消费验证结果。 |
 | `evidence.maintenance-intensity-checkpoint` | 模板维护强度 checkpoint | template-source 变更的 L1 / L2 / L3 分级、触发项、最低验证证据、review 模式和升级记录。 |
 | `evidence.repository-identity-check` | 仓库身份校验结果 | yss-project.yaml 的合法性与 repository_mode 裁决。 |
 | `evidence.approval-record` | 人工批准记录 | 对需要人工批准的 Spec、设计、契约或发布裁决的可追溯记录。 |

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"
   }
 }