create-yss-spec 3.5.5 → 3.5.8

package/template/.cursor/skills/yss-product-lifecycle/SKILL.md

@@ -5,11 +5,11 @@ description: 编排 YSS 研发全生命周期；当阶段、产物、门禁或 S
 
 # YSS Product Lifecycle
 
-合同阅读与托管更新：`scripts/contract view|render|check-views`；见 `.template-spec/process/contract-reading.md`。
+合同阅读与更新：`scripts/contract view|render|check-views`；见 `.template-spec/process/contract-reading.md`。
 
 五类机器资产默认 JSON；读写、迁移及恢复须遵循 `.template-spec/process/structured-assets.md`。
 
-文档及进度按 `document_writing` 调用 `i-have-adhd`，遵循 `.template-spec/process/document-writing.md`；正文用中文名称与动作，编号按需追踪。
+文档及进度按 `document_writing` 调用 `i-have-adhd`，遵循 `.template-spec/process/document-writing.md`；中文说明，编号按需追踪。
 
 ## 事实源
 
@@ -24,10 +24,10 @@ description: 编排 YSS 研发全生命周期；当阶段、产物、门禁或 S
 | 影响面、裁剪与维护强度 | `.template-spec/process/harness-process-tailoring.md`、`.template-source/process/maintenance-intensity.yaml` |
 
 ```bash
-scripts/query-lifecycle-context --mode route --stage stage.plan --work-unit work-unit.plan-requirements --include execution_efficiency
+scripts/query-lifecycle-context --work-unit work-unit.plan-requirements --check-skills
 ```
 
-`--include` 接受合同顶层键，非法输入失败。详见 `references/orchestration.md`。
+`--include` 限合同顶层键。调用前按 [来源与补装](references/matt-yss-adapter.md) 预检，在既有授权内补装并重验。
 
 按 `execution_efficiency` 合并查询、复用未变资料；仍核验当前资产、词汇和门禁，产品流转不重跑模板套件。
 
@@ -38,9 +38,9 @@ scripts/query-lifecycle-context --mode route --stage stage.plan --work-unit work
 3. 按合同 `request_triage` 选择 `route`、`orchestrate`、`resume`、`audit`；明确行动请求无需模式关键字，意图不明时只读 `route`。`modes`、门禁及授权边界仍适用。
 4. `project-instance` 按生命周期注册表推进；`template-source` 只走模板维护流程。
 
-Plan 入口读取 `.template-spec/plan/README.md` 和 `.template-spec/process/plan-migration.md`，核查战略输入与退出条件。关键未决项阻断 Spec；其余记录责任人、解决时点和接收方。只用 Plan 标识，旧阶段不解析，历史批准不自动沿用。
+Plan 入口读 `.template-spec/plan/README.md`、`.template-spec/process/plan-migration.md`，核验战略输入及退出条件。关键未决项阻断 Spec；其余记责任人、解决时点和接收方。只认 Plan 标识，不解析旧阶段，不自动沿用历史批准。
 
-分诊见 [协议](references/request-triage.md) 与 `--include request_triage`。先查证据，只问下一动作所需缺口，不按问题长度追问。
+分诊见 [协议](references/request-triage.md) 与 `--include request_triage`。先查证据，只问下一动作所需缺口。
 
 ## 不可越过的边界
 
