create-yss-spec 3.5.6 → 3.5.9

package/template/.codex/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
@@ -124,6 +164,14 @@ request_triage:
     structural_checks_prove_model_accuracy: false
 
 execution_efficiency:
+  script_execution:
+    standard_operations: reuse-installed-public-entrypoints
+    entrypoint_invocation: declared-interpreter-or-executable-shebang
+    missing_capability: inspect-help-and-profile-before-adding-adapter
+    temporary_analysis: bounded-scope-outside-repository-no-new-authority
+    diagnostic_generation: synthetic-fixtures-no-real-approval-bodies
+    dependency_explanation: derive-from-current-source-and-distribution-closure
+    guidance_ref: .template-spec/process/script-execution.md
   context_query:
     strategy: combine-mode-stage-work-unit-and-required-includes
     read_scope: current-work-unit-and-triggered-impacts
@@ -256,6 +304,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 +373,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 +633,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
@@ -715,6 +795,38 @@ planning:
   implementation_authorized: false
   frontier_scope: current-plan-decisions
   deferred_details: excluded-from-frontier-only-after-user-confirms-deferral
+  clarification_policy:
+    trigger: required-plan-user-decision-unresolved
+    skill: grilling
+    invocation_mode: model-invoked
+    explicit_user_invocation_required: false
+    inputs: [ current_scope, discovered_facts, confirmed_decisions, open_items, decision_dependencies ]
+    dispositions:
+      required_user_decision: grilling-with-real-user-response
+      discoverable_fact: investigate-or-yss-research
+      runnable_blocker: prototype-or-actual-verification-with-evidence
+      professional_wait: autonomously-dispatch-or-inspect-existing-task-then-wait
+      verification_failure: repair-supply-evidence-or-reroute
+      noncritical_detail: existing-deferral-policy-with-user-confirmation
+    rounds:
+      frontier: decisions-with-settled-prerequisites
+      questions: all-independent-actionable-frontier-questions-with-recommendations
+      advance: after-real-user-response
+      unsettled_facts: wait-only-for-dependent-questions
+      reuse: unchanged-confirmed-decisions
+      correction: reopen-only-affected-decisions-and-dependencies
+      independent_authorized_work: continue
+    convergence:
+      summary: [ user_problem, goals, mvp, non_goals, key_rules, acceptance_examples, open_item_resolutions, remaining_uncertainty ]
+      required_open_items: resolved-with-current-evidence
+      facts_and_verification: readable-evidence-required
+      preparation_check: grill_exit
+      preparation_passed_means: clarification-materials-and-prerequisites-ready
+      final_confirmation_boundary: gate.plan-approved
+      final_confirmation: shared-understanding-and-current-plan-in-one-real-response
+      final_confirmation_proof: plan_user_decision_ref-or-valid-plan_continuation_ref
+      confirmation_writeback: external-proof-without-review-or-basis-rewrite
+      completion: passed-preparation-and-valid-current-user-decision
 
 grill_exit:
   required: [ frontier_empty, facts_resolved_or_routed, decisions_confirmed, shared_understanding_confirmed, no_unresolved_runnable_blocker ]
@@ -723,6 +835,9 @@ grill_exit:
     runnable_question: handoff-prototype-handoff
     external_decision: external-input-required
   user_confirmation_required: true
+  preparation_check: grill_exit
+  final_confirmation_boundary: gate.plan-approved
+  completion: passed-preparation-and-valid-current-user-decision
   output: plan-evidence
 
 ticket_role_transition:
@@ -750,7 +865,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 +1238,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 +1373,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 +1383,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 +1393,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/.codex/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 读取与编排、人工等待；没有计时记录时不把总时长归因于摘要计算。
@@ -31,6 +55,8 @@
 
 脚本命令、实际退出码和 duration_ms 记入已有 checkpoint 的验证证据；Agent 编排和人工等待仅在有计时来源时记录，否则标为 unknown。无需为耗时再建一套阶段产物。
 
