create-yss-spec 3.5.0 → 3.5.3

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

@@ -27,6 +27,34 @@
     "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
@@ -44,7 +72,10 @@
       "minLength": 1
     },
     "schema_version": {
-      "const": 1
+      "enum": [
+        1,
+        2
+      ]
     },
     "frontend_delivery": {
       "type": "object",
@@ -127,7 +158,7 @@
       ],
       "properties": {
         "registry_ref": {
-          "const": "docs/agents/digital-human-roles.yaml"
+          "const": ".template-spec/agents/digital-human-roles.yaml"
         },
         "defaults_ref": {
           "type": "string",
@@ -168,7 +199,8 @@
           "enum": [
             "lifecycle-work-unit",
             "slice-implementation",
-            "template-maintenance"
+            "template-maintenance",
+            "read-only-intake"
           ]
         },
         "contract_id": {
@@ -330,7 +362,7 @@
     },
     "allowed_write_paths": {
       "type": "array",
-      "minItems": 1,
+      "minItems": 0,
       "uniqueItems": true,
       "items": {
         "type": "string",
@@ -356,7 +388,7 @@
     },
     "expected_evidence_files": {
       "type": "array",
-      "minItems": 1,
+      "minItems": 0,
       "uniqueItems": true,
       "items": {
         "type": "string",
@@ -365,7 +397,7 @@
     },
     "verification_commands": {
       "type": "array",
-      "minItems": 1,
+      "minItems": 0,
       "items": {
         "type": "string",
         "minLength": 1
@@ -410,6 +442,10 @@
           "stderr_ref": {
             "type": "string",
             "minLength": 1
+          },
+          "evidence_digest": {
+            "type": "string",
+            "pattern": "^sha256:[a-f0-9]{64}$"
           }
         }
       }
@@ -586,6 +622,42 @@
         "checkpoint_ref": {
           "type": "string",
           "minLength": 1
+        },
+        "research_verification": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "ref",
+            "digest"
+          ],
+          "properties": {
+            "ref": {
+              "type": "string",
+              "minLength": 1
+            },
+            "digest": {
+              "type": "string",
+              "pattern": "^sha256:[0-9a-f]{64}$"
+            }
+          }
+        },
+        "maintenance_authorization": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "ref",
+            "digest"
+          ],
+          "properties": {
+            "ref": {
+              "type": "string",
+              "minLength": 1
+            },
+            "digest": {
+              "type": "string",
+              "pattern": "^sha256:[0-9a-f]{64}$"
+            }
+          }
         }
       }
     },
@@ -664,6 +736,16 @@
     "checkpoint_ref": {
       "type": "string",
       "minLength": 1
+    },
+    "verification_status": {
+      "enum": [
+        "not-executed",
+        "executed"
+      ]
+    },
+    "observation_ref": {
+      "type": "string",
+      "pattern": "^run:"
     }
   },
   "allOf": [
@@ -752,6 +834,127 @@
           "review_context"
         ]
       }
