create-yss-spec 3.5.2 → 3.5.3

package/template/.pi/skills/yss-product-lifecycle/references/orchestration-contract.yaml

@@ -168,7 +168,7 @@ entry_routing:
   invalid_manifest:
     action: migration-check
   formal_user_entry:
-    skills: [setup-matt-pocock-skills, grill-with-docs, to-spec, to-tickets, implement]
+    skills: [setup-matt-pocock-skills, to-spec, to-tickets, implement]
     action: lifecycle-validate-and-accept
     lifecycle_artifact_write: conditional-explicit-user-entry
     return_to_orchestrator: required
@@ -297,8 +297,8 @@ task_package:
 # may prepare, validate and accept their results, but cannot invoke them or create
 # their formal artifacts on their behalf.
 matt_invocation_boundary:
-  user_invoked_skills: [grill-with-docs, handoff, implement, improve-codebase-architecture, setup-matt-pocock-skills, to-questionnaire, to-spec, to-tickets, triage, wait-what, wayfinder]
-  lifecycle_managed_user_entries: [setup-matt-pocock-skills, grill-with-docs, to-spec, to-tickets, implement]
+  user_invoked_skills: [handoff, implement, setup-matt-pocock-skills, to-spec, to-tickets, triage, wayfinder]
+  lifecycle_managed_user_entries: [setup-matt-pocock-skills, to-spec, to-tickets, implement]
   model_invoked_skills: [code-review, codebase-design, diagnosing-bugs, domain-modeling, grilling, prototype, resolving-merge-conflicts, tdd, writing-for-agents, yss-research]
   lifecycle_allowed_model_invoked_skills: [code-review, codebase-design, diagnosing-bugs, domain-modeling, grilling, prototype, tdd, yss-research]
   lifecycle_may_invoke_user_invoked: false
@@ -323,6 +323,18 @@ lifecycle_native_entries:
     implement: lifecycle-validate-and-accept
 
 work_unit_routes:
+  work-unit.maintenance-research:
+    native: {source: yss-product-lifecycle, skill: yss-research, invocation_mode: model-invoked}
+    primary_skill: yss-research
+    supporting_skills: []
+    skills: [yss-research]
+    applies_when: template_source_persisted_research
+    not_applicable_reason: project_instance_or_no_persisted_research
+    repository_mode: template-source
+    completion_validator: scripts/verify-maintenance-research
+    terminal_allowed: true
+    next_routes: [work-unit.ssot-update]
+    continuation_requires: bound_user_maintenance_authorization
   work-unit.plan-opportunity:
     native: {source: yss-product-lifecycle, skill: yss-product-lifecycle, invocation_mode: model-invoked}
     primary_skill: yss-product-lifecycle
@@ -1031,7 +1043,11 @@ wayfinder_mode:
   template_source_use: only-when-template-evolution-is-long-running
 
 context_engineering:
-  contract_field: slice_contract.common.context_plan
+  contract_field: slice_contract.common.context_plan # 仅运行时归一化读取别名
+  raw_v2_contract_field: slice_contract.common.context_plan
+  raw_v3_contract_field: slice_contract.scope.context_plan
+  dispatch_reading: implementation-task-view-or-review-view
+  reading_reference: .template-spec/process/contract-reading.md
   required_context: [CONTEXT.md, approved-spec, current-slice-contract, applicable-adr-or-baseline]
   on_demand_context: [specialist-references, implementation-repository-files, historical-evidence]
   stop_rule: minimal-sufficient-evidence

package/template/.pi/skills/yss-product-lifecycle/references/orchestration.md

@@ -131,7 +131,7 @@ tracker 选择和冲突按 `.template-spec/agents/issue-tracker.md` 裁决：已
 
 Decision ticket 产生决策，不是实现切片，不得标记 `ready-for-agent`。
 
-## `grill-with-docs` 退出判定
+## `work-unit.plan-requirements` 退出判定
 
 进入 `to-spec` 前必须区分已确认项与未决项，并确认用户、问题、MVP、非目标、成功标准、术语/ADR 候选和测试 seam。事实问题走 `yss-research`；需 runnable 反馈的问题走 `handoff → prototype → handoff`。存在未回流 blocker 时不得进入 Spec baseline。
 
