create-yss-spec 3.4.10 → 3.5.2

package/template/{docs → .template-spec}/process/lifecycle-registry.yaml

@@ -6,7 +6,7 @@ description: >-
 id_policy:
   pattern: '^(stage|gate|check|artifact|work-unit|evidence)\.[a-z0-9][a-z0-9-]*$'
   published_ids_immutable: true
-  baseline: docs/process/lifecycle-registry-baseline.json
+  baseline: .template-spec/process/lifecycle-registry-baseline.json
   deprecated_ids:
     - artifact.high-fidelity-html-prototype
     - work-unit.fresh-verification
@@ -31,6 +31,11 @@ id_policy:
     - gate.slice-ready-for-agent
     - gate.frontend-implementation-verified
     - gate.release-ready
+    - artifact.prototype-review
+    - artifact.prototype-confirmation
+    - work-unit.intensity-aware-verification
+    - work-unit.intensity-aware-review
+    - work-unit.prototype-design
 
 stages:
   - id: stage.entry-triage
@@ -120,7 +125,9 @@ evidence:
     description: 基于低保真评审后的风险触发、决定目标、H1/H2 计算结果以及人工升降级依据。
   - id: evidence.prototype-deliverable-verification
     name: 原型交付物验证证据
+    # description 保留已发布稳定 ID 的历史语义快照；当前产物版本读取 public_description 及原型证据合同。
     description: schema v3 共同证据与所选档位的浏览器、Design QA、无障碍、组件事实或真实组件合同验证结果。
+    public_description: 新原型证据采用 schema v4，包含共同证据、Visual Baseline Bundle、浏览器、Design QA、无障碍及档位验证结果；历史 v3 仅供只读兼容。
   - id: evidence.prototype-confirmation
     name: 原型用户确认记录
     description: 高保真原型、验证清单和进入下游阶段范围的人工确认结论。
@@ -259,14 +266,14 @@ artifacts:
     name: 原型交付物
     stage: stage.product-design
     trigger: 低保真评审后需要 H1 视觉或 H2 流程校准。
-  - id: artifact.prototype-review
+  - id: artifact.prototype-review-v2
     name: 原型评审记录
     stage: stage.product-design
-    trigger: 命中 gate.prototype-reviewed。
-  - id: artifact.prototype-confirmation
+    trigger: 命中 check.prototype-reviewed。
+  - id: artifact.prototype-confirmation-v2
     name: 原型确认记录
     stage: stage.product-design
-    trigger: 命中 gate.user-confirmation。
+    trigger: 命中 gate.product-design-approved。
   - id: artifact.openapi-draft
     name: OpenAPI Draft
     stage: stage.system-data-engineering
@@ -363,18 +370,18 @@ work_units:
     input: 目标仓库、dry-run 计划。
     output: 受管资产和 metadata。
     completion: 验证通过或完整回滚。
-  - id: work-unit.intensity-aware-verification
+  - id: work-unit.intensity-aware-verification-v2
     name: 分级 Fresh verification
     scope: template-source
     input: 变更仓库、强度分级与对应最低证据。
     output: 命令输出与证据。
-    completion: L1 相关检查、L2 最小反例与 fresh verification、L3 完整 RED / GREEN / REFACTOR 与 fresh verification 按命中等级通过。
-  - id: work-unit.intensity-aware-review
+    completion: L1 完成相关检查；L2 完成最小反例、维护者自检与本轮 fresh verification；L3 完成维护者自检与本轮 fresh verification，正式发布前另运行完整 scripts/verify-template。
+  - id: work-unit.intensity-aware-review-v2
     name: 分级审查
     scope: template-source
     input: 变更 diff、强度分级与验证证据。
-    output: L1 self-check / 人工 checkpoint、L2 聚焦独立审查或 L3 正式独立审查结论。
-    completion: 已按命中等级完成审查且无未处理阻断项；L1 不强制独立 reviewer。
+    output: 维护者自检结论与阻断项；按需记录聚焦独立审查结果。
+    completion: 已完成命中等级要求的维护者自检并处理阻断项；独立审查仅在另行触发时执行，不由 L2 或 L3 自动强制。
   - id: work-unit.release-and-rollback
     name: 发布与回滚
     scope: template-source
@@ -417,12 +424,12 @@ work_units:
     input: 已确认的 Plan 记录和测试 seam。
     output: Spec、产品总体设计和功能架构。
     completion: Spec 内容完整并进入 ready-for-human；下游推进仍需 gate.spec-baseline-approved。
-  - id: work-unit.prototype-design
+  - id: work-unit.prototype-design-v2
     name: 原型设计与验证
     scope: project-instance
     input: Spec、产品设计影响和状态矩阵。
     output: 交互说明、低保真、状态矩阵、H1/H2 原型交付物、统一 Design QA、档位验证证据与前端实现交接事项。
-    completion: 低保真评审、schema v3 原型交付物验证和用户确认门禁均通过；生产组件待验事项已交接到前端实现计划。
+    completion: 低保真评审、schema v4 原型交付物验证和用户确认门禁均通过；Visual Baseline Bundle 和生产组件待验事项已交接到前端实现计划。
   - id: work-unit.technical-analysis
     name: 技术分析与契约冻结
     scope: project-instance

package/template/{docs → .template-spec}/process/plan-migration.md

@@ -2,7 +2,7 @@
 
 新流程仅使用 `stage.plan`、`artifact.plan-record`、`work-unit.plan-opportunity` 和 `work-unit.plan-requirements`。不提供 Discovery 阶段别名、旧标识解析或兼容入口；旧 ID 在注册表中仅作为弃用清单保留，以防重新分配，不可执行。
 
-新工作从 `docs/plan/templates/plan-template.md` 起草，工作目录为 `docs/.scratch/<feature>/plan/`。问题、机会和事实探索是 Plan 内按影响面执行的活动。
+新工作从 `.template-spec/plan/templates/plan-template.md` 起草，工作目录为 `docs/.scratch/<feature>/plan/`。问题、机会和事实探索是 Plan 内按影响面执行的活动。
 
 历史冻结文档、批准记录和摘要保持原字节。旧状态不能直接恢复执行；如需继续，按当前 Plan 模板重新整理输入并核查当前退出条件，不把旧批准自动视为新流程批准。已有事实和结论可引用，但须记录当前版本、适用范围和复用理由。
 

