create-yss-spec 3.1.3 → 3.3.0

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/scripts/verify-strategic-handoff-package-scenarios

@@ -9,7 +9,7 @@ import { fixture, context } from './fixtures/strategic-handoff/fixture.mjs';
 import { exportBundle, openBundle, importBundle } from './lib/strategic-handoff.mjs';
 import { read, json, hash, digest } from './lib/strategic-handoff-io.mjs';
 import { parseContextContract } from './lib/context-contract.mjs';
-const setup=async t=>{const base=mkdtempSync(path.join(tmpdir(),'handoff-test-'));t.after(()=>rmSync(base,{recursive:true,force:true}));const source=path.join(base,'source');mkdirSync(source);return{base,source,...await fixture(source)};};
+const setup=async t=>{const base=mkdtempSync(path.join(tmpdir(),'handoff-test-'));t.after(()=>rmSync(base,{recursive:true,force:true}));const source=path.join(base,'source');mkdirSync(source);return{base,source,...await fixture(source,{technicalDesign:true})};};
 function advanceStrategy(f,version='v2') {
  f.handoff.handoff_version=version;
  f.strategy.domain_version=version;
@@ -79,6 +79,12 @@ test('受控延期只阻断依赖切片；未知依赖扩大阻断；目标未
  writeFileSync(path.join(target,'reconciliation.yaml'),json(record));
  for(const row of tactical.strategic_handoff.rows)Object.assign(row,{disposition:'implemented',tactical_refs:['behavior.submit'],test_seam_refs:['test-seam.submit'],scenario_tests:[{outcome:'success',seam_ref:'test-seam.submit'},{outcome:'failure',seam_ref:'test-seam.submit'}],evidence_refs:['CONTEXT.md'],dependency_status:'known',dependent_slice_refs:['slice.submit']});
  assert.equal((await verifyConsumption(tactical,{root:target})).result,'verified');
+ const mvc={schema_version:2,status:'approved',architecture:{family:'layered-mvc'},strategic_handoff:structuredClone(tactical.strategic_handoff),design:{use_case_catalog:[{use_case_id:'use-case.submit'}],test_seams:[{seam_id:'test-seam.submit',subject_ref:'use-case.submit'}]}};
+ for(const row of mvc.strategic_handoff.rows)row.tactical_refs=['use-case.submit'];
+ assert.equal((await verifyConsumption(mvc,{root:target})).result,'verified');
+ mvc.strategic_handoff.rows[0].tactical_refs=['aggregate.fake'];
+ await assert.rejects(()=>verifyConsumption(mvc,{root:target}),/落点悬空/);
+
  const row=tactical.strategic_handoff.rows[0];Object.assign(row,{disposition:'deferred',reason:'分批实现',risk:'不能提交',owner:'需求负责人',followup_ticket_ref:'ticket.followup',verification_plan:'提交测试',target_version:'v2'});
  assert.equal((await verifyConsumption(tactical,{root:target,sliceRef:'slice.submit'})).result,'blocked');
  assert.equal((await verifyConsumption(tactical,{root:target,sliceRef:'slice.other'})).result,'verified');

package/template/skills-lock.json

@@ -21,7 +21,7 @@
       "revision": "c4d958f18cc947cb91cbe1bd48783fa4601cc18f"
     },
     "iloveZzz/yss-harness-design-agent": {
-      "revision": "5c1c98225bb181c7c1add8972c1e44b866205f76"
+      "revision": "8a67e0f5a56aa5085d18c2b42bb540c8f36c2fab"
     }
   },
   "skills": {
@@ -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",
@@ -559,7 +559,7 @@
         "sourceType": "git-submodule",
         "skillPath": ".agents/skills/prototype-review/SKILL.md",
         "effectiveHash": "51021f119697dbff644d70c3d6ba3314147c47f412c6f56e4b5540ea3bf554a1",
-        "sourceRevision": "5c1c98225bb181c7c1add8972c1e44b866205f76",
+        "sourceRevision": "8a67e0f5a56aa5085d18c2b42bb540c8f36c2fab",
         "upstreamHash": "2e77b3093a758bb692fb3bda453c5c020d0523f875975e17e2731365f67432e1",
         "adaptationRef": "docs/agents/strategic-design-skills-integration.md",
         "targets": [
@@ -824,7 +824,7 @@
         "sourceType": "git-submodule",
         "skillPath": ".agents/skills/yss-antd-design/SKILL.md",
         "effectiveHash": "917099caa9b76ca3cfd1d0f81f61b28111c1c54ed93e92891f81012dcd0662e2",
-        "sourceRevision": "5c1c98225bb181c7c1add8972c1e44b866205f76",
+        "sourceRevision": "8a67e0f5a56aa5085d18c2b42bb540c8f36c2fab",
         "upstreamHash": "08ce99d45586d5ea19e25fdd9e9a6ede16e66f18992b70b87e0cd23f92343b16",
         "adaptationRef": "docs/agents/strategic-design-skills-integration.md",
         "targets": [
@@ -842,7 +842,7 @@
         "sourceType": "git-submodule",
         "skillPath": ".agents/skills/yss-antdv-next-design/SKILL.md",
         "effectiveHash": "8c55e3a815ace34fbf591e931a58970b3d58cb657e00432ca6c72938d307563b",
-        "sourceRevision": "5c1c98225bb181c7c1add8972c1e44b866205f76",
+        "sourceRevision": "8a67e0f5a56aa5085d18c2b42bb540c8f36c2fab",
         "upstreamHash": "2942ed52dd58a38e51f09eb11254809334aeaed08f21cd081f09f35e6647a68c",
         "adaptationRef": "docs/agents/strategic-design-skills-integration.md",
         "targets": [
@@ -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",
@@ -953,7 +953,7 @@
         "sourceType": "git-submodule",
         "skillPath": ".agents/skills/yss-design-system/SKILL.md",
         "effectiveHash": "e69597b8b6a5ce4de5bd40f67630443b8176202f6b028b2ce146a2a1d062816f",
-        "sourceRevision": "5c1c98225bb181c7c1add8972c1e44b866205f76",
+        "sourceRevision": "8a67e0f5a56aa5085d18c2b42bb540c8f36c2fab",
         "upstreamHash": "90aaf06b2514353152464a4d032076fa9d5ef56272d8ad526f5544f3c22a2b00",
         "adaptationRef": "docs/agents/strategic-design-skills-integration.md",
         "targets": [
@@ -985,7 +985,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-domain/SKILL.md",
-        "effectiveHash": "ed5fbd0ff31f0677f7901a9ea69c4939c22a170f1fef3947b4f7409b11fa5161",
+        "effectiveHash": "e682e141ac6cdb9d97296f270e314a6c7d00ebf574f8a9aaba557dcd8f6553b7",
         "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": "abc754700c6ac1c20245923400c0e5c65e5dcf419c7d6674ec9a3fe6a997868b",
+        "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",
@@ -1149,6 +1149,21 @@
           ".trae/skills"
         ]
       },
+      "yss-mvc-design": {
+        "source": "project",
+        "sourceType": "local",
+        "skillPath": ".agents/skills/yss-mvc-design/SKILL.md",
+        "effectiveHash": "b3deae27723c3a0e9e32c8f5b40fb1295d082a31ccea3f4d9a190b47a704efd3",
+        "targets": [
+          ".agents/skills",
+          ".claude/skills",
+          ".codex/skills",
+          ".cursor/skills",
+          ".pi/skills",
+          ".qoder/skills",
+          ".trae/skills"
+        ]
+      },
       "yss-mvc-scaffold-generator": {
         "source": "project",
         "sourceType": "local",
@@ -1168,7 +1183,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-mybatis/SKILL.md",
-        "effectiveHash": "1f70b00dcc6be6fde9c32ebf4ee41a86f2b348ca4bb789a3f2f32a7a24258ff4",
+        "effectiveHash": "8ab792d519c045a8a682942185f9aae3dcabfe86dbd8a4a9a444d7f657798701",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1213,7 +1228,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-product-lifecycle/SKILL.md",
-        "effectiveHash": "3134144d171d3ac7a52ba37683d6a2972cf7df1f83492a5d58083567f12764af",
+        "effectiveHash": "d317bd2799da0442745c8126e62f7919a0b3de03f2c3cc2e1a7ca0433dc69645",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1229,7 +1244,7 @@
         "sourceType": "git-submodule",
         "skillPath": ".agents/skills/yss-prototype-stage/SKILL.md",
         "effectiveHash": "0ecf3125a73d15e4c9b6b665f92535180df82ccb2255fa863ec59f3ff5d460aa",
-        "sourceRevision": "5c1c98225bb181c7c1add8972c1e44b866205f76",
+        "sourceRevision": "8a67e0f5a56aa5085d18c2b42bb540c8f36c2fab",
         "upstreamHash": "e8f2f3a507da6bf7be0582e4a4dd9659381da8e291755070698a1f51a4e33808",
         "adaptationRef": "docs/agents/strategic-design-skills-integration.md",
         "targets": [
@@ -1246,7 +1261,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-repository/SKILL.md",
-        "effectiveHash": "19f4380ba81f6cf373b737a4b17316f35bf2be27646be38707d52cfd6c1c7aef",
+        "effectiveHash": "0abe4e8f4896613985074615281f11711b807fcfc5727a6e6d2e7d2ebcf7ddc7",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1309,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",
@@ -1325,7 +1340,7 @@
         "sourceType": "git-submodule",
         "skillPath": ".agents/skills/yss-stage-decision/SKILL.md",
         "effectiveHash": "63e222ec2bc572c8d66fc52143ba3862650d243f57e1e9c71214b533eba37c23",
-        "sourceRevision": "5c1c98225bb181c7c1add8972c1e44b866205f76",
+        "sourceRevision": "8a67e0f5a56aa5085d18c2b42bb540c8f36c2fab",
         "upstreamHash": "1eadf230f0e17bf6d209c1df1249acef3520ab29c26a80c476a2a557a224c10a",
         "adaptationRef": "docs/agents/strategic-design-skills-integration.md",
         "targets": [
@@ -1342,7 +1357,22 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-tactical-design/SKILL.md",
-        "effectiveHash": "336eda3a058ae565d31f90a46cb26d6fc921d2c8a7ec0ccc2f4bcb2c780bd128",
+        "effectiveHash": "2ffb26709fd68184e0fe8f724318dc748fc479dcf52af236fe63f49a17540bfa",
+        "targets": [
+          ".agents/skills",
+          ".claude/skills",
+          ".codex/skills",
+          ".cursor/skills",
+          ".pi/skills",
+          ".qoder/skills",
+          ".trae/skills"
+        ]
+      },
+      "yss-technical-design": {
+        "source": "project",
+        "sourceType": "local",
+        "skillPath": ".agents/skills/yss-technical-design/SKILL.md",
+        "effectiveHash": "a4226303571483b115ef7134f9615440ce8b7d39f209be39e1bc16152e080a9f",
         "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": "4f01bef25dfac465e9ff54c71681cf4d0f74669b",
-  "templateCommit": "4f01bef25dfac465e9ff54c71681cf4d0f74669b",
+  "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": "3c5bb9dea7cc8f5bf8559f49ee7b31fea830bff51839dfc49e233e7afe9f948d",
-  "generatedAt": "2026-09-07T03:27:16.902Z"
+  "snapshotHash": "2a676bf4ed0d3151bab51ad900181cbb8fdd628385572e11dd398bcbaceab61b",
+  "generatedAt": "2026-09-09T02:16:12.516Z"
 }

package/template/.agents/skills/yss-mybatis/assets/BaseRepository.java

@@ -1,112 +0,0 @@
-package com.yss.cloud.mybatis.support;
-
-import com.baomidou.mybatisplus.core.conditions.Wrapper;
-import com.baomidou.mybatisplus.core.toolkit.Constants;
-import io.mybatis.mapper.BaseMapper;
-import io.mybatis.mapper.list.ListMapper;
-import io.mybatis.mapper.list.ListProvider;
-import io.mybatis.provider.Caching;
-import com.baomidou.mybatisplus.core.mapper.Mapper;
-import org.apache.ibatis.annotations.*;
-
-import java.io.Serializable;
-import java.util.Collection;
-import java.util.List;
-import java.util.Map;
-
-/**
- * @author zhudaoming
- */
-public interface BaseRepository<T, D extends Serializable> extends Mapper<T>, BaseMapper<T, D>, ListMapper<T> {
-    /**s
-    /**
-     * 删除（根据ID或实体 批量删除）
-     *
-     * @param idList 主键ID列表或实体列表(不能为 null 以及 empty)
-     */
-    int deleteBatchIds(@Param(Constants.COLL) Collection<?> idList);
-    /**
-     * 查询（根据ID 批量查询）
-     *
-     * @param idList 主键ID列表(不能为 null 以及 empty)
-     */
-    List<T> selectBatchIds(@Param(Constants.COLL) Collection<? extends Serializable> idList);
-    /**
-     * 查询（根据 columnMap 条件）
-     *
-     * @param columnMap 表字段 map 对象
-     */
-    List<T> selectByMap(@Param(Constants.COLUMN_MAP) Map<String, Object> columnMap);
-    /**
-     * 根据 Wrapper 条件，查询全部记录
-     *
-     * @param queryWrapper 实体对象封装操作类（可以为 null）
-     */
-    List<Map<String, Object>> selectMaps(@Param(Constants.WRAPPER) Wrapper<T> queryWrapper);
-
-    /**
-     * 根据 Wrapper 条件，查询全部记录
-     * <p>注意： 只返回第一个字段的值</p>
-     *
-     * @param queryWrapper 实体对象封装操作类（可以为 null）
-     */
-    List<Object> selectObjs(@Param(Constants.WRAPPER) Wrapper<T> queryWrapper);
-    /**
-     * 保存实体，默认主键自增，并且名称为 id
-     * <p>
-     * 这个方法是个示例，你可以在自己的接口中使用相同的方式覆盖父接口中的配置
-     *
-     * @param entity 实体类
-     * @return 1成功，0失败
-     */
-    @Override
-    @Lang(Caching.class)
-    @Options(useGeneratedKeys = true)
-    @InsertProvider(type = EntityProvider.class, method = "insert")
-    <S extends T> int insert(S entity);
-
-    /**
-     * 保存实体中不为空的字段，默认主键自增，并且名称为 id
-     * <p>
-     * 这个方法是个示例，你可以在自己的接口中使用相同的方式覆盖父接口中的配置
-     *
-     * @param entity 实体类
-     * @return 1成功，0失败
-     */
-    @Override
-    @Lang(Caching.class)
-    @Options(useGeneratedKeys = true)
-    @InsertProvider(type = EntityProvider.class, method = "insertSelective")
-    <S extends T> int insertSelective(S entity);
-
-    @Override
-    @Lang(Caching.class)
-    @Options(useGeneratedKeys = true)
-    @InsertProvider(type = ListProvider.class, method = "insertList")
-    <S extends T> int insertList(@Param("entityList") List<S> entityList);
-
-    /**
-     * 批量更新
-     *
-     * @author dengsd
-     * @date 2022/9/27 11:49
-     */
-    @Override
-    @Lang(Caching.class)
-    @Options(useGeneratedKeys = true)
-    @UpdateProvider(type = ListProvider.class, method = "updateList")
-    <S extends T> int updateList(@Param("entityList") List<S> entityList);
-
-
-    /**
-     * 批量更新
-     *
-     * @author dengsd
-     * @date 2022/9/27 11:49
-     */
-    @Override
-    @Lang(Caching.class)
-    @Options(useGeneratedKeys = true)
-    @UpdateProvider(type = ListProvider.class, method = "updateListSelective")
-    <S extends T> int updateListSelective(@Param("entityList") List<S> entityList);
-}

package/template/.agents/skills/yss-mybatis/assets/EntityQueryAspect.java

@@ -1,37 +0,0 @@
-package com.yss.cloud.mybatis.aop;
-
-import com.github.pagehelper.Page;
-import com.github.pagehelper.PageHelper;
-import com.yss.cloud.dto.page.PageQuery;
-import lombok.SneakyThrows;
-import org.aspectj.lang.ProceedingJoinPoint;
-import org.aspectj.lang.annotation.Around;
-import org.aspectj.lang.annotation.Aspect;
-
-@Aspect
-public class EntityQueryAspect {
-
-    /**
-     * 字段开启分页的方法
-     *
-     * @apiNote 1. 包命名需符合规范 com.yss.datamiddle.(项目名).service?.impl.serviceImpl.method <br/> 2. 参数为pageQuery dto的方法
-     * @param joinPoint 加入切点
-     * @param pageQuery 查询分页对象dtp
-     * @return 执行结果
-     */
-    @Around("( (execution(public * (@org.springframework.stereotype.Repository *).*(..)) || execution(* com.yss..*.gateway.impl.*.*(..))))&& (args(pageQuery)||args(pageQuery,..))")
-    @SneakyThrows
-    public Object interceptEntityQueries(ProceedingJoinPoint joinPoint, PageQuery pageQuery) {
-        if (pageQuery != null) {
-            //分页查询开始
-            Page<Object> page = PageHelper.offsetPage(pageQuery.getOffset(), pageQuery.getPageSize());
-            // 继续执行目标方法
-            Object result = joinPoint.proceed();
-            long total = page.getTotal();
-            pageQuery.setTempTotalCount(total);
-            return result;
-        }
-        // 不满足条件时直接执行目标方法
-        return joinPoint.proceed();
-    }
-}

package/template/.agents/skills/yss-mybatis/assets/MybatisBaseConfiguration.java

@@ -1,18 +0,0 @@
-package com.yss.cloud.mybatis;
-
-import com.yss.cloud.mybatis.config.PageQueryEntityConfigration;
-import org.springframework.boot.context.properties.EnableConfigurationProperties;
-import org.springframework.context.annotation.Configuration;
-import org.springframework.context.annotation.Import;
-
-
-@Configuration
-@Import({
-        PageQueryEntityConfigration.class}
-)
-@EnableConfigurationProperties({PrimaryDataSourceProperties.class,
-        MybatisPlusGlobalProperties.class,
-        YssMybatisMapperProperties.class})
-public class MybatisBaseConfiguration {
-
-}

package/template/.agents/skills/yss-mybatis/assets/PageQueryEntityConfigration.java

@@ -1,18 +0,0 @@
-package com.yss.cloud.mybatis.config;
-
-import com.yss.cloud.mybatis.aop.EntityQueryAspect;
-import lombok.extern.slf4j.Slf4j;
-import org.springframework.context.annotation.Bean;
-import org.springframework.context.annotation.Configuration;
-import org.springframework.context.annotation.Primary;
-
-@Configuration
-@Slf4j
-public class PageQueryEntityConfigration {
-    @Primary
-    @Bean
-    public EntityQueryAspect entityQueryAspect() {
-        log.info("【MapperConfiguration】DataSource 获取数据源primaryDataSourceProperties配置");
-        return new EntityQueryAspect();
-    }
-}