create-yss-spec 2.2.2 → 2.2.4

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

@@ -0,0 +1,105 @@
+#!/usr/bin/env node
+import assert from "node:assert/strict";
+import { validateImplementationEntry, 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",
+].includes(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 : "";
+const options = { exists, read };
+
+const validTicketState = {
+  predecessor_work_unit: "work-unit.ticket-decomposition",
+  tracker_kind: "local-markdown",
+  ticket_decomposition_result_ref: "docs/.scratch/demo/evidence/ticket-decomposition-result.yaml",
+  vertical_slice_ticket_ref: "docs/.scratch/demo/issues/01-valid-slice.md",
+  vertical_slice_ticket_role: "ready-for-agent",
+  vertical_slice_ticket_kind: "vertical-slice-ticket",
+  ticket_decomposition_result: {
+    result: "completed",
+    evidence_refs: ["docs/.scratch/demo/evidence/ticket-decomposition-result.yaml"],
+  },
+  vertical_slice_ticket: {
+    ref: "docs/.scratch/demo/issues/01-valid-slice.md",
+    kind: "vertical-slice-ticket",
+    role: "ready-for-agent",
+  },
+  slice_contract: {
+    ticket_ref: "docs/.scratch/demo/issues/01-valid-slice.md",
+    status: "approved",
+    persisted: true,
+    current_version: true,
+  },
+};
+
+const valid = validateTicketFormalization(validTicketState, options);
+assert.equal(valid.result, "allowed");
+
+const implementation = validateImplementationEntry({
+  ...validTicketState,
+  ready_for_agent: true,
+}, options);
+assert.equal(implementation.result, "allowed");
+
+const cases = [
+  ["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"],
+  ["missing slice kind", { ...validTicketState, vertical_slice_ticket_kind: undefined }, "vertical-slice-ticket-kind-missing"],
+  ["missing vertical slice", { ...validTicketState, vertical_slice_ticket: undefined }, "vertical-slice-ticket-required"],
+  ["parent ticket reference", { ...validTicketState, vertical_slice_ticket: { ref: "docs/.scratch/demo/parent-ticket.md", kind: "parent-ticket", role: "ready-for-agent" } }, "parent-ticket-forbidden"],
+  ["human-ready slice", { ...validTicketState, vertical_slice_ticket: { ...validTicketState.vertical_slice_ticket, role: "ready-for-human" } }, "ticket-not-ready-for-agent"],
+  ["uncompleted decomposition", { ...validTicketState, ticket_decomposition_result: { result: "blocked", evidence_refs: [] } }, "ticket-decomposition-incomplete"],
+  ["needs-human decomposition", { ...validTicketState, ticket_decomposition_result: { result: "needs-human", evidence_refs: [] } }, "ticket-decomposition-incomplete"],
+  ["unreadable decomposition evidence", { ...validTicketState, ticket_decomposition_result: { ...validTicketState.ticket_decomposition_result, evidence_refs: ["docs/.scratch/demo/missing-evidence.md"] } }, "ticket-formalization-evidence-missing"],
+  ["wrong slice kind", { ...validTicketState, vertical_slice_ticket: { ...validTicketState.vertical_slice_ticket, kind: "parent-ticket" }, vertical_slice_ticket_kind: "parent-ticket" }, "parent-ticket-forbidden"],
+  ["unapproved contract", { ...validTicketState, slice_contract: { ...validTicketState.slice_contract, status: "draft" } }, "slice-contract-not-approved"],
+  ["unpersisted contract", { ...validTicketState, slice_contract: { ...validTicketState.slice_contract, persisted: false } }, "slice-contract-not-persisted"],
+  ["stale formalization", { ...validTicketState, stale: true }, "ticket-formalization-stale"],
+  ["wrong implementation predecessor", { ...validTicketState, predecessor_work_unit: "work-unit.spec-synthesis" }, "invalid-implementation-predecessor"],
+  ["contract bound to another ticket", { ...validTicketState, slice_contract: { ...validTicketState.slice_contract, ticket_ref: "docs/.scratch/demo/issues/02-other.md" } }, "slice-contract-ticket-mismatch"],
+  ["unreadable slice", { ...validTicketState, vertical_slice_ticket: { ...validTicketState.vertical_slice_ticket, ref: "docs/.scratch/demo/issues/03-missing.md" } }, "vertical-slice-ticket-unreadable"],
+];
+
+for (const [name, state, signal] of cases) {
+  const result = validateImplementationEntry(state, options);
+  assert.equal(result.result, "blocked", name);
+  assert.ok(result.blocking_signals.includes(signal), `${name}: missing ${signal}`);
+}
+
+const parentOnly = validateTicketFormalization({
+  ...validTicketState,
+  vertical_slice_ticket: { ref: "docs/.scratch/demo/parent-ticket.md", kind: "parent-ticket", role: "ready-for-human" },
+}, options);
+assert.equal(parentOnly.result, "blocked");
+
+assert.equal(validateNextRoute("work-unit.ticket-decomposition", "work-unit.slice-implementation").result, "allowed");
+for (const current of ["work-unit.spec-synthesis", "work-unit.prototype-design", "work-unit.technical-analysis"]) {
+  const result = validateNextRoute(current, "work-unit.slice-implementation");
+  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.intensity-aware-verification", "work-unit.intensity-aware-review").result, "allowed");
+assert.equal(validateNextRoute("work-unit.release-and-rollback", null).result, "allowed");
+const arbitraryReadable = validateTicketFormalization({
+  ...validTicketState,
+  ticket_decomposition_result_ref: "docs/process/lifecycle-registry.yaml",
+  ticket_decomposition_result: { result: "completed", evidence_refs: ["docs/process/lifecycle-registry.yaml"] },
+}, options);
+assert.equal(arbitraryReadable.result, "blocked");
+assert.ok(arbitraryReadable.blocking_signals.includes("ticket-decomposition-incomplete"));
+assert.equal(validateTicketFormalization({
+  ...validTicketState,
+  tracker_kind: "github",
+  ticket_decomposition_result_ref: "https://github.com/example/project/issues/1",
+  ticket_decomposition_result: { result: "completed", evidence_refs: ["https://github.com/example/project/issues/1"] },
+  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") : "" }).result, "allowed");
+
+process.stdout.write("生命周期转换压力场景验证通过\n");

package/template/scripts/verify-subagent-task-package

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import { spawnSync } from "node:child_process";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const result = spawnSync(process.execPath, [path.join(root, "scripts/verify-digital-human-task-package"), ...process.argv.slice(2)], { stdio: "inherit" });
+process.exitCode = result.status ?? 1;

package/template/scripts/verify-subagent-task-package-scenarios

@@ -0,0 +1,196 @@
+#!/usr/bin/env node
+import assert from "node:assert/strict";
+import { existsSync, mkdirSync, rmSync, writeFileSync } from "node:fs";
+import path from "node:path";
+import { spawnSync } from "node:child_process";
+import { ROOT } from "./lib/lifecycle-registry.mjs";
+import { generateTaskPackageDefaults, validateTaskPackage, validateTaskPackageSet } from "./lib/task-package.mjs";
+
+const contractRef = ".template-source/evidence/.task-package-slice-contract.json";
+const contractFile = path.join(ROOT, contractRef);
+const templateSourceRoot = path.join(ROOT, ".template-source");
+const templateSourceExisted = existsSync(templateSourceRoot);
+const evidenceRef = ".template-source/evidence/.task-package-evidence.json";
+const evidenceFile = path.join(ROOT, evidenceRef);
+const maintenanceRef = ".template-source/evidence/.task-package-maintenance.json";
+const contract = {
+  schema_version: 1,
+  contract_id: "slice-todo",
+  contract_version: 2,
+  slice_id: "todo",
+  status: "approved",
+  lifecycle_refs: {},
+  readiness: {},
+  work_units: [
+    { id: "work-unit.slice-frontend", role_id: "role.frontend-engineer", runtime_id: "runtime.skill-projection", task_package_ref: "work-unit.slice-frontend", contract_id: "slice-todo", contract_version: 2, allowed_write_paths: ["apps/frontend/todo/"] },
+    { id: "work-unit.slice-backend", role_id: "role.backend-engineer", runtime_id: "runtime.skill-projection", task_package_ref: "work-unit.slice-backend", contract_id: "slice-todo", contract_version: 2, allowed_write_paths: ["apps/backend/todo/"] }
+  ]
+};
+const maintenance = {
+  schema_version: 1,
+  intensity: "L2",
+  classification_reason: "场景测试维护合同",
+  triggers: [],
+  changed_assets: ["scenario-fixture"],
+  verification_evidence: [
+    { kind: "counterexample", command: "scenario", result: "pass" },
+    { kind: "fresh-verification", command: "scenario", result: "pass" },
+    { kind: "focused-independent-review", command: "scenario", result: "pass" }
+  ],
+  review_mode: "focused-independent",
+  escalation: "none"
+};
+
+function writeFixtures() {
+  mkdirSync(path.dirname(contractFile), { recursive: true });
+  writeFileSync(contractFile, JSON.stringify(contract));
+  writeFileSync(evidenceFile, JSON.stringify({ ok: true }));
+  writeFileSync(path.join(ROOT, maintenanceRef), JSON.stringify(maintenance));
+}
+
+function packageBase(roleId, taskId, workUnitId, kind, contractFields, stageId) {
+  writeFixtures();
+  return generateTaskPackageDefaults(roleId, {
+    task_id: taskId,
+    work_unit_id: workUnitId,
+    actor_id: `${roleId}.instance-1`,
+    ...(stageId ? { stage_id: stageId } : {}),
+    runtime_id: "runtime.skill-projection",
+    execution_state: "Worker",
+    workflow_status: "not-started",
+    contract: { kind, contract_id: `${kind}-${taskId}`, contract_version: 1, status: "issued", contract_ref: "docs/process/lifecycle-registry.yaml", ...contractFields },
+    inputs: ["CONTEXT.md"],
+    objective: "执行有界生命周期工作单元",
+    allowed_write_paths: ["docs/.scratch/"],
+    forbidden_actions: ["不得越过主控门禁"],
+    expected_outputs: ["结构化工作结果"],
+    expected_evidence_files: [evidenceRef],
+    verification_commands: ["scripts/verify-template"],
+    verification_results: [],
+    downstream_consumers: ["role.lifecycle-orchestrator"],
+    convergence: { parent_work_unit: workUnitId, convergence_ref: "checkpoint:test", conflict_escalation: "返回主控" }
+  });
+}
+
+function lifecyclePackage() {
+  return packageBase("role.requirements-manager", "task-discovery", "work-unit.discovery-opportunity", "lifecycle-work-unit", { lifecycle_ref: "docs/process/lifecycle-registry.yaml", artifact_refs: ["artifact.discovery-record"] , gate_refs: [] , contract_id: "lifecycle-discovery", contract_version: 1 }, "stage.discovery");
+}
+
+function lifecycleStagePackage(roleId, taskId, workUnitId, stageId) {
+  return packageBase(roleId, taskId, workUnitId, "lifecycle-work-unit", { lifecycle_ref: "docs/process/lifecycle-registry.yaml", contract_id: `lifecycle-${taskId}`, contract_version: 1 }, stageId);
+}
+
+function templatePackage() {
+  return packageBase("role.lifecycle-orchestrator", "task-maintenance", "work-unit.intensity-aware-verification", "template-maintenance", { maintenance_ref: maintenanceRef, contract_id: "template-maintenance", contract_version: 1 });
+}
+
+function slicePackage(roleId, taskId, workUnitId, writePath) {
+  writeFixtures();
+  return generateTaskPackageDefaults(roleId, {
+    task_id: taskId,
+    work_unit_id: workUnitId,
+    actor_id: `${roleId}.instance-1`,
+    stage_id: "stage.vertical-slice-implementation",
+    runtime_id: "runtime.skill-projection",
+    execution_state: "Worker",
+    workflow_status: "not-started",
+    contract: { kind: "slice-implementation", contract_id: contract.contract_id, contract_version: contract.contract_version, status: "issued", contract_ref: contractRef, slice_contract_ref: contractRef },
+    inputs: ["CONTEXT.md"],
+    objective: "实现 Todo 垂直切片",
+    allowed_write_paths: [writePath],
+    forbidden_actions: ["不得修改合同"],
+    expected_outputs: ["实现代码", "测试证据"],
+    expected_evidence_files: [evidenceRef],
+    verification_commands: ["scripts/verify-template"],
+    verification_results: [],
+    downstream_consumers: ["role.test-engineer"],
+    convergence: { parent_work_unit: "work-unit.slice-implementation", convergence_ref: "checkpoint:todo", conflict_escalation: "返回主控" }
+  });
+}
+
+function completedResult(pkg, overrides = {}) {
+  return {
+    result_schema: "workflow-execution-result-v1",
+    work_unit: pkg.work_unit_id,
+    workflow_reference: `workflow:${pkg.task_id}`,
+    result: "completed",
+    skill: "yss-product-lifecycle",
+    changed_files: [],
+    evidence_refs: [evidenceRef],
+    deferred_seams: [],
+    drift: [],
+    violation: [],
+    new_impacts: [],
+    stale_candidates: [],
+    next_route: "work-unit.spec-synthesis",
+    blocking_signals: [],
+    ...overrides
+  };
+}
+
+function mustFail(mutator, pattern, label, factory = () => lifecyclePackage()) {
+  const value = factory();
+  mutator(value);
+  assert.throws(() => validateTaskPackage(value), pattern, label);
+}
+
+try {
+  const discovery = lifecyclePackage();
+  const spec = lifecycleStagePackage("role.requirements-manager", "task-spec", "work-unit.spec-synthesis", "stage.spec-architecture");
+  const prototype = lifecycleStagePackage("role.product-manager", "task-prototype", "work-unit.prototype-design", "stage.product-design");
+  const technical = lifecycleStagePackage("role.backend-engineer", "task-technical", "work-unit.technical-analysis", "stage.system-data-engineering");
+  const tickets = lifecycleStagePackage("role.project-manager", "task-tickets", "work-unit.ticket-decomposition", "stage.ticket-formalization");
+  const review = lifecycleStagePackage("role.test-engineer", "task-review", "work-unit.code-review", "stage.verification-release-retrospective");
+  review.execution_state = "Reviewer";
+  review.review_context = { implementation_actor_id: "role.frontend-engineer.instance-1" };
+  const maintenance = templatePackage();
+  const frontend = slicePackage("role.frontend-engineer", "task-frontend", "work-unit.slice-frontend", "apps/frontend/todo/");
+  const backend = slicePackage("role.backend-engineer", "task-backend", "work-unit.slice-backend", "apps/backend/todo/");
+  [discovery, spec, prototype, technical, tickets, review].forEach((pkg) => validateTaskPackage(pkg));
+  validateTaskPackage(maintenance);
+  validateTaskPackage(frontend);
+  validateTaskPackage(backend);
+  validateTaskPackageSet([frontend, backend]);
+
+  const completedDiscovery = lifecyclePackage();
+  completedDiscovery.workflow_status = "resolved";
+  completedDiscovery.verification_results = [{ command: "scripts/verify-template", exit_code: 0, executed_at: "now", evidence_ref: evidenceRef }];
+  completedDiscovery.result = completedResult(completedDiscovery);
+  validateTaskPackage(completedDiscovery);
+
+  const validFile = path.join(ROOT, ".template-source/evidence/.task-package-valid.json");
+  writeFileSync(validFile, JSON.stringify(discovery));
+  for (const cli of ["scripts/verify-digital-human-task-package", "scripts/verify-subagent-task-package"]) {
+    const result = spawnSync(process.execPath, [path.join(ROOT, cli), validFile], { encoding: "utf8" });
+    assert.equal(result.status, 0, result.stderr);
+  }
+  rmSync(validFile, { force: true });
+
+  mustFail((value) => { value.contract.kind = "unknown"; }, /未知 contract.kind|not one of/, "unknown-contract-kind");
+  mustFail((value) => { value.contract.slice_contract_ref = contractRef; }, /不得携带专项合同引用/, "lifecycle-slice-ref");
+  mustFail((value) => { delete value.contract.lifecycle_ref; }, /lifecycle_ref/, "lifecycle-missing-ref");
+  mustFail((value) => { value.contract.kind = "slice-implementation"; delete value.contract.slice_contract_ref; }, /slice_contract_ref/, "slice-missing-ref");
+  mustFail((value) => { value.contract.kind = "template-maintenance"; delete value.contract.maintenance_ref; }, /maintenance_ref/, "maintenance-missing-ref");
+  mustFail((value) => { value.work_unit_id = "work-unit.intensity-aware-review"; value.contract.kind = "lifecycle-work-unit"; value.contract.lifecycle_ref = "docs/process/lifecycle-registry.yaml"; }, /template-source.*template-maintenance/, "template-source-lifecycle-kind");
+  mustFail((value) => { value.work_unit_id = "work-unit.slice-implementation"; value.stage_id = "stage.vertical-slice-implementation"; value.contract.kind = "lifecycle-work-unit"; value.contract.lifecycle_ref = "docs/process/lifecycle-registry.yaml"; }, /不得冒充垂直切片/, "implementation-lifecycle-kind", () => lifecycleStagePackage("role.frontend-engineer", "task-illegal-implementation", "work-unit.slice-implementation", "stage.vertical-slice-implementation"));
+  mustFail((value) => { value.convergence.parent_work_unit = "work-unit.code-review"; }, /必须汇合到 work-unit.slice-implementation/, "slice-wrong-parent", () => slicePackage("role.frontend-engineer", "task-slice-parent", "work-unit.slice-frontend", "apps/frontend/todo/"));
+  mustFail((value) => { value.contract.status = "stale"; }, /stale 任务包必须暂停/, "stale-not-paused");
+  mustFail((value) => { value.runtime_id = "runtime.unknown"; }, /未知 runtime_id/, "unknown-runtime");
+  mustFail((value) => { value.skill_source.core_skills = ["forbidden-skill"]; }, /core_skills 必须与角色注册表完全一致/, "skill-source-mismatch");
+  mustFail((value) => { value.stage_id = "stage.product-design"; }, /未覆盖 stage_id/, "role-stage-mismatch");
+  mustFail((value) => { value.result = { result: "blocked", changed_files: ["docs/../secret.txt"] }; }, /超出 allowed_write_paths|越出仓库/, "write-path-traversal");
+  mustFail((value) => { value.execution_state = "Reviewer"; value.review_context = { implementation_actor_id: value.actor_id }; }, /不同 actor_id/, "reviewer-implementer-conflict");
+  mustFail((value) => { value.workflow_status = "resolved"; value.verification_results = [{ command: "scripts/verify-template", exit_code: 0, executed_at: "now", evidence_ref: evidenceRef }]; value.result = completedResult(value, { new_impacts: ["api-change"] }); }, /new_impacts 必须为空/, "completed-new-impact");
+  mustFail((value) => { value.workflow_status = "resolved"; value.verification_commands = ["scripts/verify-template", "pnpm test"]; value.verification_results = [{ command: "scripts/verify-template", exit_code: 0, executed_at: "now", evidence_ref: evidenceRef }]; value.result = completedResult(value); }, /覆盖全部 verification_commands/, "verification-command-gap");
+  mustFail((value) => { value.workflow_status = "resolved"; value.result = completedResult(value, { evidence_refs: [".template-source/evidence/.missing.json"] }); value.verification_results = [{ command: "scripts/verify-template", exit_code: 0, executed_at: "now", evidence_ref: evidenceRef }]; }, /不可读/, "unreadable-evidence");
+  mustFail((value) => { value.workflow_status = "resolved"; value.verification_results = [{ command: "scripts/verify-template", exit_code: 0, executed_at: "now", evidence_ref: evidenceRef }]; }, /Workflow Execution Result/, "resolved-without-result");
+  mustFail((value) => { value.workflow_status = "resolved"; value.result = { result: "blocked" }; value.verification_results = [{ command: "scripts/verify-template", exit_code: 0, executed_at: "now", evidence_ref: evidenceRef }]; }, /Workflow Execution Result/, "resolved-blocked-result");
+  mustFail((value) => { value.workflow_status = "resolved"; value.verification_results = [{ command: "scripts/verify-template", exit_code: 0, executed_at: "now", evidence_ref: evidenceRef }]; value.result = completedResult(value); value.expected_evidence_files = [".template-source/evidence/.missing.json"]; }, /expected_evidence_files.*不可读/, "missing-expected-evidence");
+
+  process.stdout.write("数字人全生命周期任务包压力场景验证通过\n");
+} finally {
+  rmSync(contractFile, { force: true });
+  rmSync(evidenceFile, { force: true });
+  rmSync(path.join(ROOT, maintenanceRef), { force: true });
+  if (!templateSourceExisted) rmSync(templateSourceRoot, { recursive: true, force: true });
+}

package/template/scripts/verify-template

@@ -5,7 +5,7 @@ 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); }'
 
-required_files=(yss-project.yaml AGENTS.md CONTEXT.md skills-lock.json docs/agents/yss-skill-registry.yaml docs/process/lifecycle-registry.yaml docs/process/lifecycle-registry-baseline.json docs/process/maintenance-intensity.yaml docs/process/schemas/lifecycle-checkpoint.schema.json docs/process/schemas/frontend-implementation-evidence.schema.json docs/process/templates/lifecycle-checkpoint-template.yaml docs/process/templates/frontend-implementation-plan-template.yaml docs/process/templates/frontend-implementation-verification-template.yaml scripts/repository-mode scripts/implementation-path-policy scripts/repository-scope-policy scripts/sync-skills scripts/update-skill-lock scripts/generate-lifecycle-artifacts scripts/verify-lifecycle-registry scripts/verify-lifecycle-checkpoint scripts/verify-frontend-implementation-evidence scripts/verify-maintenance-checkpoint scripts/verify-maintenance-intensity-scenarios scripts/verify-skill-registry scripts/verify-skill-governance scripts/verify-yss-dto-openapi-profile scripts/verify-yss-dto-openapi-scenarios scripts/export-yss-skills)
+required_files=(yss-project.yaml AGENTS.md CONTEXT.md skills-lock.json docs/agents/yss-skill-registry.yaml docs/agents/digital-human-roles.yaml docs/process/lifecycle-registry.yaml docs/process/lifecycle-registry-baseline.json docs/process/maintenance-intensity.yaml docs/process/schemas/lifecycle-checkpoint.schema.json docs/process/schemas/frontend-implementation-evidence.schema.json docs/process/schemas/digital-human-task-package.schema.json docs/process/schemas/subagent-task-package.schema.json docs/process/templates/lifecycle-checkpoint-template.yaml docs/process/templates/frontend-implementation-plan-template.yaml docs/process/templates/frontend-implementation-verification-template.yaml docs/templates/subagent-task-package-template.md .agents/skills/yss-tactical-design/SKILL.md .agents/skills/yss-tactical-design/agents/openai.yaml .agents/skills/yss-tactical-design/references/tactical-design-contract.md .agents/skills/yss-tactical-design/references/tactical-design.schema.json .agents/skills/yss-tactical-design/references/validation-rules.md .agents/skills/yss-tactical-design/references/output-template.md .agents/skills/yss-tactical-design/scripts/validate-tactical-design.mjs .agents/skills/yss-tactical-design/tests/run-scenarios.mjs scripts/repository-mode scripts/implementation-path-policy scripts/repository-scope-policy scripts/sync-skills scripts/update-skill-lock scripts/generate-lifecycle-artifacts scripts/verify-lifecycle-registry scripts/verify-lifecycle-checkpoint scripts/verify-frontend-implementation-evidence scripts/lib/task-package.mjs scripts/verify-digital-human-task-package scripts/verify-digital-human-task-package-scenarios scripts/verify-subagent-task-package scripts/verify-subagent-task-package-scenarios scripts/verify-lifecycle-transition-scenarios scripts/verify-maintenance-checkpoint scripts/verify-maintenance-intensity-scenarios scripts/verify-skill-registry scripts/verify-skill-governance scripts/verify-yss-dto-openapi-profile scripts/verify-yss-dto-openapi-scenarios scripts/verify-digital-human-roles scripts/verify-digital-human-roles-scenarios scripts/verify-approval-record scripts/export-yss-skills)
 for required in "${required_files[@]}"; do test -f "$required" || { echo "缺少模板必需文件: $required" >&2; exit 1; }; done
 
 repository_mode="$(scripts/repository-mode)"
@@ -20,13 +20,27 @@ scripts/sync-skills --check
 scripts/update-skill-lock --check
 scripts/verify-skill-registry
 scripts/verify-skill-governance
+node --check .agents/skills/yss-tactical-design/scripts/validate-tactical-design.mjs
+node --check .agents/skills/yss-tactical-design/tests/run-scenarios.mjs
+node .agents/skills/yss-tactical-design/tests/run-scenarios.mjs
 scripts/verify-yss-dto-openapi-profile
 scripts/verify-yss-dto-openapi-scenarios
+scripts/verify-digital-human-roles
+scripts/verify-digital-human-roles-scenarios
+scripts/verify-approval-record docs/templates/approval-record-template.yaml
 scripts/verify-lifecycle-registry
 scripts/verify-lifecycle-checkpoint docs/process/templates/lifecycle-checkpoint-template.yaml
 scripts/verify-frontend-implementation-evidence --allow-template docs/process/templates/frontend-implementation-plan-template.yaml
 scripts/verify-frontend-implementation-evidence --allow-template docs/process/templates/frontend-implementation-verification-template.yaml
+scripts/verify-subagent-task-package-scenarios
+scripts/verify-digital-human-task-package-scenarios
+if [[ "$repository_mode" == "template-source" ]]; then
+  scripts/verify-digital-human-task-package .template-source/evidence/maintenance/digital-human-task-package-review-task.yaml
+  scripts/verify-digital-human-task-package .template-source/evidence/maintenance/lifecycle-ticket-transition-review-task-package.yaml
+  scripts/verify-maintenance-checkpoint .template-source/evidence/maintenance/yss-tactical-design-l3-checkpoint-2026-08-27.yaml
+fi
 scripts/verify-lifecycle-scenarios
+scripts/verify-lifecycle-transition-scenarios
 scripts/verify-maintenance-intensity-scenarios
 scripts/verify-governance-release
 scripts/verify-implementation-path-scenarios
@@ -39,7 +53,7 @@ scripts/verify-yss-ui-scenarios
 scripts/verify-openapi-yaml-first-scenarios
 scripts/verify-openapi-json-handoff-scenarios
 
-for entry in scripts/sync-skills scripts/update-skill-lock scripts/generate-lifecycle-artifacts scripts/verify-lifecycle-registry scripts/verify-lifecycle-checkpoint scripts/verify-frontend-implementation-evidence scripts/verify-maintenance-checkpoint scripts/verify-maintenance-intensity-scenarios scripts/verify-skill-registry scripts/verify-skill-governance scripts/verify-yss-dto-openapi-profile scripts/verify-yss-dto-openapi-scenarios 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/verify-repository-scope-scenarios scripts/export-yss-skills; do node --check "$entry"; done
+for entry in scripts/sync-skills scripts/update-skill-lock scripts/generate-lifecycle-artifacts scripts/verify-lifecycle-registry scripts/verify-lifecycle-checkpoint scripts/verify-frontend-implementation-evidence scripts/lib/task-package.mjs scripts/verify-digital-human-task-package scripts/verify-digital-human-task-package-scenarios scripts/verify-subagent-task-package scripts/verify-subagent-task-package-scenarios scripts/verify-maintenance-checkpoint scripts/verify-maintenance-intensity-scenarios scripts/verify-skill-registry scripts/verify-skill-governance scripts/verify-yss-dto-openapi-profile scripts/verify-yss-dto-openapi-scenarios scripts/verify-digital-human-roles scripts/verify-digital-human-roles-scenarios scripts/verify-approval-record scripts/lib/lifecycle-transition.mjs scripts/verify-lifecycle-scenarios scripts/verify-lifecycle-transition-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/verify-repository-scope-scenarios scripts/export-yss-skills; do node --check "$entry"; done
 
 legacy_runtime="ru""by"
 script_roots=(scripts)

package/template/skills-lock.json

@@ -1190,7 +1190,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-domain/SKILL.md",
-        "effectiveHash": "3254ddfca94e1ecca34d43521e781c466d76511c358618b4ad381697987f7bc0",
+        "effectiveHash": "6a4e88ad17cfc143e18e547f89ae7d3d91b59a9131feff1aa8eea0bb8a8b602b",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1398,7 +1398,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-product-lifecycle/SKILL.md",
-        "effectiveHash": "6b5ca6ad3453abf2b4794569853ffc4a1c5a625adee4428373fc690c729fee20",
+        "effectiveHash": "04df4a9cef4e994d703e5eb6626b15460a42d3177773935619adc5060aea4bbe",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1462,7 +1462,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-router/SKILL.md",
-        "effectiveHash": "f78b0264ff4e381fa5ca64b65a08de501e6f3580f00d186e7dd28d3da252769f",
+        "effectiveHash": "29792bb3938257a12e1f4a175808fceeebfb3318116c6c09621c05d5137cb61d",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1506,6 +1506,38 @@
           ".trae/skills"
         ]
       },
+      "yss-stage-decision": {
+        "source": "project",
+        "sourceType": "local",
+        "skillPath": ".agents/skills/yss-stage-decision/SKILL.md",
+        "effectiveHash": "ee846c58ba39f4ce76d94db609f7690f3e79518af54478d7b97780febc8eade3",
+        "targets": [
+          ".agents/skills",
+          ".claude/skills",
+          ".codex/skills",
+          ".cursor/skills",
+          ".hermes/skills",
+          ".pi/skills",
+          ".qoder/skills",
+          ".trae/skills"
+        ]
+      },
+      "yss-tactical-design": {
+        "source": "project",
+        "sourceType": "local",
+        "skillPath": ".agents/skills/yss-tactical-design/SKILL.md",
+        "effectiveHash": "c9ad1856974b18af0fd250ee6ad541fcd8cdaab2ad32880488a757094e130ce6",
+        "targets": [
+          ".agents/skills",
+          ".claude/skills",
+          ".codex/skills",
+          ".cursor/skills",
+          ".hermes/skills",
+          ".pi/skills",
+          ".qoder/skills",
+          ".trae/skills"
+        ]
+      },
       "yss-ui": {
         "source": "project",
         "sourceType": "local",

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": "51189cae987209ff9076a3336269318f47615d5a",
-  "templateCommit": "51189cae987209ff9076a3336269318f47615d5a",
+  "requestedRef": "37251d0c7dacbe62a66cd935f1d33031891afedd",
+  "templateCommit": "37251d0c7dacbe62a66cd935f1d33031891afedd",
   "manifestHash": "10d161eb3f0e426aeefad5d0b9e6c5522d8a4dbacb9edf6ed64285dcb40b1a65",
   "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": "f3ae9ea041af1b2c07c60e3d9794f22dc20f7c7cd655e95fba442344f124a8b2",
-  "generatedAt": "2026-08-25T05:55:41.500Z"
+  "snapshotHash": "0c214ce41c7c618e67615aaa8759e07ed66fca1106aa7f4845a6447eff4fc005",
+  "generatedAt": "2026-08-27T06:55:49.960Z"
 }