package/template/{docs → .template-spec}/process/schemas/digital-human-task-package.schema.json

@@ -27,6 +27,19 @@
     "convergence"
   ],
   "properties": {
+    "transition_evidence": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "strategic_handoff_consumption": { "type": "object" },
+        "approved_spec": { "type": "object" },
+        "context_reconciliation": { "type": "object" },
+        "technical_design": { "type": "object" },
+        "data_architecture_decision": { "type": "object" },
+        "api_contract_decision": { "type": "object" },
+        "engineering_contract_approval_ref": { "type": "string", "minLength": 1 }
+      }
+    },
     "plan_review_ref": {
       "type": "string",
       "minLength": 1
@@ -127,7 +140,7 @@
       ],
       "properties": {
         "registry_ref": {
-          "const": "docs/agents/digital-human-roles.yaml"
+          "const": ".template-spec/agents/digital-human-roles.yaml"
         },
         "defaults_ref": {
           "type": "string",

package/template/{docs → .template-spec}/process/schemas/lifecycle-checkpoint.schema.json

@@ -22,6 +22,21 @@
     "rollback"
   ],
   "properties": {
+    "service_project_initialization": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["project_id", "contract_ref", "contract_digest", "project_root", "context_handoff_digest"],
+      "properties": {
+        "project_id": { "type": "string", "minLength": 1 },
+        "contract_ref": { "type": "string", "minLength": 1 },
+        "contract_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "project_root": { "type": "string", "minLength": 1 },
+        "context_handoff_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "manifest_ref": { "type": "string", "minLength": 1 },
+        "verification_ref": { "type": "string", "minLength": 1 },
+        "result_ref": { "type": "string", "minLength": 1 }
+      }
+    },
     "plan_continuation_ref": {
       "type": "string",
       "minLength": 1

package/template/{docs → .template-spec}/process/schemas/lifecycle-registry.schema.json

@@ -45,7 +45,7 @@
           "const": true
         },
         "baseline": {
-          "const": "docs/process/lifecycle-registry-baseline.json"
+          "const": ".template-spec/process/lifecycle-registry-baseline.json"
         },
         "deprecated_ids": {
           "type": "array",

package/template/{docs → .template-spec}/process/schemas/strategic-design-handoff-v3.schema.json

@@ -114,7 +114,7 @@
           "const": "CONTEXT.md"
         },
         "reconciliation_schema_ref": {
-          "const": "docs/process/schemas/context-reconciliation.schema.json"
+          "const": ".template-spec/process/schemas/context-reconciliation.schema.json"
         },
         "required_before_skill": {
           "enum": [

package/template/{docs → .template-spec}/process/schemas/strategic-design-handoff-v4.schema.json

@@ -667,7 +667,7 @@
           "properties": {
             "required": {"const": true},
             "target_context_ref": {"const": "CONTEXT.md"},
-            "schema_ref": {"const": "docs/process/schemas/context-reconciliation.schema.json"}
+            "schema_ref": {"const": ".template-spec/process/schemas/context-reconciliation.schema.json"}
           }
         },
         "reason": {"type": "string", "minLength": 1},

package/template/{docs → .template-spec}/process/schemas/strategic-design-handoff-v5.schema.json

@@ -769,7 +769,7 @@
               "const": "CONTEXT.md"
             },
             "schema_ref": {
-              "const": "docs/process/schemas/context-reconciliation.schema.json"
+              "const": ".template-spec/process/schemas/context-reconciliation.schema.json"
             }
           }
         },

package/template/{docs → .template-spec}/process/schemas/strategic-design-handoff.schema.json

@@ -769,7 +769,7 @@
               "const": "CONTEXT.md"
             },
             "schema_ref": {
-              "const": "docs/process/schemas/context-reconciliation.schema.json"
+              "const": ".template-spec/process/schemas/context-reconciliation.schema.json"
             }
           }
         },

package/template/{docs → .template-spec}/process/stage-tracking.md

@@ -4,7 +4,7 @@
 
 ## 启用与职责
 
-`docs/agents/issue-tracker.md` 的 `tracker.lifecycle_tracking_version: 1` 表示项目已启用。新初始化默认启用；attach / sync 保留已有配置，未声明的旧项目不自动启用。只读检查不修改项目；旧项目先 plan 再显式 apply。模板源只维护机制，不在模板根生成产品工作项。
+`.template-spec/agents/issue-tracker.md` 的 `tracker.lifecycle_tracking_version: 1` 表示项目已启用。新初始化默认启用；attach / sync 保留已有配置，未声明的旧项目不自动启用。只读检查不修改项目；旧项目先 plan 再显式 apply。模板源只维护机制，不在模板根生成产品工作项。
 
 完整研发从 Plan（或接入的最近可信阶段）建立唯一父 Ticket。Design 继续使用 checkpoint / map，不创建工程父 Ticket。Backend / Frontend 只消费已交接资产，不因本协议取得 Plan、Spec 或产品设计的编写权限。Dev 消费主模板的同一协议。
 

package/template/{docs → .template-spec}/process/subagent-collaboration.md

@@ -6,8 +6,8 @@ Subagent 和其它运行时实例只接收边界清晰的任务包。主控数
 
 ## 任务包
 