+    },
+    {
+      "if": {
+        "properties": {
+          "schema_version": {
+            "const": 1
+          }
+        }
+      },
+      "then": {
+        "properties": {
+          "contract": {
+            "properties": {
+              "kind": {
+                "enum": [
+                  "lifecycle-work-unit",
+                  "slice-implementation",
+                  "template-maintenance"
+                ]
+              }
+            }
+          },
+          "allowed_write_paths": {
+            "minItems": 1
+          },
+          "expected_evidence_files": {
+            "minItems": 1
+          },
+          "verification_commands": {
+            "minItems": 1
+          }
+        }
+      },
+      "else": {
+        "required": [
+          "verification_status"
+        ],
+        "properties": {
+          "execution_state": {
+            "const": "Explorer"
+          },
+          "work_unit_id": {
+            "enum": [
+              "work-unit.entry-triage",
+              "work-unit.harness-entry"
+            ]
+          },
+          "allowed_write_paths": {
+            "maxItems": 0
+          },
+          "contract": {
+            "properties": {
+              "kind": {
+                "const": "read-only-intake"
+              }
+            },
+            "not": {
+              "anyOf": [
+                {
+                  "required": [
+                    "maintenance_ref"
+                  ]
+                },
+                {
+                  "required": [
+                    "slice_contract_ref"
+                  ]
+                },
+                {
+                  "required": [
+                    "lifecycle_ref"
+                  ]
+                }
+              ]
+            }
+          },
+          "result": {
+            "properties": {
+              "changed_files": {
+                "maxItems": 0
+              },
+              "changed_artifacts": {
+                "maxItems": 0
+              },
+              "next_route": {
+                "type": "null"
+              }
+            }
+          },
+          "stage_id": {
+            "enum": [
+              "stage.entry-triage",
+              "stage.harness-entry"
+            ]
+          }
+        },
+        "not": {
+          "anyOf": [
+            {
+              "required": [
+                "checkpoint_ref"
+              ]
+            },
+            {
+              "required": [
+                "review_context"
+              ]
+            },
+            {
+              "required": [
+                "review_input"
+              ]
+            },
+            {
+              "required": [
+                "user_decisions"
+              ]
+            }
+          ]
+        }
+      }
     }
   ]
 }

package/template/{docs → .template-spec}/process/schemas/frontend-implementation-evidence.schema.json

@@ -6,6 +6,8 @@
   "additionalProperties": false,
   "required": ["schema_version", "kind", "template", "status", "prototype_ref", "spec_ref", "visual_baseline", "route_and_page_inventory", "pnpm_commands"],
   "properties": {
+    "console_evidence": {"$ref": "#/$defs/binding"},
+    "implementation_plan": {"$ref": "#/$defs/binding"},
     "frontend_delivery": {"type":"object","additionalProperties":false,"required":["acceptance_ref","digest"],"properties":{"acceptance_ref":{"type":"string","minLength":1},"digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}}},
     "slice_id": {"type":"string","minLength":1},
     "slice_contract_ref": {"type":"string","minLength":1},
@@ -23,7 +25,7 @@
     "state_cases": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}},
     "pnpm_commands": {"type": "array", "minItems": 1, "items": {"type": "string", "pattern": "^pnpm(?: |$)"}},
     "case_results": {"type": "array", "minItems": 1, "items": {"$ref": "#/$defs/caseResult"}},
-    "interaction_results": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}},
+    "interaction_results": {"type": "array", "minItems": 1, "items": {"oneOf": [{"type": "string", "minLength": 1}, {"$ref": "#/$defs/interaction"}]}},
     "console_warning_check": {"enum": ["pass", "blocked"]},
     "actual_verification": {"type": "array", "minItems": 1, "items": {"$ref": "#/$defs/verification"}},
     "uncovered_differences": {"type": "array", "items": {"type": "string", "minLength": 1}},
@@ -35,6 +37,8 @@
     {"if": {"properties": {"kind": {"const": "verification"}}, "required": ["kind"]}, "then": {"required": ["case_results", "interaction_results", "console_warning_check", "actual_verification", "uncovered_differences", "difference_owner", "independent_review"]}}
   ],
   "$defs": {
+    "interaction": {"type": "object", "additionalProperties": false, "required": ["case_id", "state", "result", "evidence_ref", "evidence_digest"], "properties": {"case_id": {"$ref": "#/$defs/caseId"}, "state": {"type": "string", "minLength": 1}, "result": {"enum": ["pass", "failed", "blocked"]}, "evidence_ref": {"type": "string", "minLength": 1}, "evidence_digest": {"$ref": "#/$defs/digest"}}},
+    "binding": {"type": "object", "additionalProperties": false, "required": ["ref", "digest"], "properties": {"ref": {"type": "string", "minLength": 1}, "digest": {"$ref": "#/$defs/digest"}}},
     "digest": {"type": "string", "pattern": "^sha256:[a-f0-9]{64}$"},
     "caseId": {"type": "string", "pattern": "^[a-z0-9][a-z0-9-]*$"},
     "visualBaseline": {
@@ -52,20 +56,8 @@
       "required": ["route", "page", "case_ids"],
       "properties": {"route": {"type": "string", "minLength": 1}, "page": {"type": "string", "minLength": 1}, "case_ids": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"$ref": "#/$defs/caseId"}}}
     },