@@ -52,49 +52,51 @@ Plan 入口读取 `.template-spec/plan/README.md` 和 `.template-spec/process/pl
 
 不得越过命中的阶段、门禁、实现仓库准备或 Ticket 正式化。实现只接收绑定垂直切片、已批准且持久化、版本当前并通过完整 `ready-for-agent` 计算的合同；父 Ticket、`ready-for-human` 切片、`stale`、`drift`、`new_impacts`、`violation` 或缺失证据均阻断。实现仓库、脚手架、UI 还原、review input 和发布条件从对应合同子树查询，不在入口重复定义。
 
-聚合批准见 `gate_consolidation`。普通功能默认一个独立审查者，按能力缺口、冲突或外部制度增员；相邻检查组合审查、逐项留证。
+按 `gate_consolidation` 默认一名独立审查者，按能力缺口、冲突或外部制度增员；相邻检查组合、逐项留证。复审按 `review_input.rereview` 首轮完整、修复定向、当前候选重绑定，未知先调查。
 
-职责与后端终点见 `execution_scopes`，恢复、编译和派发须复验。保留产品设计门禁，后端交付不等于业务完成或发布。
+职责及后端终点见 `execution_scopes`，恢复、编译、派发须复验。保留产品设计门禁，后端交付不等于业务完成或发布。
 
 ### 用户决定
 
-按角色表 `user_decision_policy` 和 `references/user-decisions.md` 先展示可审阅资产、范围、风险及后续动作，再取得提问者或其指定生物人的原始回复。数字人、超时和默认项不能代答。已有授权优先用 `continuation_ref` 核验延续；未知/实质变化或强制审批缺失才重新决定。缺陷和缺证据阻断，建议记待办；合同、验证及外部动作授权仍须满足。
+按角色表 `user_decision_policy` 和 `references/user-decisions.md` 先展示资产、范围、风险及后续动作，再取得提问者或其指定生物人的原始回复。数字人、超时和默认项不能代答。优先核验 `continuation_ref`；未知影响先调查，实质变化或强制审批缺失后重新决定。缺陷和缺证据阻断，建议记待办；合同、验证及外部授权仍适用。
 
 ### 外部副作用与 Git
 
-生命周期批准、实现授权和自然语言意向不构成结构化 Git 授权。commit、push、远端仓库创建、发布及其他运行时外部副作用分别检查明确动作、范围和可读授权引用；缺失时保持外部状态不变。`git-submodule` 还必须遵守逐仓授权、非 detached HEAD 和先子仓后父仓 gitlink 的顺序。
+生命周期批准、实现授权和泛泛意向不构成 Git 授权。按 `references/user-decisions.md`，Agent 可整理明确动作和范围的真实回复，无需用户重填字段。commit、push 及其他外部动作分别核验；来源不可读、撤回或动作越界时不执行。`git-submodule` 仍逐仓授权、非 detached HEAD、先子仓后父仓 gitlink。
 
 ## 有界编排循环
 
-1. 从真实资产重建当前状态，查询当前 mode、stage、work-unit 及必要合同子树。
-2. 评估影响面、上游新鲜度、门禁和阻塞，选择第一个未阻塞工作单元；不把 `not-applicable` 当作豁免。
-3. 原生工作单元由主控持有正式资产；专项按结构化任务包派发，只调用合同允许的 model-invoked skill。
+1. 从真实资产重建状态，查询 mode、stage、work-unit 及必要合同子树。
+2. 核验影响面、上游新鲜度、门禁和阻塞，选择首个未阻塞单元；`not-applicable` 不作豁免。
+3. 主控持有原生正式资产；专项按结构化任务包派发，只调用合同允许的 model-invoked skill。
 4. `to-spec`、`to-tickets`、`implement` 等兼容入口只可由用户显式调用。主控预检输入、路径和门禁；入口按 `matt_invocation_boundary` 写入其产物并回交验收，不批准或改变 Ticket 就绪状态。原生资产仍归主控。
 5. 先逐项验收用户目标、遗漏、错误假设和未决问题，再验收 `Workflow Execution Result`：工作单元、合同、允许写路径、`context_reconciliation`、证据、实际验证、延期 seam、漂移和下一路由必须可核验。实现派发额外绑定当前 Slice Implementation Contract v3；其他阶段不得伪造该合同。
-6. 在授权边界内继续下一工作单元；遇到人工决定、新授权、证据冲突、专项失败或合并/发布结论时暂停。暂停不得阻断独立工作。
+6. 按 `blocking_disposition` 自主处理阻塞；缺真实决定或新授权才展示资产后询问。独立工作继续，完成结论不新增暂停。
 
-每个 `project-instance` 工作单元批准或流转前，回写稳定术语到唯一根 `CONTEXT.md`，并生成通过校验的 `context_reconciliation`。候选术语、错误路径、摘要漂移或未决冲突必须阻断。质量标准只由 `engineering-baseline` 定义一次；高风险影响按裁剪合同补充反证和残余风险。
+`project-instance` 批准或流转前按根 `AGENTS.md` 完成术语回写与 `context_reconciliation`；候选术语、错误路径、摘要漂移或冲突阻断。质量标准由 `engineering-baseline` 唯一定义，高风险反证按裁剪合同。
 
 ## 面向业务角色
 
 澄清目标、流程、责任、规则、范围和验收例子。业务总览引用权威资产，展示状态、未决项、责任人和下一步，不复制正文或新增门禁。
 
-Plan → Spec（含正式草稿、恢复与显式 `to-spec`）写入前，按 `.template-spec/plan/entry-review.md` 持久化审阅包并运行 `node scripts/verify-plan-spec-entry <state.yaml>`。检查默认 pending，缺项、过期或无真实回复即阻断；独立调研可继续。
+Plan → Spec 写入前按 `.template-spec/plan/entry-review.md` 持久化审阅包，执行 `node scripts/verify-plan-spec-entry <state.yaml>`；缺项、过期或无真实回复阻断，独立调研继续。
 
 ## 结果与暂停
 
-结构化结果保留模式、仓库身份、阶段/工作单元、影响面、资产/门禁/Ticket/Slice/合同状态、证据新鲜度、就绪、阻塞、本轮动作、下一单元、暂停理由、Ticket 同步和 Git checkpoint；用户说明按中文写作规范呈现。
+每轮返回或暂停按 `user_progress_report` 说明当前阶段与依据、本轮结果、下一阶段/单元及条件、问题/阻塞、责任方、解除与复验、主控动作和用户决定。未知写“待核验”，负责人缺失写“未登记”；目标不代表批准，已授权修复继续。
 
-会签记录保留门禁 ID、`role_id`、`runtime_id`、文件路径、推荐答案和恢复动作；用户提示解释待决定事项与责任方。恢复前运行适用验证器。同一候选通过适用审查与 fresh verification 才可提出完成、合并或发布结论；发布仍须生物人决定。
+结构化结果按 `workflow_execution_result` 与 `references/state-model.md` 记录状态、证据新鲜度、阻塞、动作、路由和 Ticket / Git checkpoint。
 
-Plan / Spec / Design 追踪按 `.template-spec/process/stage-tracking.md`。
+发送前核对状态、证据新鲜度、阻塞与结构化结果一致；详见 [结果与友好提示](references/orchestration.md#结果与友好提示)。会签保留门禁、角色/运行时、文件、推荐答案和恢复动作。恢复先验证；完成、合并、发布须同一候选通过适用审查与 fresh verification，发布仍须生物人决定。
 
-需求澄清读 [对账](references/plan-requirements.md)；外部输入读 [问卷](references/external-input-questionnaire.md)。
+Plan / Spec / Design 追踪见 `.template-spec/process/stage-tracking.md`。
+
+需求澄清读 [对账](references/plan-requirements.md)，外部输入读 [问卷](references/external-input-questionnaire.md)。
 
 Spec 起草业务票，Design 校准后正式化；无设计影响直接正式化，研发再细化 Slice。按 `.template-spec/process/business-tickets.md` 检查覆盖和批准；业务票不授予实现资格。
 
 ## 功能资产整理
 
-整理与旧票迁移先读 `.template-spec/process/feature-assets.md`，只按显式候选计划处理，保留状态、批准依据和原文；不得推进阶段。临时输入与草稿放临时工作区，引用后按正式资产保留。
+整理与旧票迁移按 `.template-spec/process/feature-assets.md` 和显式计划保留状态、批准依据及原文，不推进阶段。临时草稿被引用后按正式资产保留。
 
 既有 YSS 实例的模板版本升级、旧治理布局迁移或升级恢复路由到 `yss-harness-upgrade`，按 `.template-spec/process/harness-upgrade.md` 执行；不由升级动作推进产品阶段或重写历史批准。

package/template/.cursor/skills/yss-product-lifecycle/references/artifact-dependencies.md

@@ -28,7 +28,7 @@ Implementation → Independent Review → Fresh Verification → Release
 5. 重新审查后优先恢复原 Ticket；仅在范围或验收目标根本变化时重建。
 6. 原 `not-applicable` 的条件被推翻时，改为 `missing` 或 `draft`。
 
-具体 `impact type → artifact/gate → direct/transitive → when` 以 `orchestration-contract.yaml` 为机器可执行事实。条件满足时，`direct` 节点直接标记 `stale`；`transitive` 节点仅在其依赖的 direct 节点发生语义变化时传播。条件不满足时保持原状态，尤其不得把 `not-applicable` 改成 `stale`。表中未列出的节点不传播；无法分类的变化暂停影响面裁决，不得猜测。
+具体 `impact type → artifact/gate → direct/transitive → when` 以 `orchestration-contract.yaml` 为机器可执行事实。条件满足时，`direct` 节点直接标记 `stale`；`transitive` 节点仅在其依赖的 direct 节点发生语义变化时传播。条件不满足时保持原状态，尤其不得把 `not-applicable` 改成 `stale`。表中未列出的节点不传播；无法分类的变化先调查行为、结论和依赖，并阻断依赖事项，不猜测或默认全轴复审。
 
 每个 `stale` 节点必须记录 `stale_by`、影响类型、证据引用和重新批准条件。重新批准 direct 节点后，逐个重新核验 transitive 节点；只有其全部受影响上游恢复为 `approved/not-applicable` 且本节点重新验证通过，才能移除 `stale`。
 

package/template/.cursor/skills/yss-product-lifecycle/references/matt-yss-adapter.md

@@ -1,5 +1,25 @@
 # Matt / YSS 工作流适配
 
+上游来源是 [mattpocock/skills](https://github.com/mattpocock/skills)。固定提交、原始哈希和实际生效的 YSS 适配哈希以根 `skills-lock.json` 为准；补装使用模板快照中的适配版，不直接覆盖为上游最新版本。
+
+项目实例按需分发：注册表中受支持的技能可能尚未安装；改名与别名由 `.template-spec/agents/yss-skill-registry.yaml` 解析；已退役名称按 `.template-spec/agents/skill-migrations.md` 重新路由。这三种情况不能混用，也不需要把整个上游仓库装进实例。
+
+## 工作单元技能预检与补装
+
+准备调用原生工作单元的专项技能前，运行：
+
+```bash
+scripts/query-lifecycle-context --work-unit work-unit.plan-requirements --check-skills --agent-runtime codex
+```
+
+运行时只在实例登记了唯一平台时可以省略；条件依赖用重复的 `--when <条件>` 传入。查询只检查当前工作单元和已触发依赖，不加载兼容入口的纯引用或整个角色技能包。普通查询仍不证明技能已安装。
+
+`skill_readiness` 为 `ready` 时退出 0；`missing` / `blocked` 时退出 2；非法输入或查询失败退出 1。技能可用不证明阶段批准、切片资格或任务完成。
+
+收到 `missing` 后，由 Agent 执行结果中的 `remediation.plan_command`，核对新增技能、路径和依赖。已有任务授权覆盖该范围且计划无冲突时执行 `apply_command`，利用现有事务刷新锁文件并校验实例；随后重新执行同一预检，通过后才调用技能。安装 user-invoked 技能不授予调用资格。
+
+`blocked` 中的受管文件丢失、哈希／投影漂移、同名路径冲突、运行时未配置、退役或外部技能缺失必须分别处理；CLI 快照不匹配时补装计划也会拒绝。不得自动覆盖、强制同步或扩展迁移范围。旧实例只读检查现有文件，缺失时按本家族 CLI 规划同步或迁移，不自动转换分发模式。
+
 Matt skills 决定如何工作；YSS 生命周期决定是否允许推进；YSS 专项 skills 决定如何符合工程规范。
 
 生命周期默认使用 `work_unit_routes.*.native`；下表中的 Matt flow 是 `work_unit_routes.*.compatibility` 显式兼容输入。兼容入口的正式资产由用户创建并回交生命周期验收，原生工作单元的正式资产由生命周期编排器创建。
@@ -33,7 +53,7 @@ Matt skills 决定如何工作；YSS 生命周期决定是否允许推进；YSS
 
 尽量不修改 Matt skill 以复制 YSS 规则。只有它违反模板硬门禁时才做最小兼容修改。
 
-实现合同编译器 只能返回 `draft`、`blocked` 或 `ready-for-lifecycle-review`，不得自行批准合同、设置 `ready-for-agent` 或宣布完成。`new_impacts`、`drift`、`violation`、越界路径或缺失实际验证会暂停当前工作单元，并由本编排器决定增量重路由、完整重路由或回到更早生命周期阶段。
+实现合同编译器 只能返回 `draft`、`blocked` 或 `ready-for-lifecycle-review`，不得自行批准合同、设置 `ready-for-agent` 或宣布完成。`new_impacts`、`drift`、`violation`、越界路径或缺失实际验证阻断依赖动作，由本编排器先调查实际变化及依赖，再修复、补证据或回到受影响生命周期工作单元；不因此默认全轴复审或向用户索取新决定。
 
 ## Workflow Execution Result
 
@@ -56,7 +76,7 @@ next_route: <next-work-unit-or-null>
 blocking_signals: []
 ```
 