-凡主控向数字人角色或独立运行时正式派发生命周期工作单元，都必须使用 `docs/process/schemas/digital-human-task-package.schema.json` 定义的任务包，并写明 `task_id`、`work_unit_id`、`actor_id`、数字人角色 ID、`runtime_id`、执行态、工作流状态、从 `docs/agents/digital-human-roles.yaml` 复制的 `core_skills` / `forbidden_skills`（可用 `taskPackageDefaults`）、合同类型和版本、输入资产、目标、允许写路径、禁止事项、验收标准、验证命令及其实际退出码 / 执行时间 / 证据引用、下游消费者和汇合方式。`slice-implementation` 才额外绑定 Slice Implementation Contract；禁止手写第二套技能包；任务包由 `scripts/verify-digital-human-task-package` 校验，`scripts/verify-subagent-task-package` 仅为兼容入口。
+凡主控向数字人角色或独立运行时正式派发生命周期工作单元，都必须使用 `.template-spec/process/schemas/digital-human-task-package.schema.json` 定义的任务包，并写明 `task_id`、`work_unit_id`、`actor_id`、数字人角色 ID、`runtime_id`、执行态、工作流状态、从 `.template-spec/agents/digital-human-roles.yaml` 复制的 `core_skills` / `forbidden_skills`（可用 `taskPackageDefaults`）、合同类型和版本、输入资产、目标、允许写路径、禁止事项、验收标准、验证命令及其实际退出码 / 执行时间 / 证据引用、下游消费者和汇合方式。`slice-implementation` 才额外绑定 Slice Implementation Contract；禁止手写第二套技能包；任务包由 `scripts/verify-digital-human-task-package` 校验，`scripts/verify-subagent-task-package` 仅为兼容入口。
 
 ## 汇合
 
-返回结果必须符合 `workflow-execution-result-v1`，至少包括 `work_unit`、`workflow_reference`、`result`、`skill`、`changed_files` / `changed_artifacts`、`evidence_refs`、实际验证结果、`deferred_seams`、`drift`、`violation`、`new_impacts`、`stale_candidates`、`blocking_signals` 和 `next_route`。主控必须重新执行 fresh verification，并在集中 checkpoint 中保留阶段因果。会签写入 `docs/.scratch/<feature>/gates/<gate-id>-approval.yaml`（形状见 `docs/templates/approval-record-template.yaml`），不能用聊天表情代替。恢复前校验 `scripts/verify-approval-record`。
+返回结果必须符合 `workflow-execution-result-v1`，至少包括 `work_unit`、`workflow_reference`、`result`、`skill`、`changed_files` / `changed_artifacts`、`evidence_refs`、实际验证结果、`deferred_seams`、`drift`、`violation`、`new_impacts`、`stale_candidates`、`blocking_signals` 和 `next_route`。主控必须重新执行 fresh verification，并在集中 checkpoint 中保留阶段因果。会签写入 `docs/.scratch/<feature>/gates/<gate-id>-approval.yaml`（形状见 `.template-spec/templates/approval-record-template.yaml`），不能用聊天表情代替。恢复前校验 `scripts/verify-approval-record`。

package/template/{docs → .template-spec}/templates/build-architecture-checklist-template.md

@@ -20,7 +20,7 @@ owner: ai
 | 风险 / 回滚约束 | `AGENTS.md` |  |
 | Slice Implementation Contract |  | 填写 contract_id / contract_version / 生命周期批准状态 |
 | 后端脚手架策略 | `orchestration-contract.yaml` / DDD 或 Layered MVC 生成器 |  | backend `scaffold_status=required` 时填写架构与平台用户门禁、architecture decision、精确 Spring Boot 版本、schema v4 合同身份、批准/持久化引用、生成器输入、Manifest v4、实际 `./mvnw` 结果和后置实现合同编译器重编译；既有工程填写登记值复用证据 |
-| 工程项目路径策略 | `docs/process/implementation-repo-integration.md` / 实现合同编译器 Contract |  | Harness 内必须是 `apps/backend/<project>/` 或 `apps/frontend/<project>/`；`apps/backend/`、`apps/frontend/` 仅为容器，`app/backend/`、`app/frontend/` 及其子路径阻断 |
+| 工程项目路径策略 | `.template-spec/process/implementation-repo-integration.md` / 实现合同编译器 Contract |  | Harness 内必须是 `apps/backend/<project>/` 或 `apps/frontend/<project>/`；`apps/backend/`、`apps/frontend/` 仅为容器，`app/backend/`、`app/frontend/` 及其子路径阻断 |
 | 垂直切片工作单元 |  |  |
 | YSS Skill Execution Result |  | 每个 skill / work_unit 的结果文件引用 |
 
@@ -43,7 +43,7 @@ owner: ai
 | Infrastructure：需要持久化的切片必须有 PO / Repository / Convertor / GatewayImpl；`InMemory*Gateway` 只能作为显式 `seam-deferred` | `yss-repository` / 数据架构 |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 未补齐时不得声称生产持久化完成 |
 | POJO / Convertor：DTO / VO / CMD / Query / PO / Domain Model 样板代码默认使用 Lombok；对象转换默认使用 MapStruct，禁止 `BeanUtils.copyProperties`、反射拷贝和重复手写字段赋值 | `lombok` / `mapstruct` / `AGENTS.md` |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 未加载 skill、缺注解处理器配置、缺 Convertor 或无例外说明时标记 `violation` |
 | 后端工程工具链：构建、测试、运行、OpenAPI 生成、CI 和 Release 命令必须使用项目根目录 `./mvnw ...`；裸 `mvn ...` 必须有受控例外记录 | DDD / Layered MVC 生成器及 implementation routing |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 无例外记录时改为 `./mvnw ...`，否则不得进入完成 / 可合并结论 |
-| 工程项目路径：每个 Harness 内项目必须有具体项目段，禁止直接写入容器根或单数 `app/...` | `docs/process/implementation-repo-integration.md` / implementation path validator |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 路径违规时停止 build，并回到实现路由 |
+| 工程项目路径：每个 Harness 内项目必须有具体项目段，禁止直接写入容器根或单数 `app/...` | `.template-spec/process/implementation-repo-integration.md` / implementation path validator |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 路径违规时停止 build，并回到实现路由 |
 | 文档语言：持久化生命周期文档、实施记录、审查报告、发布说明和 Git checkpoint 正文必须使用中文，英文 skill / 模板不得原样落地 | `AGENTS.md` / `yss-product-lifecycle` |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 仅保留必要英文技术标识、命令和 metadata |
 | 高风险变更：按已批准的普通影响面结论记录验证证据、责任人和回滚约束 | `AGENTS.md` / Spec / 架构记录 |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 缺验证证据或责任人时不得发布或合并 |
 | 质量基线：`baseline_id` / `baseline_version` 只从 `engineering-baseline` 引用，Slice、Execution Result、审查和发布不得重复定义 | `engineering-baseline` / `orchestration-contract.yaml` |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 缺少基线引用或出现重复标准时阻断并回到工程基线 |

