create-yss-spec 2.1.5 → 2.1.6

package/template/scripts/verify-prototype-backend-scaffold-scenarios

@@ -1,261 +1,3 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-require "pathname"
-require "yaml"
-
-ROOT = Pathname.new(__dir__).join("..").realpath
-
-failures = []
-
-def require_marker(failures, path, marker)
-  body = ROOT.join(path).read
-  failures << "#{path} 缺少约束标记: #{marker}" unless body.include?(marker)
-end
-
-def route_after_prototype(facts)
-  return {"status" => "not-applicable", "steps" => []} unless facts.fetch(:backend_impact)
-
-  if facts.fetch(:ui_impact)
-    {
-      prototype_review: "prototype-review-required",
-      prototype_verification: "prototype-verification-required",
-      antd_cli_verification: "antd-cli-verification-required",
-      browser_verification: "browser-verification-required",
-      prototype_confirmation: "prototype-confirmation-required"
-    }.each do |fact, reason|
-      return {"status" => "blocked", "reason" => reason, "steps" => []} unless facts.fetch(fact, false)
-    end
-  end
-
-  steps = ["engineering-baseline"]
-  case facts.fetch(:scaffold_status)
-  when "required"
-    return {"status" => "blocked", "reason" => "scaffold-contract-required", "steps" => []} unless facts.fetch(:scaffold_contract_approved)
-    steps.concat(%w[yss-router-scaffold-contract lifecycle-approve-scaffold-contract yss-ddd-scaffold-generator yss-backend-scaffold-parent yss-router-contract-recompile])
-  when "existing", "initialized"
-    steps.concat(%w[yss-backend-scaffold-parent yss-router-contract-recompile])
-  else
-    return {"status" => "blocked", "reason" => "scaffold-status-required", "steps" => []}
-  end
-  {"status" => "ready-for-contract-review", "steps" => steps}
-end
-
-def generated_code_decision(facts)
-  return "blocked" unless facts.fetch(:contract_approved)
-  return "blocked" unless facts.fetch(:contract_persisted)
-  return "blocked" unless facts.fetch(:contract_current)
-  return "blocked" unless facts.fetch(:yss_skill_selected)
-  return "blocked" unless facts.fetch(:execution_result_bound)
-  return "blocked" if facts.fetch(:behavioral_impact) && facts.fetch(:tdd_mode) != "behavior-tdd"
-  return "blocked" if facts.fetch(:tdd_mode) == "controlled-generation" && facts.fetch(:business_behavior_in_generator)
-
-  "allowed"
-end
-
-def scaffold_generation_decision(facts)
-  return "blocked" if facts.fetch(:with_example)
-  return "blocked" if facts.fetch(:nonempty_target) && facts.fetch(:force) && !facts.fetch(:overwrite_approval)
-
-  "allowed"
-end
-
-contract_path = ROOT.join(".agents/skills/yss-product-lifecycle/references/orchestration-contract.yaml")
-contract = YAML.safe_load(contract_path.read, permitted_classes: [], aliases: false)
-router_contract = YAML.safe_load(
-  ROOT.join(".agents/skills/yss-router/references/router-contract.yaml").read,
-  permitted_classes: [], aliases: false
-)
-
-backend_scaffold = contract["backend_scaffold"]
-failures << "编排契约缺少 backend_scaffold" unless backend_scaffold.is_a?(Hash)
-if backend_scaffold.is_a?(Hash)
-  scaffold_schema = backend_scaffold.fetch("contract_schema", {})
-  failures << "脚手架合同必须声明结构化 schema" unless scaffold_schema.is_a?(Hash)
-  if scaffold_schema.is_a?(Hash)
-    failures << "生命周期脚手架合同 schema 版本不受支持" unless scaffold_schema["schema_version"] == 1
-    failures << "生命周期脚手架合同 schema 未分离 Router 与生命周期状态" unless scaffold_schema.dig("status_by_owner", "router").to_a.include?("ready-for-lifecycle-review") && scaffold_schema.dig("status_by_owner", "lifecycle").to_a.include?("approved")
-  end
-  %w[contract_id contract_version slice_id status router_draft_ref lifecycle_approval_ref persisted_ref current_version implementation_repository backend_repository scaffold_status target_git_url_or_output_dir allowed_write_paths expected_evidence_files verification_commands approval work_unit overwrite_policy].each do |required|
-    failures << "脚手架合同 schema 缺少 #{required}" unless scaffold_schema.fetch("required", []).include?(required)
-  end
-  %w[approval_ref approver persisted_ref current_version].each do |required|
-    failures << "脚手架合同审批记录缺少 #{required}" unless scaffold_schema.dig("approval", "required").to_a.include?(required)
-  end
-  %w[prototype_review prototype_verification antd_cli_verification browser_verification prototype_confirmation].each do |required|
-    failures << "backend_scaffold 必须声明 #{required} 后置顺序" unless backend_scaffold.dig("sequence", "after").include?(required)
-  end
-  failures << "backend_scaffold 必须先于业务代码生成" unless backend_scaffold.dig("sequence", "before").include?("business_code_generation")
-  failures << "required 脚手架必须使用 yss-ddd-scaffold-generator" unless backend_scaffold["generator_skill"] == "yss-ddd-scaffold-generator"
-  failures << "脚手架生成必须使用 controlled-generation" unless backend_scaffold["tdd_mode"] == "controlled-generation"
-  %w[scaffold_contract_file scaffold_contract_draft scaffold_contract_approved scaffold_contract_persisted scaffold_contract_current_version].each do |required|
-    failures << "脚手架生成前缺少合同条件 #{required}" unless backend_scaffold.fetch("required_inputs", []).include?(required)
-  end
-  %w[yss-backend-scaffold-parent yss-router].each do |skill|
-    failures << "脚手架后置流程缺少 #{skill}" unless backend_scaffold.fetch("after_generation", []).include?(skill)
-  end
-  %w[business_rules state_machine permission transaction complex_query error_mapping user_visible_behavior].each do |forbidden|
-    failures << "脚手架生成禁止项缺少 #{forbidden}" unless backend_scaffold.fetch("forbidden_generation", []).include?(forbidden)
-  end
-  failures << "脚手架必须关闭 --with-example" unless backend_scaffold.dig("generation_options", "with_example") == false
-  failures << "脚手架覆盖写入必须默认阻断" unless backend_scaffold.dig("generation_options", "force") == "forbidden-by-default"
-  %w[contract_file router_draft_ref persisted_ref overwrite_scope rollback_ref].each do |required|
-    failures << "脚手架覆盖写入条件缺少 #{required}" unless backend_scaffold.dig("generation_options", "force_requires").to_a.include?(required)
-  end
-  failures << "脚手架必须留存生成元数据清单" unless backend_scaffold.fetch("required_evidence", []).include?("scaffold_generation_manifest")
-  %w[business_example_crud unapproved_force_overwrite].each do |forbidden|
-    failures << "脚手架生成禁止项缺少 #{forbidden}" unless backend_scaffold.fetch("forbidden_generation", []).include?(forbidden)
-  end
-  failures << "脚手架验证必须执行真实命令" unless backend_scaffold.dig("verification", "requires_execution") == true
-  failures << "脚手架验证必须记录命令结果" unless backend_scaffold.dig("verification", "evidence").to_a.include?("exit_code")
-  failures << "脚手架验证必须统一记录 duration_ms" unless backend_scaffold.dig("verification", "evidence").to_a.include?("duration_ms")
-  failures << "脚手架打印命令不得冒充验证证据" unless backend_scaffold.dig("verification", "printed_commands_are_not_evidence") == true
-end
-
-generated_policy = contract["post_scaffold_generated_code_policy"]
-failures << "编排契约缺少 post_scaffold_generated_code_policy" unless generated_policy.is_a?(Hash)
-if generated_policy.is_a?(Hash)
-  failures << "generated_code_policy 必须明确只约束脚手架后的代码" unless generated_policy["scope"] == "post_scaffold_generated_code"
-  %w[approved_persisted_current_slice_contract primary_yss_skill dependency_closure allowed_write_paths expected_evidence_files yss_skill_execution_result].each do |required|
-    failures << "后续代码生成缺少强制条件 #{required}" unless generated_policy.fetch("required", []).include?(required)
-  end
-  failures << "后续业务代码生成必须使用 behavior-tdd" unless generated_policy.dig("business_behavior", "tdd_mode") == "behavior-tdd"
-  failures << "未满足生成约束时必须阻断" unless generated_policy["on_violation"] == "blocked"
-  failures << "脚手架工程结构不得落入脚手架后的生成策略" if generated_policy.dig("controlled_generation", "allowed_for").to_a.include?("project_scaffold")
-end
-
-scaffold_policy = contract["scaffold_work_unit_policy"]
-failures << "编排契约缺少 scaffold_work_unit_policy" unless scaffold_policy.is_a?(Hash)
-if scaffold_policy.is_a?(Hash)
-  %w[approved_scaffold_contract primary_yss_skill allowed_write_paths expected_evidence_files verification_commands].each do |required|
-    failures << "脚手架工作单元缺少强制条件 #{required}" unless scaffold_policy.fetch("required", []).include?(required)
-  end
-  failures << "脚手架工作单元违反约束时必须阻断" unless scaffold_policy["on_violation"] == "blocked"
-end
-
-ready_requirements = contract.dig("ready_for_agent", "required") || []
-failures << "ready-for-agent 缺少 backend_scaffold_policy_satisfied" unless ready_requirements.include?("backend_scaffold_policy_satisfied")
-
-router_generator = router_contract.dig("dependency_closure", "yss-ddd-scaffold-generator") || {}
-failures << "Router 未把 yss-backend-scaffold-parent 绑定到脚手架" unless router_generator.fetch("always", []).include?("yss-backend-scaffold-parent")
-failures << "Router 未把 alibaba-java-code-style 绑定到脚手架" unless router_generator.fetch("always", []).include?("alibaba-java-code-style")
-failures << "Router 未声明脚手架完成后的完整重路由" unless router_contract.fetch("full_reroute_triggers", []).include?("scaffold-baseline-drift")
-router_scaffold_schema = router_contract.fetch("scaffold_contract_schema", {})
-failures << "Router 未声明脚手架合同 schema" unless router_scaffold_schema.is_a?(Hash)
-if router_scaffold_schema.is_a?(Hash)
-  failures << "Router 脚手架合同 schema 版本不受支持" unless router_scaffold_schema["schema_version"] == 1
-  failures << "Router 脚手架合同 schema 必须由 yss-router 编译" unless router_scaffold_schema["compiled_by"] == "yss-router"
-  failures << "Router 脚手架合同 schema 必须由生命周期批准" unless router_scaffold_schema["approved_by"] == "yss-product-lifecycle"
-  failures << "Router 脚手架合同必须按 owner 分离状态" unless router_scaffold_schema.dig("status_by_owner", "router").to_a.include?("ready-for-lifecycle-review") && router_scaffold_schema.dig("status_by_owner", "lifecycle").to_a.include?("approved")
-  failures << "Router 不得自行声明 approved 状态" if router_scaffold_schema.dig("status_by_owner", "router").to_a.include?("approved")
-  %w[contract_id contract_version slice_id status router_draft_ref lifecycle_approval_ref persisted_ref current_version allowed_write_paths expected_evidence_files verification_commands approval work_unit overwrite_policy].each do |required|
-    failures << "Router 脚手架合同 schema 缺少 #{required}" unless router_scaffold_schema.fetch("required", []).include?(required)
-  end
-  failures << "Router 脚手架合同 schema 未要求真实验证执行" unless router_scaffold_schema.dig("verification", "requires_execution") == true
-  failures << "Router 脚手架合同 schema 未统一 duration_ms" unless router_scaffold_schema.dig("verification", "evidence").to_a.include?("duration_ms")
-end
-
-complete_facts = {
-  backend_impact: true, ui_impact: true, prototype_review: true, prototype_verification: true,
-  antd_cli_verification: true, browser_verification: true, prototype_confirmation: true,
-  scaffold_status: "required", scaffold_contract_approved: true
-}
-complete_route = route_after_prototype(complete_facts)
-expected_steps = %w[engineering-baseline yss-router-scaffold-contract lifecycle-approve-scaffold-contract yss-ddd-scaffold-generator yss-backend-scaffold-parent yss-router-contract-recompile]
-failures << "原型完成后的后端路由顺序不完整" unless complete_route == {"status" => "ready-for-contract-review", "steps" => expected_steps}
-
-blocked_route = route_after_prototype(complete_facts.merge(prototype_confirmation: false))
-failures << "原型未确认时错误允许后端脚手架" unless blocked_route["status"] == "blocked" && blocked_route["reason"] == "prototype-confirmation-required"
-
-{
-  prototype_review: "prototype-review-required",
-  prototype_verification: "prototype-verification-required",
-  antd_cli_verification: "antd-cli-verification-required",
-  browser_verification: "browser-verification-required"
-}.each do |missing_fact, reason|
-  blocked = route_after_prototype(complete_facts.merge(missing_fact => false))
-  failures << "#{missing_fact} 缺失时错误允许后端脚手架" unless blocked["status"] == "blocked" && blocked["reason"] == reason
-end
-
-missing_scaffold_contract = route_after_prototype(complete_facts.merge(scaffold_contract_approved: false))
-failures << "脚手架受控生成缺少批准合同仍被允许" unless missing_scaffold_contract["status"] == "blocked" && missing_scaffold_contract["reason"] == "scaffold-contract-required"
-
-existing_route = route_after_prototype(complete_facts.merge(scaffold_status: "existing"))
-failures << "existing 工程不应重复全量脚手架" if existing_route.fetch("steps").include?("yss-ddd-scaffold-generator")
-failures << "existing 工程仍需基线校验和 Router" unless existing_route.fetch("steps") == %w[engineering-baseline yss-backend-scaffold-parent yss-router-contract-recompile]
-
-initialized_route = route_after_prototype(complete_facts.merge(scaffold_status: "initialized"))
-failures << "initialized 工程不应重复全量脚手架" if initialized_route.fetch("steps").include?("yss-ddd-scaffold-generator")
-failures << "initialized 工程仍需基线校验和 Router" unless initialized_route.fetch("steps") == %w[engineering-baseline yss-backend-scaffold-parent yss-router-contract-recompile]
-
-pressure_cases = {
-  "原型完成但无批准合同" => [
-    {contract_approved: false, contract_persisted: false, contract_current: false, yss_skill_selected: true, execution_result_bound: false, behavioral_impact: true, tdd_mode: "behavior-tdd", business_behavior_in_generator: false},
-    "blocked"
-  ],
-  "脚手架把事务和权限一起生成" => [
-    {contract_approved: true, contract_persisted: true, contract_current: true, yss_skill_selected: true, execution_result_bound: true, behavioral_impact: true, tdd_mode: "controlled-generation", business_behavior_in_generator: true},
-    "blocked"
-  ],
-  "批准合同下的业务行为切片" => [
-    {contract_approved: true, contract_persisted: true, contract_current: true, yss_skill_selected: true, execution_result_bound: true, behavioral_impact: true, tdd_mode: "behavior-tdd", business_behavior_in_generator: false},
-    "allowed"
-  ]
-}
-pressure_cases.each do |name, (facts, expected)|
-  actual = generated_code_decision(facts)
-  failures << "压力场景 #{name} 期望 #{expected}，实际 #{actual}" unless actual == expected
-end
-
-scaffold_pressure_cases = {
-  "--with-example 伪装成样板" => [{with_example: true, nonempty_target: false, force: false, overwrite_approval: false}, "blocked"],
-  "非空目录无覆盖批准" => [{with_example: false, nonempty_target: true, force: true, overwrite_approval: false}, "blocked"],
-  "空目录纯骨架" => [{with_example: false, nonempty_target: false, force: false, overwrite_approval: false}, "allowed"]
-}
-scaffold_pressure_cases.each do |name, (facts, expected)|
-  actual = scaffold_generation_decision(facts)
-  failures << "脚手架压力场景 #{name} 期望 #{expected}，实际 #{actual}" unless actual == expected
-end
-
-required_markers = {
-  ".agents/skills/yss-product-lifecycle/SKILL.md" => [
-    "原型确认 → 后端脚手架",
-    "yss-ddd-scaffold-generator",
-    "所有后续生成的后端代码",
-    "controlled-generation",
-    "behavior-tdd",
-    "--with-example",
-    "--force"
-  ],
-  ".agents/skills/yss-product-lifecycle/references/orchestration.md" => [
-    "prototype_confirmation",
-    "脚手架生成",
-    "不得把业务规则",
-    "YSS Skill Execution Result"
-  ],
-  "AGENTS.md" => [
-    "原型确认后",
-    "所有后续生成的后端代码",
-    "yss-ddd-scaffold-generator"
-  ],
-  "docs/architecture/templates/engineering-baseline-review-template.md" => [
-    "prototype_confirmation",
-    "脚手架生成结果",
-    "禁止生成业务行为"
-  ],
-  "docs/templates/implementation-routing-template.md" => [
-    "原型确认后先完成后端脚手架",
-    "所有后续生成代码",
-    "backend_scaffold_policy_satisfied"
-  ]
-}
-required_markers.each do |path, markers|
-  markers.each { |marker| require_marker(failures, path, marker) }
-end
-
-if failures.empty?
-  puts "原型到后端脚手架及后续 YSS 代码生成压力场景验证通过"
-else
-  warn failures.join("\n")
-  exit 1
-end
+#!/usr/bin/env node
+import { runScenario } from "./lib/scenario-checks.mjs";
+try { runScenario("prototype"); } catch (error) { process.stderr.write(`${error.message}\n`); process.exitCode = 1; }

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