-存在 `drift`、`new_impacts`、`violation`、`missing_evidence` 或 `stale_candidates`，以及证据缺失时，不得返回 `completed`；必须暂停并由编排器决定增量重路由、完整重路由或回到更早阶段。
+存在 `drift`、`new_impacts`、`violation`、`missing_evidence` 或 `stale_candidates`，以及证据缺失时，不得返回 `completed`；由编排器调查变化、受影响结论 / 行为及依赖，定向修复 / 重路由、复验并重绑定当前候选。专业等待自主派发并等待，缺真实决定或新授权才展示资产后询问，无依赖的已授权工作继续。
 
 实现合同编译器 状态映射为：`draft → completed`、`blocked → blocked`、`ready-for-lifecycle-review → needs-human`。这里的 `completed` 只表示 Matt 工作单元已产出可验收结果，不表示生命周期完成或可发布。
 
@@ -74,11 +94,11 @@ blocking_signals: []
 
 ## Review 候选与 Git 授权
 
-YSS 调用 `code-review` 前必须形成 review input，至少包含 `review_mode`、`review_base_ref`、`implementation_candidate_ref`、`candidate_snapshot_ref`、`candidate_digest`、`spec_ref`、`ticket_ref`、`slice_contract_ref`、`build_architecture_checklist_ref` 和 `yss_execution_result_refs`，并满足 `orchestration-contract.yaml.review_input.manifest_required_by_mode`。Standards 还必须编译 `review_standards_route`：合同 `required_skills`、影响面专项检查输入、报告模板与 `finding_disposition`；机器检查按 `run_if_present` 执行。质量标准只从 `engineering-baseline` 引用，禁止在 review input 或切片中另起一份。命中高风险影响时，review input 还要引用 Doubt-Driven 主张 / 反证记录；缺少反证或残余风险未处理时返回 `blocked`。`committed` 审查 merge-base 到不可变 `HEAD`；`worktree` 一次捕获 merge-base 到 working tree 的 committed、staged、unstaged 和 untracked 内容，使用 `yss-worktree-candidate-v1` 规定的 raw path、uint64 big-endian 长度、tracked/untracked record 和不支持条目阻断规则计算 SHA-256，让所有参与审查者（人数按 `orchestration-contract.yaml.gate_consolidation`） 消费同一不可变快照，并在返回和完成 checkpoint 复核摘要未变化。缺少输入、候选为空、专项覆盖缺失、未关闭 mandatory `violation`、适用行空白或摘要变化时返回 `blocked`，不能缩小审查范围、另起通用审查 skill、由审查者改实现，或合并不同候选的结论。`violation` 类 finding 交实现者在原合同路径修复后全轴复审；`drift` / `new_impacts` 使合同 `stale` 并回 实现合同编译器。
+YSS 调用 `code-review` 前必须形成 review input，至少包含 `review_mode`、`review_base_ref`、`implementation_candidate_ref`、`candidate_snapshot_ref`、`candidate_digest`、`spec_ref`、`ticket_ref`、`slice_contract_ref`、`build_architecture_checklist_ref` 和 `yss_execution_result_refs`，并满足 `orchestration-contract.yaml.review_input.manifest_required_by_mode`。Standards 还必须编译 `review_standards_route`：合同 `required_skills`、影响面专项检查输入、报告模板与 `finding_disposition`；机器检查按 `run_if_present` 执行。质量标准只从 `engineering-baseline` 引用，禁止在 review input 或切片中另起一份。命中高风险影响时，review input 还要引用 Doubt-Driven 主张 / 反证记录；缺少反证或残余风险未处理时返回 `blocked`。`committed` 审查 merge-base 到不可变 `HEAD`；`worktree` 一次捕获 merge-base 到 working tree 的 committed、staged、unstaged 和 untracked 内容，使用 `yss-worktree-candidate-v1` 规定的 raw path、uint64 big-endian 长度、tracked/untracked record 和不支持条目阻断规则计算 SHA-256，让所有参与审查者（人数按 `orchestration-contract.yaml.gate_consolidation`）消费同一不可变快照，并在返回和完成 checkpoint 复核摘要未变化。缺少输入、候选为空、专项覆盖缺失、未关闭 mandatory `violation`、适用行空白或摘要变化时返回 `blocked`，不能漏掉首轮适用项、另起通用审查 skill、由审查者改实现，或合并未重绑定的不同候选结论。`violation` 类 finding 交实现者在原合同路径修复，按差异、受影响结论 / 行为及依赖定向复审并重绑定；摘要变化、UI 或 `new_impacts` 不触发全轴默认或兜底，未知先调查。`drift` / `new_impacts` 使合同 `stale` 并回 实现合同编译器更新受影响合同；未受影响项须有可读比较依据才能复用。
 
-Matt `implement` 的通用提交指令不构成 YSS Git 授权。只有用户明确给出 `commit_authorized` 为 `true`、非空 `commit_scope` 和 `commit_authorization_ref` 时才能 commit；只有明确给出 `push_authorized` 为 `true`、非空 `push_scope` 和 `push_authorization_ref` 时才能 push。缺少任一字段时保持工作区不变，只输出 checkpoint 判断；不得把 `orchestrate`、实现授权、当前分支、测试通过或负责人要求解释为隐含授权。`git-submodule` 还必须按仓授权、禁止 detached HEAD 提交，并先推子仓再更新父仓 gitlink。
+Matt `implement` 的通用提交指令不构成 YSS Git 授权。执行 commit 必须同时具备 `commit_authorized=true`、非空 `commit_scope` 和 `commit_authorization_ref`；执行 push 必须同时具备 `push_authorized=true`、非空 `push_scope` 和 `push_authorization_ref`。commit 与 push 分别检查，commit 授权不包含 push。`git-submodule` 还必须按仓授权、禁止 detached HEAD 提交，并先推子仓再更新父仓 gitlink。
 
-“然后 commit”“做完提交”“可以帮我提交”等自然语言意向本身不是结构化授权。编排器必须取得上述三个 commit 字段；不能先把意向解释成授权，再在完成时补 scope 或引用。
+按既有 [用户决定协议](user-decisions.md)，编排器可以把具体 Git 动作、仓库和改动范围明确的真实用户回复整理成上述三字段，并保留可读原始来源，不要求用户再填写内部字段。结合可读原始上下文，指向明确范围的“做完提交”可整理为 commit 授权；泛泛的“继续”、实现授权、当前分支或测试通过不能补足动作和范围。字段缺失、来源不可读、授权撤回或动作超出范围时不执行对应 Git 动作，只记录 checkpoint 判断；不得补造同意或扩大原回复范围。
 
 ## Setup readiness
 

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