package/template/{docs → .template-spec}/templates/digital-human-runtime-profile-template.md

@@ -1,6 +1,6 @@
 # 数字人运行时 Profile：<数字人角色>
 
-> 从 `docs/agents/digital-human-roles.yaml` 复制 title / description / skill。不要手写第二套职责。先选 `runtime_id`，再按该运行时适配器落地。
+> 从 `.template-spec/agents/digital-human-roles.yaml` 复制 title / description / skill。不要手写第二套职责。先选 `runtime_id`，再按该运行时适配器落地。
 
 ## 绑定
 
@@ -34,5 +34,5 @@
 - 人默认只跟主控说话。
 - 逻辑协作组以 YAML `stage_groups` 为准。
 - 当前运行时若声明了 `max_collaboration_group_size` 且 `overflow=one-to-one-handoff`，超员时改 1:1，不改逻辑组。
-- 会签按 YAML `gate_policy` 写 `docs/templates/approval-record-template.yaml`，填 `runtime_id` 与 `principal_ref`。恢复前跑 `scripts/verify-approval-record`。
+- 会签按 YAML `gate_policy` 写 `.template-spec/templates/approval-record-template.yaml`，填 `runtime_id` 与 `principal_ref`。恢复前跑 `scripts/verify-approval-record`。
 - 权威产物写 git。

package/template/{docs → .template-spec}/templates/grok-bot-profile-template.md

@@ -1,6 +1,6 @@
 # Grok Bot Profile：<数字人角色>
 
-> 这是 `runtime.grok` 适配模板。角色职责仍以 `docs/agents/digital-human-roles.yaml` 为准。通用流程见 `docs/templates/digital-human-runtime-profile-template.md`。
+> 这是 `runtime.grok` 适配模板。角色职责仍以 `.template-spec/agents/digital-human-roles.yaml` 为准。通用流程见 `.template-spec/templates/digital-human-runtime-profile-template.md`。
 
 ## Profile
 

package/template/{docs → .template-spec}/templates/local-parent-ticket-template.md

@@ -52,7 +52,7 @@ Status: ready-for-human
 
 | 门禁 | 记录路径 | 会签角色 | 状态 |
 |---|---|---|---|
-|  | `docs/.scratch/<feature>/gates/<gate-id>-approval.yaml` | 见 `docs/agents/digital-human-roles.yaml` | pending / approved / blocked / not-applicable |
+|  | `docs/.scratch/<feature>/gates/<gate-id>-approval.yaml` | 见 `.template-spec/agents/digital-human-roles.yaml` | pending / approved / blocked / not-applicable |
 
 ## 阻塞关系
 

package/template/.template-spec/templates/release-note-template.md

@@ -0,0 +1,29 @@
+---
+pipeline: <feature-id>
+stage: archive
+status: draft
+owner: ai
+---
+
+# 发布说明：<功能名称>
+
+## 变更内容
+
+引用本次 Spec / Ticket、当前候选及验收记录，说明用户可观察变化和实际交付范围。
+
+## 迁移说明
+
+说明兼容性、数据或配置迁移、受影响消费者及执行顺序；无迁移时给出依据。已有实例按显式迁移处理，不由本说明自动更新。
+
+## 验证结果
+
+引用同一候选的 Fresh Verification、实际运行环境及未覆盖范围。命中的必需验证失败或未执行仍阻断；不能以历史结果或 skipped 表示通过。
+
+## 发布与回滚
+
+- 发布前提与当前决定：<适用门禁、真实负责人回复及范围引用；未取得写待决定>。
+- 发布顺序与观察条件：<各仓 / 服务依赖、验证点与中止条件；不适用写依据>。
+- 回滚点、触发条件与处理人：<当前可执行方案及已有负责人>。
+- 实际执行记录：<已执行动作、版本、时间和结果引用；未执行写未发布>。
+
+本说明只汇总证据，不代替发布批准或授予外部动作权限。

package/template/.template-spec/templates/retro-report-template.md

@@ -0,0 +1,24 @@
+---
+pipeline: <feature-id>
+stage: archive
+status: draft
+owner: ai
+---
+
+# 复盘报告：<功能名称>
+
+## 做得好的地方
+
+引用本次实际结果与证据，说明哪些做法值得保留；不把预期收益写成已实现。
+
+## 需要改进的地方
+
+记录触发条件、实际影响与证据，区分已确认机制和待验证假设；说明返工或漏检为何未被既有检查发现。
+
+## 改进动作
+
+引用既有待办 / 工作项；在其权威记录中登记负责人、解决时点、验证方法、关闭条件与关闭证据。本节说明动作如何解决上述问题，不另外维护一套进度；未分派写未登记。
+
+## 沉淀去向
+
+列出需修订的事实源、Skill / 模板 / 校验场景及关联行动。关闭时引用实际修订和验证结果，只有建议或计划时保持待处理。

package/template/{docs → .template-spec}/templates/subagent-task-package-template.md

@@ -5,7 +5,7 @@ owner: ai
 
 # Digital Human Task Package：<task_id>
 
-> Canonical contract: `docs/process/schemas/digital-human-task-package.schema.json`。本文件路径保留为兼容入口。
+> Canonical contract: `.template-spec/process/schemas/digital-human-task-package.schema.json`。本文件路径保留为兼容入口。
 
 > 用于主控 Agent 派发 subagent 前固定输入、输出、写范围和验收标准。没有任务包边界时，不得派发 subagent。
 
