create-yss-spec 3.3.4 → 3.3.7

package/template/docs/templates/examples/lifecycle-writing-examples.md

@@ -0,0 +1,138 @@
+# Plan、Spec、Ticket 写作对照
+
+性质：虚构的写作示例，非产品资产，不代表业务术语或批准记录。
+
+本文件配合[中文写作规范](../../process/document-writing.md)。每组先给固定输入，再给两种表达，最后逐项核对。三组独立提供事实，不表示真实项目已经从 Plan 进入 Spec 或取得任何批准。“原写法”由作者构造，不是对模型运行结果或真实文档的抽样。
+
+## 1. Plan：让业务问题和取舍可见
+
+### 固定输入
+
+| 示例编号 | 已提供信息 |
+|---|---|
+| P1 | 示例访谈中，一名采购申请人说申请曾因缺少材料被退回；未提供访谈记录或样本统计 |
+| P2 | 本期候选范围是在提交前检查必填附件，并指出缺少的材料；业务价值尚待验证 |
+| P3 | 材料真实性识别、审批路线调整不在本期范围 |
+| P4 | 建议用缺材料退回比例观察效果；基线、统计口径和目标值尚未确认 |
+| P5 | 必填材料清单尚未确认，影响关键业务规则；需求经理需在进入 Spec 前取得业务负责人确认，并交接给 Spec 起草者 |
+| P6 | 当前范围及成功标准仍待用户确认，本组示例不能支持 Plan 流转 |
+
+### 原写法：事实齐全，但结论被修饰语遮住
+
+为全面提升采购协作体验，本阶段拟通过前置校验能力构建高效闭环，实现申请质量的持续优化。一名申请人在示例访谈中提到材料缺失导致退回，但尚无访谈原始记录及统计数据。规划提交前检查必填附件并提示缺少材料，业务价值待验证；材料真实性识别和审批路线调整不纳入本期。建议围绕缺材料退回比例建立成效评估体系，相关基线、统计口径和目标值有待明确。必填清单影响关键业务规则，由需求经理在进入 Spec 前取得业务负责人确认并交给 Spec 起草者；范围和成功标准也待用户确认，当前不能流转。
+
+### 改写：按问题、范围和未决决定组织
+
+本期建议在采购申请提交前检查必填附件，直接告诉申请人缺少哪些材料。
+
+问题线索来自一名申请人对材料缺失退回的描述；目前没有原始访谈记录和统计数据，尚不能判断问题发生频率或预期收益。
+
+本期不做材料真实性识别，也不调整审批路线。建议观察缺材料退回比例是否下降；统计口径、基线和目标值仍待确认。
+
+进入 Spec 前，需求经理需要取得业务负责人对必填材料清单的确认，并交给 Spec 起草者。清单影响关键业务规则；当前范围和成功标准也未取得用户确认，因此本组规划尚不能流转。
+
+### 保真核对
+
+| 输入 | 改写落点 | 保留语义 |
+|---|---|---|
+| P1 | 问题线索段 | 保留单一样本和来源缺口，没有改写成普遍问题 |
+| P2 | 首段及问题线索段 | 范围保持候选语气，没有承诺已验证收益 |
+| P3 | 非目标句 | 两项非目标均保留 |
+| P4 | 指标句 | 基线、口径、目标均未凭空补值 |
+| P5 | 最后一段 | 保留关键程度、负责人、确认方、时点和接收方 |
+| P6 | 最后一句 | 未将文字完善解释为可以流转 |
+
+## 2. Spec：让规则可以转成验收
+
+### 固定输入
+
+以下是假设已由业务提供的七条规则，用于独立演示；它们不是从上一组待确认的 Plan 自动推导的决定。
+
+| 示例编号 | 已提供信息 |
+|---|---|
+| S1 | 校验发生在申请人点击提交时 |
+| S2 | 缺少任一必填附件时，拒绝提交，申请保持草稿 |
+| S3 | 逐一列出所有缺少附件的名称，不只显示第一项 |
+| S4 | 校验拒绝后，保留本次页面已填写内容；未承诺关闭或刷新页面后仍保留 |
+| S5 | 补齐附件后，再次提交时重新校验 |
+| S6 | 附件齐全且其他既有提交条件通过时，沿用既有提交流程；附件齐全本身不保证提交成功 |
+| S7 | 不检查材料真实性；必填清单读取失败时如何处理尚未确认，交业务负责人在 Spec 冻结前确认 |
+
+### 原写法：规则挤在一段中
+
+系统应提供完善的附件校验能力和友好的异常反馈。在申请人点击提交时进行检查，缺少任一必填附件即拒绝并保持草稿，完整列出所有缺少附件名称，且保留本次页面输入，但不保证刷新或关闭页面后保留。补齐后再次提交需重新校验，只有附件齐全且其他既有条件也通过才能沿用既有流程，附件齐全不能单独保证成功。不校验材料真实性；清单读取失败行为尚未明确，需业务负责人在 Spec 冻结前确认，以保障整体体验。
+
+### 改写：规则和例子对应
+
+申请人点击提交时，系统检查必填附件。缺少任一附件即拒绝提交，申请保持草稿，并逐一列出所有缺少附件的名称。
+
+| 条件 / 操作 | 可观察结果 | 对应输入 |
+|---|---|---|
+| 缺少任一必填附件，点击提交 | 拒绝提交；申请仍为草稿；列出全部缺失名称 | S1、S2、S3 |
+| 因附件缺失被拒绝 | 本次页面已填写内容仍在；不承诺刷新或关闭后的保存 | S4 |
+| 补齐附件后再次点击提交 | 重新执行附件校验 | S5 |
+| 附件齐全且其他既有条件通过 | 进入既有提交流程 | S6 |
+
+附件齐全不代表其他提交条件已经通过。本功能不检查材料真实性。
+
+验收例子：在示例清单中，“报价单”和“采购说明”均为必填，申请人两项都未提供。点击提交后，应看到两个缺失名称，申请仍为草稿，当前页面已填写内容保留。这里的附件名称是测试数据，不扩展实际必填清单。
+
+待确认：必填清单读取失败时的行为，由业务负责人在 Spec 冻结前确认。当前不能将失败默认解释为放行或拒绝。
+
+### 保真核对
+
+| 输入 | 改写落点 | 保留语义 |
+|---|---|---|
+| S1、S2 | 首段、首行条件 | 触发点和状态保持不变 |
+| S3 | 首段、首行结果、验收例子 | “所有”未缩为一项，没有五项展示上限 |
+| S4 | 第二行结果 | 页面内保留未扩展成持久保存 |
+| S5 | 第三行 | 保留再次校验 |
+| S6 | 第四行及后续限定句 | 保留与其他条件的合取关系 |
+| S7 | 非目标与待确认段 | 未新增真实性检查，也未决定故障降级行为 |
+
+本例比原文更长，增加的是规则之间的边界和定位信息；这不构成效果退步。
+
+## 3. Ticket：把交付行为与实现就绪区分清楚
+
+### 固定输入
+
+| 示例编号 | 已提供信息 |
+|---|---|
+| T1 | 切片交付“提交申请时校验必填附件并展示拒绝结果”，覆盖所需前后端行为，不以技术层横拆 |
+| T2 | 示例内给定 Spec v2 的规则 R1 和 OpenAPI v3 已冻结；它们只是虚构输入标签，没有真实批准记录 |
+| T3 | 验收覆盖缺失时拒绝且不提交、全部缺失名称可见、页面输入保留，以及补齐后重新校验 |
+| T4 | 公共测试 seam 是提交接口和申请表单交互；命令应从真实工程与实现合同读取，示例未提供命令 |
+| T5 | Slice Implementation Contract v1 仍为草案、生命周期批准 pending；依赖的必填材料配置切片未完成 |
+| T6 | 当前 Ticket 状态为 ready-for-human；不存在实现或测试通过证据；真实性识别不在范围内 |
+
+### 原写法：重点埋在实现名词之后
+
+本任务将全面完善前后端附件校验链路，覆盖提交接口、页面交互及相关测试，遵循示例 Spec v2 / R1 和冻结 OpenAPI v3，以端到端切片交付提交申请时的必填附件校验及拒绝反馈，不按技术层横拆。需验证缺失拒绝且不提交、完整提示缺失名称、保留页面输入和补齐后重新校验；公共 seam 为提交接口与申请表单，命令需读取工程和合同。实现合同 v1 为草案且批准 pending，必填材料配置依赖尚未完成。状态 ready-for-human，尚无实现或测试通过证据，真实性识别不在范围。
+
+### 改写：先说交付，再列验收和阻塞
+
+本切片交付：申请人提交申请时，系统校验必填附件，并在拒绝提交后展示缺失材料。交付覆盖所需前后端行为。
+
+范围依据：示例 Spec v2 / R1、冻结 OpenAPI v3；材料真实性识别不在本切片范围。
+
+验收项均待验证：
+
+- [ ] 缺少必填附件时拒绝提交，申请未提交。
+- [ ] 页面列出全部缺失附件名称。
+- [ ] 拒绝后保留本次页面已填写内容。
+- [ ] 补齐后再次提交，重新执行附件校验。
+
+通过提交接口和申请表单交互验证以上行为。具体命令待从真实工程与实现合同读取，当前没有实现或测试通过证据。
+
+当前状态：`ready-for-human`。实现合同 v1 为草案，生命周期批准为 `pending`；必填材料配置切片也未完成。两项阻塞均需闭合，并由生命周期完成全部适用就绪核验后，才可决定是否进入实现。
+
+### 保真核对
+
+| 输入 | 改写落点 | 保留语义 |
+|---|---|---|
+| T1 | 首段 | 保留完整用户行为和跨受影响层范围 |
+| T2 | 范围依据 | 沿用示例版本，不产生真实批准 |
+| T3 | 四条未勾选验收 | 四项均保留，未伪造完成 |
+| T4 | 验证段 | seam 明确，未臆造工程命令 |
+| T5 | 状态段 | 两项阻塞均展示，未只保留一个下一步 |
+| T6 | 范围、验证及状态段 | 状态未提前推进；未扩大范围 |