@@ -139,7 +139,7 @@ Prototype 回流必须有可核验证据：来源 handoff、prototype 资产或
 
 Matt `prototype` 的回流还必须注明 `prototype_branch`，并保留单文件 HTML 主来源；该结果只能作为 YSS 原型输入，仍须完成阶段 4 的低保真评审、H1/H2 档位路由、schema v4 验证和用户确认，不得用 throwaway prototype 替代。
 
-`to-questionnaire` 未收到答案时使用 `external-input-required` 暂停，记录问卷、接收人、所需输出和恢复路由；收到答案后记录 response、重新分类影响面和更新后的权威资产，再回到 `grill-with-docs` 或 `to-spec`。
+生命周期外部输入问卷 未收到答案时使用 `external-input-required` 暂停，记录问卷、接收人、所需输出和恢复路由；收到答案后记录 response、重新分类影响面和更新后的权威资产，再回到 `work-unit.plan-requirements` 或 `to-spec`。
 
 Release 与 Retrospective 属于生命周期编排器拥有的工作单元。发布和复盘前都必须重新取得 fresh verification；发布还需要发布/回滚证据和独立审查，复盘还需要复盘记录和治理回流判断，再回流权威资产。
 

package/template/.pi/skills/yss-product-lifecycle/references/plan-requirements.md

@@ -0,0 +1,10 @@
+# 需求澄清与 Context 对账
+
+`work-unit.plan-requirements` 由 `yss-product-lifecycle` 或当前 profile 编排器执行，按需使用 `grilling` 和 `domain-modeling`，不另建批准入口。
+
+1. 读取 yss-project.yaml 与唯一根 CONTEXT.md，执行 `scripts/verify-context-contract --root . --json`。缺失、大小写错误、嵌套合同、跨仓路径、伪锚点或不支持的 schema 都阻断；格式消费 `domain-modeling/CONTEXT-FORMAT.md`。
+2. 先查可发现事实；真正用户决定才组成当前决策前沿，每个问题给出建议，保留原始回复。未确认的术语留在 Plan，不能写成稳定事实。
+3. 确认后由 domain-modeling 维护五列业务词汇表，以 `<ContextId>/<EnglishIdentifier>` 标识；非 Global 的 ContextId 来自已确认业务责任区。只有难以逆转、非显然且有真实取舍的决定才形成 ADR。研究和实际验证保留可读证据。
+4. `project-instance` 批准或返回下一工作单元前生成 `context_reconciliation`，保存可读 ref、document_digest、referenced_terms_digest 与 term_refs，并执行对账验证。候选、别名、范围冲突或摘要漂移均阻断；对账不另增门禁。`template-source` 仅校验模板合同并记录有原因的 `not-applicable`，不虚构业务术语。
+5. 结束时列出已确认决定、未决假设、变更文档、对账状态与引用、下一授权动作。按既有退出判定确认用户、问题、MVP、非目标、成功标准及测试 seam，未回流 blocker 不得进入 Spec。
+6. 共享理解与变更范围未确认前不改实现合同或代码；澄清结果不能批准资产、设置 ready-for-agent 或自行推进阶段，交回当前编排器验收。

package/template/.pi/skills/yss-product-lifecycle/references/state-model.md

@@ -33,7 +33,7 @@ phase_boundary:
 
 `handoff` 必须有来源和目的地；subagent 必须有任务包和汇合证据；`compact` 必须有下一阶段。`Continue`、`clear` 不要求跨上下文引用，但仍应记录判断理由。
 
-`to-questionnaire` 的暂停使用 `pause.reason_code: external-input-required`，并保存 `questionnaire_ref`、`recipient_role`、`requested_outputs` 和 `resume_route`。答案回流后补 `response_ref`、`reclassified_impact` 和 `updated_authoritative_asset`，然后重新计算 `stale`、门禁和可执行 frontier。
+生命周期外部输入问卷 的暂停使用 `pause.reason_code: external-input-required`，并保存 `questionnaire_ref`、`recipient_role`、`requested_outputs` 和 `resume_route`。答案回流后补 `response_ref`、`reclassified_impact` 和 `updated_authoritative_asset`，然后重新计算 `stale`、门禁和可执行 frontier。
 
 ## `ready-for-agent` 公式
 