@@ -22,7 +22,7 @@ owner: ai
 | 对应门禁 |  |
 | Ticket / MR / PR |  |
 | 主控 Agent |  |
-| 数字人角色 | `role.` 见 `docs/agents/digital-human-roles.yaml` |
+| 数字人角色 | `role.` 见 `.template-spec/agents/digital-human-roles.yaml` |
 | runtime_id | `runtime.generic` / `runtime.skill-projection` / `runtime.grok` |
 | core_skills | 从角色表复制，禁止手写 |
 | forbidden_skills | 从角色表复制，禁止手写 |
@@ -54,7 +54,7 @@ owner: ai
 | lifecycle_ref | 生命周期工作单元使用 |
 | Slice Implementation Contract | 仅 `slice-implementation` 填写 |
 | maintenance_ref | 仅 `template-maintenance` 填写维护 checkpoint |
-| 技能注册表 | `docs/agents/digital-human-roles.yaml` |
+| 技能注册表 | `.template-spec/agents/digital-human-roles.yaml` |
 | 技能默认值 | `taskPackageDefaults(<role_id>)` |
 
 ## 3. 输出要求

package/template/.template-spec/templates/verification-record-template.md

@@ -0,0 +1,64 @@
+---
+pipeline: <feature-id>
+stage: verify
+status: draft
+owner: ai
+---
+
+# <功能名称>Fresh Verification 记录
+
+> 适用场景：合并、发布、归档或宣称完成前。
+> 本文记录最新验证证据；没有 fresh verification，不得给出“完成 / 可合并 / 可发布”结论。
+
+## 1. 验证范围
+
+- 当前验证对象：<候选 / 合同 / 工作树范围及其实际摘要记录引用>。
+- 上游验收依据：<当前 Spec、Ticket、适用契约与质量基线引用>。
+- 实际运行记录：<可读日志或结构化结果引用；未运行写未执行>。
+
+以下摘要从上述证据形成，保留证据来源；资产变化后按影响重新验证，不能沿用旧通过结论。
+
+| 范围 | 说明 | 是否覆盖 |
+|------|------|----------|
+| Spec 验收标准 |  | 是 / 否 |
+| OpenAPI / 契约 |  | 是 / 否 / 不适用 |
+| 后端行为 |  | 是 / 否 / 不适用 |
+| 前端组件 / 页面 |  | 是 / 否 / 不适用 |
+| E2E 关键路径 |  | 是 / 否 / 不适用 |
+| 风险 / 回滚约束 |  | 是 / 否 / 不适用 |
+
+## 2. 命令与结果
+
+引用已有运行记录，核对其中的候选 / 输入、cwd、实际命令、开始与结束时间、退出码及日志位置。Agent 从记录整理下面的阅读摘要，人工无需另抄机器摘要；记录缺项时明确写未知，不能将计划命令写成已执行。
+
+| 运行记录引用 | 覆盖的验收 / 范围 | 实际结果与未覆盖项 |
+|---|---|---|
+| <日志 / 结构化结果> | <规则或验收引用> | <pass / fail / skipped / 未执行，及依据> |
+
+## 3. 手工验证
+
+| 场景 | 步骤 | 结果 | 证据 |
+|------|------|------|------|
+|  |  |  |  |
+
+## 4. 未覆盖风险
+
+| 风险 | 原因 | 处理方式 |
+|------|------|----------|
+|  |  |  |
+
+## 5. 完成标准
+
+- [ ] 验证命令是本次完成前新鲜执行的结果。
+- [ ] 失败项已有修复或明确阻断。
+- [ ] skipped 项有原因和处理方式；命中的必需项未执行仍阻断，未命中项才按证据记录不适用。
+- [ ] 发布 / 合并 / 归档所需证据已能追溯。
+
+## 6. 结论
+
+- 验证结论：<待验证 / 通过 / 阻断；仅针对上述候选和覆盖范围>。
+- 未覆盖范围及阻断项：<实际依据；无则说明核验范围>。
+- 合并 / 发布前提与决定：<引用当前适用门禁、Fresh Verification 和真实授权；缺失则待处理>。
+- 下一动作与负责人：<依据已有登记>。
+
+验证通过不产生合并或发布授权；实际动作仍按原流程和授权边界执行。

package/template/{docs → .template-spec}/templates/vertical-slice-ticket-template.md

@@ -72,14 +72,9 @@ Agent 使用 `scripts/slice-contract view <合同.yaml>` 展示审阅说明，
 
 ### 后端阻断规则
 
-- [ ] 未填写 `Backend Slice Implementation Contract` 时不得写后端业务代码。
-- [ ] `CMD` / `Query` / `VO` / `SingleResult` / `MultiResult` / `PageResult` 按 `yss-dto` 定义或复用；不私自新建 / 混用响应包装。
-- [ ] Controller 不用内部类或非约定包临时承载主要 DTO / VO；写操作参数继承 `CommandDTO`，读操作参数继承 `QueryDTO` 或 `PageQuery`，分页查询优先继承 `PageQuery`。
-- [ ] Controller 不手工分页主要业务集合，不穿透 Repository / Mapper / PO。
-- [ ] Application 只做用例编排、事务边界和跨聚合协调，核心领域规则放入 Domain。
-- [ ] 需要持久化的切片必须补 PO / Repository / Convertor / GatewayImpl；临时 `InMemory*Gateway` 必须标记 `seam-deferred`。
-- [ ] POJO 样板代码默认使用 Lombok；成片手写 getter/setter、constructor、builder、logger 必须说明例外原因、测试证据和 review 结论。
-- [ ] MapStruct / Convertor 强制优先；`BeanUtils.copyProperties`、反射式通用拷贝或重复手写 mapping 必须说明例外原因、测试证据和 review 结论。
+- [ ] 涉及后端业务代码时，已批准且当前的 Slice Implementation Contract 绑定 Technical Design 的架构族、工程基线、适用 Skill、测试 seam 和实现写范围。
+- [ ] 根据已批准的 `domain-driven` 或 `layered-mvc` 路线，执行合同编译器给出的 DTO、Controller、Application、持久化和对象映射约束；不得把另一架构族的 Gateway、Domain 模块或映射方式强加给本切片。
+- [ ] 合同缺失、过期、验证失败或出现新影响时停止实现，返回生命周期重新编译与批准。
 
 ## 阻塞关系
 