@@ -11,6 +11,45 @@ document_writing:
   artifact_ownership: unchanged
   gate_and_status_semantics: unchanged
 
+user_progress_report:
+  owner: yss-product-lifecycle
+  reference: references/orchestration.md#结果与友好提示
+  writing_reference: .template-spec/process/document-writing.md#4-进度与会签提示
+  emit_on: [ controller-return, status-request, resume, stage-boundary, blocked, human-pause, handoff, completion-assessment ]
+  ordinary_progress: meaningful-changes-only
+  audience: current-feature-or-authorized-task
+  sources: [ current-checkpoint, stage-tracking, readable-assets, applicable-verification, lifecycle-registry, orchestration-contract ]
+  required_information: [ current-stage-and-work-unit, state-basis, this-turn-outcome, next-stage-and-work-unit, entry-conditions, issues-and-blockers, registered-owner, recovery-action-and-recheck, agent-next-action, user-action-if-required, evidence-freshness ]
+  structured_result_fields: [ mode, repository_mode, stage, work_unit, impacts, artifacts, gates, tickets, slices, contracts, evidence_freshness, readiness, blockers, actions_taken, next_work_unit, pause_reason, ticket_sync, git_checkpoint ]
+  presentation_is: derived-explanation-never-approval-or-execution-authorization
+  next_stage:
+    source: current-registered-work-unit-stage-association-and-validated-route
+    stage-order-as-route: forbidden
+    same_stage: explain-remaining-work-in-current-stage
+    unresolved_or_missing_route: not-verified-with-missing-input
+    terminal: explain-verified-task-or-execution-scope-endpoint
+    planned_target_is_approved_transition: false
+    include: [ expected-output, applicable-entry-conditions, unmet-preconditions ]
+  issues:
+    classification: [ blocker, nonblocking-open-question, suggestion ]
+    blocker_fields: [ problem, affected-action, source-ref, registered-owner, resolution-action, resolution-evidence, resume-verification ]
+    all_material_blockers_visible: true
+    unknown_owner: not-registered-never-auto-assigned
+    nonblocking_items: retain-owner-resolution-time-and-receiver-or-backlog-ref
+    missing_or_stale_evidence: not-verified-with-recovery-action
+    no_blockers_claim: current-applicable-verification-required
+    readonly_no_findings: no-detected-blockers-with-unchecked-scope
+  recovery:
+    authorized_agent_actions: continue-and-report-result
+    dependent_actions: wait-for-real-input-or-current-valid-approval
+    independent_authorized_work: continue
+    human_action: explain-why-needed-source-scope-options-and-resume-condition
+    commands: actual-applicable-validator-and-arguments-never-invented
+  before_send: [ current-state-matches-evidence, next-route-and-entry-conditions-explained, blockers-have-actionable-recovery, owner-is-registered-or-explicitly-missing, freshness-and-unchecked-scope-visible, user-text-matches-structured-result, authorized-work-not-shifted-to-user ]
+  template_source: maintenance-step-and-verification-target-never-product-stage
+  invalid_identity: explain-manifest-error-and-migration-check-without-guessing-stage
+  forbidden: [ skill-name-only-return, raw-json-only-user-answer, bare-blocked-without-recovery, stage-complete-from-file-existence, repeated-approval-without-new-boundary ]
+
 backend_architecture_identity_policy:
   source: .template-spec/agents/yss-skill-registry.yaml
   generated_profiles: architecture_profiles
@@ -50,6 +89,7 @@ review_verification:
   low_medium_combined_independent_executor: true
   implementer_must_be_separate: true
   split_when: [ new_module, high_risk, responsibility_conflict, dual_control_required ]
+  capability_policy_ref: .template-spec/agents/digital-human-roles.yaml
 
 checkpoint_policy:
   strategy: consolidated
@@ -256,6 +296,19 @@ task_package:
     registry_ref: .template-spec/agents/digital-human-roles.yaml
     defaults: taskPackageDefaults(role_id)
     copy_required: [ core_skills, forbidden_skills ]
+    review_skills: compiled-from-review-capabilities-for-readonly-review
+    review_execution_states: [ Reviewer, Verifier ]
+    review_skills_do_not_override: [ core_skills, forbidden_skills, allowed_write_paths ]
+  review_context:
+    source: current-consumer-checkpoint-and-review-task
+    schema_ref: .template-spec/process/schemas/digital-human-task-package.schema.json
+    capability_policy_ref: .template-spec/agents/digital-human-roles.yaml
+    applicable_to: formal-v1-professional-review
+    required: [ check_ids, capability_ids, candidate_ref, candidate_digest, policy_ref, policy_digest, reviewer_principal_ref, drafter_principal_ref, approval_scope, basis ]
+    candidate_and_policy: current-ref-and-byte-digest
+    reviewer_must_differ_from_drafter: true
+    compile_skills_from: review_capabilities
+    readonly_intake_v2: unchanged
   contract:
     kinds: [ lifecycle-work-unit, slice-implementation, template-maintenance ]
     required: [ kind, contract_id, contract_version, status, contract_ref ]
@@ -312,6 +365,23 @@ skill_source_contract:
   adaptation_ref_required_when_effective_diff: true
   retired_shared_skills: [ yss-antd-design, yss-antdv-next-design, ask-matt, batch-grill-me, grill-me, dispatching-parallel-agents, loop-me, migrate-to-shoehorn, product-design-prototype, prototype-page-acceptance, scaffold-exercises, setup-pre-commit, setup-ts-deep-modules, teach, writing-beats, writing-fragments, writing-shape, yss-components, yss-dictionary, yss-jdbc, yss-log, yss-microapp-commit, yss-mvc-scaffold-generator, yss-mvc-design, yss-mvc-data-analysis-project-initializer, yss-backend-scaffold-parent, yss-page-module-development, yss-taskflow, yss-backend-scaffold-application, yss-backend-scaffold-domain, yss-backend-scaffold-infrastructure, yss-backend-scaffold-web, yss-backend-scaffold-adapter, yss-application-layer-reference, yss-domain-layer-reference, yss-infrastructure-layer-reference, yss-web-layer-reference ]
 
+skill_preflight:
+  command: scripts/query-lifecycle-context
+  enable_flag: --check-skills
+  scope: selected-work-unit-and-active-context-dependencies
+  readonly: true
+  statuses: [ ready, missing, blocked ]
+  exit_codes: { ready: 0, missing_or_blocked: 2, invalid_input_or_execution_error: 1 }
+  runtime_selection: explicit-or-single-registered-runtime
+  conditional_dependencies: explicit-when-triggers
+  excludes: [ compatibility-references, complete-role-skill-lists, other-work-units ]
+  installation: existing-family-cli-plan-then-apply
+  apply_requires: [ existing-task-authorization-covers-plan, no-conflicts ]
+  after_apply: rerun-current-work-unit-preflight
+  never_grants: [ skill-invocation-permission, stage-approval, ready-for-agent, completion ]
+  block_current_invocation_on: [ managed-file-missing, hash-drift, projection-drift, path-conflict, runtime-unavailable, external-skill-unavailable, retired-skill, cli-snapshot-mismatch ]
+  automatic_force_or_migration: forbidden
+
 # 生命周期默认走原生工作单元；Matt user-invoked skill 仅保留为兼容入口。
 lifecycle_native_entries:
   default_entry: yss-product-lifecycle
@@ -555,15 +625,17 @@ work_unit_routes:
           product-slice: slice-contract
           template-maintenance: L1-L2-L3
         reviewer_write_implementation: forbidden
-        repair_then_full_rereview:
+        repair_then_targeted_rereview:
           kinds: [ violation, machine_check_failure, blank_applicable_row, missing_evidence ]
           actor: implementer
           on_original_contract: true
-          then: recapture_candidate_and_rerun_all_axes
+          then: compare_diff_map_affected_conclusions_behavior_dependencies_rereview_and_rebind
+          reuse_unaffected: readable-unchanged-conditions-basis-and-dependencies-evidence
         stale_and_reroute:
           kinds: [ drift, new_impacts, required_skills_mismatch ]
           mark_contract: stale
           continue_coding_on_old_contract: forbidden
