create-yss-spec 3.2.0 → 3.3.0

package/template/scripts/lib/lifecycle-transition.mjs

@@ -5,6 +5,7 @@ import { enforceFrontendDelivery } from "./frontend-delivery-boundary.mjs";
 
 const IMPLEMENTATION_WORK_UNIT = "work-unit.slice-implementation";
 const TICKET_DECOMPOSITION_WORK_UNIT = "work-unit.ticket-decomposition";
+const REPOSITORY_PREPARATION_WORK_UNIT = "work-unit.implementation-repository-preparation";
 
 function deepFreeze(value) {
   if (!value || typeof value !== "object" || Object.isFrozen(value)) return value;
@@ -26,9 +27,10 @@ const NEXT_ROUTES = deepFreeze({
   "work-unit.discovery-requirements": ["work-unit.domain-strategy-design", "work-unit.stage-decision", "work-unit.spec-synthesis"],
   "work-unit.domain-strategy-design": ["work-unit.stage-decision", "work-unit.spec-synthesis"],
   "work-unit.stage-decision": ["work-unit.spec-synthesis"],
-  "work-unit.spec-synthesis": ["work-unit.prototype-design", "work-unit.technical-analysis", TICKET_DECOMPOSITION_WORK_UNIT],
-  "work-unit.prototype-design": ["work-unit.technical-analysis", TICKET_DECOMPOSITION_WORK_UNIT],
-  "work-unit.technical-analysis": [TICKET_DECOMPOSITION_WORK_UNIT],
+  "work-unit.spec-synthesis": ["work-unit.prototype-design", "work-unit.technical-analysis", REPOSITORY_PREPARATION_WORK_UNIT],
+  "work-unit.prototype-design": ["work-unit.technical-analysis", REPOSITORY_PREPARATION_WORK_UNIT],
+  "work-unit.technical-analysis": [REPOSITORY_PREPARATION_WORK_UNIT],
+  [REPOSITORY_PREPARATION_WORK_UNIT]: [TICKET_DECOMPOSITION_WORK_UNIT],
   [TICKET_DECOMPOSITION_WORK_UNIT]: [IMPLEMENTATION_WORK_UNIT],
   [IMPLEMENTATION_WORK_UNIT]: ["work-unit.frontend-implementation-verification", "work-unit.code-review"],
   "work-unit.frontend-implementation-verification": ["work-unit.code-review"],
@@ -56,6 +58,15 @@ const BLOCKING_SIGNALS = Object.freeze({
   contractNotCurrent: "slice-contract-not-current",
   missingEvidence: "ticket-formalization-evidence-missing",
   stale: "ticket-formalization-stale",
+  repositoryDecisionRequired: "implementation-repository-decision-required",
+  repositoryLocationRequired: "implementation-repository-location-required",
+  repositoryOnboardingIncomplete: "implementation-repository-onboarding-incomplete",
+  scaffoldChoiceRequired: "scaffold-choice-required",
+  scaffoldContractUnapproved: "scaffold-contract-unapproved",
+  scaffoldGenerationIncomplete: "scaffold-generation-incomplete",
+  scaffoldVerificationFailed: "scaffold-verification-failed",
+  frontendTemplateUnavailable: "frontend-template-unavailable",
+  implementationRepositoriesStale: "implementation-repositories-stale",
 });
 
 const allowedResult = (evidenceRefs = []) => ({
@@ -130,9 +141,101 @@ export function validateNextRoute(currentWorkUnit, nextRoute, decisionState, opt
     }
     return blockedResult(signals, ["allowed_next_route"]);
   }
+  if (nextRoute === TICKET_DECOMPOSITION_WORK_UNIT) {
+    const readiness = validateImplementationRepositoriesReady(decisionState, options);
+    if (readiness.result === "blocked") return readiness;
+  }
   return decisionState ? validateDecisionBoundary(currentWorkUnit, decisionState, options) : allowedResult();
 }
 
+/**
+ * Validate the aggregate stage-5 repository-preparation result. Every affected
+ * delivery role must resolve to an onboarded existing repository or a freshly
+ * generated and verified scaffold. Unaffected roles need an explicit reason.
+ */
+export function validateImplementationRepositoriesReady(state, { exists = existsSync } = {}) {
+  const preparation = state?.implementation_repository_preparation;
+  const impacts = state?.delivery_impacts;
+  const signals = [];
+  const missing = [];
+  const evidenceRefs = Array.isArray(preparation?.evidence_refs) ? preparation.evidence_refs : [];
+
+  if (!preparation || preparation.result !== "completed" || !Array.isArray(preparation.projects)) {
+    return blockedResult([BLOCKING_SIGNALS.repositoryDecisionRequired], ["completed implementation_repository_preparation with projects"]);
+  }
+  if (preparation.current_version !== true || state?.implementation_repositories_stale === true) {
+    signals.push(BLOCKING_SIGNALS.implementationRepositoriesStale);
+    missing.push("implementation repository preparation is current");
+  }
+  if (evidenceRefs.length === 0 || evidenceRefs.some((ref) => !isReadable(ref, exists))) {
+    signals.push(BLOCKING_SIGNALS.repositoryOnboardingIncomplete);
+    missing.push("readable implementation_repository_preparation.evidence_refs");
+  }
+
+  for (const role of ["backend", "frontend"]) {
+    const affected = impacts?.[role] === true;
+    const projects = preparation.projects.filter((project) => project?.delivery_role === role);
+    if (affected && projects.length === 0) {
+      signals.push(BLOCKING_SIGNALS.repositoryDecisionRequired);
+      missing.push(`${role} repository decision`);
+    }
+    if (!affected && projects.length === 0) {
+      signals.push(BLOCKING_SIGNALS.repositoryDecisionRequired);
+      missing.push(`${role} not-applicable decision with reason`);
+    }
+    for (const project of projects) {
+      if (!hasText(project.project_id) || !hasText(project.status)) {
+        signals.push(BLOCKING_SIGNALS.repositoryDecisionRequired);
+        missing.push(`${role} project_id and status`);
+        continue;
+      }
+      if (project.status === "not-applicable") {
+        if (affected || !hasText(project.reason)) {
+          signals.push(BLOCKING_SIGNALS.repositoryDecisionRequired);
+          missing.push(`${project.project_id} not-applicable reason for an unaffected role`);
+        }
+        continue;
+      }
+      if (!hasText(project.repository_ref) || !hasText(project.project_root) || !hasText(project.repository_scope)) {
+        signals.push(BLOCKING_SIGNALS.repositoryLocationRequired);
+        missing.push(`${project.project_id} repository_ref, project_root and repository_scope`);
+      }
+      if (project.status === "existing-and-onboarded") {
+        if (project.onboarding_result?.status !== "completed" || !isReadable(project.onboarding_result?.ref, exists)) {
+          signals.push(BLOCKING_SIGNALS.repositoryOnboardingIncomplete);
+          missing.push(`${project.project_id} readable completed onboarding result`);
+        }
+      } else if (project.status === "initialized-and-verified") {
+        if (role === "backend" && !hasText(project.architecture_family)) {
+          signals.push(BLOCKING_SIGNALS.scaffoldChoiceRequired);
+          missing.push(`${project.project_id} confirmed backend architecture_family`);
+        }
+        const contract = project.scaffold_contract;
+        if (![3, 4].includes(contract?.schema_version) || contract?.status !== "approved" || contract?.persisted !== true || contract?.current_version !== true || (role === "frontend" && contract?.schema_version !== 4)) {
+          signals.push(BLOCKING_SIGNALS.scaffoldContractUnapproved);
+          missing.push(`${project.project_id} approved persisted current scaffold contract`);
+        }
+        if (!isReadable(project.scaffold_manifest_ref, exists)) {
+          signals.push(BLOCKING_SIGNALS.scaffoldGenerationIncomplete);
+          missing.push(`${project.project_id} readable scaffold manifest`);
+        }
+        if (project.scaffold_verification?.status !== "passed" || !isReadable(project.scaffold_verification?.ref, exists)) {
+          signals.push(BLOCKING_SIGNALS.scaffoldVerificationFailed);
+          missing.push(`${project.project_id} readable passed scaffold verification`);
+        }
+        if (role === "frontend" && project.template_available !== true) {
+          signals.push(BLOCKING_SIGNALS.frontendTemplateUnavailable);
+          missing.push(`${project.project_id} verified frontend template source`);
+        }
+      } else {
+        signals.push(BLOCKING_SIGNALS.repositoryDecisionRequired);
+        missing.push(`${project.project_id} supported repository preparation status`);
+      }
+    }
+  }
+  return signals.length === 0 ? allowedResult(evidenceRefs) : blockedResult(signals, missing, evidenceRefs);
+}
+
 function validateDecisionBoundary(workUnit, state, options) {
   try { assertWorkUnitUserDecision(workUnit, state, options); return allowedResult(); }
   catch (error) { return blockedResult([error.code || "user-decision-invalid"], [error.message]); }
@@ -145,6 +248,8 @@ function validateDecisionBoundary(workUnit, state, options) {
 export function validateTicketFormalization(state, { exists = existsSync, read = (ref) => readFileSync(ref, "utf8"), ...decisionOptions } = {}) {
   try { enforceFrontendDelivery(state, { root: decisionOptions.root, phase: "implementation" }); }
   catch (error) { return blockedResult(["frontend-delivery-blocked"], [error.message]); }
+  const repositoryResult = validateImplementationRepositoriesReady(state, { exists });
+  if (repositoryResult.result === "blocked") return repositoryResult;
   const decomposition = state?.ticket_decomposition_result;
   const ticket = state?.vertical_slice_ticket;
   const contract = state?.slice_contract;
@@ -276,6 +381,7 @@ export function validateImplementationEntry(state, options = {}) {
 export const lifecycleTransitionContract = Object.freeze({
   implementation_work_unit: IMPLEMENTATION_WORK_UNIT,
   ticket_decomposition_work_unit: TICKET_DECOMPOSITION_WORK_UNIT,
+  repository_preparation_work_unit: REPOSITORY_PREPARATION_WORK_UNIT,
   next_routes: NEXT_ROUTES,
   blocking_signals: BLOCKING_SIGNALS,
 });

package/template/scripts/lib/scenario-checks.mjs

@@ -76,7 +76,9 @@ function validateInvocationBoundary(data) {
   ensure(routes?.["work-unit.frontend-implementation-verification"]?.skills?.includes("code-review") && routes?.["work-unit.frontend-implementation-verification"]?.applies_when === "ui_impact", "前端还原验证未绑定 UI fidelity 审查轴");
   const reviewRoute = routes?.["work-unit.code-review"];
   ensure(reviewRoute?.primary_skill === "code-review" && reviewRoute?.review_standards_route?.unique_default_skill === "code-review" && reviewRoute?.review_standards_route?.second_generic_review_skill === "forbidden", "code-review 不是唯一默认审查入口或允许第二套通用审查 skill");
-  ensure(includesAll(reviewRoute?.supporting_skills, ["alibaba-java-code-style", "yss-ui", "yss-domain"]) && includesAll(reviewRoute?.skills, ["code-review", "alibaba-java-code-style", "yss-ui"]), "审查工作单元缺少 YSS / Alibaba 专项检查输入");
+  ensure(includesAll(reviewRoute?.supporting_skills, ["alibaba-java-code-style", "yss-ui", "yss-domain", "yss-repository", "yss-mybatis"]) && includesAll(reviewRoute?.skills, ["code-review", "alibaba-java-code-style", "yss-ui", "yss-repository", "yss-mybatis"]), "审查工作单元缺少 YSS / Alibaba / Repository / MyBatis 专项检查输入");
+  const reviewScope = reviewRoute?.review_standards_route?.project_scope;
+  ensure(includesAll(reviewScope?.sources, ["candidate-project-root", "implementation-repository-registry", "slice-project-roots", "allowed-write-paths"]) && includesAll(reviewScope?.include, ["project-itself", "registered-backend-development-projects"]) && includesAll(reviewScope?.exclude, ["frontend-projects", "unrelated-submodules", "vendor", "unregistered-directories"]) && reviewScope?.fixed_apps_backend_assumption === "forbidden", "后端审查范围未绑定本体项目与已登记后端研发项目，或仍固定为 apps/backend");
   const disposition = reviewRoute?.review_standards_route?.finding_disposition;
   ensure(includesAll(disposition?.same_loop_for, ["product-slice", "template-maintenance"]) && disposition?.reviewer_write_implementation === "forbidden", "审查 finding 闭环未同时覆盖产品切片与模板维护，或允许审查者写实现");
   ensure(includesAll(disposition?.repair_then_full_rereview?.kinds, ["violation", "machine_check_failure", "blank_applicable_row", "missing_evidence"]) && disposition?.repair_then_full_rereview?.actor === "implementer" && disposition?.repair_then_full_rereview?.then === "recapture_candidate_and_rerun_all_axes", "violation 类 finding 未要求实现者修复后全轴复审");
@@ -125,6 +127,8 @@ function validateWorkflowExecutionResult(payload, contract, workUnitRoutes) {
     const implementationState = {
       user_decisions: payload.user_decisions,
       slice_contract_ref: payload.slice_contract_ref,
+      delivery_impacts: payload.delivery_impacts,
+      implementation_repository_preparation: payload.implementation_repository_preparation,
       tracker_kind: payload.tracker_kind,
       predecessor_work_unit: payload.predecessor_work_unit,
       ready_for_agent: payload.ready_for_agent,
@@ -164,18 +168,15 @@ function validateInvocationMetadata(boundary, skillContents) {
   for (const skill of boundary.model_invoked_skills) ensure(!skillContents(skill).includes("disable-model-invocation: true"), `${skill} 不应出现在 model-invoked 白名单`);
 }
 
-function validateMattProse(skill, adapter) {
-  ensure(skill.includes("不得写生命周期资产或改变门禁/Ticket 状态") && skill.includes("任何写入前回交本编排器"), "主技能缺少 direct Matt 只导航并回交的说明");
-  ensure(adapter.includes("仅发现旧路径资产") && adapter.includes("不得调用 `setup-matt-pocock-skills`"), "适配器缺少 setup 旧资产迁移或显式用户入口条件");
-  ensure(adapter.includes("frontier 为空") && adapter.includes("双方共同理解已确认"), "适配器缺少 grill_exit 的 frontier 或共同理解条件");
-  ensure(skill.includes("自然语言意向不构成上述结构化 Git 授权") && adapter.includes("本身不是结构化授权"), "主技能或适配器缺少自然语言 Git 意向不是授权的说明");
-  ensure(adapter.includes("禁止 detached HEAD 提交") && adapter.includes("先推子仓再更新父仓 gitlink"), "适配器缺少 git-submodule 嵌套 Git 授权说明");
-}
-
-function validateInvocationProse(skill, adapter, orchestration) {
-  ensure(skill.includes("不得自动调用它们或代替其创建正式资产") && skill.includes("Workflow Execution Result"), "主技能未限制 user-invoked 调用或未采用新结果协议");
-  ensure(adapter.includes("workflow reference 不表示调用") && adapter.includes("正式 Spec、Ticket 或实现资产仍只能由对应显式用户入口创建"), "适配器未限制 workflow reference 的正式资产所有权");
-  ensure(orchestration.includes("只实际调用允许的 model-invoked skill") && orchestration.includes("用户显式启动"), "编排协议未区分 model-invoked 原语和显式用户入口");
+function validateLifecycleEntrySkill(skill) {
+  ensure(/^---\nname: yss-product-lifecycle\n/m.test(skill), "生命周期入口缺少有效 frontmatter");
+  ensure(Buffer.byteLength(skill) <= 8192, "生命周期入口超过 8KB 上下文预算");
+  for (const reference of ["docs/process/lifecycle-registry.yaml", "references/orchestration-contract.yaml", "docs/agents/yss-skill-registry.yaml", "scripts/query-lifecycle-context"]) {
+    ensure(skill.includes(reference), `生命周期入口缺少权威引用: ${reference}`);
+  }
+  for (const heading of ["### 仓库身份", "### 流转与实现", "### 用户决定", "### 外部副作用与 Git"]) {
+    ensure(skill.includes(heading), `生命周期入口缺少边界分组: ${heading}`);
+  }
 }
 
 const profiles = {
@@ -192,7 +193,7 @@ const profiles = {
   prototype: {
     message: "原型到后端脚手架及后续 YSS 代码生成压力场景验证通过",
     files: [".agents/skills/yss-ddd-scaffold-generator/scripts/generate_scaffold.mjs", ".agents/skills/yss-implementation-contract-compiler/references/compiler-contract.yaml"],
-    markers: [[".agents/skills/yss-product-lifecycle/SKILL.md", "controlled-generation"]]
+    markers: [[".agents/skills/yss-implementation-contract-compiler/references/compiler-contract.yaml", "controlled-generation"]]
   },
   implementationContractCompiler: {
     message: "YSS implementation contract compiler stage 7 scenarios passed",
@@ -248,7 +249,10 @@ export function runScenario(name) {
       { from: "work-unit.spec-synthesis", to: "work-unit.slice-implementation" },
       { from: "work-unit.prototype-design", to: "work-unit.slice-implementation" },
       { from: "work-unit.technical-analysis", to: "work-unit.slice-implementation" },
-    ]), "生命周期转换图缺少 Spec/原型/技术分析到实现的越级阻断");
+      { from: "work-unit.technical-analysis", to: "work-unit.ticket-decomposition" },
+    ]), "生命周期转换图缺少工程准备、Ticket 正式化与实现越级阻断");
+    ensure(contract.transition_graph?.routes?.["work-unit.implementation-repository-preparation"]?.includes("work-unit.ticket-decomposition"), "实现仓库准备未成为 Ticket 正式化前置");
+    ensure(contract.implementation_repository_preparation?.gate === "gate.implementation-repositories-ready", "实现仓库准备聚合门禁缺失");
     ensure(lifecycleTransitionContract.next_routes["work-unit.ticket-decomposition"]?.includes("work-unit.slice-implementation"), "转换校验器未允许 Ticket 正式化后进入实现");
     ensure(contract.release_readiness?.conditional?.ui_impact?.includes("gate.frontend-implementation-verified") && contract.frontend_implementation_plan?.acceptance?.includes("no_template_placeholders"), "发布公式或前端计划实质校验不完整");
     const templateRejected = spawnSync("scripts/verify-frontend-implementation-evidence", ["docs/process/templates/frontend-implementation-plan-template.yaml"], { cwd: root, encoding: "utf8" });
@@ -275,7 +279,7 @@ export function runScenario(name) {
       changed_artifacts: [],
       new_impacts: [],
       stale_candidates: [],
-      next_route: "work-unit.ticket-decomposition",
+      next_route: "work-unit.implementation-repository-preparation",
       blocking_signals: []
     };
     validateWorkflowExecutionResult(validResult, data.workflow_execution_result, data.work_unit_routes);
@@ -304,6 +308,14 @@ export function runScenario(name) {
       slice_contract_status: "approved",
       slice_contract_persisted: true,
       slice_contract_current_version: true,
+      delivery_impacts: { backend: true, frontend: false },
+      implementation_repository_preparation: {
+        result: "completed", current_version: true, evidence_refs: ["docs/process/lifecycle-registry.yaml"],
+        projects: [
+          { project_id: "backend", delivery_role: "backend", status: "existing-and-onboarded", repository_ref: "git://backend", project_root: "/workspace/backend", repository_scope: "external-repository", onboarding_result: { status: "completed", ref: "docs/process/lifecycle-registry.yaml" } },
+          { project_id: "frontend-na", delivery_role: "frontend", status: "not-applicable", reason: "no frontend impact" },
+        ],
+      },
     };
     validateWorkflowExecutionResult(validImplementationResult, data.workflow_execution_result, data.work_unit_routes);
     for (const mutate of [
@@ -377,16 +389,7 @@ export function runScenario(name) {
       ensure(rejected, "Matt/YSS 契约变异未被 baseline oracle 拒绝");
     }
     const skill = read(".agents/skills/yss-product-lifecycle/SKILL.md");
-    const adapter = read(".agents/skills/yss-product-lifecycle/references/matt-yss-adapter.md");
-    const orchestration = read(".agents/skills/yss-product-lifecycle/references/orchestration.md");
-    validateMattProse(skill, adapter);
-    validateInvocationProse(skill, adapter, orchestration);
-    let proseRejected = false;
-    try { validateMattProse(skill.replace("任何写入前回交本编排器", "允许直接写入"), adapter); } catch { proseRejected = true; }
-    ensure(proseRejected, "Matt/YSS prose 变异未被 baseline oracle 拒绝");
-    let invocationProseRejected = false;
-    try { validateInvocationProse(skill.replace("不得自动调用它们或代替其创建正式资产", "可以自动调用并创建正式资产"), adapter, orchestration); } catch { invocationProseRejected = true; }
-    ensure(invocationProseRejected, "调用边界 prose 变异未被 baseline oracle 拒绝");
+    validateLifecycleEntrySkill(skill);
     for (const relative of ["SKILL.md", "references/matt-yss-adapter.md", "references/orchestration-contract.yaml"]) {
       ensure(read(`.agents/skills/yss-product-lifecycle/${relative}`) === read(`.codex/skills/yss-product-lifecycle/${relative}`), `YSS 生命周期投影未同步: ${relative}`);
     }

package/template/scripts/lib/skill-registry.mjs

@@ -166,6 +166,10 @@ function validateReviewInputFinding(reviewInput) {
   if (reviewInput.completed_requires_no_open_mandatory_violations !== true) fail("未关闭的 mandatory violation 不得 completed");
   if (reviewInput.completed_requires_no_blank_applicable_rows !== true) fail("适用报告行空白不得 completed");
   if (reviewInput.reviewer_write_implementation !== "forbidden") fail("review_input 禁止审查者写实现");
+  requireObject(reviewInput.scope_resolution, "review_input.scope_resolution");
+  requireStringSet(reviewInput.scope_resolution.sources, ["candidate-project-root", "implementation-repository-registry", "slice-project-roots", "allowed-write-paths"], "review_input.scope_resolution.sources");
+  requireStringSet(reviewInput.scope_resolution.backend_includes, ["project-itself", "registered-backend-development-projects"], "review_input.scope_resolution.backend_includes");
+  requireStringSet(reviewInput.scope_resolution.excludes, ["frontend-projects", "unrelated-submodules", "vendor", "unregistered-directories"], "review_input.scope_resolution.excludes");
 }
 
 function validateCodeReviewRoute(route, resolve) {
@@ -180,6 +184,11 @@ function validateCodeReviewRoute(route, resolve) {
   if (standards.contract_required_skills !== "required") fail("Standards 必须消费 Slice 合同 required_skills");
   requireString(standards.report_template, "review_standards_route.report_template");
   if (!existsSync(path.join(ROOT, standards.report_template))) fail(`审查报告模板不存在: ${standards.report_template}`);
+  requireObject(standards.project_scope, "review_standards_route.project_scope");
+  requireStringSet(standards.project_scope.sources, ["candidate-project-root", "implementation-repository-registry", "slice-project-roots", "allowed-write-paths"], "review_standards_route.project_scope.sources");
+  requireStringSet(standards.project_scope.include, ["project-itself", "registered-backend-development-projects"], "review_standards_route.project_scope.include");
+  requireStringSet(standards.project_scope.exclude, ["frontend-projects", "unrelated-submodules", "vendor", "unregistered-directories"], "review_standards_route.project_scope.exclude");
+  if (standards.project_scope.fixed_apps_backend_assumption !== "forbidden") fail("code-review 不得把后端审查范围固定为 apps/backend");
   const conditional = standards.conditional_skills;
   if (!conditional || typeof conditional !== "object" || Array.isArray(conditional)) {
     fail("review_standards_route.conditional_skills 必须是对象");

package/template/scripts/query-lifecycle-context

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+import { parseArgs } from "node:util";
+import { queryLifecycleContext } from "./lib/lifecycle-context-query.mjs";
+
+try {
+  const { values } = parseArgs({
+    options: {
+      mode: { type: "string" },
+      stage: { type: "string" },
+      "work-unit": { type: "string" },
+      include: { type: "string", multiple: true },
+    },
+    strict: true,
+  });
+  const result = queryLifecycleContext({
+    mode: values.mode,
+    stageId: values.stage,
+    workUnitId: values["work-unit"],
+    include: values.include ?? [],
+  });
+  process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+} catch (error) {
+  process.stderr.write(`${error.message}\n`);
+  process.exitCode = 1;
+}

package/template/scripts/verify-business-language-scenarios

@@ -25,13 +25,6 @@ for (const relativePath of PUBLIC_FILES) {
   }
 }
 
-const lifecycle = read(".agents/skills/yss-product-lifecycle/SKILL.md");
-for (const phrase of [
-  "机会与目标 → 业务故事 → 责任与交接 → 规则、例子与疑问 → 可验收需求 → 页面验证 → 业务任务 → 交接研发",
-  "业务方案总览",
-  "不成为新的事实源",
-]) assert.match(lifecycle, new RegExp(phrase));
-
 const registry = read("docs/process/lifecycle-registry.yaml");
 for (const stableId of ["work-unit.domain-strategy-design", "artifact.domain-strategy", "gate.domain-strategy-approved"]) {
   assert.match(registry, new RegExp(`id: ${stableId.replaceAll(".", "\\.")}`));

package/template/scripts/verify-frontend-scaffold-generator-scenarios

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "../.agents/skills/yss-frontend-scaffold-generator/scripts/scaffold-generator.test.mjs";

package/template/scripts/verify-lifecycle-context-query-scenarios

@@ -0,0 +1,68 @@
+#!/usr/bin/env node
+import assert from "node:assert/strict";
+import { readFileSync } from "node:fs";
+import { spawnSync } from "node:child_process";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { queryLifecycleContext } from "./lib/lifecycle-context-query.mjs";
+
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+
+const query = {
+  mode: "route",
+  stageId: "stage.discovery",
+  workUnitId: "work-unit.discovery-requirements",
+  include: ["grill_exit"],
+};
+const first = queryLifecycleContext(query);
+const second = queryLifecycleContext(query);
+
+assert.deepEqual(first, second, "同一查询必须产生确定性结果");
+assert.equal(first.query.mode, "route");
+assert.equal(first.lifecycle.stage.id, "stage.discovery");
+assert.ok(first.lifecycle.gates.every((gate) => gate.stage === "stage.discovery"));
+assert.ok(first.lifecycle.artifacts.every((artifact) => artifact.stage === "stage.discovery"));
+assert.equal(first.lifecycle.work_unit.id, "work-unit.discovery-requirements");
+assert.equal(first.execution.mode, "read_only");
+assert.equal(first.execution.work_unit_route.primary_skill, "yss-product-lifecycle");
+assert.ok(first.execution.selected.grill_exit.required.includes("frontier_empty"));
+assert.equal("review_input" in first.execution.selected, false, "不得返回未请求的合同子树");
+assert.ok(first.skills.some((skill) => skill.id === "grilling"));
+assert.match(first.sources.lifecycle_registry.semantic_sha256, /^[0-9a-f]{64}$/);
+assert.match(first.sources.orchestration_contract.sha256, /^[0-9a-f]{64}$/);
+
+for (const invalid of [
+  { mode: "invalid" },
+  { stageId: "stage.missing" },
+  { workUnitId: "work-unit.missing" },
+  { include: ["missing_contract_section"] },
+]) {
+  assert.throws(() => queryLifecycleContext(invalid), /未知|至少提供/);
+}
+
+const cli = spawnSync("node", [
+  "scripts/query-lifecycle-context",
+  "--mode", "route",
+  "--stage", "stage.discovery",
+  "--work-unit", "work-unit.discovery-requirements",
+  "--include", "grill_exit",
+], { cwd: ROOT, encoding: "utf8" });
+assert.equal(cli.status, 0, cli.stderr);
+assert.deepEqual(JSON.parse(cli.stdout), first, "CLI 输出必须等于库函数的规范投影");
+
+const skillPath = path.join(ROOT, ".agents/skills/yss-product-lifecycle/SKILL.md");
+const skill = readFileSync(skillPath, "utf8");
+assert.ok(Buffer.byteLength(skill) <= 8192, "生命周期入口 Skill 必须保持在 8KB 软预算内");
+assert.equal(skill.includes("| 主阶段 |"), false, "入口 Skill 不得复制完整阶段表");
+for (const marker of [
+  "docs/process/lifecycle-registry.yaml",
+  "references/orchestration-contract.yaml",
+  "docs/agents/yss-skill-registry.yaml",
+  "scripts/query-lifecycle-context",
+  "### 仓库身份",
+  "### 流转与实现",
+  "### 用户决定",
+  "### 外部副作用与 Git",
+]) assert.match(skill, new RegExp(marker.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")));
+
+process.stdout.write("生命周期按需上下文查询场景验证通过\n");

package/template/scripts/verify-lifecycle-transition-scenarios

@@ -3,16 +3,24 @@ import assert from "node:assert/strict";
 import { mkdtempSync, rmSync, readFileSync, existsSync } from "node:fs";
 import os from "node:os";
 import path from "node:path";
-import { buildImplementationFixture } from "./fixtures/user-decision/build-fixture.mjs";
+import { buildDecisionFixture, buildImplementationFixture } from "./fixtures/user-decision/build-fixture.mjs";
 const temp = mkdtempSync(path.join(os.tmpdir(), "lifecycle-decision-test-"));
 process.on("exit", () => rmSync(temp, { recursive: true, force: true }));
 const approval = buildImplementationFixture(temp, "docs/.scratch/demo/issues/01-valid-slice.md");
-import { validateImplementationEntry, validateNextRoute, validateTicketFormalization } from "./lib/lifecycle-transition.mjs";
+const scaffoldApproval = buildDecisionFixture(path.join(temp, "scaffold-choice"), { boundary: "scaffold-choice", scope: ["backend", "frontend"] });
+import { validateImplementationEntry, validateImplementationRepositoriesReady, validateNextRoute, validateTicketFormalization } from "./lib/lifecycle-transition.mjs";
 
 const exists = (ref) => [
   "docs/process/lifecycle-registry.yaml",
   "docs/.scratch/demo/issues/01-valid-slice.md",
   "docs/.scratch/demo/evidence/ticket-decomposition-result.yaml",
+  "docs/.scratch/demo/evidence/repository-preparation.yaml",
+  "docs/.scratch/demo/evidence/backend-onboarding.yaml",
+  "docs/.scratch/demo/evidence/frontend-onboarding.yaml",
+  "docs/.scratch/demo/evidence/backend-manifest.json",
+  "docs/.scratch/demo/evidence/backend-verification.json",
+  "docs/.scratch/demo/evidence/frontend-manifest.json",
+  "docs/.scratch/demo/evidence/frontend-verification.json",
 ].includes(ref) || existsSync(ref);
 const decompositionResult = `result_schema: workflow-execution-result-v1\nwork_unit: work-unit.ticket-decomposition\nresult: completed\nevidence_refs:\n  - docs/.scratch/demo/evidence/ticket-decomposition-result.yaml\n`;
 const read = (ref) => ref === "docs/.scratch/demo/evidence/ticket-decomposition-result.yaml" ? decompositionResult : readFileSync(ref, "utf8");
@@ -20,6 +28,17 @@ const options = { exists, read };
 
 const validTicketState = {
   ...approval.state,
+  user_decisions: [...approval.state.user_decisions, scaffoldApproval.requirement],
+  delivery_impacts: { backend: true, frontend: true },
+  implementation_repository_preparation: {
+    result: "completed",
+    current_version: true,
+    evidence_refs: ["docs/.scratch/demo/evidence/repository-preparation.yaml"],
+    projects: [
+      { project_id: "backend", delivery_role: "backend", status: "existing-and-onboarded", repository_ref: "git://backend", project_root: "/workspace/backend", repository_scope: "external-repository", onboarding_result: { status: "completed", ref: "docs/.scratch/demo/evidence/backend-onboarding.yaml" } },
+      { project_id: "frontend", delivery_role: "frontend", status: "existing-and-onboarded", repository_ref: "git://frontend", project_root: "/workspace/frontend", repository_scope: "external-repository", onboarding_result: { status: "completed", ref: "docs/.scratch/demo/evidence/frontend-onboarding.yaml" } },
+    ],
+  },
   predecessor_work_unit: "work-unit.ticket-decomposition",
   tracker_kind: "local-markdown",
   ticket_decomposition_result_ref: "docs/.scratch/demo/evidence/ticket-decomposition-result.yaml",
@@ -45,6 +64,19 @@ const validTicketState = {
 
 const valid = validateTicketFormalization(validTicketState, options);
 assert.equal(valid.result, "allowed");
+assert.equal(validateImplementationRepositoriesReady(validTicketState, options).result, "allowed");
+const initializedState = {
+  delivery_impacts: { backend: true, frontend: true },
+  implementation_repository_preparation: {
+    result: "completed", current_version: true, evidence_refs: ["docs/.scratch/demo/evidence/repository-preparation.yaml"],
+    projects: [
+      { project_id: "backend-ddd", delivery_role: "backend", status: "initialized-and-verified", repository_ref: "git://backend", project_root: "/workspace/backend", repository_scope: "external-repository", architecture_family: "domain-driven", scaffold_contract: { schema_version: 4, status: "approved", persisted: true, current_version: true }, scaffold_manifest_ref: "docs/.scratch/demo/evidence/backend-manifest.json", scaffold_verification: { status: "passed", ref: "docs/.scratch/demo/evidence/backend-verification.json" } },
+      { project_id: "frontend", delivery_role: "frontend", status: "initialized-and-verified", repository_ref: "git://frontend", project_root: "/workspace/frontend", repository_scope: "external-repository", template_available: true, scaffold_contract: { schema_version: 4, status: "approved", persisted: true, current_version: true }, scaffold_manifest_ref: "docs/.scratch/demo/evidence/frontend-manifest.json", scaffold_verification: { status: "passed", ref: "docs/.scratch/demo/evidence/frontend-verification.json" } },
+    ],
+  },
+};
+assert.equal(validateImplementationRepositoriesReady(initializedState, options).result, "allowed");
+assert.equal(validateImplementationRepositoriesReady({ delivery_impacts: { backend: false, frontend: false }, implementation_repository_preparation: { result: "completed", current_version: true, evidence_refs: ["docs/.scratch/demo/evidence/repository-preparation.yaml"], projects: [{ project_id: "backend-na", delivery_role: "backend", status: "not-applicable", reason: "no backend impact" }, { project_id: "frontend-na", delivery_role: "frontend", status: "not-applicable", reason: "no frontend impact" }] } }, options).result, "allowed");
 
 const implementation = validateImplementationEntry({
   ...validTicketState,
@@ -53,6 +85,11 @@ const implementation = validateImplementationEntry({
 assert.equal(implementation.result, "allowed");
 
 const cases = [
+  ["missing repository preparation", { ...validTicketState, implementation_repository_preparation: undefined }, "implementation-repository-decision-required"],
+  ["stale repository preparation", { ...validTicketState, implementation_repositories_stale: true }, "implementation-repositories-stale"],
+  ["missing frontend decision", { ...validTicketState, implementation_repository_preparation: { ...validTicketState.implementation_repository_preparation, projects: validTicketState.implementation_repository_preparation.projects.filter((item) => item.delivery_role !== "frontend") } }, "implementation-repository-decision-required"],
+  ["missing repository location", { ...validTicketState, implementation_repository_preparation: { ...validTicketState.implementation_repository_preparation, projects: validTicketState.implementation_repository_preparation.projects.map((item) => item.delivery_role === "backend" ? { ...item, project_root: undefined } : item) } }, "implementation-repository-location-required"],
+  ["incomplete onboarding", { ...validTicketState, implementation_repository_preparation: { ...validTicketState.implementation_repository_preparation, projects: validTicketState.implementation_repository_preparation.projects.map((item) => item.delivery_role === "backend" ? { ...item, onboarding_result: { status: "blocked" } } : item) } }, "implementation-repository-onboarding-incomplete"],
   ["missing decomposition result ref", { ...validTicketState, ticket_decomposition_result_ref: undefined }, "ticket-decomposition-result-ref-missing"],
   ["missing slice ref", { ...validTicketState, vertical_slice_ticket_ref: undefined }, "vertical-slice-ticket-ref-missing"],
   ["missing slice role", { ...validTicketState, vertical_slice_ticket_role: undefined }, "vertical-slice-ticket-role-missing"],
@@ -90,7 +127,10 @@ for (const current of ["work-unit.spec-synthesis", "work-unit.prototype-design",
   assert.equal(result.result, "blocked", current);
   assert.ok(result.blocking_signals.includes("ticket-formalization-required"), current);
 }
-assert.equal(validateNextRoute("work-unit.spec-synthesis", "work-unit.ticket-decomposition").result, "allowed");
+assert.equal(validateNextRoute("work-unit.spec-synthesis", "work-unit.ticket-decomposition").result, "blocked");
+assert.equal(validateNextRoute("work-unit.technical-analysis", "work-unit.implementation-repository-preparation").result, "allowed");
+assert.equal(validateNextRoute("work-unit.implementation-repository-preparation", "work-unit.ticket-decomposition", validTicketState, options).result, "allowed");
+assert.ok(validateNextRoute("work-unit.implementation-repository-preparation", "work-unit.ticket-decomposition", {}, options).blocking_signals.includes("implementation-repository-decision-required"));
 assert.equal(validateNextRoute("work-unit.intensity-aware-verification", "work-unit.intensity-aware-review").result, "allowed");
 assert.equal(validateNextRoute("work-unit.release-and-rollback", null).result, "allowed");
 const arbitraryReadable = validateTicketFormalization({
@@ -110,6 +150,6 @@ assert.equal(validateTicketFormalization({
   vertical_slice_ticket_ref: "https://github.com/example/project/issues/1",
   vertical_slice_ticket: { ref: "https://github.com/example/project/issues/1", kind: "vertical-slice-ticket", role: "ready-for-agent" },
   slice_contract: { ...validTicketState.slice_contract, ticket_ref: "https://github.com/example/project/issues/1" },
-}, { ...options, exists: (ref) => ref === "https://github.com/example/project/issues/1", read: (ref) => ref === "https://github.com/example/project/issues/1" ? decompositionResult.replace("docs/.scratch/demo/evidence/ticket-decomposition-result.yaml", "https://github.com/example/project/issues/1") : readFileSync(ref, "utf8") }).result, "allowed");
+}, { ...options, exists: (ref) => ref === "https://github.com/example/project/issues/1" || exists(ref), read: (ref) => ref === "https://github.com/example/project/issues/1" ? decompositionResult.replace("docs/.scratch/demo/evidence/ticket-decomposition-result.yaml", "https://github.com/example/project/issues/1") : readFileSync(ref, "utf8") }).result, "allowed");
 
 process.stdout.write("生命周期转换压力场景验证通过\n");

package/template/skills-lock.json

@@ -63,7 +63,7 @@
         "source": "mattpocock/skills",
         "sourceType": "github",
         "skillPath": "skills/engineering/code-review/SKILL.md",
-        "effectiveHash": "a9839b761443bcb9bf46b886630378e53dfb748ed77fc46b96e5777e701a438e",
+        "effectiveHash": "660ca39ab37b65099940b2e6a197089291e2fb74494ec93bbeb8e2fde6559465",
         "sourceRevision": "0ab1b63a410a03d3627979a109c8695de27af954",
         "upstreamHash": "12daafb9c4f77deb3c3303dc2e6f8a3c2a0ff7928fc004af959ba18b8bd38068",
         "adaptationRef": "docs/process/MATT-POCOCK-ENGINEERING-SKILLS.md",
@@ -937,7 +937,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-ddd-scaffold-generator/SKILL.md",
-        "effectiveHash": "438b92a03e9e0c80ac68db65096fd499275ad16cb69d4d751571754a97aa38a8",
+        "effectiveHash": "96e1c82c538a96af293273906db5ddefcf9943e8b76bb47b05d08772f16258cb",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1078,7 +1078,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-frontend-scaffold-generator/SKILL.md",
-        "effectiveHash": "87bc0d2f0c279d3fff14ded7a07ba7b9f72a61080e7b9ca826bb452894877e4e",
+        "effectiveHash": "968c213c90a30d719e51050a6122ef729bc03ae97d2841a5d47824d68a5d27ff",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1108,7 +1108,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-implementation-contract-compiler/SKILL.md",
-        "effectiveHash": "4f9ec75e4484bc2794ea057037890d2bcb96512c8c64bef9d9fdae7c66abe46d",
+        "effectiveHash": "96582c950a13f26a7c16b2087d0614cb28a99f0f805190fc64cfc80e6456c335",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1123,7 +1123,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-layered-mvc-scaffold-generator/SKILL.md",
-        "effectiveHash": "360389486d6bd07949c0b11ab30e266fbf073169d8ee447d89581fe583228950",
+        "effectiveHash": "50d0f704326fc523c29f4b728c08148cde372c674b9e8686829bee3e74b66fdc",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1183,7 +1183,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-mybatis/SKILL.md",
-        "effectiveHash": "1f70b00dcc6be6fde9c32ebf4ee41a86f2b348ca4bb789a3f2f32a7a24258ff4",
+        "effectiveHash": "8ab792d519c045a8a682942185f9aae3dcabfe86dbd8a4a9a444d7f657798701",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1228,7 +1228,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-product-lifecycle/SKILL.md",
-        "effectiveHash": "c262bd69e978eee24b49526043b2439c30ce006f4fbbcb56e881c903ba6f3d51",
+        "effectiveHash": "d317bd2799da0442745c8126e62f7919a0b3de03f2c3cc2e1a7ca0433dc69645",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1261,7 +1261,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-repository/SKILL.md",
-        "effectiveHash": "19f4380ba81f6cf373b737a4b17316f35bf2be27646be38707d52cfd6c1c7aef",
+        "effectiveHash": "0abe4e8f4896613985074615281f11711b807fcfc5727a6e6d2e7d2ebcf7ddc7",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1324,7 +1324,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-skill-source-index-refresh/SKILL.md",
-        "effectiveHash": "4c95ec664da1d3515ac49b80c063df20bf69d352c6892f66ceb29d0a12b55458",
+        "effectiveHash": "96ff974a0f7b3db8de09680daf9ecada94dd19f608341dcc85a32d40c02591b0",
         "targets": [
           ".agents/skills",
           ".claude/skills",

package/template.snapshot.json

@@ -3,8 +3,8 @@
   "templateName": "yss-spec-project-template",
   "templateSource": "github:iloveZzz/yss-spec-project-template",
   "templateRepository": "https://github.com/iloveZzz/yss-spec-project-template.git",
-  "requestedRef": "c3d09280872dcfc905c86ac6f40e4e32e610e220",
-  "templateCommit": "c3d09280872dcfc905c86ac6f40e4e32e610e220",
+  "requestedRef": "6f5c5d80adcdb743fb06199f70a7ab0b0a640ce5",
+  "templateCommit": "6f5c5d80adcdb743fb06199f70a7ab0b0a640ce5",
   "manifestHash": "f7520dfdfa388b19ea47cb893c2daab8936019783aa84589f13921e459702280",
   "encodedPaths": {
     ".codex/skills/data-analytics/.gitignore": ".codex/skills/data-analytics/__yss_dotfile__.gitignore",
@@ -12,6 +12,6 @@
     ".codex/skills/product-design/templates/prototype/.npmrc": ".codex/skills/product-design/templates/prototype/__yss_dotfile__.npmrc",
     ".gitignore": "__yss_dotfile__.gitignore"
   },
-  "snapshotHash": "80175edec720607595f99f1bab5d0a8480b1644537be8ae71623de01acb0a787",
-  "generatedAt": "2026-09-08T11:40:21.647Z"
+  "snapshotHash": "2a676bf4ed0d3151bab51ad900181cbb8fdd628385572e11dd398bcbaceab61b",
+  "generatedAt": "2026-09-09T02:16:12.516Z"
 }