@@ -19,7 +19,7 @@ GENERATOR = (
     / "skills"
     / "yss-ddd-scaffold-generator"
     / "scripts"
-    / "generate_scaffold.py"
+    / "generate_scaffold.mjs"
 )
 VERIFIER = (
     REPOSITORY_ROOT
@@ -27,13 +27,13 @@ VERIFIER = (
     / "skills"
     / "yss-ddd-scaffold-generator"
     / "scripts"
-    / "run_scaffold_verification.py"
+    / "run_scaffold_verification.mjs"
 )
 
 
 def run_generator(*arguments: str) -> subprocess.CompletedProcess[str]:
     return subprocess.run(
-        [sys.executable, str(GENERATOR), *arguments],
+        ["node", str(GENERATOR), *arguments],
         cwd=REPOSITORY_ROOT,
         text=True,
         capture_output=True,
@@ -296,7 +296,7 @@ def main() -> int:
         evidence_dir = verification_project / "evidence"
         verification_result = subprocess.run(
             [
-                sys.executable,
+                "node",
                 str(VERIFIER),
                 "--project-root",
                 str(verification_project),

package/template/scripts/verify-template

@@ -3,139 +3,19 @@ set -euo pipefail
 
 ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
 cd "$ROOT_DIR"
+node -e 'const [major]=process.versions.node.split(".").map(Number); if (major < 22 || major >= 27) { console.error("模板工具需要 Node >=22 <27"); process.exit(1); }'
 
-# Ruby inherits US-ASCII under a C locale on some macOS installations. Keep
-# all verification scripts UTF-8 capable because the template contains Chinese
-# documentation and skill metadata.
-export RUBYOPT="${RUBYOPT:+$RUBYOPT }-EUTF-8:UTF-8"
+required_files=(yss-project.yaml AGENTS.md CONTEXT.md skills-lock.json docs/process/lifecycle-registry.yaml docs/process/lifecycle-registry-baseline.json scripts/repository-mode scripts/implementation-path-policy scripts/sync-skills scripts/update-skill-lock scripts/generate-lifecycle-artifacts scripts/verify-lifecycle-registry scripts/export-yss-skills)
+for required in "${required_files[@]}"; do test -f "$required" || { echo "缺少模板必需文件: $required" >&2; exit 1; }; done
 
-ruby <<'RUBY'
-# encoding: UTF-8
-require "pathname"
-require "yaml"
-
-root = Pathname.pwd
-manifest = YAML.safe_load(root.join("yss-project.yaml").read, permitted_classes: [], aliases: false)
-if manifest.is_a?(Hash) && manifest["repository_mode"] == "template-source"
-  canonical_scratch = root.join("docs/.scratch")
-  legacy_scratch = root.join(".scratch")
-  abort("template-source 不得包含产品 docs/.scratch 资产") if canonical_scratch.directory? && canonical_scratch.children.any?
-  abort("template-source 不得包含产品根 .scratch 资产") if legacy_scratch.directory? && legacy_scratch.children.any?
-end
-RUBY
-
-required_files=(
-  "yss-project.yaml"
-  "AGENTS.md"
-  "CONTEXT.md"
-  "skills-lock.json"
-  "docs/process/lifecycle-registry.yaml"
-  "docs/process/lifecycle-registry-baseline.json"
-  "docs/process/schemas/lifecycle-registry.schema.json"
-  "docs/process/lifecycle-artifact-map.md"
-  "docs/process/harness-process-tailoring.md"
-  "docs/templates/local-parent-ticket-template.md"
-  "docs/templates/spec-template.md"
-  "docs/templates/vertical-slice-ticket-template.md"
-  "docs/user-guide/规格与任务迁移指南.md"
-  "scripts/sync-skills"
-  "scripts/update-skill-lock"
-  "scripts/implementation-path-policy.rb"
-  "scripts/verify-lifecycle-scenarios"
-  "scripts/generate-lifecycle-artifacts"
-  "scripts/verify-lifecycle-registry"
-  "scripts/test-lifecycle-registry.rb"
-  "scripts/verify-governance-release"
-  "scripts/verify-implementation-path-scenarios"
-  "scripts/verify-scaffold-generator-scenarios"
-  "scripts/verify-prototype-backend-scaffold-scenarios"
-  "scripts/verify-matt-yss-integration-scenarios"
-  "scripts/verify-yss-ui-scenarios"
-  "scripts/verify-openapi-yaml-first-scenarios"
-  "scripts/verify-openapi-json-handoff-scenarios"
-)
-
-required_skills=(
-  "ask-matt"
-  "competitive-intelligence"
-  "grill-with-docs"
-  "to-spec"
-  "to-tickets"
-  "implement"
-  "tdd"
-  "diagnosing-bugs"
-  "code-review"
-  "domain-modeling"
-  "codebase-design"
-  "improve-codebase-architecture"
-  "triage"
-  "prototype"
-  "research"
-  "setup-matt-pocock-skills"
-  "resolving-merge-conflicts"
-  "to-questionnaire"
-  "wait-what"
-  "wizard"
-  "writing-for-agents"
-)
-
-for required_file in "${required_files[@]}"; do
-  test -f "$required_file" || {
-    echo "缺少模板必需文件: $required_file" >&2
-    exit 1
-  }
-done
-
-if git check-ignore --no-index -q docs/.scratch 2>/dev/null; then
-  echo "模板不得忽略 docs/.scratch/：Local Markdown 产物必须可提交、可审计" >&2
-  exit 1
+repository_mode="$(scripts/repository-mode)"
+if [[ "$repository_mode" == "template-source" ]]; then
+  test -x .template-source/scripts/evidence-index
+  .template-source/scripts/evidence-index --check
+  pnpm --dir .template-source/tooling/node test
+  pnpm --dir .template-source/tooling/node check:vendor
 fi
 
-for skill_name in "${required_skills[@]}"; do
-  test -f ".agents/skills/$skill_name/SKILL.md" || {
-    echo "缺少权威共享 skill: .agents/skills/$skill_name/SKILL.md" >&2
-    exit 1
-  }
-done
-
-ruby <<'RUBY'
-# encoding: UTF-8
-require "json"
-require "pathname"
-require "yaml"
-
-root = Pathname.pwd
-manifest = YAML.safe_load(root.join("yss-project.yaml").read, permitted_classes: [], aliases: false)
-valid_modes = %w[template-source project-instance]
-unless manifest.is_a?(Hash) && manifest.keys.sort == %w[repository_mode schema_version] &&
-       manifest["schema_version"] == 1 && valid_modes.include?(manifest["repository_mode"])
-  warn "yss-project.yaml 必须只声明 schema_version: 1 和合法 repository_mode"
-  exit 1
-end
-
-lock = JSON.parse(root.join("skills-lock.json").read)
-unless lock["version"] == 3 && lock["canonicalRoot"] == ".agents/skills"
-  warn "skills-lock.json 必须使用 version 3 且 canonicalRoot 为 .agents/skills"
-  exit 1
-end
-
-projection_roots = lock.fetch("projectionRoots", [])
-lock.fetch("skills", {}).fetch("shared", {}).each do |skill_name, metadata|
-  skill_path = metadata.fetch("skillPath", "")
-  if projection_roots.any? { |projection_root| skill_path.start_with?("#{projection_root}/") }
-    warn "共享 skill 的 skillPath 不得指向投影根: #{skill_name} -> #{skill_path}"
-    exit 1
-  end
-end
-
-openapi_path = root.join("docs/templates/openapi-spec-template.yaml")
-documents = YAML.load_stream(openapi_path.binread.force_encoding("UTF-8"))
-unless documents.length == 1 && documents.first.is_a?(Hash) && documents.first["openapi"] == "3.1.0"
-  warn "docs/templates/openapi-spec-template.yaml 必须是单一 OAS 3.1 YAML document"
-  exit 1
-end
-RUBY
-
 scripts/sync-skills --check
 scripts/update-skill-lock --check
 scripts/verify-lifecycle-registry
@@ -144,161 +24,22 @@ scripts/verify-governance-release
 scripts/verify-implementation-path-scenarios
 scripts/verify-scaffold-generator-scenarios
 scripts/verify-prototype-backend-scaffold-scenarios
-ruby scripts/verify-matt-yss-integration-scenarios
+scripts/verify-matt-yss-integration-scenarios
 scripts/verify-yss-router-scenarios
 scripts/verify-yss-ui-scenarios
 scripts/verify-openapi-yaml-first-scenarios
 scripts/verify-openapi-json-handoff-scenarios
-ruby scripts/test-lifecycle-registry.rb
-ruby scripts/test-export-yss-skills.rb
-
-ruby <<'RUBY'
-# encoding: UTF-8
-require "pathname"
-require "json"
-
-root = Pathname.pwd
-manifest = JSON.parse(root.join("skills-lock.json").read)
-agent_roots = %w[
-  .agents/skills
-  .claude/skills
-  .codex/skills
-  .hermes/skills
-  .pi/skills
-  .qoder/skills
-  .trae/skills
-]
-obsolete_names = [
-  "to-" + "prd",
-  "to-" + "issues",
-  "design-an-interface",
-  "qa",
-  "request-refactor-plan",
-  "ubiquitous-language",
-  "edit-article",
-  "obsidian-vault",
-  "writing-great-skills",
-  "code-review-process",
-  "yss-domain-modeling",
-  "yss-openapi"
-].freeze
-
-agent_roots.each do |agent_root|
-  obsolete_names.each do |name|
-    path = root.join(agent_root, name)
-    abort("过时 skill 目录仍然存在: #{path.relative_path_from(root)}") if path.exist? || path.symlink?
-  end
-end
-
-manifest_skill_names = manifest.fetch("skills", {}).fetch("shared", {}).keys
-manifest_skill_names += manifest.fetch("skills", {}).fetch("platform", {}).values.flat_map(&:keys)
-obsolete_names.each do |name|
-  abort("过时 skill 仍在 skills-lock.json: #{name}") if manifest_skill_names.include?(name)
-end
 
-singular_agent_root = root.join(".agent" + "/skills")
-abort("不允许存在单数 Agent skill root: #{singular_agent_root.relative_path_from(root)}") if singular_agent_root.exist?
+for entry in scripts/sync-skills scripts/update-skill-lock scripts/generate-lifecycle-artifacts scripts/verify-lifecycle-registry scripts/verify-lifecycle-scenarios scripts/verify-matt-yss-integration-scenarios scripts/verify-prototype-backend-scaffold-scenarios scripts/verify-yss-router-scenarios scripts/verify-openapi-yaml-first-scenarios scripts/verify-openapi-json-handoff-scenarios scripts/export-yss-skills; do node --check "$entry"; done
 
-legacy_ticket_directory = root.join("docs/requirements/issues")
-if legacy_ticket_directory.exist?
-  abort("不允许存在旧任务目录: #{legacy_ticket_directory.relative_path_from(root)}")
-end
-
-allowed_legacy_files = %w[
-  docs/process/template-governance-grilling-record.md
-  docs/process/template-governance-skill-validation.md
-  docs/user-guide/规格与任务迁移指南.md
-  scripts/sync-skills
-  scripts/update-skill-lock
-  scripts/verify-template
-].freeze
-
-legacy_patterns = {
-  "旧规格 skill" => /to-prd/,
-  "旧任务 skill" => /to-issues/,
-  "旧规格模板" => /prd-template\.md/,
-  "旧切片模板" => /vertical-slice-issue-template\.md/,
-  "旧任务目录" => %r{docs/requirements/issues/},
-  "旧规格文件名" => /<feature>-prd\.md/,
-  "旧规格术语" => /\bPRD\b/,
-  "单数 Agent root 声明" => /\.agent\//
-}.freeze
-
-scan_entries = %w[AGENTS.md CONTEXT.md README.md docs scripts .agents .claude .codex .hermes .pi .qoder .trae]
-files = scan_entries.flat_map do |entry|
-  path = root.join(entry)
-  path.directory? ? path.glob("**/*", File::FNM_DOTMATCH) : [path]
-end
-
-legacy_hits = []
-files.select(&:file?).uniq.each do |path|
-  relative = path.relative_path_from(root).to_s
-  next if allowed_legacy_files.include?(relative)
-  next if relative.start_with?("docs/reviews/")
-
-  body = path.binread.force_encoding("UTF-8")
-  next unless body.valid_encoding?
-
-  legacy_patterns.each do |label, pattern|
-    body.each_line.with_index(1) do |line, line_number|
-      legacy_hits << "#{relative}:#{line_number}: #{label}" if line.match?(pattern)
-    end
-  end
-end
-
-unless legacy_hits.empty?
-  warn "发现未迁移的旧入口或声明:"
-  legacy_hits.each { |hit| warn "  #{hit}" }
-  exit 1
-end
-
-unless root.join("AGENTS.md").binread.force_encoding("UTF-8").include?("正文统一使用简体中文") &&
-       root.join("CONTEXT.md").binread.force_encoding("UTF-8").include?("统一使用简体中文")
-  abort("AGENTS.md 与 CONTEXT.md 必须共同声明落地文档使用简体中文")
-end
-
-markdown_paths = (root.glob("*.md") + root.glob("docs/**/*.md")).reject do |path|
-  path.relative_path_from(root).to_s.start_with?("docs/process/presentations/")
-end
-missing_links = []
-markdown_paths.uniq.sort.each do |path|
-  body = path.read
-  body.scan(/\[[^\]]+\]\(([^)]+)\)/).flatten.each do |target|
-    next if target.start_with?("http://", "https://", "mailto:", "#")
-
-    clean = target.split("#", 2).first
-    next if clean.empty?
-
-    resolved = path.dirname.join(clean).cleanpath
-    missing_links << "#{path.relative_path_from(root)} -> #{target}" unless resolved.exist?
-  end
-end
-
-unless missing_links.empty?
-  warn "发现无效 Markdown 相对链接:"
-  missing_links.each { |item| warn "  #{item}" }
-  exit 1
-end
-RUBY
-
-ruby -c scripts/sync-skills >/dev/null
-ruby -c scripts/update-skill-lock >/dev/null
-ruby -c scripts/implementation-path-policy.rb >/dev/null
-ruby -c scripts/verify-lifecycle-scenarios >/dev/null
-ruby -c scripts/lifecycle-registry.rb >/dev/null
-ruby -c scripts/generate-lifecycle-artifacts >/dev/null
-ruby -c scripts/verify-lifecycle-registry >/dev/null
-ruby -c scripts/test-lifecycle-registry.rb >/dev/null
-ruby -c scripts/verify-governance-release >/dev/null
-ruby -c scripts/verify-prototype-backend-scaffold-scenarios >/dev/null
-ruby -c scripts/verify-matt-yss-integration-scenarios >/dev/null
-ruby -c scripts/verify-yss-ui-scenarios >/dev/null
-python3 -m py_compile .agents/skills/yss-ddd-scaffold-generator/scripts/generate_scaffold.py
-python3 -m py_compile .agents/skills/yss-ddd-scaffold-generator/scripts/run_scaffold_verification.py
+legacy_runtime="ru""by"
+script_roots=(scripts)
+if [[ -d .template-source/scripts ]]; then
+  script_roots+=(.template-source/scripts)
+fi
+if rg -n "^#!.*${legacy_runtime}|\\b${legacy_runtime}\\b" "${script_roots[@]}" --glob '!*.md'; then echo "模板脚本不得保留活跃 Ruby 调用或 shebang" >&2; exit 1; fi
+if rg --files "${script_roots[@]}" | rg '\.rb$'; then echo "模板脚本不得保留 .rb 路径" >&2; exit 1; fi
 if git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
   git diff --check
-else
-  echo "当前目录尚未初始化 Git，跳过 git diff --check"
 fi
-
 echo "模板发布校验通过"