+          impact_analysis: investigate-before-selecting-rereview-scope
           next: compiler-or-earlier-lifecycle
         exemption_policy:
           not_applicable: impact_not_triggered_only
@@ -750,7 +822,15 @@ review_input:
   completed_requires_no_blank_applicable_rows: true
   reviewer_write_implementation: forbidden
   repair_invalidates_candidate: true
-  repair_action: recapture_candidate_and_rerun_all_axes
+  repair_action: recapture_candidate_and_rereview_affected_conclusions_behavior_dependencies
+  rereview:
+    first_review: all-applicable-axes-and-specialist-checks
+    sequence: [ compare-old-and-current-candidate, map-affected-conclusions-behavior-and-dependencies, targeted-rereview-and-verification, rebind-current-candidate-and-basis ]
+    reuse_requires: [ readable-comparison-evidence, unchanged-check-conditions, unchanged-basis, unchanged-dependencies, current-candidate-binding ]
+    unknown_impact: investigate-and-block-dependent-conclusions
+    full_axis_default_or_fallback: forbidden
+    digest_ui_new_impacts_alone: insufficient-for-full-axis-rereview
+    history: preserve-old-reports-and-bind-new-consumption-evidence
   modes: [ committed, worktree ]
   committed:
     candidate_ref: HEAD
@@ -1115,8 +1195,10 @@ frontend_implementation_verification:
   on_new_impact: [ new_impacts, drift, reroute ]
 
 unknown_impact:
-  action: pause
+  action: investigate-and-block-dependent-transition
   reason_code: impact-classification-required
+  user_question: only-if-investigation-identifies-missing-real-decision-or-authorization
+  full_axis_default_or_fallback: forbidden
 
 # 每个 target 必须声明 kind、传播层级和适用条件。条件不满足时保持原状态，尤其不得把 not-applicable 改成 stale。
 impact_propagation:
@@ -1248,6 +1330,7 @@ user_decision_evidence:
 gate_consolidation:
   source: .template-spec/process/lifecycle-registry.yaml
   check_policy: .template-spec/agents/digital-human-roles.yaml
+  capability_source: .template-spec/agents/digital-human-roles.yaml#review_capabilities
   checks: automatic_or_independent_review_without_separate_user_decision
   check_failure: blocks_aggregate_gate
   plan_decision_boundary: gate.plan-approved
@@ -1257,6 +1340,9 @@ gate_consolidation:
   reuse: unchanged_approval_or_verified_approved_scope_continuation
   default_review: one_owner_one_independent_reviewer
   adjacent_reviews: one_bundle_with_explicit_per_check_outcomes
+  new_approval_and_review_bundle_schema: 2
+  current_validation: scripts/verify-approval-record --require-approved --checkpoint <current checkpoint>
+  expected_context: consumer-checkpoint-and-review-task-never-self-filled-from-record
   extra_reviewers: uncovered_expertise_conflict_or_external_requirement
   suggestions: recorded_backlog_without_blocking
   continuation_protocol: references/user-decisions.md
@@ -1264,6 +1350,16 @@ gate_consolidation:
   historical_gate_records: read_only_no_automatic_approval_migration
   verifier: scripts/verify-lifecycle-checkpoint
 
+blocking_disposition:
+  professional_wait: autonomously-dispatch-or-inspect-existing-task-then-wait
+  verification_failure: repair-supply-evidence-or-reroute
+  unknown_impact: investigate-before-review-scope-or-decision
+  real_decision_or_new_authorization_missing: present-reviewable-assets-then-request-designated-human-response
+  unresolved_state_conflict: investigate-and-block-dependent-actions
+  independent_authorized_work: continue
+  completion_conclusion_alone: no-new-pause
+  question_count: minimum-actionable-independent-questions-may-be-batched
+
 # 项目 opt-in 只选择此权威策略，不能传入自定义工作单元白名单。
 execution_scopes:
   plan-to-backend:

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

@@ -9,6 +9,8 @@
 5. 执行最小生命周期工作单元：主控先按 `.template-spec/process/schemas/digital-human-task-package.schema.json` 编译并校验任务包，再只实际调用允许的 model-invoked skill；原生工作单元可直接持有正式资产，Matt 兼容 user-invoked skill 仅作为 workflow reference，仍由用户显式启动。将结果归一化为 `Workflow Execution Result`，验收输出并回写状态与证据。任务包的 `contract.kind` 按工作单元选择；只有实现子任务使用 `slice-implementation` 并消费 Slice Implementation Contract，其他阶段不伪造该合同。
 6. 若仍在授权和自动推进边界内，回到第 3 步；否则暂停。
 
+第 5 步调用专项技能前，执行 `scripts/query-lifecycle-context --work-unit <当前工作单元> --check-skills`，多运行时显式指定 `--agent-runtime`，条件依赖传入 `--when`。按 `skill_preflight` 和 [来源与补装协议](matt-yss-adapter.md) 处理结果：缺失时核对现有 CLI 计划，在既有授权内安装并重新预检；漂移、冲突、缺运行时和版本不匹配暂停当前调用。纯查询、安装或预检通过均不能代替调用资格、批准或完成证据。
+
 不要仅输出下一个提示词后结束 `orchestrate`/`resume`。不要因进入业务代码阶段而退出主控；应把实现交给专项 skill，并在返回后继续核验。
 
 连续阶段自动推进时累积 Ticket 同步和 Git 判断证据，在阶段退出、人工暂停、handoff、进入实现、合并或发布边界集中 checkpoint。发生阻塞、责任人变化或资产需要单独批准时立即落 checkpoint，不因合并记录而丢失阶段因果关系。
@@ -21,6 +23,28 @@
 
 上游变化按既有依赖关系使受影响资产过期，保留未受影响工作和历史记录；恢复、派发和交付边界仍执行适用 Context、决定/延续、门禁、仓库和允许写范围的校验。核验后输入变化即重验。有效授权不重复询问；未知或实质变化回交原责任方。历史实例缺 stage_tracking 时按已登记兼容和显式迁移入口处理，状态查询不自动补写。
 