package/template/docs/templates/spec-template.md

@@ -7,17 +7,19 @@ owner: ai
 
 # 产品研发规格：<功能名称>
 
+填写前读取[中文写作规范](../process/document-writing.md)和 [Spec 对照](examples/lifecycle-writing-examples.md#2-spec让规则可以转成验收)。保留原规则、例外和不确定性；输入缺失时记录待确认项。
+
 ## 功能父 Ticket
 
 <Local：`docs/.scratch/<feature>/parent-ticket.md`；GitHub / GitLab：Issue URL / 编号>
 
 ## 问题陈述
 
-（从用户视角描述要解决的问题。）
+（说明哪个角色在什么场景遇到什么问题，给出来源及其限制。）
 
 ## 解决方案
 
-（从用户视角描述解决方案。）
+（说明本次改变的用户行为和范围，区分已确认规则与候选方案。）
 
 ## 用户故事
 
@@ -25,12 +27,16 @@ owner: ai
 
 ## 功能需求
 
+需求写明主体、触发条件和可观察结果；关联验收标准。不要用“完善、友好、高效”代替规则。
+
 | ID | 需求 | 优先级 | 备注 |
 |---|---|---|---|
 | FR-001 | | P0/P1/P2 | |
 
 ## 非功能需求
 
+命中时填写工作负载或适用条件、目标值及单位、验证方式与依据；尚未确认的目标保留为未决项，不补造性能承诺。
+
 | 类别 | 需求 | 目标 |
 |---|---|---|
 | 性能 | | |
@@ -38,6 +44,8 @@ owner: ai
 
 ## 验收标准
 
+关联需求 ID，按实际影响覆盖成功、拒绝、边界和恢复。保留“全部”“仅当”等限定；测试数据不能反向扩展业务规则。
+
 ```gherkin
 假如 <上下文>
 当 <操作>
@@ -47,7 +55,8 @@ owner: ai
 ## 产品总体设计 / 功能架构
 
 - 功能域与模块边界：
-- MVP / 非目标：
+- MVP：
+- 非目标：见本文“非目标范围”，此处不重复维护。
 - UI 影响：是 / 否
 - 产品总体设计：`docs/.scratch/<feature>/design/<feature>-product-overview-design.md`
 
@@ -99,4 +108,8 @@ owner: ai
 
 ## 非目标范围
 
+明确本次不交付什么及依据；与上游范围保持一致。
+
 ## 风险
+
+记录已知风险和未决项的影响、责任人、解决时点及接收方；尚未明确原因时保留现象和验证方法。

package/template/docs/templates/vertical-slice-ticket-template.md

@@ -4,7 +4,7 @@ status: ready-for-human
 
 # 垂直切片 Ticket：<标题>
 
-Status: ready-for-human
+填写前读取[中文写作规范](../process/document-writing.md)和 [Ticket 对照](examples/lifecycle-writing-examples.md#3-ticket把交付行为与实现就绪区分清楚)。状态只在 frontmatter 维护，正文记录依据。
 
 ## 父级
 
@@ -14,6 +14,8 @@ Status: ready-for-human
 
 描述本 Ticket 要交付的窄而完整的端到端行为。它必须贯穿所有受影响层，是可独立验证的垂直切片，不能只是某一层的横向任务。
 
+先用一句话写出用户操作及交付结果，再引用对应 Spec 规则、版本和本切片边界；不要重写冻结需求或填入未经确认的范围。
+
 ## 覆盖的用户故事
 
 - <用户故事 ID 或文本>
@@ -31,6 +33,8 @@ Status: ready-for-human
 
 ## 验收标准
 
+每项写条件、操作和可观察结果，关联上游规则；保留必要例外。测试未执行前保持未勾选。
+
 - [ ] 标准 1
 - [ ] 标准 2
 - [ ] 标准 3
@@ -92,7 +96,7 @@ Status: ready-for-human
 
 ## 阻塞关系
 
-- 无，可立即开始
+列出实际依赖、未决项、责任人和解除条件；尚未核验时写“待核验”。只有确认没有阻塞时才写“无”，无依赖不等于已通过实现就绪核验。
 
 ## 重路由状态
 
@@ -116,9 +120,9 @@ Status: ready-for-human
 
 ## 状态
 
-`ready-for-agent`
+状态依据：<当前版本合同、批准和就绪核验记录引用，以及尚未关闭的阻塞>。
 
-> 仅当阻塞关系为“无”且必要门禁已通过时填写 `ready-for-agent`；否则写明被哪个 Ticket 阻塞。
+> 默认 frontmatter 为 `ready-for-human`。仅在生命周期确认合同已批准且当前、阻塞已清除、全部适用门禁及就绪条件通过后更新为 `ready-for-agent`；本节不另维护第二个状态值。
 
 ## AI / 人工审查点
 

package/template/scripts/lib/approval-record.mjs

@@ -1,3 +1,4 @@
+import { assertApprovalUserDecision } from './user-decision-reuse.mjs';
 import { existsSync, readFileSync } from "node:fs";
 import path from "node:path";
 import { parseDocument } from "../vendor/yaml.mjs";
@@ -101,7 +102,7 @@ export function validateApprovalRecord(record, { rolesDoc, requireApproved = fal
 
 function assertRecordUserDecision(record, registry, options) {
   if (!registry.user_decision_policy.gates.includes(record.gate_id) && countersignRuleForGate(registry.gate_policy, record.gate_id)?.bucket !== "biological_human") return;
-  const result = assertUserDecisionRequirement({ boundary: record.gate_id, subject_ref: record.subject_ref, scope: record.approval_scope, user_decision_ref: record.user_decision_ref }, { ...options, rolesDoc: registry });
+  const result = assertApprovalUserDecision(record, registry, options);
   if (record.actor_kind === "biological-human" && result.validated.some((item) => item.principal_ref !== record.principal_ref)) fail("user-decision-responder-mismatch: 生物人会签者与原始回复者不一致");
 }
 

package/template/scripts/lib/backend-delivery.mjs

@@ -6,7 +6,7 @@ import { read, safe, ensure, hash, digest, json, files, write, project, schema,
 
 // Evidence binds the deliverable basis, avoiding a circular hash through its own logs.
 export function backendDeliveryBasis(delivery) {
-  return digest(Object.fromEntries(['delivery_id','version','strategic_bundle_digest','scope','openapi','slice_contract','build','environment'].map(key=>[key,delivery[key]])));
+  return digest(Object.fromEntries(['delivery_id','version','strategic_bundle_digest','strategic_route_id','scope','openapi','slice_contract','build','environment'].filter(key=>delivery[key]!==undefined).map(key=>[key,delivery[key]])));
 }
 
 function boundFile(root, binding) {
@@ -57,6 +57,10 @@ export async function inspectBackendDelivery(root, ref) {
   verification(root,delivery.verification.deployment,basis,'backend-deployment');
   return openBundle(safe(root,delivery.strategic_bundle_ref),bundle=>{
     ensure(bundle.manifest.bundle_digest===delivery.strategic_bundle_digest,'后端交付与战略版本不一致');
+    if(bundle.handoff.schema_version===4){
+      const route=bundle.handoff.consumer_routes.find(item=>item.capability==='backend-technical-design');
+      ensure(route&&route.activation!=='not-applicable'&&delivery.strategic_route_id===route.route_id,'后端交付未绑定当前 backend-technical-design route_id');
+    }
     const sources=new Set([...bundle.indexes.rules.map(x=>x.rule_id),...bundle.indexes.scenarios.map(x=>x.scenario_id)]);
     ensure(delivery.scope.source_ids.every(id=>sources.has(id)),'后端交付引用未知规则/场景');
     const scenarios=bundle.indexes.scenarios.filter(x=>delivery.scope.source_ids.includes(x.scenario_id));
@@ -152,14 +156,22 @@ export async function importBackendDelivery({bundle,targetRoot}) {
     }
     const strategic=await importBundle({bundle:safe(b.source,b.delivery.strategic_bundle_ref),targetRoot:target});
     const strategicReceipt=read(safe(target,strategic.receipt_ref));
-    const trace=read(safe(target,`${path.posix.dirname(strategic.receipt_ref)}/tactical-traceability-draft.json`));
+    const strategicBase=path.posix.dirname(strategic.receipt_ref);
+    const frontendRoute=strategicReceipt.schema_version===2?strategicReceipt.routes.find(route=>route.capability==='frontend-engineering-design'):null;
+    const traceRef=frontendRoute?.artifact_refs.find(item=>item.endsWith('frontend-traceability-draft.json'))||`${strategicBase}/tactical-traceability-draft.json`;
+    const trace=read(safe(target,traceRef));
     mkdirSync(path.dirname(destination),{recursive:true});
     const staging=mkdtempSync(path.join(path.dirname(destination),'.backend-import-'));
     try {
       cpSync(b.root,path.join(staging,'package'),{recursive:true,errorOnExist:true,force:false});
       const receipt={schema_version:1,delivery_id:b.delivery.delivery_id,version:b.delivery.version,bundle_digest:b.manifest.bundle_digest,package_ref:`${ref}/package`};
       write(staging,'import-receipt.json',json(receipt));
-      write(staging,'frontend-acceptance-draft.json',json({schema_version:1,status:'draft',slice_id:b.delivery.scope.slice_id,backend_delivery:{import_receipt_ref:`${ref}/import-receipt.json`,bundle_digest:b.manifest.bundle_digest},strategic_handoff:{import_receipt_ref:strategic.receipt_ref,bundle_digest:strategicReceipt.bundle_digest,context_reconciliation_ref:'',rows:trace.rows.map(({tactical_refs,test_seam_refs,...row})=>({...row,frontend_case_refs:[]}))},frontend_cases:[]}));
+      const strategicHandoff={import_receipt_ref:strategic.receipt_ref,bundle_digest:strategicReceipt.bundle_digest,...(trace.route_id?{route_id:trace.route_id}:{}),context_reconciliation_ref:'',rows:trace.rows.map(({tactical_refs,test_seam_refs,...row})=>({...row,frontend_case_refs:[]}))};
+      if(strategicReceipt.schema_version===2){
+        ensure(frontendRoute,'Handoff v4 Import Receipt 未选择 frontend-engineering-design 能力');
+        const preflightRef=frontendRoute.artifact_refs.find(item=>item.endsWith('frontend-strategic-preflight-draft.json'));ensure(preflightRef,'Handoff v4 缺少 Frontend Strategic Preflight 草案');
+        write(staging,'frontend-acceptance-draft.json',json({schema_version:2,status:'draft',slice_id:b.delivery.scope.slice_id,strategic_preflight:{ref:preflightRef,digest:hash(readFileSync(safe(target,preflightRef)))},backend_dependency:{mode:'required',route_id:'route.backend'},backend_delivery:{import_receipt_ref:`${ref}/import-receipt.json`,bundle_digest:b.manifest.bundle_digest},strategic_handoff:strategicHandoff,frontend_cases:[]}));
+      }else write(staging,'frontend-acceptance-draft.json',json({schema_version:1,status:'draft',slice_id:b.delivery.scope.slice_id,backend_delivery:{import_receipt_ref:`${ref}/import-receipt.json`,bundle_digest:b.manifest.bundle_digest},strategic_handoff:strategicHandoff,frontend_cases:[]}));
       ensure(!existsSync(destination),'后端包导入并发冲突');renameSync(staging,destination);
       return {result:'imported-pending-acceptance',receipt_ref:`${ref}/import-receipt.json`,acceptance_ref:`${ref}/frontend-acceptance-draft.json`};
     } finally { rmSync(staging,{recursive:true,force:true}); }

package/template/scripts/lib/frontend-delivery-boundary.mjs

@@ -7,14 +7,27 @@ import { ROOT, read, safe, ensure, digest } from './strategic-handoff-io.mjs';
 // Shared synchronous adapter for existing compiler, lifecycle and task-package seams.
 // Always re-executes the verifier; a caller-supplied "verified" flag is never evidence.
 export function enforceFrontendDelivery(state={}, {root=ROOT,phase='inputs'}={}) {
+  ensure(['preflight','design','contract','inputs','implementation','verification'].includes(phase),`未知前端交付阶段: ${phase}`);
   const profile=loadDeliveryProfile(root);
   let contract;
   const contractRef=state.slice_contract_ref||state.contract?.slice_contract_ref;
-  const selected=profile?.profile_id==='harness.frontend-delivery'||profile?.frontend_delivery?.required===true;
+  const dedicatedProfile=profile?.profile_id==='harness.frontend-delivery'||profile?.profile_id==='yss-harness-frontend';
+  const selected=dedicatedProfile||profile?.frontend_delivery?.required===true||profile?.handoff?.consumer_capabilities?.includes('frontend-engineering-design');
   const identity=selected?read(safe(root,'yss-project.yaml')):null;
   if(selected)ensure(identity.schema_version===1&&['template-source','project-instance'].includes(identity.repository_mode),'前端项目仓库身份无效');
-  const dedicated=selected&&identity.repository_mode==='project-instance';
+  const dedicated=dedicatedProfile&&identity.repository_mode==='project-instance';
   if(dedicated)ensure(state.contract?.kind!=='template-maintenance','前端产品项目不得用模板维护任务绕过输入条件');
+  if(['preflight','design'].includes(phase)) {
+    const preflight=state.frontend_preflight||state.frontend?.preflight||state.resolution?.frontend_preflight;
+    ensure(preflight?.preflight_ref,'frontend-preflight-required: 缺少 Frontend Strategic Preflight');
+    const args=[path.join(ROOT,'scripts/verify-frontend-strategic-preflight'),'--root',root];
+    if(preflight.digest)args.push('--expected-digest',preflight.digest);
+    args.push(preflight.preflight_ref);
+    const verified=spawnSync(process.execPath,args,{cwd:root,encoding:'utf8',timeout:60000,maxBuffer:2*1024*1024});
+    ensure(verified.status===0,`frontend-preflight-blocked: ${verified.error?.message||verified.stderr||verified.stdout}`);
+    const result=JSON.parse(verified.stdout);ensure(result.result==='preflight-verified'&&result.ready_for_agent===false,'前端战略预检返回非法状态');
+    return result;
+  }
   let binding=state.frontend_delivery||state.frontend?.delivery||state.resolution?.frontend_delivery;
   if(contractRef) {
     // Legacy callers may supply an absolute external contract. Discover whether
@@ -27,17 +40,20 @@ export function enforceFrontendDelivery(state={}, {root=ROOT,phase='inputs'}={})
       binding=direct||resolved||binding;
     }
   }
-  if(!dedicated&&!binding)return {result:'not-applicable'};
+  const frontendStatus=contract?.frontend?.status||state.frontend?.status;
+  const contractRequiresFrontend=typeof frontendStatus==='string'&&!['not-applicable','disabled'].includes(frontendStatus);
+  if(!dedicated&&!binding&&!contractRequiresFrontend)return {result:'not-applicable'};
   if(contractRef)safe(root,contractRef);
   ensure(binding?.acceptance_ref,'frontend-delivery-required: 缺少战略与后端联合接收记录');
   const slice=contract?.slice_id||state.slice_id;
   ensure(!contract?.slice_id||!state.slice_id||contract.slice_id===state.slice_id,'前端任务与 Slice Contract 切片不一致');
   ensure(slice,'frontend-delivery-required: 缺少明确切片');
-  if(phase==='implementation') {
+  if(['implementation','verification'].includes(phase)) {
     ensure(contract?.status==='approved','frontend-delivery-required: 必须读取已持久化的 approved Slice Contract');
     ensure(contract.frontend?.delivery||contract.resolution?.frontend_delivery,'frontend-delivery-required: Slice Contract 未绑定前端交付');
     ensure(binding.digest,'frontend-delivery-required: Slice Contract 未冻结接收记录摘要');
   }
+  if(phase==='verification')ensure(state.frontend_implementation_verification_ref||contract?.frontend?.implementation_verification_ref,'frontend-delivery-required: 验证阶段缺少 frontend_implementation_verification 引用');
   const args=[path.join(ROOT,'scripts/verify-frontend-delivery'),'--root',root,'--slice',slice];
   if(binding.digest)args.push('--expected-digest',binding.digest);
   args.push(binding.acceptance_ref);

package/template/scripts/lib/frontend-delivery.mjs

@@ -1,9 +1,49 @@
 import { existsSync, readdirSync, readFileSync } from 'node:fs';
 import path from 'node:path';
+import { spawnSync } from 'node:child_process';
 import { openBackendDelivery } from './backend-delivery.mjs';
 import { openBundle } from './strategic-handoff.mjs';
 import { verifyConsumption } from './strategic-handoff-consumption.mjs';
-import { read, safe, ensure, hash, schema, project } from './strategic-handoff-io.mjs';
+import { read, safe, ensure, hash, schema, project, ROOT } from './strategic-handoff-io.mjs';
+
+const ACCEPTANCE_SCHEMAS=new Map([[1,'docs/process/schemas/frontend-delivery-acceptance-v1.schema.json'],[2,'docs/process/schemas/frontend-delivery-acceptance.schema.json']]);
+
+function acceptanceSchema(version) {
+  ensure(ACCEPTANCE_SCHEMAS.has(version),`Frontend Delivery Acceptance 未知 schema_version: ${String(version)}；支持版本: 1, 2；新接收请迁移到 2`);
+  return ACCEPTANCE_SCHEMAS.get(version);
+}
+
+export async function verifyFrontendStrategicPreflight({root=process.cwd(),preflightRef,expectedDigest}={}) {
+  project(root);
+  const file=safe(root,preflightRef),preflight=read(file);
+  schema(preflight,'docs/process/schemas/frontend-strategic-preflight.schema.json');
+  const preflightDigest=hash(readFileSync(file));
+  if(expectedDigest)ensure(expectedDigest===preflightDigest,'前端战略预检摘要已变化，需重编译合同');
+  ensure(preflight.status==='verified','前端战略预检尚未 verified');
+  const receipt=read(safe(root,preflight.import_receipt_ref));
+  ensure(receipt.schema_version===2,'Frontend Strategic Preflight 仅接受 Import Receipt v2');
+  const base=`docs/handoffs/${receipt.bundle_id}/${receipt.version}`;
+  ensure(preflight.import_receipt_ref===`${base}/import-receipt.json`&&receipt.package_ref===`${base}/package`,'战略预检收据路径与身份不匹配');
+  ensure(preflight.bundle_digest===receipt.bundle_digest,'战略预检与收据摘要不一致');
+  const routeReceipt=receipt.routes.find(item=>item.route_id===preflight.route_id&&item.capability==='frontend-engineering-design');
+  ensure(routeReceipt&&routeReceipt.activation!=='not-applicable','当前 Handoff 未启用前端工程设计路由');
+  const reconciliation=spawnSync(process.execPath,[path.join(ROOT,'scripts/verify-context-reconciliation'),'--root',root,safe(root,preflight.context_reconciliation_ref)],{encoding:'utf8'});
+  ensure(reconciliation.status===0,`前端战略预检 Context Reconciliation 未通过: ${reconciliation.error?.message||reconciliation.stderr}`);
+  return openBundle(safe(root,receipt.package_ref),bundle=>{
+    ensure(bundle.handoff.schema_version===4&&bundle.manifest.bundle_digest===receipt.bundle_digest,'前端战略预检必须绑定 Handoff v4 当前包');
+    const frontendRoute=bundle.handoff.consumer_routes.find(item=>item.route_id===preflight.route_id&&item.capability==='frontend-engineering-design');
+    const backendRoute=bundle.handoff.consumer_routes.find(item=>item.capability==='backend-technical-design');
+    ensure(frontendRoute&&frontendRoute.activation!=='not-applicable','前端路由未启用');
+    const known=[...bundle.indexes.rules.map(item=>item.rule_id),...bundle.indexes.scenarios.filter(item=>item.critical).map(item=>item.scenario_id)].sort();
+    ensure(JSON.stringify([...preflight.source_rule_refs].sort())===JSON.stringify(known),'前端战略预检未完整绑定源规则/关键场景');
+    const expectedVisual=`${base}/package/payload/files/${bundle.handoff.source.visual_baseline_ref.persisted_ref}/${bundle.handoff.source.visual_baseline_ref.manifest_ref}`;
+    ensure(preflight.visual_baseline_ref===expectedVisual,'前端战略预检 Visual Baseline 引用不一致');
+    const expectedMode=backendRoute.activation==='not-applicable'?'not-applicable':'required';
+    ensure(preflight.backend_dependency.mode===expectedMode&&preflight.backend_dependency.route_id===backendRoute.route_id,'前端战略预检后端依赖与消费者路由不一致');
+    if(expectedMode==='not-applicable')ensure(preflight.backend_dependency.reason===backendRoute.reason&&JSON.stringify(preflight.backend_dependency.impact_refs)===JSON.stringify(backendRoute.impact_refs)&&JSON.stringify(preflight.backend_dependency.evidence_refs)===JSON.stringify(backendRoute.evidence_refs),'backend-not-applicable 依据与战略路由不一致');
+    return {result:'preflight-verified',ready_for_agent:false,preflight_ref:preflightRef,preflight_digest:preflightDigest,strategic_bundle_digest:receipt.bundle_digest,backend_dependency:expectedMode,next_action:'prepare-frontend-engineering-design-draft'};
+  });
+}
 
 function pointer(value, ref) {
   ensure(ref.startsWith('/')&&!ref.includes('//'),'服务版本 JSON Pointer 无效');
@@ -35,10 +75,33 @@ export async function probeBackend(delivery) {
 export async function verifyFrontendDelivery({root=process.cwd(),acceptanceRef,sliceRef,expectedDigest}) {
   project(root);
   const file=safe(root,acceptanceRef), acceptance=read(file);
-  schema(acceptance,'docs/process/schemas/frontend-delivery-acceptance.schema.json');
+  schema(acceptance,acceptanceSchema(acceptance?.schema_version));
   const acceptanceDigest=hash(readFileSync(file));
   if(expectedDigest)ensure(expectedDigest===acceptanceDigest,'前端接收记录摘要已变化，需重编译合同');
   ensure(sliceRef&&acceptance.slice_id===sliceRef,'前端接收记录与执行切片不匹配');
+  if(acceptance.schema_version===2) {
+    const preflight=await verifyFrontendStrategicPreflight({root,preflightRef:acceptance.strategic_preflight.ref,expectedDigest:acceptance.strategic_preflight.digest});
+    ensure(preflight.strategic_bundle_digest===acceptance.strategic_handoff.bundle_digest,'前端接收与战略预检版本不一致');
+    if(acceptance.backend_dependency.mode==='not-applicable') {
+      ensure(!acceptance.backend_delivery,'backend-not-applicable 不得绑定后端交付收据');
+      const strategic=await verifyConsumption(acceptance,{root,sliceRef,consumer:'frontend'});
+      ensure(strategic.result==='verified',`战略承接阻断: ${JSON.stringify(strategic.issues)}`);
+      const strategicReceipt=read(safe(root,acceptance.strategic_handoff.import_receipt_ref));
+      return openBundle(safe(root,strategicReceipt.package_ref),bundle=>{
+        const visualCases=bundle.handoff.source.visual_baseline_ref.case_ids;
+        const sourceIds=new Set([...bundle.indexes.rules.map(item=>item.rule_id),...bundle.indexes.scenarios.filter(item=>item.critical).map(item=>item.scenario_id)]);
+        const ids=acceptance.frontend_cases.map(item=>item.case_id);ensure(new Set(ids).size===ids.length,'前端验收用例 ID 重复');
+        for(const item of acceptance.frontend_cases){
+          ensure(item.operation_ids.length===0,'backend-not-applicable 前端用例不得绑定 operation_ids');
+          ensure(item.source_ids.every(id=>sourceIds.has(id)),'前端用例引用未知规则/场景');
+          ensure(item.visual_case_ids.every(id=>visualCases.includes(id)),'前端用例视觉基线悬空');
+          const evidence=readFileSync(safe(root,item.evidence_ref));ensure(evidence.length>0&&hash(evidence)===item.evidence_digest,'前端承接用例说明为空或摘要漂移');
+        }
+        return {result:'inputs-verified',ready_for_agent:false,slice_id:sliceRef,acceptance_ref:acceptanceRef,acceptance_digest:acceptanceDigest,strategic_bundle_digest:strategic.consumed_bundle_digest,backend_dependency:'not-applicable',next_action:'prepare-or-revalidate-frontend-plan-and-slice-contract'};
+      });
+    }
+    ensure(acceptance.backend_dependency.mode==='required','frontend backend_dependency.mode 非法');
+  }
   const binding=acceptance.backend_delivery, receipt=read(safe(root,binding.import_receipt_ref));
   const base=`docs/backend-deliveries/${receipt.delivery_id}/${receipt.version}`;
   ensure(binding.import_receipt_ref===`${base}/import-receipt.json`&&receipt.package_ref===`${base}/package`,'后端收据路径与身份不匹配');
@@ -56,6 +119,7 @@ export async function verifyFrontendDelivery({root=process.cwd(),acceptanceRef,s
     await openBundle(safe(backend.source,delivery.strategic_bundle_ref),bundle=>{
       const visualCases=bundle.handoff.source.visual_baseline_ref.case_ids;
       for(const item of acceptance.frontend_cases) {
+        if(acceptance.schema_version===2)ensure(item.operation_ids.length>0,'有后端依赖时前端用例必须绑定已交付 operation_ids');
         ensure(item.operation_ids.every(id=>delivery.scope.operation_ids.includes(id)),'前端用例依赖未交付接口');
         ensure(item.source_ids.every(id=>delivery.scope.source_ids.includes(id)),'前端用例依赖未交付规则/场景');
         ensure(item.visual_case_ids.every(id=>visualCases.includes(id)),'前端用例视觉基线悬空');