+常见查询、合同准备/阅读/验证、状态恢复和技能同步直接消费已安装入口，调用约定见消费项目 `.template-spec/process/script-execution.md`。工具缺失先按 Profile 和固定版本核对安装；只有实际参数或输出缺口才补适配。一次性分析保留明确输入、允许写范围与实际日志，不承载阶段裁决或批准；诊断使用固定适配器与合成 fixture。
+
 ## 阶段边界
 
 Matt phase boundary 是工作阶段之间的上下文决策，不是新的生命周期状态。按以下顺序判断，第一项适用即停止判断：
@@ -77,7 +103,7 @@ tracker 选择和冲突按 `.template-spec/agents/issue-tracker.md` 裁决：已
 
 - `work-unit.technical-analysis` 由 `yss-technical-design` 组织后端技术设计；其 `domain-driven` 分支调用 `yss-tactical-design`，`layered-mvc` 分支由自身持有。状态、规则、一致性、持久化影响本身不意味着选择 DDD。无后端技术设计影响记录带原因的 `not-applicable`，其他 API / 前端技术分析继续各自路由。新合同使用 `artifact.technical-design`，通过 `evidence.technical-design-review` 回交现有架构审查；旧 DDD 稳定 ID 只读兼容。批准仍由生命周期维护，编译器消费批准且当前的设计起草实现合同；`stale`、`drift` 或 `new_impacts` 时不得继续 Ticket 正式化。
 
-- `work-unit.plan-requirements` 实际调用 `grilling` 和 `domain-modeling`；`work-unit.plan-opportunity` 按事实类型路由 `competitive-intelligence` 或 `yss-research`。`yss-research:quick` 只用于探索；外部证据进入领域战略、阶段决策或其他生命周期批准输入前必须升级为 `evidence-audited`。生命周期原生工作单元默认负责 Spec、Ticket 和实现资产；`to-spec`、`to-tickets`、`implement` 仅保留为显式兼容入口，结果必须回交生命周期验收。
+- `work-unit.plan-requirements` 按 `planning.clarification_policy` 在必须确认的需求、规则、范围或取舍未决时主动调用 `grilling`，术语工作使用 `domain-modeling`。事实、实验、专业审查分别回流证据，依赖分轮并复用未变确认。`checks.grill_exit=passed` 表示准备就绪；固定审阅包后将共同理解与 Plan 批准范围一并展示，以单独保存的真实回复联合完成完整退出。`work-unit.plan-opportunity` 按事实类型路由 `competitive-intelligence` 或 `yss-research`。`yss-research:quick` 只用于探索；外部证据进入领域战略、阶段决策或其他生命周期批准输入前必须升级为 `evidence-audited`。生命周期原生工作单元默认负责 Spec、Ticket 和实现资产；`to-spec`、`to-tickets`、`implement` 仅保留为显式兼容入口，结果必须回交生命周期验收。
 - 原生 `work-unit.ticket-decomposition` 只能在 OpenAPI Freeze 或无 API 影响记录后创建垂直切片，初始 Ticket 状态统一为 `ready-for-human`；生命周期复算完整公式后才能提升 `ready-for-agent`。该工作单元必须返回 `ticket_decomposition_result_ref` 和垂直切片引用，并作为实现的必经前置证据。
 - 原生 `work-unit.slice-implementation` 必须在生命周期批准并持久化 Slice Implementation Contract 和 Build Architecture Checklist 后执行；用户显式 `implement` 仍走兼容入口，不得绕过生命周期。
 - `Workflow Execution Result.next_route` 必须通过生命周期转换校验；Spec、原型和技术分析不得直接跳转到 Ticket 正式化或实现，必须先完成 `work-unit.implementation-repository-preparation`，再进入 `work-unit.ticket-decomposition`。
@@ -87,16 +113,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 +130,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/.codex/skills/yss-product-lifecycle/references/plan-requirements.md

@@ -1,12 +1,13 @@
 # 需求澄清与 Context 对账
 