-    "caseResult": {
-      "type": "object", "additionalProperties": false,
-      "required": ["case_id", "baseline_image_ref", "implementation_image_ref", "diff_ref", "mask_ref", "result", "uncovered_difference", "explanation"],
-      "properties": {
-        "case_id": {"$ref": "#/$defs/caseId"}, "baseline_image_ref": {"type": "string", "minLength": 1}, "implementation_image_ref": {"type": "string", "minLength": 1},
-        "diff_ref": {"type": "string", "minLength": 1}, "mask_ref": {"type": "string", "minLength": 1}, "result": {"enum": ["pass", "blocked"]},
-        "uncovered_difference": {"type": "boolean"}, "explanation": {"type": "string"}
-      }
-    },
-    "verification": {
-      "type": "object", "additionalProperties": false,
-      "required": ["command", "exit_code", "executed_at", "evidence_ref"],
-      "properties": {"command": {"type": "string", "minLength": 1}, "exit_code": {"type": "integer"}, "executed_at": {"type": "string", "minLength": 1}, "evidence_ref": {"type": "string", "minLength": 1}}
-    },
+    "caseResult": {"type": "object", "additionalProperties": false, "required": ["case_id", "baseline_image_ref", "implementation_image_ref", "diff_ref", "mask_ref", "result", "uncovered_difference", "explanation"], "properties": {"case_id": {"$ref": "#/$defs/caseId"}, "baseline_image_ref": {"type": "string", "minLength": 1}, "implementation_image_ref": {"type": "string", "minLength": 1}, "diff_ref": {"type": "string", "minLength": 1}, "mask_ref": {"type": "string", "minLength": 1}, "result": {"enum": ["pass", "blocked"]}, "uncovered_difference": {"type": "boolean"}, "explanation": {"type": "string"}, "implementation_image_digest": {"$ref": "#/$defs/digest"}, "diff_digest": {"$ref": "#/$defs/digest"}}},
+    "verification": {"type": "object", "additionalProperties": false, "required": ["command", "exit_code", "executed_at", "evidence_ref"], "properties": {"command": {"type": "string", "minLength": 1}, "exit_code": {"type": "integer"}, "executed_at": {"type": "string", "minLength": 1}, "evidence_ref": {"type": "string", "minLength": 1}, "evidence_digest": {"$ref": "#/$defs/digest"}}},
     "review": {
       "type": "object", "additionalProperties": false,
       "required": ["reviewer", "candidate_digest", "status", "findings_ref"],

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/.template-spec/process/subagent-collaboration.md

@@ -0,0 +1,21 @@
+# Subagent 协作规则
+
+Subagent 和其它运行时实例只接收边界清晰的任务包。主控数字人负责仓库身份、门禁计算、Ticket 状态、Git checkpoint 和完成结论。数字人角色、`runtime_id` 与 Explorer / Drafter / Worker / Reviewer / Verifier 执行态正交，任务包必须同时写明。
+
+写入范围不得与其他执行者重叠；实现者不得同时担任同一切片的独立审查者，也不得会签自己起草的资产。写隔离以任务包为准。某运行时若共享磁盘或会话，不得把不同实例当成安全边界。
+
+## 任务包
+
+凡主控向数字人角色或独立运行时正式派发生命周期工作单元，都必须使用 `.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`（形状见 `.template-spec/templates/approval-record-template.yaml`），不能用聊天表情代替。恢复前校验 `scripts/verify-approval-record`。
+
+## 只读分诊任务包 v2
+
+schema v1 及三种正式合同继续执行原规则。v2 仅用于 `read-only-intake`：`Explorer`、注册表已有 `work-unit.entry-triage` 或专职 Profile 的 `work-unit.harness-entry`、`allowed_write_paths: []`，不带 checkpoint、Slice 或正式审查合同。研究完成只回传来源和结论，不更新阶段、Ticket、批准或 `next_route`；写正式资产前由主控重新分析影响并生成正式任务包。旧消费者必须拒绝 v2 并升级，禁止改写为 v1 绕过边界。
+
+`prepare-read-only-intake --input <选择.yaml> --output <仓库外/task.json>` 从角色默认值生成任务包；输入沿用任务 ID、角色、运行时、分诊入口、合同 ID/版本/来源、输入、目标、禁止事项、预期输出、下游消费者和汇合字段。`run-read-only-intake --task <task.json> --run-dir <仓库外新目录> [--timeout-ms <毫秒>] -- <命令> <参数>` 保存观测与日志；不传命令时明确未执行验证。复核使用 `verify-digital-human-task-package <run-dir/task-result.json> --run-dir <绝对目录>`。
+
+运行证据使用 `run:` 相对引用，禁止绝对路径、`..` 与符号链接逃逸。命令、退出码、时间、stdout/stderr 与摘要必须一致；源码引用不能冒充运行日志。派发器观察 Git 跟踪、未跟踪及忽略文件的新增、删除、修改及已初始化子仓，结果中的空变更声明不能覆盖实际差异。未初始化子仓阻断观测。此工具是合同与结果审计，不是 OS 沙箱：执行期间改后恢复及可信派发器证据被恶意同步伪造不在终态观测能力内；运行目录应由派发器持有，不扩大 Agent 仓库写权限，运行时仍须采用只读权限。恢复后重新观察，不能直接复用旧完成状态。

package/template/{docs → .template-spec}/process/templates/frontend-implementation-verification-template.yaml

@@ -19,12 +19,25 @@ case_results:
   - case_id: primary-desktop
     baseline_image_ref: docs/.scratch/example/handoff/visual-baseline-v1/images/primary-desktop.png
     implementation_image_ref: docs/.scratch/example/verification/images/primary-desktop.png
+    implementation_image_digest: sha256:0000000000000000000000000000000000000000000000000000000000000000
+    diff_digest: sha256:0000000000000000000000000000000000000000000000000000000000000000
     diff_ref: docs/.scratch/example/verification/diffs/primary-desktop.png
     mask_ref: not-applicable
     result: blocked
     uncovered_difference: false
     explanation: <difference-or-not-applicable>
-interaction_results: [loading, empty, error, permission, selected, key-interaction]
+implementation_plan:
+  ref: docs/.scratch/example/verification/frontend-plan.yaml
+  digest: sha256:0000000000000000000000000000000000000000000000000000000000000000
+interaction_results:
+  - case_id: primary-desktop
+    state: key-interaction
+    result: blocked
+    evidence_ref: docs/.scratch/example/verification/interaction.json
+    evidence_digest: sha256:0000000000000000000000000000000000000000000000000000000000000000
+console_evidence:
+  ref: docs/.scratch/example/verification/console.json
+  digest: sha256:0000000000000000000000000000000000000000000000000000000000000000
 console_warning_check: blocked
 pnpm_commands: [pnpm lint, pnpm type-check, pnpm test]
 actual_verification:
@@ -32,6 +45,7 @@ actual_verification:
     exit_code: 0
     executed_at: <iso-8601>
     evidence_ref: docs/.scratch/example/verification/pnpm-test.txt
+    evidence_digest: sha256:0000000000000000000000000000000000000000000000000000000000000000
 uncovered_differences: []
 difference_owner: null
 independent_review:

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. 输出要求