create-yss-spec 3.3.7 → 3.4.1

package/template/scripts/verify-openapi-draft-validation-record

@@ -1,144 +1,25 @@
 #!/usr/bin/env node
-import { createHash } from "node:crypto";
-import { existsSync, lstatSync, readFileSync, realpathSync } from "node:fs";
 import path from "node:path";
 import { parseArgs } from "node:util";
 import { fileURLToPath } from "node:url";
-import { parseAllDocuments, parseDocument } from "./vendor/yaml.mjs";
-import { validateJsonSchema } from "./lib/json-schema.mjs";
+import { validateOpenApiDraftValidationRecord } from "./lib/openapi-draft-validation.mjs";
 
 const templateRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
-const schemaPath = path.join(templateRoot, "docs/process/schemas/openapi-draft-validation-record.schema.json");
-const methods = new Set(["get", "put", "post", "delete", "options", "head", "patch", "trace"]);
-
-function ensure(condition, message) {
-  if (!condition) throw new TypeError(message);
-}
-
-function resolveSafe(root, reference) {
-  ensure(typeof reference === "string" && reference.length > 0, "引用不能为空");
-  ensure(!path.isAbsolute(reference) && !reference.includes("\\") && !reference.split("/").includes(".."), `引用必须位于项目内: ${reference}`);
-  const target = path.resolve(root, reference);
-  ensure(target === root || target.startsWith(`${root}${path.sep}`), `引用越出项目根: ${reference}`);
-  ensure(existsSync(target), `引用不可读取: ${reference}`);
-  ensure(!lstatSync(target).isSymbolicLink(), `引用不能是 symlink: ${reference}`);
-  return target;
-}
-
-function parseOne(file, label) {
-  const source = readFileSync(file, "utf8");
-  const documents = parseAllDocuments(source, { uniqueKeys: true, maxAliasCount: 0 });
-  ensure(documents.length === 1, `${label} 必须是单一 YAML document`);
-  ensure(!documents[0].errors.length, `${label} YAML 无效: ${documents[0].errors[0]?.message}`);
-  return documents[0].toJS({ maxAliasCount: 0 });
-}
-
-function pointer(value, fragment, reference) {
-  if (!fragment || fragment === "#") return value;
-  ensure(fragment.startsWith("#/"), `仅支持 JSON Pointer fragment: ${reference}`);
-  return fragment.slice(2).split("/").reduce((current, part) => {
-    const key = decodeURIComponent(part).replaceAll("~1", "/").replaceAll("~0", "~");
-    ensure(current && Object.hasOwn(current, key), `$ref 无法解析: ${reference}`);
-    return current[key];
-  }, value);
-}
-
-function verifyReferences(rootDocument, draftFile) {
-  const apiRoot = realpathSync(path.dirname(draftFile));
-  const cache = new Map([[realpathSync(draftFile), rootDocument]]);
-  const active = new Set();
-
-  function load(reference, ownerFile) {
-    ensure(!/^[a-z][a-z0-9+.-]*:/i.test(reference) && !path.isAbsolute(reference), `$ref 禁止远程或绝对路径: ${reference}`);
-    const [filePart, fragment = ""] = reference.split("#", 2);
-    const targetFile = filePart ? path.resolve(path.dirname(ownerFile), filePart) : ownerFile;
-    ensure(existsSync(targetFile), `$ref 文件不存在: ${reference}`);
-    const realTarget = realpathSync(targetFile);
-    ensure(realTarget === apiRoot || realTarget.startsWith(`${apiRoot}${path.sep}`), `$ref 越出 feature API 目录: ${reference}`);
-    if (!cache.has(realTarget)) cache.set(realTarget, parseOne(realTarget, `$ref ${reference}`));
-    return { value: pointer(cache.get(realTarget), fragment ? `#${fragment}` : "", reference), file: realTarget };
-  }
-
-  function walk(value, ownerFile) {
-    if (!value || typeof value !== "object") return;
-    if (typeof value.$ref === "string") {
-      const key = `${ownerFile}|${value.$ref}`;
-      if (active.has(key)) return;
-      active.add(key);
-      const resolved = load(value.$ref, ownerFile);
-      walk(resolved.value, resolved.file);
-      active.delete(key);
-    }
-    for (const child of Object.values(value)) walk(child, ownerFile);
-  }
-  walk(rootDocument, realpathSync(draftFile));
-  return (reference, ownerFile = realpathSync(draftFile)) => load(reference, ownerFile);
-}
-
-function verifyOperations(document, resolveReference) {
-  const operationIds = new Set();
-  for (const [route, pathItem] of Object.entries(document.paths ?? {})) {
-    if (!pathItem || typeof pathItem !== "object") continue;
-    const placeholders = [...route.matchAll(/\{([^}]+)\}/g)].map((match) => match[1]);
-    for (const [method, operation] of Object.entries(pathItem)) {
-      if (!methods.has(method) || !operation || typeof operation !== "object") continue;
-      ensure(typeof operation.operationId === "string" && operation.operationId.length > 0, `${method.toUpperCase()} ${route} 缺少 operationId`);
-      ensure(!operationIds.has(operation.operationId), `operationId 重复: ${operation.operationId}`);
-      operationIds.add(operation.operationId);
-      const parameters = [...(pathItem.parameters ?? []), ...(operation.parameters ?? [])].map((item) =>
-        typeof item?.$ref === "string" ? resolveReference(item.$ref).value : item
-      );
-      for (const name of placeholders) {
-        const parameter = parameters.find((item) => item?.in === "path" && item?.name === name);
-        ensure(parameter && parameter.required === true, `${method.toUpperCase()} ${route} 缺少 required path parameter: ${name}`);
-      }
-    }
-  }
-}
 
 try {
   const { values, positionals } = parseArgs({
     options: { "allow-template": { type: "boolean" }, root: { type: "string", default: templateRoot } },
     allowPositionals: true,
-    strict: true
+    strict: true,
   });
-  ensure(positionals.length === 1, "用法: scripts/verify-openapi-draft-validation-record [--allow-template] [--root <project>] <record.yaml>");
-  const root = path.resolve(values.root);
-  const recordFile = path.resolve(positionals[0]);
-  const recordDocument = parseDocument(readFileSync(recordFile, "utf8"), { uniqueKeys: true, maxAliasCount: 0 });
-  ensure(!recordDocument.errors.length, `validation record YAML 无效: ${recordDocument.errors[0]?.message}`);
-  const record = recordDocument.toJS({ maxAliasCount: 0 });
-  validateJsonSchema(record, schemaPath, { cwd: templateRoot, label: "OpenAPI Draft validation record schema" });
-
-  if (values["allow-template"]) {
-    ensure(record.template === true, "--allow-template 只接受模板记录");
-    process.stdout.write("OpenAPI Draft validation record 模板验证通过\n");
-    process.exit(0);
-  }
-
-  ensure(record.template === false, "正式 validation record 必须设置 template: false");
-  ensure(record.status === "passed", "正式 validation record 必须达到 status: passed");
-  ensure(record.toolchain.exit_code === 0, "Redocly lint 必须以退出码 0 完成");
-  ensure(Object.values(record.checks).every((result) => result === "passed"), "所有结构与 lint checks 必须为 passed");
-  ensure(record.toolchain.command === `pnpm exec redocly lint ${record.draft.ref}`, "lint command 必须精确指向当前 Draft");
-
-  const draftFile = resolveSafe(root, record.draft.ref);
-  const lockfile = resolveSafe(root, record.toolchain.lockfile_ref);
-  resolveSafe(root, record.toolchain.evidence_ref);
-  const draftBytes = readFileSync(draftFile);
-  const actualDigest = `sha256:${createHash("sha256").update(draftBytes).digest("hex")}`;
-  ensure(actualDigest === record.draft.sha256, `Draft SHA-256 不匹配: record=${record.draft.sha256}, actual=${actualDigest}`);
-  const lock = readFileSync(lockfile, "utf8");
-  const version = record.toolchain.version.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-  const lockedPackage = new RegExp(`['\"]?@redocly/cli@${version}(?:['\":\\s(]|$)`).test(lock)
-    || new RegExp(`['\"]?@redocly/cli['\"]?:[\\s\\S]{0,240}?\\n\\s+version:\\s*['\"]?${version}(?:\\(|['\"\\s]|$)`).test(lock);
-  ensure(lockedPackage, "pnpm lockfile 未绑定记录中的 @redocly/cli 版本");
-
-  const draft = parseOne(draftFile, "OpenAPI Draft");
-  ensure(draft?.openapi === "3.1.0" && record.draft.oas_version === draft.openapi, "OpenAPI Draft 必须为 OAS 3.1.0");
-  const resolveReference = verifyReferences(draft, draftFile);
-  verifyOperations(draft, resolveReference);
-  process.stdout.write(`OpenAPI Draft validation record 验证通过: ${record.draft.sha256}\n`);
+  if (positionals.length !== 1) throw new TypeError("用法: scripts/verify-openapi-draft-validation-record [--allow-template] [--root <project>] <record.yaml>");
+  const result = validateOpenApiDraftValidationRecord(path.resolve(positionals[0]), {
+    root: path.resolve(values.root),
+    allowTemplate: values["allow-template"] === true,
+  });
+  process.stdout.write(result.template
+    ? "OpenAPI Draft validation record 模板验证通过\n"
+    : `OpenAPI Draft validation record 验证通过: ${result.record.draft.sha256}\n`);
 } catch (error) {
   process.stderr.write(`OpenAPI Draft validation record 验证失败: ${error.message}\n`);
   process.exitCode = 1;

package/template/scripts/verify-strategic-context-import

@@ -1,15 +1,19 @@
 #!/usr/bin/env node
-import { existsSync, readFileSync } from "node:fs";
+import { readFileSync } from "node:fs";
 import path from "node:path";
 import { spawnSync } from "node:child_process";
 import { parseArgs } from "node:util";
 import { fileURLToPath } from "node:url";
 import { parseDocument } from "./vendor/yaml.mjs";
 import { parseContextContract } from "./lib/context-contract.mjs";
-import { validateVisualBaseline } from "../.agents/skills/yss-prototype-stage/scripts/visual-baseline-contract.mjs";
+import { validateHandoffUiBaseline } from "./lib/ui-baseline.mjs";
 
 const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
-const schemaPath = path.join(repoRoot, "docs/process/schemas/strategic-design-handoff.schema.json");
+const schemaPaths = new Map([
+  [3, "docs/process/schemas/strategic-design-handoff-v3.schema.json"],
+  [4, "docs/process/schemas/strategic-design-handoff-v4.schema.json"],
+  [5, "docs/process/schemas/strategic-design-handoff-v5.schema.json"],
+]);
 const pythonValidator = String.raw`
 import json, sys
 from jsonschema import Draft202012Validator
@@ -33,19 +37,13 @@ try {
   if (positionals.length !== 1 || !values.reconciliation) throw new TypeError("用法: scripts/verify-strategic-context-import --root <target-repo> --reconciliation <record> <handoff.yaml|json>");
   const root = path.resolve(values.root);
   const handoff = parseFile(path.resolve(positionals[0]));
-  if ([1, 2].includes(handoff.schema_version)) throw new TypeError(`migration-required: Strategic Design Handoff v${handoff.schema_version} 是只读历史资产；在途 UI 交接必须升级 v3 并携带 Visual Baseline`);
+  if ([1, 2].includes(handoff.schema_version)) throw new TypeError(`migration-required: Strategic Design Handoff v${handoff.schema_version} 是只读历史资产；修改或重新交付必须升级 Handoff v5 并重新批准`);
+  const schemaRef = schemaPaths.get(handoff.schema_version);
+  if (!schemaRef) throw new TypeError(`migration-required: 未知 Strategic Design Handoff schema_version ${String(handoff.schema_version)}；支持历史 v3/v4 与当前 v5`);
+  const schemaPath = path.join(repoRoot, schemaRef);
   const schemaResult = spawnSync("python3", ["-c", pythonValidator, schemaPath], { encoding: "utf8", input: JSON.stringify(handoff) });
   if (schemaResult.status !== 0) throw new TypeError(`${schemaResult.stdout}${schemaResult.stderr}`.trim());
-  const baselineRef = handoff.source.visual_baseline_ref;
-  const bundleRoot = path.resolve(root, baselineRef.persisted_ref);
-  const manifestPath = path.resolve(bundleRoot, baselineRef.manifest_ref);
-  if (!manifestPath.startsWith(`${bundleRoot}${path.sep}`) || !existsSync(manifestPath)) throw new TypeError("Strategic Design Handoff 的 Visual Baseline manifest 不可读或越界");
-  const baseline = parseFile(manifestPath);
-  const baselineResult = await validateVisualBaseline(baseline, { bundleRoot });
-  if (baselineResult.errors.length) throw new TypeError(`Visual Baseline 无效: ${baselineResult.errors.join("; ")}`);
-  if (baseline.baseline_id !== baselineRef.baseline_id || baseline.version !== baselineRef.version || baseline.bundle.digest !== baselineRef.digest) throw new TypeError("Strategic Design Handoff 的 Visual Baseline 身份、版本或 digest 不一致");
-  const actualCaseIds = baseline.cases.map((item) => item.case_id).sort();
-  if (JSON.stringify(actualCaseIds) !== JSON.stringify([...baselineRef.case_ids].sort())) throw new TypeError("Strategic Design Handoff 的 Visual Baseline case_ids 不一致");
+  await validateHandoffUiBaseline(root, handoff);
   const reconciliationResult = spawnSync(process.execPath, [path.join(repoRoot, "scripts/verify-context-reconciliation"), "--root", root, path.resolve(values.reconciliation)], { cwd: repoRoot, encoding: "utf8" });
   if (reconciliationResult.status !== 0) throw new TypeError(reconciliationResult.stderr.trim());
   const target = parseContextContract({ root });

package/template/skills-lock.json

@@ -18,7 +18,7 @@
       "revision": "c4d958f18cc947cb91cbe1bd48783fa4601cc18f"
     },
     "iloveZzz/yss-harness-design-agent": {
-      "revision": "e24465921a8a51d8690a1732842274a35b935c9e"
+      "revision": "e5cc1b2b9a99297b475551174057dbeb1d5f1a24"
     },
     "ayghri/i-have-adhd": {
       "revision": "7b9069b39972e269e61bd95c2f66ebb90cac6a02"
@@ -331,7 +331,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/implementation-repo-onboarding/SKILL.md",
-        "effectiveHash": "2083358c6ed57dbae7b94c2e52f91f9e9103168ad14f4b296ac084d8d9ac4ff3",
+        "effectiveHash": "905e97faee589bcc283cc299a05e795d75a3028440f7059f0115ebe80a266b3c",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -481,7 +481,7 @@
         "sourceType": "git-submodule",
         "skillPath": ".agents/skills/prototype-review/SKILL.md",
         "effectiveHash": "df6f131bef0f52a96d307d98ab42d74888a9b72c5508911b5622913b334e8eab",
-        "sourceRevision": "e24465921a8a51d8690a1732842274a35b935c9e",
+        "sourceRevision": "e5cc1b2b9a99297b475551174057dbeb1d5f1a24",
         "upstreamHash": "9206df8b6c555c1af1351e425c5ec99ec2a40263c6861607f1418b9c520873ab",
         "adaptationRef": "docs/agents/strategic-design-skills-integration.md",
         "targets": [
@@ -696,36 +696,6 @@
           ".pi/skills"
         ]
       },
-      "yss-antd-design": {
-        "source": "iloveZzz/yss-harness-design-agent",
-        "sourceType": "git-submodule",
-        "skillPath": ".agents/skills/yss-antd-design/SKILL.md",
-        "effectiveHash": "92739eb34352fd70fbb52f4d9d6c6ac09aa02bc0155a4bd812a98cd5f933ff70",
-        "sourceRevision": "e24465921a8a51d8690a1732842274a35b935c9e",
-        "upstreamHash": "08ce99d45586d5ea19e25fdd9e9a6ede16e66f18992b70b87e0cd23f92343b16",
-        "adaptationRef": "docs/agents/strategic-design-skills-integration.md",
-        "targets": [
-          ".agents/skills",
-          ".codex/skills",
-          ".cursor/skills",
-          ".pi/skills"
-        ]
-      },
-      "yss-antdv-next-design": {
-        "source": "iloveZzz/yss-harness-design-agent",
-        "sourceType": "git-submodule",
-        "skillPath": ".agents/skills/yss-antdv-next-design/SKILL.md",
-        "effectiveHash": "c7c07c5dc3716f578904559473d43d92878aa25a6a45c8827e288f0242d42b75",
-        "sourceRevision": "e24465921a8a51d8690a1732842274a35b935c9e",
-        "upstreamHash": "2942ed52dd58a38e51f09eb11254809334aeaed08f21cd081f09f35e6647a68c",
-        "adaptationRef": "docs/agents/strategic-design-skills-integration.md",
-        "targets": [
-          ".agents/skills",
-          ".codex/skills",
-          ".cursor/skills",
-          ".pi/skills"
-        ]
-      },
       "yss-api-integration": {
         "source": "iloveZzz/yss-ui",
         "sourceType": "github",
@@ -745,7 +715,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-application/SKILL.md",
-        "effectiveHash": "51115e474c8cd55991fd40c8ab8802fbcced3b5debed61e30ce95c7db7a8d7cb",
+        "effectiveHash": "a5a4b5765ab59178656a2d888961a19712623a3b5f0fa24d3a9f33dbc799df14",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -777,23 +747,11 @@
           ".pi/skills"
         ]
       },
-      "yss-components": {
-        "source": "project",
-        "sourceType": "local",
-        "skillPath": ".agents/skills/yss-components/SKILL.md",
-        "effectiveHash": "37cdd0a21338c3a9dd0c5e11788aa4f522eb1a0777c7311a446c122f6ecbc5f9",
-        "targets": [
-          ".agents/skills",
-          ".codex/skills",
-          ".cursor/skills",
-          ".pi/skills"
-        ]
-      },
       "yss-ddd-scaffold-generator": {
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-ddd-scaffold-generator/SKILL.md",
-        "effectiveHash": "ab1bd70b73a148d57a8e3f88e9a94be57b81f59bbfb81849e6e1dba16bfc7e16",
+        "effectiveHash": "36067afa5f048a3af0420d86e7dc2f9ea1e32d3de1c99dd31eb477ee77f718fa",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -805,9 +763,9 @@
         "source": "iloveZzz/yss-harness-design-agent",
         "sourceType": "git-submodule",
         "skillPath": ".agents/skills/yss-design-system/SKILL.md",
-        "effectiveHash": "e69597b8b6a5ce4de5bd40f67630443b8176202f6b028b2ce146a2a1d062816f",
-        "sourceRevision": "e24465921a8a51d8690a1732842274a35b935c9e",
-        "upstreamHash": "90aaf06b2514353152464a4d032076fa9d5ef56272d8ad526f5544f3c22a2b00",
+        "effectiveHash": "c5c023813042472030cecca187c222257151dd5554655a6bdcdd757bc2a516c7",
+        "sourceRevision": "e5cc1b2b9a99297b475551174057dbeb1d5f1a24",
+        "upstreamHash": "c917ecf40a67c52f0fa7894fbdfbf827cc1ed6aff1037be2911377387fede1a0",
         "adaptationRef": "docs/agents/strategic-design-skills-integration.md",
         "targets": [
           ".agents/skills",
@@ -880,7 +838,7 @@
         "source": "iloveZzz/yss-ui",
         "sourceType": "github",
         "skillPath": "packages/skills/yss-formily/SKILL.md",
-        "effectiveHash": "63c07b8968b0d61a5ec03b30b85ee725c3adc78ae326b1d137b1a1565f8351d4",
+        "effectiveHash": "78ff1a1b6b720f0c3c85c57d145471ac49b01b4aa2df2f24420863d8ae1764d4",
         "sourceRevision": "c4d958f18cc947cb91cbe1bd48783fa4601cc18f",
         "upstreamHash": "f30e312a632c592c9050d00c35c22f2dc032658e6d9fdd6e2b5dc4ac0ea970c8",
         "adaptationRef": "docs/agents/yss-ui-skills-integration.md",
@@ -907,7 +865,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-frontend-scaffold-generator/SKILL.md",
-        "effectiveHash": "2f829e4e2a9cb42e123e8de37fe812bc65eef1308758e077b52f0698de9b68ab",
+        "effectiveHash": "4db10d9240f5ba97312e0afca807b654368dbee0df62396b135e58d1965694d9",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -919,7 +877,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-hook/SKILL.md",
-        "effectiveHash": "77740f75587c2978b72b3651693e4c630aecd62ff757ad50e630a5a4c5b05d49",
+        "effectiveHash": "326e418d71870f0079658e2fd51fba65ab734facd64d194be585bf10bf960422",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -931,7 +889,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-implementation-contract-compiler/SKILL.md",
-        "effectiveHash": "cfa69127e633d485a6691d9e70737fd050401bee7e598971c42bf5d6825c0391",
+        "effectiveHash": "f4a96ee28a8a9f98d03b8bc264ef1202796b25fcbf0d474a50ee3ec745060fb3",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -943,7 +901,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-layered-mvc-scaffold-generator/SKILL.md",
-        "effectiveHash": "50d0f704326fc523c29f4b728c08148cde372c674b9e8686829bee3e74b66fdc",
+        "effectiveHash": "562cee54e4b83ca014049540b8998149026290f283c2ba2aaec39d37ae88e457",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -955,7 +913,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-mvc-data-analysis-project-initializer/SKILL.md",
-        "effectiveHash": "9066e52ea188f5ec6765bb7fe1096f84577c9b1d1abf90e2fafd7e25d35e1a58",
+        "effectiveHash": "5d8711cc0b7fa5ccacbabc0916c7ef11bb82075db8b08260f08221c0cf91895c",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -975,18 +933,6 @@
           ".pi/skills"
         ]
       },
-      "yss-mvc-scaffold-generator": {
-        "source": "project",
-        "sourceType": "local",
-        "skillPath": ".agents/skills/yss-mvc-scaffold-generator/SKILL.md",
-        "effectiveHash": "0c25a113567f2589e06cbba0e361e1c159f6286beae1ec9d2e27104ef3ef52ad",
-        "targets": [
-          ".agents/skills",
-          ".codex/skills",
-          ".cursor/skills",
-          ".pi/skills"
-        ]
-      },
       "yss-mybatis": {
         "source": "project",
         "sourceType": "local",
@@ -1015,7 +961,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-openapi-governance/SKILL.md",
-        "effectiveHash": "e33980c3964c4749ef900c7c27ee683ad4e5ff285e9adf234bc82687304dee30",
+        "effectiveHash": "39f6b613b91875ec3394fc2e4e6f623f49c3833e30cff3be05cf857f5d192b01",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -1027,7 +973,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-product-lifecycle/SKILL.md",
-        "effectiveHash": "9bebb957fdd80cfe812605cec25cdb2d2c2ba229db2547f870efb00e2175b2a9",
+        "effectiveHash": "60e4bd2be607b470316330b3e7e5aebe62fe25c1139e34089d8d989166776349",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -1039,10 +985,9 @@
         "source": "iloveZzz/yss-harness-design-agent",
         "sourceType": "git-submodule",
         "skillPath": ".agents/skills/yss-prototype-stage/SKILL.md",
-        "effectiveHash": "c87c7c38c9598c04f28cfa759fd6c1c12b2937b49e92f8171992d8346cb179e0",
-        "sourceRevision": "e24465921a8a51d8690a1732842274a35b935c9e",
-        "upstreamHash": "aa78ef758ad3c515e94fb6b87d4e519f39a38e53bb3c82413d707f7d0f96f58b",
-        "adaptationRef": "docs/agents/strategic-design-skills-integration.md",
+        "effectiveHash": "8256a1edfeb203f4de27d190210b0ba5593f8f74e0f3655b62b146daff2105a8",
+        "sourceRevision": "e5cc1b2b9a99297b475551174057dbeb1d5f1a24",
+        "upstreamHash": "8256a1edfeb203f4de27d190210b0ba5593f8f74e0f3655b62b146daff2105a8",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -1105,7 +1050,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-skill-source-index-refresh/SKILL.md",
-        "effectiveHash": "96ff974a0f7b3db8de09680daf9ecada94dd19f608341dcc85a32d40c02591b0",
+        "effectiveHash": "8635080a3322c2f18d3f314aab1aa034a6987b28eeecb3cb0c15767969add09f",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -1118,7 +1063,7 @@
         "sourceType": "git-submodule",
         "skillPath": ".agents/skills/yss-stage-decision/SKILL.md",
         "effectiveHash": "ada584c7b996439a47e24153e156c38198f60f3f84250cd37aea6e2a118131aa",
-        "sourceRevision": "e24465921a8a51d8690a1732842274a35b935c9e",
+        "sourceRevision": "e5cc1b2b9a99297b475551174057dbeb1d5f1a24",
         "upstreamHash": "8752a1ed6903bd20c33e21b521d52bd4f7a0662b1d25e00152b60ba38333c93b",
         "adaptationRef": "docs/agents/strategic-design-skills-integration.md",
         "targets": [
@@ -1132,7 +1077,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-tactical-design/SKILL.md",
-        "effectiveHash": "2ffb26709fd68184e0fe8f724318dc748fc479dcf52af236fe63f49a17540bfa",
+        "effectiveHash": "4229d14cd6a5d354db8e88752f4ce050482421720c95b97506a00df42bc371e3",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -1144,7 +1089,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-technical-design/SKILL.md",
-        "effectiveHash": "06e7cdbf6441be90a19ec705388c1e164daefed5ace237c7e6595cf0c0f81e1f",
+        "effectiveHash": "1370875d4316133101a4eae60d75d47759861f3e3f31177f0ea528379639ae3f",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -1156,7 +1101,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-ui/SKILL.md",
-        "effectiveHash": "3140934bcd219ba05581530e0c4465cf700bd2059f596798975a8145b8e84083",
+        "effectiveHash": "215cc4a7ae029d3b2d92ab849176fe6c45c57f3e452e53217d8fdee3eaf1f106",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -1249,7 +1194,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-web-controller/SKILL.md",
-        "effectiveHash": "164e31bcb783676fe7ddd99b400c3b199c4c747a8153fe039048c62b914aa132",
+        "effectiveHash": "6f8082793d3de76eb3cd42a8fa0c62c94361c34f739ceb9601e77d2cf7dfa7e0",
         "targets": [
           ".agents/skills",
           ".codex/skills",

package/template/yss-public-skills.json

@@ -3,13 +3,10 @@
   "repository": "iloveZzz/yss-spec-dev-skills",
   "canonical_root": ".agents/skills",
   "skills": [
-    "yss-antd-design",
-    "yss-antdv-next-design",
     "yss-api-integration",
     "yss-audit-log",
     "yss-application",
     "yss-cache",
-    "yss-components",
     "yss-ddd-scaffold-generator",
     "yss-design-system",
     "yss-distributed-id",
@@ -69,9 +66,6 @@
       "title": "前端",
       "description": "用于 YSS Vue、Formily、页面模块和 UI 实现的技能。",
       "skills": [
-        "yss-antd-design",
-        "yss-antdv-next-design",
-        "yss-components",
         "yss-design-system",
         "yss-formily",
         "yss-formily-schema-generator",

package/template.snapshot.json

@@ -4,15 +4,19 @@
   "templateSource": "github:iloveZzz/yss-spec-project-template",
   "templateRepository": "https://github.com/iloveZzz/yss-spec-project-template.git",
   "requestedRef": "working-tree",
-  "templateCommit": "32fa044c0123f73b8d8091590d1f060440ac9ccb",
+  "templateCommit": "a0fbb41aec24d5ca1c1ef3df0b3c3a67fa3e6a2c",
   "sourceState": "working-tree",
   "manifestHash": "191240f4716de5f93cf1b30ea917a9a14dfd4a29b12dd2ba569c6271fa46009e",
   "encodedPaths": {
+    ".agents/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/.gitignore": ".agents/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/__yss_dotfile__.gitignore",
     ".codex/skills/data-analytics/.gitignore": ".codex/skills/data-analytics/__yss_dotfile__.gitignore",
     ".codex/skills/product-design/.npmignore": ".codex/skills/product-design/__yss_dotfile__.npmignore",
     ".codex/skills/product-design/templates/prototype/.npmrc": ".codex/skills/product-design/templates/prototype/__yss_dotfile__.npmrc",
-    ".gitignore": "__yss_dotfile__.gitignore"
+    ".codex/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/.gitignore": ".codex/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/__yss_dotfile__.gitignore",
+    ".cursor/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/.gitignore": ".cursor/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/__yss_dotfile__.gitignore",
+    ".gitignore": "__yss_dotfile__.gitignore",
+    ".pi/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/.gitignore": ".pi/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/__yss_dotfile__.gitignore"
   },
-  "snapshotHash": "c6c4ab647dbf5a99159098417f05edcd7133c2907fe00aeaae0ea06d5589bf0d",
-  "generatedAt": "2026-09-11T13:22:12.721Z"
+  "snapshotHash": "3f8c8d92079e1489d0be0d466943f14691d0cc60ffa6ae594e67e512e7c6b360",
+  "generatedAt": "2026-09-15T02:57:32.780Z"
 }

package/template/.agents/skills/yss-antd-design/SKILL.md

@@ -1,35 +0,0 @@
----
-name: yss-antd-design
-description: Use when an H2 React/AntD prototype needs versioned Ant Design v6 facts or an incremental fact-pack refresh. Not for H1, frontend implementation, lifecycle approval, or replacing yss-prototype-stage.
----
-
-# YSS Ant Design 事实
-
-只服务 H2 `flow-review` 中实际采用 React AntD 的原型，把官方 `@ant-design/cli` 与 `design.md` 收成可追溯的条件事实源。阶段合同仍是 `yss-prototype-stage`。H1 不适用；前端代码落地一律改用 `yss-ui`。
-
-## 何时使用
-
-- 已进入 `yss-prototype-stage` 且档位为 H2、实际采用 React AntD，需要组件 / token / demo / semantic 事实。
-- 现有 fact pack 不满足精确版本、组件覆盖、项目 Token digest 与无新 API 疑问四项 freshness 条件，需要增量补齐。
-
-不要用本技能：H1、H2 非 AntD 原型、前端实现、Vue / Ant Design Vue 生产代码、批准门禁、生成页面流、安装官方 `antd` skill，或运行 `antd setup`。
-
-## 步骤
-
-1. 先检查 `docs/design/facts/antd/<exact-version>/manifest.json`。fresh 时直接引用；不 fresh 才检测 CLI，优先已安装的 `antd`，否则用 `npx -y @ant-design/cli`。记录实际 CLI 版本，不执行全局安装。
-2. 读项目 `docs/design/design.md` 与 `docs/design/tokens/*`。
-3. 选定 `<target_antd_version>`（项目已选的 v6；未选则先查再记录，不得依赖空仓库自动检测）。此后每次知识查询都传同一版本。
-4. 设置 `ANTD_NO_AUTO_REPORT=1`。一律 `--format json`，对外说明用 `--lang zh`。
-5. 查询官方 `design.md`，再按选用组件跑 `info` / `demo` / `token` / `semantic`。命令矩阵见 `references/cli-matrix.md`。
-6. 把 fact-pack manifest 或增量 JSON 路径写入证据清单。字段与 lint 适用范围见 `references/evidence.md`。
-7. 上游默认与项目 token 冲突时，以项目覆盖为准，并标记 `project_override_reviewed`。
-
-## 硬规则
-
-- 禁止凭记忆写 Ant Design v6 API。
-- 禁止 `antd setup`、`npx skills add ant-design/ant-design-cli`，以及把官方 `skills/antd` 拷进 `.agents/skills`。
-- 禁止把官方 `design.md` 的默认色、圆角、间距写回项目实现或覆盖项目 token。
-- 禁止在前端代码落地、垂直切片实现或 `yss-ui` 任务中调用本技能。
-- 禁止把 React props / demo / hook 当作 `yss-ui` 或 Ant Design Vue API。
-- 禁止为 H1 伪造 AntD 字段，或用 React CLI 证据宣称生产 YSS/AntDV 组件已经验证。
-- MCP 与 `llms-full.txt` 不是门禁证据。边界见 `references/boundaries.md`。

package/template/.agents/skills/yss-antd-design/references/boundaries.md

@@ -1,30 +0,0 @@
-# 边界与官方资料
-
-官方文档只提供 React `antd` 事实，不提供 YSS 阶段合同。入口对照：
-
-| 官方资料 | 本技能用法 |
-|---|---|
-| https://ant.design/docs/react/for-agents-cn | 了解 CLI / skill / MCP / LLMs 分层。不要把其中的 “安装 skill” prompt 写进 `AGENTS.md` |
-| https://ant.design/docs/react/cli-cn | 命令与参数的权威说明 |
-| https://ant.design/docs/react/design-md-cn | 上游 `design.md` 定位。项目覆盖是 `docs/design/design.md` |
-| https://ant.design/docs/react/mcp-cn | MCP 是 IDE 加速，8 个知识工具不含 `lint` |
-| https://ant.design/docs/react/llms-cn | CLI 不可用时的降级目录。不要默认注入 `llms-full.txt` |
-| https://ant.design/design.md | 与 `antd design.md` 同一份 v6 上游默认 |
-
-## 与其他技能
-
-- `yss-prototype-stage`：阶段顺序、评审、浏览器验证、用户确认。本技能只回写 AntD 事实段。
-- `yss-design-system`：项目风格与 token 规范。本技能查询上游事实，不得改项目 token。
-- `product-design:index`：Codex 视觉产出。本技能不替代它，也不使用 `antd-page-generator`。
-- `yss-ui`：前端代码落地的唯一 UI 入口。进入实现后不得再查本技能或 `@ant-design/cli` 的 React API。
-- 官方 `antd` skill：不安装、不锁定、不投影。
-
-## MCP 与 LLMs.txt
-
-开发者本机可以运行 `npx -y @ant-design/cli mcp --version <target_antd_version> --lang zh`，但：
-
-- 不把 `.cursor/mcp.json` 提交为模板默认。
-- 不把 MCP 调用记录当成 `evidence.antd-cli-validation`。
-- `antd-page-generator` 不是原型阶段入口。
-
-CLI 不可用时，可用 `https://ant.design/llms.txt` 定位单组件 `.md`，并在证据里写明降级原因。恢复 CLI 后补 JSON 落盘。

package/template/.agents/skills/yss-antd-design/references/cli-matrix.md

@@ -1,38 +0,0 @@
-# CLI 命令矩阵
-
-运行时入口：已安装的 `antd`，或 `npx -y @ant-design/cli`。记录实际 CLI 版本。知识查询必须带 `--format json`、`--lang zh` 和同一 `<target_antd_version>`。
-
-官方命令说明：https://ant.design/docs/react/cli-cn
-
-## 允许（原型 / 设计事实）
-
-| 命令 | 用途 |
-|---|---|
-| `antd design.md --version <target_antd_version> --lang zh --format json` | 上游默认 Light 主题。只对 antd v6 发布 |
-| `antd list --version <target_antd_version> --format json` | 组件选型 |
-| `antd info <Component> --version <target_antd_version> --format json` | props / 类型 / 默认值 |
-| `antd demo <Component> [name] --version <target_antd_version> --format json` | 可运行 demo 源码（React/TSX） |
-| `antd token <Component> --version <target_antd_version> --format json` | 组件或全局 token |
-| `antd semantic <Component> --version <target_antd_version> --format json` | `classNames` / `styles` 结构 |
-| `antd doc <Component> --version <target_antd_version> --lang zh --format json` | 需要完整文档时 |
-| `antd changelog <v1> <v2> [Component] --format json` | 仅当版本差异影响当前决策 |
-
-`design.md` 对 v5 返回 `UNSUPPORTED_VERSION_FEATURE`。空仓库不传 `--version` 时的回退版本不要假设；必须写进证据。
-
-## 条件允许
-
-| 命令 | 条件 |
-|---|---|
-| `antd lint <tsx-or-src> --format json` | 产物是 React/TSX 源码。HTML 原型不得当作通过 |
-| `antd doctor` / `antd usage` / `antd migrate` | 仅已登记的 React + `antd` 实现仓 |
-| `antd env --format json` | 排障需要环境快照时 |
-
-## 默认禁止
-
-| 命令 | 原因 |
-|---|---|
-| `antd setup` | 会写入 `.agents/skills/antd` 和 `AGENTS.md`，绕过 `skills-lock.json` |
-| `npx skills add ant-design/ant-design-cli` | 同上，安装官方 skill |
-| `antd bug` / `antd bug-cli` | 与 YSS Ticket 无关。保持 `ANTD_NO_AUTO_REPORT=1` |
-| `antd upgrade` | 不得在模板源或未授权时改动全局 CLI |
-| `antd mcp` 作为证据采集 | MCP 调用默认不落盘，见 `boundaries.md` |