-`work-unit.plan-requirements` 由 `yss-product-lifecycle` 或当前 profile 编排器执行，按需使用 `grilling` 和 `domain-modeling`，不另建批准入口。
+`work-unit.plan-requirements` 由 `yss-product-lifecycle` 或当前 profile 编排器执行。发现必须确认的需求、业务规则、范围或取舍未决项时，按 `planning.clarification_policy` 主动调用 `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 或自行推进阶段，交回当前编排器验收。
+2. 自行查证可发现事实，技术事实路由 `yss-research`，可执行阻塞安排原型或实际验证，专业审查由主控派发，验证失败修复或补证。真正用户决定才组成当前决策前沿；调查未完成只等待依赖该事实的问题，其他必要问题和独立已授权工作继续。未确认的术语留在 Plan，不能写成稳定事实。
+3. 依问题依赖分轮询问全部当前可回答的必要问题，每题给出建议，保留真实原始回复；回复后再推进依赖问题。复用未变化的确认，用户纠正理解时只重开受影响问题及依赖。不能用口头同意代替事实、实验或审查证据。
+4. 确认后由 domain-modeling 维护五列业务词汇表，以 `<ContextId>/<EnglishIdentifier>` 标识；非 Global 的 ContextId 来自已确认业务责任区。只有难以逆转、非显然且有真实取舍的决定才形成 ADR。研究和实际验证保留可读证据。
+5. `project-instance` 批准或返回下一工作单元前生成 `context_reconciliation`，保存可读 ref、document_digest、referenced_terms_digest 与 term_refs，并执行对账验证。候选、别名、范围冲突或摘要漂移均阻断；对账不另增门禁。`template-source` 仅校验模板合同并记录有原因的 `not-applicable`，不虚构业务术语。
+6. 收敛时回述用户问题、目标、MVP、非目标、关键规则、验收例子、未决项结论及剩余不确定性，核对解决证据和非关键延期交接。`checks.grill_exit=passed` 表示准备就绪，仍待最终真实决定。固定完整 Plan 审阅包后，将共同理解与当前 Plan 批准范围合并展示、取得同一真实回复；回复存入外部 `plan_user_decision_ref`，不回写审阅包或其 `basis`。入口通过准备检查和当前决定后才判定完整 `grill_exit`；既有批准仅按用户决定协议核验延续。
+7. 结束时列出已确认决定、未决假设、变更文档、对账状态与引用、下一授权动作。未回流 blocker 不得进入 Spec。共同理解与变更范围未确认前不改实现合同或代码；澄清结果不能批准资产、设置 ready-for-agent 或自行推进阶段，交回当前编排器验收。
 
 起草 Plan 使用 `.template-spec/plan/templates/plan-template.md`，Spec 使用 `.template-spec/templates/spec-template.md`；显式 `to-spec` 使用同一模板。可选只读诊断及未评估项见 `.template-spec/process/plan-spec-quality.md`，不增加阶段门禁。

package/template/.codex/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/.codex/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/.codex/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/.codex/skills/yss-prototype-stage/scripts/verify-prototype-design.mjs

@@ -26,6 +26,7 @@ export async function verifyPrototypeDesign({scope='all',toolchain=process.env.Y
  if((await readdir(output)).length)throw Error('验证输出非空，拒绝覆盖历史证据');
  const report={schema_version:1,scope,status:'running',started_at:new Date().toISOString(),output,source:null,tools:{node:process.version},checks:[],counts:{passed:0,failed:0,'not-executed':0,'not-applicable':0},limitations:['自动化结果不构成人工视觉批准、读屏结论或真实用户效果。']};
  const env={...process.env,TMPDIR:output,YSS_PROTOTYPE_EVIDENCE_DIR:output};
+ delete env.NODE_TEST_CONTEXT; // 子进程独立输出 TAP，不继承父级 node --test 的内部传输协议。
  const add=(id,status,reason,extra={})=>report.checks.push({id,status,...(reason?{reason}:{}),...extra});
  async function run(id,args){
   const log=path.join(output,id+'.log'),command=[process.execPath,...args];

package/template/.codex/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 阻断已有效登记的既有工程。