@@ -105,7 +100,7 @@ Agent 使用 `scripts/slice-contract view <合同.yaml>` 展示审阅说明，
 
 | 门禁 | 记录路径 | 会签角色 | 状态 |
 |---|---|---|---|
-|  | `docs/.scratch/<feature>/gates/<gate-id>-approval.yaml` | 见 `docs/agents/digital-human-roles.yaml` | pending / approved / blocked / not-applicable |
+|  | `docs/.scratch/<feature>/gates/<gate-id>-approval.yaml` | 见 `.template-spec/agents/digital-human-roles.yaml` | pending / approved / blocked / not-applicable |
 
 ## 状态
 
@@ -127,7 +122,7 @@ Agent 使用 `scripts/slice-contract view <合同.yaml>` 展示审阅说明，
 - [ ] 实现完成
 - [ ] 已新增测试且测试通过
 - [ ] 已移除调试 / 原型代码
-- [ ] 已在任务包核验 `Backend Slice Implementation Contract` 和 `Build Architecture Checklist`
+- [ ] 涉及后端时，已在任务包核验当前 Slice Implementation Contract 与适用架构约束
 - [ ] 已在任务包核验当前 `contract_id` / `contract_version`、全部工作单元和对应 `YSS Skill Execution Result`
 - [ ] 实际 changed files 均在合同允许路径内，预期证据齐全，验证结果包含执行时间
 - [ ] `new_impacts`、`drift`、`violation` 和重路由状态均有明确结论，合同未处于 `stale`

package/template/{docs → .template-spec}/user-guide//347/224/250/346/210/267/346/211/213/345/206/214.md

@@ -57,7 +57,7 @@ npx create-yss-harness-frontend@latest init --target-dir ./frontend-project --pr
 
 1. `yss-project.yaml` 是 `project-instance`。
 2. 只存在本家族 metadata，且 profile 与职责一致。
-3. 根 `CONTEXT.md`、`AGENTS.md` 和 `docs/user-guide/用户手册索引.md` 可读。
+3. 根 `CONTEXT.md`、`AGENTS.md` 和 `.template-spec/user-guide/用户手册索引.md` 可读。
 4. Git 状态、实现仓登记、验证命令和回滚点符合项目实际情况。
 
 ## 第一次让 Agent 工作

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

@@ -9,10 +9,10 @@
 
 ## 按职责进入子项目
 