+## 结果与友好提示
+
+按 `orchestration-contract.yaml.user_progress_report`，每轮主控返回、状态询问、恢复、阶段切换、阻塞和暂停都提供当前任务的中文说明。先回答当前在哪一步、这轮取得什么结果，再说明下一阶段或单元、进入条件及未满足项。阶段和名称读取注册表，状态来自当前 checkpoint、资产和适用验证；未核验写“待核验”，未登记负责人写“未登记”。普通过程更新只报有意义的变化，不重复整套状态。
+
+下一工作单元可能仍在当前阶段，要说明先完成哪项工作，再流转到哪里。目标阶段从注册表的工作单元归属和经过验证的路由取得；缺少路由或归属时指出缺口，不按阶段顺序猜测，不把计划目标写成“已进入”。完成当前任务或命中执行范围终点时说明终点与验证依据；没有下一单元不自动代表完成。`template-source` 展示模板维护步骤、验证目标和余项，不套用产品阶段；身份非法时解释清单问题及迁移检查动作。
+
+区分阻塞、非阻断未决项和建议。每项实质阻塞说明具体问题、阻断的动作、来源、已登记责任方、处理动作、解除证据和恢复校验。可以优先解释最关键的问题，但其他实质阻塞也要可见。非阻断项沿用已有责任人、解决时点、接收方或待办引用；缺口如实说明，不把建议变成门禁。只读查询无发现时写“未发现已登记阻塞，完整就绪仍待核验”，不得把空数组、文件存在、历史通过或退出 0 写成“无阻塞 / 可进入下一阶段”。
+
+主控先完成已授权且能够处理的补充、修复和验证，再报告结果；提示本身不是暂停理由。确需用户决定或外部输入时，解释需要什么、来自哪个合同或门禁、影响范围、推荐选项及取舍和收到回复后的恢复动作。等待只阻断依赖工作，其他已授权工作继续。命令从当前适用合同和已有验证器取得，未执行标为待执行；未知原因写当前失败现象与下一项诊断，不编造原因或修复结果。
+
+发送前逐项核对：当前阶段有依据；本轮结果可读取；下一目标和进入条件一致；阻塞有处理与复验方法；责任方已登记或明确缺失；过期、未检查和未完成事项可见；中文提示、结构化结果、Ticket 和 checkpoint 没有矛盾；未把 Agent 可执行的操作转交用户。结构化结果保留 `user_progress_report.structured_result_fields`，此说明只消费既有状态，不要求另一套状态文件或新增批准。
+
+下面是虚构的表达示例，不作为真实项目状态或批准：
+
+> 当前仍在 Plan，需求范围已补齐，成功标准的统计口径尚未确认。下一阶段是 Spec；进入前需要确认统计口径并通过当前规划审阅包的适用检查。此项阻断 Plan → Spec，负责人未登记，需要先明确该决定的负责人。收到其真实回复后，主控更新原材料并运行规划进入 Spec 的校验；已授权的独立调研继续进行。
+
+## 运行记录与留存
+
+按 `.template-spec/process/runtime-storage.md` 保存普通执行事件和日志。`scripts/runtime-store inspect` 用于定位运行、保护原因和过期日志，`export` 形成可独立核验的文件包。正式 checkpoint、合同、批准、用户决定和恢复事务仍以原文件为权威；数据库索引或历史通过记录不能推进阶段、改变 Ticket 状态或授予执行资格。
+
+中断恢复先核对原运行身份、命令结果和仍保留的日志；存储异常或记录缺失不能触发重复执行已完成的命令。待恢复运行、被正式引用或受保护的材料保留。清理仅通过显式 `plan-gc` / `apply-gc` 完成，不在查询、恢复或阶段流转时自动清理。
+
 ## 执行成本
 
 执行策略以 `orchestration-contract.yaml.execution_efficiency` 为准，通过同一次 `query-lifecycle-context` 查询取得。Plan → Spec → Ticket 的耗时应分清脚本执行、Agent 读取与编排、人工等待；没有计时记录时不把总时长归因于摘要计算。
@@ -87,16 +111,16 @@ tracker 选择和冲突按 `.template-spec/agents/issue-tracker.md` 裁决：已
 ## 审查与验证
 
 - 调用 `code-review` 前先固定 review input：`review_mode`、`review_base_ref`、`implementation_candidate_ref`、`candidate_snapshot_ref`、`candidate_digest`、Spec/Ticket、Slice Implementation Contract、Build Architecture Checklist 和 YSS Skill Execution Result 引用。`committed` 模式审查不可变 `HEAD`；`worktree` 模式一次捕获 committed、staged、unstaged 和 untracked 内容。必须按 `orchestration-contract.yaml.review_input` 的 manifest 按模式必填字段及 `yss-worktree-candidate-v1` 字节流（raw path、uint64 big-endian 长度、tracked/untracked record）计算 SHA-256，所有参与审查者（人数按 `orchestration-contract.yaml.gate_consolidation`） 必须消费同一不可变快照。返回后或完成 checkpoint 摘要变化时返回 `blocked`，由编排器决定重新审查。候选为空、漏项或 fixed point 不可解析时阻断。
-- 小改动和中等变更可由同一独立执行者完成 `code-review` 与 fresh verification，并在同一报告中分别记录 findings、命令、结果和残余风险。
-- 该执行者必须独立于实现者；新模块、高风险变更、职责冲突或需双人控制时，Reviewer 与 Verifier 分开。
+- 小改动和中等变更可由同一具备所需能力的独立执行者完成 `code-review` 与 fresh verification，并在同一报告中分别记录 findings、命令、结果和残余风险。专业任务按角色表 `review_capabilities` 和检查策略编译 `review_context`、`skill_source.review_skills`，当前候选、策略、范围、依据和独立主体均须可核验；不在流程正文另定义能力表。
+- 该执行者必须独立于实现者；新模块、高风险变更、职责冲突或需双人控制时，Reviewer 与 Verifier 分开。按能力覆盖缺口、专业结论冲突或外部制度增加专家，是与此分离要求不同的条件。
 - `code-review` 是唯一默认代码审查 skill。GitLab、CI、Sonar、Alibaba Java 与 YSS 前端 / 后端 skill 作为仓库规则或专项检查输入接入 Standards 轴，由 `review_standards_route` 按影响面编译；不再叠加第二个通用审查 skill。漏掉合同 `required_skills`、适用报告行空白、mandatory `violation` 未关闭或可机器检查规则既无工具结果也无原文引用时，不得 `completed`。
-- 产品切片与模板维护共用 finding 分类；产品切片执行下述候选审查闭环，模板维护按 `.template-spec/process/harness-process-tailoring.md` 的 L1 / L2 / L3 验证强度闭合，不自动冻结候选或全轴复审。`violation`、机器检查失败、适用行空白由实现者在原合同路径修复，再重新捕获候选并全轴复审。`drift`、`new_impacts`、`required_skills` 与真实影响不一致时合同 `stale`，回 实现合同编译器 或更早阶段，禁止在旧合同上继续编码。审查者不得写实现。`not-applicable` 仅当影响面未命中；命中后 mandatory 不得豁免，只允许修复或完整 `seam-deferred`。禁止为日常 Alibaba / YSS 新增生物人豁免门禁。
+- 产品切片与模板维护共用 finding 分类；产品切片执行下述候选审查闭环，模板维护按 `.template-spec/process/harness-process-tailoring.md` 的 L1 / L2 / L3 验证强度闭合，不自动冻结候选或全轴复审。`violation`、机器检查失败、适用行空白由实现者在原合同路径修复，比较旧 / 新候选差异及受影响结论、行为和依赖，再捕获候选、定向复审 / 验证并重绑定。`drift`、`new_impacts`、`required_skills` 与真实影响不一致时合同 `stale`，先调查实际影响再回 实现合同编译器 或更早阶段更新受影响合同，禁止在旧合同上继续编码；不把这些信号升级为全轴默认或兜底。审查者不得写实现。`not-applicable` 仅当影响面未命中；命中后 mandatory 不得豁免，只允许修复或完整 `seam-deferred`。禁止为日常 Alibaba / YSS 新增生物人豁免门禁。
 - 独立 Reviewer 必须与实现者不同实例，并在能执行已登记 `pnpm` / `./mvnw` 的运行时中审查。模板源 `.cursor/environment.json` 只服务模板校验，不替代实现仓审查运行时。不为此再创建第二个 Cloud 审查环境或 `/code-review` skill。
-- UI 影响切片将 `UI fidelity` 作为 `code-review` 的条件第三轴；任何修复都会使候选摘要失效，必须重新捕获候选并重跑 Standards、Spec、UI fidelity 和 fresh verification。
+- UI 影响切片首轮将 `UI fidelity` 作为 `code-review` 的条件第三轴，完成全部适用检查。修复后依实际差异及行为 / 依赖判断应复验的视觉、状态、规范或验收结论；UI 影响或摘要变化不自动触发所有轴。未知影响先调查并阻断依赖事项。未受影响项须有可读比较依据证明条件、依据和依赖未变，全部消费结论重新绑定当前候选与实际验证，历史报告不改写。
 
 ## Git 授权
 