package/template/.pi/skills/yss-research/SKILL.md

@@ -42,6 +42,8 @@ Do not silently promote an exploratory request solely because more rigor would b
 
 Use a background Agent when the runtime supports it and the reading can proceed independently while other useful work continues. Otherwise research in the current Agent. Delegation is an execution optimization, not a trust signal.
 
+Read-only intake uses task-package schema v2 with `contract.kind: read-only-intake`, `Explorer`, a registered intake work unit and an empty write set. Use `scripts/prepare-read-only-intake` and `scripts/run-read-only-intake`; the dispatcher keeps task and execution evidence outside the repository. No maintenance checkpoint is needed for research intake. No executed commands means `verification_status: not-executed`, not verified. Formal asset writes require owner impact analysis and a new formal task package. See `.template-spec/process/subagent-collaboration.md`.
+
 Lifecycle dispatches must use the repository's structured task package, write isolation, role binding, and handoff contract. The owner receiving the result remains responsible for verifying material claims before consuming them.
 
 ## Evidence-audited workflow
@@ -76,4 +78,6 @@ node scripts/validate-research-package.mjs <slug>-research-brief.md <slug>-evide
 
 In `template-source`, save reusable maintenance research under the existing `.template-source/evidence/maintenance/` convention. In `project-instance`, use the project research/evidence convention and bind any decision-bearing output from the lifecycle asset that consumes it.
 
+模板中正式落盘的研究使用 `work-unit.maintenance-research`，按 `.template-spec/process/research-completion.md` 记录当前验证并收尾；结束研究不授予维护或产品批准。仅回传结论的只读分诊继续使用既有 read-only-intake v2，不伪装成正式研究闭包。
+
 If sources are unavailable or conflict, state the limitation. Ordinary gaps lower confidence; a missing or mismatched source for a decision-bearing claim prevents that claim from being treated as established.

package/template/.template-spec/agents/README.md

@@ -18,7 +18,7 @@
 | `issue-tracker.md` | Ticket / Spec / triage 在 Local Markdown、GitLab Issues 与 GitHub Issues 间路由的操作约定 |
 | `triage-labels.md` | 标准五态 triage 标签与含义 |
 | `domain.md` | 领域文档读取和维护规则 |
-| `skills-maintenance.md` | Engineering Skills 的安装、升级和验证说明 |
+| `.template-source/agents/skills-maintenance.md`（仅模板源） | 模板源的技能安装、升级和验证说明；项目实例无需此维护文档 |
 | `yss-skill-registry.yaml` | 技能分层、别名与运行时入口（active；不替代锁文件） |
 | `gitlab-workflow-skills.md` | GitLab、MR、CI 和自动 gitworks 的技能配置与使用规则 |
 

package/template/.template-spec/agents/digital-human-roles.yaml

@@ -76,7 +76,7 @@ roles:
     title: YSS 需求经理
     stages: [ stage.plan, stage.spec-architecture ]
     draft_artifact_ids: [ artifact.plan-record, artifact.spec ]
-    core_skills: [ grilling, domain-modeling, yss-research, competitive-intelligence, grill-with-docs ]
+    core_skills: [ grilling, domain-modeling, yss-research, competitive-intelligence ]
     forbidden_skills: [ yss-ui, yss-domain, yss-web-controller, yss-repository, yss-ddd-scaffold-generator, yss-layered-mvc-scaffold-generator, yss-frontend-scaffold-generator, implement, tdd ]
     description: >-
       Own Plan language, users, MVP, non-goals, success criteria, test seams, and Spec prose. Propose CONTEXT.md glossary entries. Do not freeze visual prototypes, OpenAPI, or code. Do not guess unconfirmed business rules. Hand off to the orchestrator when the frontier is empty.