-- [战略设计](https://github.com/iloveZzz/yss-harness-design-agent/blob/main/docs/user-guide/用户手册索引.md)
-- [后端交付](https://github.com/iloveZzz/yss-harness-backend-agent/blob/main/docs/user-guide/用户手册索引.md)
-- [前端接收与验收](https://github.com/iloveZzz/yss-harness-frontend-agent/blob/main/docs/user-guide/用户手册索引.md)
+- [战略设计](https://github.com/iloveZzz/yss-harness-design-agent/blob/main/.template-spec/user-guide/用户手册索引.md)
+- [后端交付](https://github.com/iloveZzz/yss-harness-backend-agent/blob/main/.template-spec/user-guide/用户手册索引.md)
+- [前端接收与验收](https://github.com/iloveZzz/yss-harness-frontend-agent/blob/main/.template-spec/user-guide/用户手册索引.md)
 
 既有通用研发实例按其固定版本和本地 README 维护，不再作为新项目入口。生成实例通过 GitHub 链接跨项目导航，但实际操作以本地 profile、CLI `--help`、包版本和模板 snapshot 为准。
 
-CLI 详解：[综合 CLI](https://github.com/iloveZzz/create-yss-spec/blob/main/docs/user-guide/create-yss-spec-cli-guide.md)、[战略 CLI](https://github.com/iloveZzz/create-yss-harness-design)、[后端 CLI](https://github.com/iloveZzz/create-yss-harness-backend)、[前端 CLI](https://github.com/iloveZzz/create-yss-harness-frontend)。组件专项见 [YSS UI MCP](yss-ui-mcp.md)。
+CLI 详解：[综合 CLI](https://github.com/iloveZzz/create-yss-spec/blob/main/.template-spec/user-guide/create-yss-spec-cli-guide.md)、[战略 CLI](https://github.com/iloveZzz/create-yss-harness-design)、[后端 CLI](https://github.com/iloveZzz/create-yss-harness-backend)、[前端 CLI](https://github.com/iloveZzz/create-yss-harness-frontend)。组件专项见 [YSS UI MCP](yss-ui-mcp.md)。

package/template/AGENTS.md

@@ -15,11 +15,11 @@
 |---|---|
 | 词汇 | `CONTEXT.md` |
 | Agent 入口红线 | `AGENTS.md` |
-| 阶段、门禁、产物、工作单元、证据、稳定 ID | `docs/process/lifecycle-registry.yaml`；`docs/process/lifecycle-artifact-map.md` 仅为派生阅读视图 |
-| 影响面、`not-applicable`、模板维护强度 | `docs/process/harness-process-tailoring.md`、`docs/process/maintenance-intensity.yaml` |
-| Skill 来源、版本、投影、路由 | `skills-lock.json`、`docs/agents/yss-skill-registry.yaml` |
-| 数字人角色、运行时与会签 | `docs/agents/digital-human-roles.yaml` |
-| 视觉规范 | `DESIGN.md`；治理见 `docs/design/design.md` |
+| 阶段、门禁、产物、工作单元、证据、稳定 ID | `.template-spec/process/lifecycle-registry.yaml`；`.template-spec/process/lifecycle-artifact-map.md` 仅为派生阅读视图 |
+| 影响面、`not-applicable`、模板维护强度 | `.template-spec/process/harness-process-tailoring.md`、`.template-source/process/maintenance-intensity.yaml` |
+| Skill 来源、版本、投影、路由 | `skills-lock.json`、`.template-spec/agents/yss-skill-registry.yaml` |
+| 数字人角色、运行时与会签 | `.template-spec/agents/digital-human-roles.yaml` |
+| 视觉规范 | `DESIGN.md`；治理见 `.template-spec/design/design.md` |
 
 其他文档和派生视图只引用，不重复定义。
 
@@ -34,7 +34,7 @@
 
 主流程：分诊 → Plan → Spec / 功能架构 → 产品设计 → 工程契约 → Ticket → 切片 → 验证 / 发布 / 复盘。
 
-- 先按 `docs/process/harness-process-tailoring.md` 判定影响面和最近可信阶段，再由 `yss-product-lifecycle` 执行 `docs/process/lifecycle-registry.yaml`；阅读导航见 `docs/process/lifecycle-artifact-map.md`。
+- 先按 `.template-spec/process/harness-process-tailoring.md` 判定影响面和最近可信阶段，再由 `yss-product-lifecycle` 执行 `.template-spec/process/lifecycle-registry.yaml`；阅读导航见 `.template-spec/process/lifecycle-artifact-map.md`。
 - 命中门禁必须完成；仅未命中时记录带原因的 `not-applicable`，不得生成空文档或混淆门禁、产物、工作单元、证据。安全 / 权限写入普通 Spec、契约、架构、验收和 seam，按实际影响触发门禁。
 - 新功能和较大变更先进入 Plan；`grill-with-docs`、`to-spec`、`to-tickets`、`implement` 仅为用户显式兼容入口。API 变更先形成 OpenAPI 3.1 Draft，审查后 Freeze，再实现。
 - Spec Delta 只记冻结基线的高风险行为差异。OpenAPI Freeze 或无 API 影响记录后拆窄垂直切片，禁止仅按技术层横拆。
@@ -42,17 +42,17 @@
 
 ## 6. Ticket 与状态
 
-- Plan / Spec / Design 按 `docs/process/stage-tracking.md` 从阶段入口登记工作、按需拆分并在恢复 / 流转时验证；工作项进度不替代 Ticket 五态和阶段批准。
+- Plan / Spec / Design 按 `.template-spec/process/stage-tracking.md` 从阶段入口登记工作、按需拆分并在恢复 / 流转时验证；工作项进度不替代 Ticket 五态和阶段批准。
 
 - 每个功能先建父 Ticket，汇总阶段资产、审查、阻塞和证据。
 - Spec、设计、原型、OpenAPI Draft 和待冻结资产使用 `ready-for-human`；只有门禁通过、阻塞清除且可直接实现的垂直切片才能使用 `ready-for-agent`。
-- 按 `docs/agents/issue-tracker.md` 持久化主 tracker，不从 Git remote 推断；平台不可用时生成待发布草案。五态见 `docs/agents/triage-labels.md`。
+- 按 `.template-spec/agents/issue-tracker.md` 持久化主 tracker，不从 Git remote 推断；平台不可用时生成待发布草案。五态见 `.template-spec/agents/triage-labels.md`。
 
 ## 7. 实现与 YSS 路由硬门禁
 
-- 实现前按 `docs/process/implementation-repo-integration.md` 登记仓库、项目根、分支、CI、验证命令、回滚点；再用 `yss-implementation-contract-compiler` 编译最小 Skill 集和当前合同。
+- 实现前按 `.template-spec/process/implementation-repo-integration.md` 登记仓库、项目根、分支、CI、验证命令、回滚点；再用 `yss-implementation-contract-compiler` 编译最小 Skill 集和当前合同。
 - 无工程先确认外部仓库或输出目录。Backend `scaffold_status=required` 时，由生命周期推荐 `domain-driven` / `layered-mvc`，用户逐项目确认后路由；Frontend 用 `yss-frontend-scaffold-generator`。缺目录不改路由。
-- 脚手架仅在 `scaffold-architecture-decisions.yaml` 已确认且当前、schema v3 合同已持久化并获批准后无交互运行，只生成机械骨架。既有工程不得重选或覆盖；架构转换单独立项。
+- 脚手架仅在 `scaffold-architecture-decisions.yaml` 已确认且当前、Project Scaffold Contract schema v4 已持久化并获批准后无交互运行，只生成机械骨架。既有工程不得重选或覆盖；架构转换单独立项。
 - 正式切片只消费已批准、已持久化且当前的 Slice Implementation Contract；编译器只起草，不批准、不设置 `ready-for-agent`、不宣布完成。
 - UI 切片在 `ready-for-agent` 前须有已校验的 `frontend_implementation_plan`，实现后补 `frontend_implementation_verification`，覆盖截图 / 视觉回归、状态交互、console warning、实际 `pnpm` 退出码。
 - 前端验证优先 `pnpm`，后端优先根 `./mvnw`；缺少时记录受控例外和实际命令。
@@ -62,7 +62,7 @@
 
 - 技术事实、标准、第三方 API 或框架行为用 `yss-research`（`technical-evidence` / `strategy-evidence`）；竞品、市场、口碑用 `competitive-intelligence`。
 - 产品设计由 `yss-prototype-stage` 持有合同并调用设计系统、独立评审、H1 / H2 适配器；原型禁用 `yss-ui`。真实组件事实只用于实现计划、已批准实现和还原验证。
-- 数字人协同或会签先读 `docs/agents/digital-human-roles.yaml`；角色不得另起生命周期、批准 Slice 合同、设置 `ready-for-agent` 或宣布可发布。
+- 数字人协同或会签先读 `.template-spec/agents/digital-human-roles.yaml`；角色不得另起生命周期、批准 Slice 合同、设置 `ready-for-agent` 或宣布可发布。
 - 业务行为默认按 `tdd` 的 `behavior-tdd` 使用已确认公开 seam 逐切片实现；一次性生成、纯配置或流程文档不适用时，记录例外理由和可执行验证。
 
 ## 9. 工作区与实现仓库边界
@@ -81,7 +81,7 @@
 
 ## 11. Subagent 协同
 
-- 使用 subagent 或其他运行时前读 `docs/process/subagent-collaboration.md`，建立含角色、`runtime_id`、执行态、技能约束和不重叠写范围的任务包；共享工作区不是安全边界。
+- 使用 subagent 或其他运行时前读 `.template-spec/process/subagent-collaboration.md`，建立含角色、`runtime_id`、执行态、技能约束和不重叠写范围的任务包；共享工作区不是安全边界。
 - 仓库身份、Ticket 最终状态、Git checkpoint、Slice 合同批准和完成结论由主控裁决；实现者不得兼任独立审查者或会签自己的资产。
 
 ## 12. 测试质量基线

package/template/CONTEXT.md

@@ -19,10 +19,10 @@ context_schema_version: 1
 | Agent | 执行特定工作流步骤的 AI 协作者。 | — | 不要与生物人审查者、数字人角色或 Ticket 状态混用。运行时实例（Cursor Agent、Codex、Grok Bot 等）是 Agent 的承载，不是角色本身。 |
 | 运行时绑定 | 把数字人角色落到某个 Agent 平台的适配声明，权威清单在数字人角色注册表的 `runtimes`。 | — | 不要为每个平台复制一套职称职责。 |
 | Grok Bot | Grok 平台上的持久数字队友实例；对应 `runtime.grok`。 | — | 不是数字人角色、技能或门禁。 |
-| 数字人角色 | 叠加在生命周期编排器上的职称配置；一个运行时实例绑定一种。v1 清单以 `docs/agents/digital-human-roles.yaml` 为准。 | — | 不要称为 Ticket「标准角色」、职能 Agent 或某个平台的产品名。 |
+| 数字人角色 | 叠加在生命周期编排器上的职称配置；一个运行时实例绑定一种。v1 清单以 `.template-spec/agents/digital-human-roles.yaml` 为准。 | — | 不要称为 Ticket「标准角色」、职能 Agent 或某个平台的产品名。 |
 | 主控数字人 | 运行 `yss-product-lifecycle` 的协调实例。 | — | 不是第八个业务职称；默认兼任项目经理。 |
 | 角色配置 | 某数字人角色的关注阶段、技能包、可起草产物和禁止事项。 | — | 不是独立编排器，也不含平台群聊人数。 |
-| 生命周期会签 | 指定数字人或生物人关闭 `gate.*` / 独立审查并写入 `evidence.approval-record`。 | — | 不是运行时副作用审批。会签人由 `docs/agents/digital-human-roles.yaml` 的 `gate_policy` 指定。起草者不得会签自己起草的资产。`paused-human-gate` 表示等待该会签人，不是必须生物人。 |
+| 生命周期会签 | 指定数字人或生物人关闭 `gate.*` / 独立审查并写入 `evidence.approval-record`。 | — | 不是运行时副作用审批。会签人由 `.template-spec/agents/digital-human-roles.yaml` 的 `gate_policy` 指定。起草者不得会签自己起草的资产。`paused-human-gate` 表示等待该会签人，不是必须生物人。 |
 | 用户决定 | 提问者或其明确指定的生物人负责人针对已展示资产、版本及范围作出的可追溯回复。 | — | 数字人审查不能代答；原始回复、指定依据及批准范围按用户决定协议记录。 |
 | 运行时副作用审批 | 对发消息、改生产、付款、删数据等工具动作的账号级确认。 | — | 点 Allow 不等于门禁已批准或可发布。避免只称「Grok 平台审批」。 |
 | Ticket 状态 | Tracker 五态：`needs-triage`、`needs-info`、`ready-for-agent`、`ready-for-human`、`wontfix`。 | — | 不要称为数字人角色或「标准角色」。 |
@@ -92,7 +92,7 @@ context_schema_version: 1
 | 试验技能 | 尚未达到项目默认支持成熟度的技能。 | — | 只在明确试验范围内使用，不进入 实现合同编译器 默认技能闭包。 |
 | 显式兼容入口 | 为已有用户操作习惯保留的 user-invoked 工作流入口，写入前由生命周期编排器预检，结果回交其验收。 | — | 不是默认路径、过时别名或可以越过门禁的第二套生命周期。 |
 | 技能成熟度 | 描述技能从 `draft`、`verified`、`supported` 到 `deprecated` 的治理状态。 | — | 不等同于文件存在、已被投影或能够安装。 |
-| 技能注册表 | 记录技能身份、别名、分层、适用影响面、成熟度、默认可发现性和 Agent 运行时入口的机器可读路由资产。 | — | 不替代 `skills-lock.json` 的来源、hash 和投影完整性职责。当前 `docs/agents/yss-skill-registry.yaml` 为 `active`，实现合同编译器、生命周期编排器和实例发现面必须消费通过校验的 canonical 技能及其 alias 解析结果。 |
+| 技能注册表 | 记录技能身份、别名、分层、适用影响面、成熟度、默认可发现性和 Agent 运行时入口的机器可读路由资产。 | — | 不替代 `skills-lock.json` 的来源、hash 和投影完整性职责。当前 `.template-spec/agents/yss-skill-registry.yaml` 为 `active`，实现合同编译器、生命周期编排器和实例发现面必须消费通过校验的 canonical 技能及其 alias 解析结果。 |
 | LLM Wiki | 由 `raw/`、`wiki/` 与 `.wiki-manifest.json` 组成的本地持久知识库。 | — | 不是 `yss-research` 一次性研究包，也不替代权威源。`ingest` 只把用户点名的外源或已落盘研究笔记编进 IR，不改 live 权威文件。 |
 | 生态发布清单 | 关联模板 schema 与 commit、CLI 版本与快照、公开技能来源与导出 hash 的跨仓发布证据。 | — | 不要求尚未生成的仓库 commit 互相循环引用。 |
 | 研发管理仓库 | 承载 Spec、OpenAPI、架构、Ticket、验证、发布和复盘等研发管理资产的仓库。 | — | 不等同于前端 / 后端代码 monorepo。 |