-实现授权、`orchestrate`/`resume` 的有界写入、当前分支和 Git checkpoint 都不蕴含 commit 或 push 授权。执行 commit 前必须同时取得 `commit_authorized=true`、非空 `commit_scope` 和 `commit_authorization_ref`；执行 push 前必须同时取得 `push_authorized=true`、非空 `push_scope` 和 `push_authorization_ref`。任一缺失时只记录 checkpoint 判断并保持 Git 状态不变；负责人要求、时间压力、测试通过或“本地 commit 可逆”都不能补足用户授权。
+实现授权、`orchestrate`/`resume` 的有界写入、当前分支和 Git checkpoint 都不蕴含 commit 或 push 授权。执行 commit 前必须同时取得 `commit_authorized=true`、非空 `commit_scope` 和 `commit_authorization_ref`；执行 push 前必须同时取得 `push_authorized=true`、非空 `push_scope` 和 `push_authorization_ref`。按既有 [用户决定协议](user-decisions.md)，Agent 可从明确动作与仓库/改动范围的真实用户回复整理三字段，保留可读原始来源，无需用户重填。commit 授权不包含 push；字段缺失、来源不可读、撤回或超出授权范围时只记录 checkpoint 判断，不执行对应动作。泛泛意向、时间压力、测试通过或“本地 commit 可逆”都不能补足授权。
 
 `repository_scope: git-submodule` 时授权按仓分别计算：禁止在 detached HEAD 提交；commit / push 顺序必须先子仓、再父仓 gitlink（`superproject-gitlink-update`）；父仓 push 使用 `git push --recurse-submodules=check`。空 gitlink、detached HEAD、`--force` 覆盖挂载点不得当成普通目录脚手架，也不得把实现源码复制进 Harness。登记字段必须能与 `harness-apps` / `external-repository` 区分，并对照工作树 gitlink。
 
@@ -104,15 +128,14 @@ tracker 选择和冲突按 `.template-spec/agents/issue-tracker.md` 裁决：已
 
 关键决定使用 [真实用户回复协议](user-decisions.md)，消费角色注册表的 `user_decision_policy`。会签前先形成可审阅资产；恢复、阶段流转、实施派发和发布时校验原始回复及当前资产摘要。普通会签的数字人审查与用户决定分别保留，关键决定不得以数字人会签、无反对意见或超时放行。等待只阻断依赖事项；新的 `user_decisions` 引用通过 Workflow Execution Result、checkpoint 和任务包传递。
 
-## 必须暂停
+## 按阻塞原因处理
 
-- 注册表中的聚合门禁等待会签裁决（数字人或生物人，以 `.template-spec/agents/digital-human-roles.yaml` 的 `gate_policy` 为准）。暂停输出必须包含：门禁 ID、指定 `role_id`、`runtime_id`、会签文件路径。恢复前执行 `scripts/verify-approval-record --require-approved`；角色错误、起草者自签或生物人门禁被数字人关闭时返回 `blocked`，不得标 `approved`。
-- 需要目标仓库、外部凭据、发布窗口或其他新授权。
-- 状态与证据冲突且无法可靠重建。
-- 专项 skill 失败或返回不可验收结果。
-- 即将作出可合并、可发布或完成结论。
+- 专业审查等待：按角色表的检查 / 能力策略自主派发任务，已有运行中任务先核对身份，不重复派发；等待结果并继续无依赖工作。会签仍保留门禁 ID、指定 `role_id`、`runtime_id`、会签文件和证据。恢复前执行 `scripts/verify-approval-record --require-approved --checkpoint <current checkpoint>`；消费者提供当前期望上下文，不能从记录反向填充。能力缺失、起草者自签、上下文过期或生物人门禁被数字人关闭时返回 `blocked`，不得标 `approved`。
+- 验证失败、证据冲突或专项结果不可验收：调查、修复、补证据或重新路由；只阻断依赖该结果的动作。专业任务未完成不等于需要用户回答。
+- 未知影响：先调查变化的行为、结论和依赖，确认复审范围和决定变化后再处理；不得默认全轴复审，也不得用扩大检查代替影响分析。
+- 真实决定、新授权或无法自主取得的必要输入缺失：先完成可独立执行检查与可审阅资产，再展示版本、差异、风险、范围及恢复动作，向提问者或其明确指定负责人询问。无真实回复保持等待；多个独立的当前决定可合并提问，不强制每次一个问题。
 
-暂停输出：门禁、指定会签 `role_id`、`runtime_id`、会签文件路径、证据、推荐答案、一个问题、恢复动作。
+暂停记录按原因保留证据、责任方、恢复条件和下一动作；只在需要真实决定或输入时展示问题与建议。提出完成、可合并或可发布结论先完成适用审查与 fresh verification，不因此另建暂停；实际合并、推送、发布仍检查既有外部动作授权。
 
 ## Context Plan 与质量基线
 

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

@@ -14,6 +14,8 @@
 
 Matt 五态不得扩义。资产的 `ready-for-human` 与 Ticket label 必须带命名空间表达。`paused-human-gate` 表示等待 `.template-spec/agents/digital-human-roles.yaml` 指定的会签人（数字人或生物人），不是「必须是生物人」。但 `user_decision_policy` 命中的关键决定还必须有真实用户回复，数字人会签不能解除该等待。
 