package/template/.template-spec/agents/skill-migrations.md

@@ -98,3 +98,18 @@ DDD 脚手架的 Parent 工程约束由 `yss-ddd-scaffold-generator/references/e
 - 独立低保真评审：`prototype-review`
 
 已关闭的 Prototype Evidence schema v1/v2/v3、旧 artifact ID、AntD CLI、浏览器验证和确认记录只读保留。在途 UI 工作迁移到 Prototype Evidence schema v4、Visual Baseline schema v1 与 `artifact.prototype-deliverable` 后再关闭门禁；无 UI 影响不创建空包。不得创建同名兼容目录或删除历史证据。
+
+## 2026-09-28 入口收敛
+
+以下旧 Skill ID 已硬退役：新调用返回 `skill-retired` 和迁移提示，不能自动执行替代入口或改变阶段状态。历史证据只读保留。
+
+| 旧入口 | 承接位置 |
+|---|---|
+| wait-what | 普通解释对话，按文档写作规范或 i-have-adhd 调整表达 |
+| grill-with-docs | 当前生命周期的 work-unit.plan-requirements，保留 Context 校验、对账和退出判定 |
+| to-questionnaire | 当前生命周期外部输入问卷，保留 external-input-required 与答案回流合同 |
+| improve-codebase-architecture | codebase-design 显式架构审计模式及可选 HTML 报告 |
+
+Data Analytics 平台包从本模板及 frontend 分发退出；不卸载用户另装插件。frontend-commit / java-backend-commit 保留专项入口并读取内部 git-commit-core。prototype 仅做逻辑与状态试验；正式 UI 由生命周期产品设计阶段承接。
+
+存量实例先预览同步计划。只按旧版本基线移除未修改的受管文件，用户修改保留并报告冲突；不自动迁移历史审批、问卷或快照。

package/template/.template-spec/agents/yss-skill-registry.yaml

@@ -190,6 +190,10 @@ recipes:
   - { id: frontend.vue3-scaffold, capabilities: [scaffold.frontend-vue3] }
   - { id: backend.springboot3-migration, capabilities: [migration.springboot3, quality.java-code-style] }
 skill_dependencies:
+  frontend-commit:
+    - { skill: git-commit-core, type: context-required }
+  java-backend-commit:
+    - { skill: git-commit-core, type: context-required }
   yss-backend-spec-review:
     - { skill: alibaba-java-code-style, type: context-required }
     - { skill: yss-implementation-contract-compiler, type: coordination-only }
@@ -361,12 +365,6 @@ skills:
     instance_default_discoverable: true
     aliases: []
     impacts: [discovery]
-  - id: grill-with-docs
-    layer: compatibility
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [discovery]
   - id: grilling
     layer: core
     maturity: supported
@@ -391,12 +389,6 @@ skills:
     instance_default_discoverable: true
     aliases: []
     impacts: [lifecycle]
-  - id: improve-codebase-architecture
-    layer: compatibility
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [quality]
   - id: llm-wiki
     layer: core
     maturity: verified
@@ -457,12 +449,6 @@ skills:
     instance_default_discoverable: true
     aliases: []
     impacts: [quality]
-  - id: to-questionnaire
-    layer: maintainer-only
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [discovery]
   - id: to-spec
     layer: compatibility
     maturity: supported
@@ -487,12 +473,6 @@ skills:
     instance_default_discoverable: false
     aliases: []
     impacts: [setup]
-  - id: wait-what
-    layer: maintainer-only
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [setup]
   - id: wayfinder
     layer: maintainer-only
     maturity: supported
@@ -751,6 +731,12 @@ skills:
     instance_default_discoverable: false
     aliases: []
     impacts: [frontend]
+  - id: git-commit-core
+    layer: maintainer-only
+    maturity: supported
+    instance_default_discoverable: false
+    aliases: []
+    impacts: [template-maintenance]
   - id: frontend-commit
     layer: maintainer-only
     maturity: supported
@@ -788,11 +774,6 @@ skills:
     aliases: []
     impacts: [frontend]
 platform_skills:
-  - id: data-analytics
-    root: .codex/skills
-    layer: maintainer-only
-    instance_default_discoverable: false
-    aliases: []
   - id: product-design
     root: .codex/skills
     layer: specialist

package/template/.template-spec/architecture/README.md

@@ -26,33 +26,9 @@
 
 ---
 
-## AI 四种角色
-
-### 方案生成器
-```python
-delegate_task(
-    goal="为'[功能]'生成 3 种技术方案并做 trade-off 对比",
-    context="评估维度：复杂度/安全/性能/扩展性/契合度/开发成本"
-)
-```
-
-### 预审者 — 六维度审查
-```python
-delegate_task(
-    goal="从可扩展性、安全性、性能、可靠性、可维护性、成本六个维度预审此方案",
-    context="每个维度打分 1-5，评分<3 给出替代方案"
-)
-```
-
-### ADR 记录者
-```python
-delegate_task(
-    goal="根据技术讨论记录，自动生成 ADR",
-    context="使用 .template-spec/templates/adr-template.md 模板"
-)
-```
+## 方案比较与审查
 
----
+存在真实取舍时比较候选方案，按业务风险说明依据，不固定方案数量或评分阈值。审查和批准只消费生命周期注册表及流程裁剪规则；本说明不增加架构师签字或进入实现的独立条件。ADR 仅记录难以回滚、非显而易见且存在真实取舍的决定。
 
 ## 六维度审查清单 (39项)
 
@@ -71,7 +47,7 @@ delegate_task(
 
 ## Deep Module 治理
 
-当出现模块难改、测试 seam 不清晰、逻辑散落、Agent 难以理解代码路径时，优先使用 `improve-codebase-architecture` 和 `codebase-design`。
+当出现模块难改、测试 seam 不清晰、逻辑散落、Agent 难以理解代码路径时，优先使用 `codebase-design` 的显式架构审计模式。
 
 落地产物：
 
@@ -82,10 +58,3 @@ delegate_task(
 架构讨论必须使用统一术语：`module`、`interface`、`seam`、`adapter`、`depth`、`leverage`、`locality`。
 
 ---
-
-## AI-Human Loop
-
-```
-需求 → AI 3方案对比 → 架构师选方向 → AI 详细方案
-→ AI 六维预审 → 架构师签字 → ADR 记录 → 进入实现
-```

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

@@ -2,7 +2,7 @@
 
 > AI 辅助生成，人工审核补充。
 > 建议配套产物：`competitive-matrix-template.md` 用于横向功能矩阵，本模板用于深度分析和 Spec 前置输入。
-> 使用 `grill-with-docs` 时，请把稳定术语同步沉淀到 `CONTEXT.md`，只有出现难以回滚、非显而易见且存在真实取舍的决策时才新增 ADR。
+> 使用 `work-unit.plan-requirements` 时，请把稳定术语同步沉淀到 `CONTEXT.md`，只有出现难以回滚、非显而易见且存在真实取舍的决策时才新增 ADR。
 
 ## 0. 文档信息
 
@@ -250,7 +250,7 @@ flowchart LR
 ## 11. 建议下一步
 
 1. [补充调研 / 用户访谈 / 厂商验证]
-2. [进入 grill-with-docs 继续澄清的问题]
+2. [进入 work-unit.plan-requirements 继续澄清的问题]
 3. [生成 Spec]
 4. [判断是否需要 OpenAPI / 垂直切片 issue]
 

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

@@ -39,8 +39,32 @@ v2 的 `openapi` 是唯一 Draft 绑定，`draft_review` 只存 `ref/digest`，F
 
 ## 验证阶段与回退
 
+Slice v3 的任务聚焦布局可显式试用 `scripts/contract view <资产> --kind slice --profile task --unit <ID> --task-layout focused`。默认仍为 `legacy`，推广取决于受控对照结果。聚焦布局展示当前工作单元及其验证项关联的验收（包括 `required_for_all`），保留全局、专项和未知约束，并给出完整验收原文件引用。v2 保留原布局，不根据缺失引用裁剪。
+
+恢复入口 `scripts/lifecycle-status --checkpoint <ref> --task <task-package-ref>` 增量返回只读 `recovery`：任务引用、合同 task 视图命令、实际结果引用及恢复顺序。引用由调用方显式选择，不扫描目录猜任务；运行中、未知或版本不符不能重复派发。`not-checked` 和 `execution_authorization: not-evaluated` 保持原义。
+
 预检、准备、派发各自建立私有验证阶段。阶段绑定根目录、用途、切片、工作单元、只读状态；只在本次操作内共享输入和纯校验结果。原始输入不可变，返回给调用者的是独立副本。相同 schema、输入和格式选项复用；外部 `$ref` 未追踪的校验不享受结果复用。Python 引擎、同步 API 和技术设计 Node 边界保留。
 
 成功返回前复核所有登记原字节、目录枚举及不存在项。技术设计子进程自行验证批准，再返回依赖清单；父进程合并读取集合，读取矛盾、遗漏报告或异常均阻断。此清单不是批准上下文。品牌上下文不能序列化、跨仓或从只读升级；在阶段中生成的上下文结束后失效。调用者可传入 `AbortSignal`，已收到的撤回事件须中止当前操作；下一次边界始终重新读取当前批准和回复。未接入读取追踪的消费者保留原检查，不共享结果。
 
 P1 可回用原 `slice-contract` 阅读入口；P2 可回退阶段调用与本次改动的读取适配，恢复完整重复检查；P3 可停止创建 v2，但已生成 v2 的读取能力必须保留。回退后重新验证当前来源和批准，不恢复历史通过状态。
+
+## 默认派发与审阅材料
+
+提供该查询入口的聚合与战略模板中，派发首先用 `scripts/query-lifecycle-context` 一次组合 mode、stage、work-unit 与必要合同子树（`--mode`、`--stage`、`--work-unit`、`--include`）。结果 `sources.lifecycle_registry.sha256` 绑定原始注册表字节，`context_sha256` 绑定规范化查询、实际返回内容及来源；旧 `semantic_sha256` 只绑定稳定 ID 语义。旧结果缺少新增绑定时重新查询，不视作可复用。身份、执行范围和查询来源在同一 `validation-phase` 内读取，返回前变化则失败。
+
+专职交付 Profile 的阶段与 mode 继续由其现有 harness-profile 和主控入口解析，不假定未分发的查询命令存在。实现者默认读取指定 `--unit` 的 `task` 视图，审阅者默认读取 `review`；不要先整读 YAML 再重复生成相同视图。身份、版本、写边界、验收、停止条件、风险与未知约束均须保留，需要追溯时展开 `full`。一次执行边界内可复用未变来源；恢复、交接、实现、合并及发布重新核验。Context Plan 的原始 v2 字段为 `common.context_plan`，原始 v3 为 `scope.context_plan`；`common.context_plan` 在 v3 运行时只是归一化别名，不是修改原 YAML 的位置。
+
+```sh
+scripts/contract prepare-review <前资产> <后资产> --kind <类型> [--unit <ID>] [--decision <原决定.yaml>] --json
+```
+
+输出来源字节绑定、差异、完整约束、原决定与缺口及恢复动作。`approval_reusable: false`、`execution_allowed: false` 固定不授予批准或执行权；语义等价、风险接受、原回复真实性和批准延续由原审查及决定验证器处理。缺少原决定标记未提供，不能据此沿用批准。
+
+## 当前前端交互证据
+
+模板正式研究的路由、实际验证及收尾见 [研究收尾协议](research-completion.md)。
+
+前端 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、截图及适用命令并另存新报告，不给旧报告补造通过记录。摘要校验不证明交互语义，实际浏览器轨迹和独立前端审查仍按既有边界执行。

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

@@ -121,6 +121,7 @@
     "work-unit.intensity-aware-review-v2",
     "work-unit.intensity-aware-verification",
     "work-unit.intensity-aware-verification-v2",
+    "work-unit.maintenance-research",
     "work-unit.plan-opportunity",
     "work-unit.plan-requirements",
     "work-unit.prototype-design",
@@ -248,6 +249,7 @@
     "work-unit.stage-decision": "9a43c029438849337d1ddead2b4f0ca1d1c3482c279265e2b1db3088cbff6048",
     "work-unit.technical-analysis": "57bb8cab7b0ef2eff43d848914bdd9297ec582570d11c0639dda3227a383726a",
     "work-unit.template-snapshot-build": "48463092d1c644f5a5fc4f1c188ba662d7984085b8b04b1fbff450ef8c682939",
-    "work-unit.ticket-decomposition": "d239bd6855ea3cc8d448892af8bff62f5531499774eed58761288374b4c3d2cc"
+    "work-unit.ticket-decomposition": "d239bd6855ea3cc8d448892af8bff62f5531499774eed58761288374b4c3d2cc",
+    "work-unit.maintenance-research": "ee03d6217e4225b453fe9a7f55718c3403769aa3b3993c28e8aedc6c6a3febec"
   }
 }

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

@@ -340,6 +340,12 @@ artifacts:
     trigger: 发布后或阶段性完成后满足复盘触发条件。
 
 work_units:
+  - id: work-unit.maintenance-research
+    name: 模板维护研究
+    scope: template-source
+    input: 已明确范围的技术或策略研究请求。
+    output: 研究简报、证据台账和绑定当前输入的验证记录。
+    completion: 当前研究包校验通过、执行阻断关闭；独立结束或在已授权范围内继续模板维护。
   - id: work-unit.entry-triage
     name: 入口分诊
     scope: template-source

package/template/.template-spec/process/research-completion.md

@@ -0,0 +1,23 @@
+# 模板维护研究收尾
+
+本协议由主模板生命周期持有；专职接收 profile 缺少本工作单元时，将研究包回交主模板收尾，不在接收 profile 另建阶段或宣布维护批准。
+
+正式落盘的模板研究使用注册工作单元 `work-unit.maintenance-research`，权威路由见生命周期注册表与主控合同。它不新增阶段或批准门禁。只返回来源与结论的咨询沿用 read-only-intake v2；产品实例研究仍由原生命周期工作单元消费。
+
+## 当前验证与完成
+
+```sh
+node scripts/verify-maintenance-research <slug>-research-brief.md <slug>-evidence.yaml --output <不存在的验证目录>
+```
+
+命令实际调用研究包校验器，保留 stdout/stderr、退出码、起止时间及简报、台账、校验器、日志的 SHA-256；返回 `binding: {ref, digest}`。不会覆盖旧目录。失败记录保留，不能用于完成。
+
+Workflow Execution Result 在原字段之外携带 `research_verification: {ref, digest}`。`evidence_refs` 包含验证记录、简报、台账和 Context 不适用说明。`context_reconciliation.status` 为 `not-applicable` 且必须给出原因；执行阻断、drift、violation、new_impacts 和 stale_candidates 必须为空。
+
+接收端重读绑定字节，并实际重跑当前研究校验器。通过后可以 `next_route: null` 独立结束。结构校验不证明来源中的事实，也不代替主控对重要结论的来源审计；研究报告保留反证、来源缺口和结论边界。
+
+## 继续维护与历史记录
+
+继续 `work-unit.ssot-update` 时，`maintenance_authorization: {ref, digest}` 指向既有用户决定协议的 requirement：`boundary: template-maintenance-scope`、明确的 `subject_ref`、包含 `work-unit.ssot-update` 的 `scope`，以及 `user_decision_ref` 或 `continuation_ref`。验证复用现有 `assertUserDecisionRequirement`，核对原始回复、展示资产与范围；这是对已有授权的绑定，不要求用户重复确认。没有维护授权仍可合法结束研究。
+
+身份从接收仓库根清单读取，结果中的 `repository_mode` 不能改变路由。旧 `entry-triage` 研究任务和阻断记录保持原字节；重新核验后另存研究收尾任务包，并通过 `inputs` 引用旧包。新记录说明复核对象及历史范围，不冒充原 Agent 在本轮重新研究。