+等待态不自动产生用户问题。按编排合同 `blocking_disposition`，专业等待自主派发或核对现有任务并等待；验证失败修复 / 路由，未知影响先调查。只有真实决定、新授权或无法自主取得的必要输入缺失，才先展示可审阅材料后询问，同时继续无依赖工作。完成结论本身不新增暂停，状态值和历史记录不因该执行规则改写。
+
 Slice v3 冻结需求文件的 status 是冻结时快照，不能用来推断当前执行状态。状态流转和验收结果写入已配置主 tracker / 任务包；需求改版后重新编译、审查与绑定批准，见 [Slice 冻结需求协议](../../yss-implementation-contract-compiler/references/slice-implementation-contract.md#第二轮增量规则)。
 
 ## 上下文与外部输入证据
@@ -73,7 +75,7 @@ AND UI 影响切片的前端实现还原计划已通过 schema 校验、`templat
 
 进入代码审查时保存 `review_mode`、`review_base_ref`、`implementation_candidate_ref`、`candidate_snapshot_ref`、`candidate_digest` 及 Spec、Ticket、合同、Checklist、YSS Execution Result 引用，并记录专项检查覆盖与机器检查结果。`worktree` 候选必须一次捕获 committed、staged、unstaged 和 untracked 文件；manifest 的按模式必填字段以及 `yss-worktree-candidate-v1`（raw path、uint64 big-endian 长度、tracked/untracked record、symlink 和不支持条目）以 `orchestration-contract.yaml.review_input` 为唯一执行定义。所有参与审查者（人数按 `orchestration-contract.yaml.gate_consolidation`） 消费同一不可变快照；返回后或完成 checkpoint 摘要变化则返回 `blocked` 并重新审查。Finding 分流不新增生命周期状态：`violation` 仍在当前合同路径由实现者修复后复审；`drift` / `new_impacts` 把合同标 `stale` 并走既有重路由。该清单只作为审查证据。
 
-Git 动作分别保存 `commit_authorized`、`commit_scope`、`commit_authorization_ref`、`push_authorized`、`push_scope`、`push_authorization_ref`。只有授权值严格为 `true`、范围和用户授权引用均非空时才执行相应动作；缺失授权时保持工作区不变并记录 checkpoint 判断。`git-submodule` 另保存每仓授权、`checkout_state` 和先子后父顺序；空 gitlink、detached HEAD 或 `--force` 覆盖挂载点时不得当成普通目录 commit / 脚手架。
+Git 动作分别保存 `commit_authorized`、`commit_scope`、`commit_authorization_ref`、`push_authorized`、`push_scope`、`push_authorization_ref`。Agent 按既有 [用户决定协议](user-decisions.md) 从明确动作与范围的真实回复整理字段并保留原始来源，不要求用户重填。只有对应授权值严格为 `true`、范围和引用非空、来源可读、未撤回且动作在范围内时才执行；commit 不隐含 push。任一不满足时不执行对应动作并记录 checkpoint 判断。`git-submodule` 另保存每仓授权、`checkout_state` 和先子后父顺序；空 gitlink、detached HEAD 或 `--force` 覆盖挂载点时不得当成普通目录 commit / 脚手架。
 
 ## 状态块
 

package/template/.cursor/skills/yss-product-lifecycle/references/user-decisions.md

@@ -39,7 +39,7 @@ messages:
 
 `scripts/verify-user-decision --requirements <当前事项.json> <决定记录.yaml>` 校验当前消费者要求的 `boundary/subject_ref/scope`；未给 `--requirements` 时校验请求中全部事项。无回复的草案可以保存，但不能通过批准验证。局部批准只允许已明确批准的事项推进。
 
-会签记录新增 `subject_ref`、`approval_scope` 和 `user_decision_ref`；checkpoint 门禁同时声明 `subject_ref/approval_scope` 并与会签记录一致。`verify-approval-record` 默认严格验证当前放行条件，`--require-approved` 是显式等价选项；只有 `--history` 仅检查历史记录结构，不构成批准。恢复和门禁关闭必须使用严格校验。旧数字人记录仍可读取和用于专业审查，不自动升级成用户决定。
+会签记录保留 `subject_ref`、`approval_scope` 和适用的 `user_decision_ref`；checkpoint 门禁同时声明 `subject_ref/approval_scope` 并与会签记录一致。新会签及组合审查使用 schema v2；专业记录绑定当前 `review_task_ref/digest`、`capability_ids` 和 `basis`，能力与技能来源读取角色表，不在本协议复制。恢复和门禁关闭执行 `scripts/verify-approval-record --require-approved --checkpoint <current checkpoint>`，当前期望来自消费者 checkpoint / 任务，禁止复制待验记录作为期望。缺当前上下文不能放行；只有 `--history` 仅检查历史记录结构，不构成批准。历史记录可读，不自动升级为当前专业审查或用户决定；旧消费者拒绝 v2 后升级，不降级绕过。
 
 Workflow Execution Result 使用 `user_decisions` 保存当前要求与证据引用。`user_decision_not_applicable` 仅对未命中的既有技术条件门禁记录 `boundary/reason`，不得跳过已经执行的业务决策。完成结果通过 `validateNextRoute(..., result)` 检查；两参数调用仅检查路由结构，不能证明可以实际流转。
 
@@ -63,11 +63,11 @@ finding 分为 `requirement-violation/missing-evidence/important-risk/suggestion
 
 使用 `scripts/verify-user-decision --continuation <requirement.yaml>` 核验。会签记录可携带同一 `continuation_ref`；工作单元和任务包沿用 `user_decisions`，Plan 入口使用 `plan_continuation_ref`。实施仍校验当前 scope 清单、切片合同、仓库、允许写路径和工程基线，不因延续省略合同校验。旧记录维持严格读取；未登记该 capability 的接收端必须拒绝延续并升级，不能静默当普通批准。
 
-相邻专业检查可共用一个 `schema_version: 1, kind: review-bundle, reviews: [...]` 文件。每行都是已有会签记录形状，有唯一 gate/check ID、当前 subject/digest/scope、独立身份和明确结论；失败项不能被总体通过掩盖。`verify-approval-record` 检查所有行，聚合门禁按检查 ID 读取各自行。组合审查不增加用户确认次数，也不省略检查覆盖。
+相邻专业检查可共用一个 `schema_version: 2, kind: review-bundle, reviews: [...]` 文件；同一任务、会话、角色、运行时和独立主体完成适用能力检查，每行保留唯一 gate/check ID、当前 subject/digest/scope/basis、任务 / 能力绑定与明确结论。失败项不能被总体通过掩盖。`verify-approval-record` 用消费者当前上下文检查所有行，聚合门禁按检查 ID 读取各自行。组合审查不增加用户确认次数，也不省略检查覆盖。首轮完整覆盖适用项，修复后依据差异、受影响结论 / 行为及依赖定向复审并重新绑定当前候选；摘要变化、UI 或 `new_impacts` 不默认触发全部审查轴，未知先调查。未受影响结论复用必须有比较依据，历史原记录保持只读。
 
 ## 实施范围与架构选择
 
-首次实施批准的主体为功能级 `implementation-scope` 清单，`slices` 每行包含：`ticket_ref`、`contract`（ref/version/digest）、`repositories`、`allowed_write_paths`、`baselines`（ref/version/digest）。仓库与写路径必须对应当前合同的实施范围（v2 `common.project_roots/allowed_write_paths`，v3 `scope.project_roots/allowed_write_paths`，通过统一读取器核验）；基线包含合同引用的工程基线。`scope` 使用批准的切片引用集合。合同、范围或基线变化时回到确认；已覆盖的后续切片复用原记录。
+首次实施批准的主体为功能级 `implementation-scope` 清单，`slices` 每行包含：`ticket_ref`、`contract`（ref/version/digest）、`repositories`、`allowed_write_paths`、`baselines`（ref/version/digest）。仓库与写路径必须对应当前合同的实施范围（v2 `common.project_roots/allowed_write_paths`，v3 `scope.project_roots/allowed_write_paths`，通过统一读取器核验）；基线包含合同引用的工程基线。`scope` 使用批准的切片引用集合。合同、范围或基线变化时先调查差异，复核当前合同、定向审查和授权延续；实质决定变化或超出原批准边界时展示差异后确认，未查明时不沿用。已覆盖的后续切片复用原记录。
 
 实施就绪和派发必须同时提供 `user_decisions`、`slice_contract_ref` 与 `vertical_slice_ticket_ref`。Worker 任务包通过 `user_decisions` 传递记录，不能只声明 `ready_for_agent=true`。
 

package/template/.cursor/skills/yss-prototype-stage/SKILL.md

@@ -9,11 +9,7 @@ description: Use when a YSS feature has product-design impact on a primary flow,
 
 把产品设计影响收敛为跨 Agent 一致的原型交付物、证据和生命周期回流合同。它不替代 `yss-product-lifecycle` 的门禁裁决，也不把原型当作生产前端代码。
 
-文档输出时按 `lifecycle-document-output` 条件调用 `i-have-adhd`，读取 `.template-spec/process/document-writing.md`；作用域仅限当前产物，派发时传递条件及引用。
-
-## 文档写作
-
-起草或修订交互说明、状态说明和设计结论前，读取 `.template-spec/process/document-writing.md` 的共用写法及产品设计指引；原型视觉和行为仍消费当前设计合同。
+起草或修订交互说明、状态说明和设计结论时，按 `lifecycle-document-output` 条件调用 `i-have-adhd`，读取 `.template-spec/process/document-writing.md` 的共用写法及产品设计指引。作用域仅限当前产物；派发时传递条件及引用，原型视觉和行为仍消费当前设计合同。
 
 ## 进入条件与主入口
 

package/template/.cursor/skills/yss-repository/SKILL.md

@@ -7,6 +7,8 @@ description: 用于按批准的 YSS 架构与持久化合同实现或重构 PO
 
 本 Skill 消费批准合同，将持久化责任落到选定架构 Profile。它不是完整脚手架，也不从 DDL、表名或示例反向创造领域/API 合同。
 
+只读审计可先盘点实际结构并记录缺失合同，不受实施前置阻止；整改仍需批准且当前的 Slice。既有工程使用有效登记与独立观测，不要求补造生成 Manifest。
+
 ## 架构分流
 
 1. 读取当前 Slice Implementation Contract 的 `architecture_identity`、`persistence_profile`、实现仓登记、数据合同、`allowed_write_paths` 和预期证据。
@@ -57,5 +59,3 @@ description: 用于按批准的 YSS 架构与持久化合同实现或重构 PO
 ## 新脚手架平台约束
 
 消费批准切片架构身份中的 `platform_configuration`，并与工程 Manifest、effective POM 和依赖树核对。命中 MyBatis 时，`framework.mybatis` 必须从该配置指向的 compatibility 条目解析出对当前架构有效的 `component_binding`；构件、摘要、源码 tree、证据或绑定状态不一致时回合同编译器阻断。Validation namespace、Jackson、starter 和处理器版本只消费解析后的精确平台事实，不在本 Skill 中按 Boot 大版本推导。不得在业务实现中升级、降级或替换 YSS 组件；平台迁移使用独立迁移工作单元。详见仓库共享合同 `.template-spec/engineering/backend-platforms.md`。
-
-只读审计可先盘点、记录缺失合同；不得用实施前置要求阻止发现既有违规。整改仍需批准合同，不因缺少生成 Manifest 阻断已有效登记的既有工程。