@qilitt-mickey/vue3-temp-skill 1.1.32 → 1.1.34

package/scripts/check.cmd

@@ -1,7 +1,9 @@
 @echo off
-REM 发布前全量检查 — 使用系统 node 绕过 npm 路径问题
-where node >nul 2>&1 && (
-  node "%~dp0check.mjs" %*
-) || (
-  "C:\Program Files\nodejs\node.exe" "%~dp0check.mjs" %*
+REM Pre-publish checks (ASCII-only wrapper for cmd.exe)
+where node >nul 2>&1
+if errorlevel 1 (
+  echo Node.js not found. Add Node.js to PATH.
+  exit /b 1
 )
+node "%~dp0check.mjs" %*
+exit /b %ERRORLEVEL%

package/scripts/check.mjs

@@ -16,31 +16,18 @@ import { fileURLToPath } from "url";
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const ROOT = path.resolve(__dirname, "..");
 const NODE = process.execPath;
+const PYTHON = process.env.VUE3_SKILL_PYTHON || (process.platform === "win32" ? "py" : "python3");
+const PYTHON_ARGS = process.platform === "win32" && !process.env.VUE3_SKILL_PYTHON ? ["-3"] : [];
 
 const checks = [
   {
     name: "结构校验",
-    desc: "frontmatter、路由表一致性、孤立模块、交叉引用",
+    desc: "frontmatter、路由引用、交叉引用",
     cmd: () => run(NODE, "scripts/validate.mjs"),
   },
   {
-    name: "命中精度",
-    desc: "关键词重叠、命中盲区、模块评分、边界冲突",
-    cmd: () => run(NODE, "scripts/ai-match-audit.mjs"),
-  },
-  {
-    name: "内容可用性",
-    desc: "样板完整性、Must-do 清单、代码块完备性",
-    cmd: () => run(NODE, "scripts/ai-content-audit.mjs"),
-  },
-  {
-    name: "依赖图",
-    desc: "断链引用、循环依赖、引用热度、孤立模块",
-    cmd: () => run(NODE, "scripts/analyze-deps.mjs"),
-  },
-  {
-    name: "匹配器批量测试",
-    desc: "15 个典型场景模块命中验证",
+    name: "匹配器回归",
+    desc: "高频 Demo 场景能力组命中验证",
     cmd: () => run("python", "scripts/match.py", ["--batch"]),
   },
 ];
@@ -48,7 +35,7 @@ const checks = [
 function run(runner, script, args = []) {
   const scriptPath = path.join(ROOT, script);
   if (runner === "python") {
-    return execFileSync("python", [scriptPath, ...args], {
+    return execFileSync(PYTHON, [...PYTHON_ARGS, scriptPath, ...args], {
       cwd: ROOT,
       encoding: "utf-8",
       stdio: "pipe",
@@ -70,8 +57,10 @@ for (const check of checks) {
     const output = check.cmd();
     // 只在有输出时打印（避免刷屏）
     const lines = output.trim().split("\n");
-    const summary = lines.find(l => l.includes("✓") || l.includes("通过") || l.includes("场景") || l.includes("个模块"))
-      || lines[lines.length - 1];
+    const summary =
+      lines.find((l) => /^OK \d+\/\d+ scenarios/.test(l.trim())) ||
+      lines.find((l) => l.includes("校验通过")) ||
+      lines[lines.length - 1];
     console.log(`\u2713 ${summary?.trim() || "OK"}`);
     passed++;
   } catch (e) {

package/scripts/cli.mjs

@@ -6,14 +6,8 @@
  * 用法：
  *   node scripts/cli.mjs                  # 等同 --validate
  *   node scripts/cli.mjs --validate      # 结构校验
- *   node scripts/cli.mjs --audit         # 命中精度审计
- *   node scripts/cli.mjs --content       # 内容可用性审计
- *   node scripts/cli.mjs --sim           # 工作流模拟
- *   node scripts/cli.mjs --deps          # 依赖图分析
  *   node scripts/cli.mjs --route "<需求>" # 路由测试
- *   node scripts/cli.mjs --reindex       # 生成路由表索引
- *   node scripts/cli.mjs --scaffold <name> # 新建模块骨架
- *   node scripts/cli.mjs --all           # 全量审计（validate + audit + content + deps）
+ *   node scripts/cli.mjs --all           # 最小发布检查（validate + match batch）
  *   node scripts/cli.mjs --list          # 列出所有命令
  *
  * 运行时匹配器（AI 调用）：
@@ -21,13 +15,15 @@
  *   python scripts/match.py --batch
  */
 
-import { execSync } from "child_process";
+import { execFileSync } from "child_process";
 import path from "path";
 import { fileURLToPath } from "url";
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const ROOT = path.resolve(__dirname, "..");
 const NODE = process.execPath;
+const PYTHON = process.env.VUE3_SKILL_PYTHON || "python";
+const PYTHON_ARGS = [];
 
 const commands = {
   validate: {
@@ -35,50 +31,15 @@ const commands = {
     file: "validate.mjs",
     args: [],
   },
-  audit: {
-    desc: "命中精度审计：关键词重叠、命中盲区、模块评分、边界冲突",
-    file: "ai-match-audit.mjs",
-    args: [],
-  },
-  content: {
-    desc: "内容可用性审计：样板完整性、Must-do 清单、代码块完备性",
-    file: "ai-content-audit.mjs",
-    args: [],
-  },
-  sim: {
-    desc: "AI 工作流模拟：6 步端到端验证",
-    file: "ai-workflow-sim.mjs",
-    args: [],
-  },
-  deps: {
-    desc: "依赖图分析：断链引用、循环依赖、引用热度、孤立模块",
-    file: "analyze-deps.mjs",
-    args: [],
-  },
   route: {
     desc: "路由测试：对自然语言需求进行模块命中分析（使用 match.py）",
     cmd: "python",
     file: "match.py",
     args: "pass",
   },
-  reindex: {
-    desc: "生成路由表索引：从 frontmatter 自动生成 SKILL.md 路由表",
-    file: "generate-index.mjs",
-    args: [],
-  },
-  scaffold: {
-    desc: "新建模块骨架：自动生成 frontmatter + 标准结构",
-    file: "scaffold-module.mjs",
-    args: "pass",
-  },
-  "handoff-init": {
-    desc: "设计落地：初始化业务项目 .handoff/session.json",
-    file: "handoff-session-init.mjs",
-    args: "pass",
-  },
-  "handoff-check": {
-    desc: "设计落地：管控闸门（步骤 + JSON 规格）",
-    file: "handoff-governance.mjs",
+  handoff: {
+    desc: "设计交接：初始化或检查 handoff 状态",
+    file: "handoff.mjs",
     args: "pass",
   },
 };
@@ -90,14 +51,10 @@ function run(cmd, extraArgs = []) {
     process.exit(1);
   }
   const scriptPath = path.join(__dirname, cfg.file);
-  const runner = cfg.cmd === "python" ? "python" : `"${NODE}"`;
-  const quotedArgs = extraArgs.map(a => a.includes(" ") ? `"${a}"` : a).join(" ");
   try {
-    const result = execSync(`${runner} "${scriptPath}" ${quotedArgs}`, {
-      cwd: ROOT,
-      encoding: "utf-8",
-      stdio: "pipe",
-    });
+    const result = cfg.cmd === "python"
+      ? execFileSync(PYTHON, [...PYTHON_ARGS, scriptPath, ...extraArgs], { cwd: ROOT, encoding: "utf-8", stdio: "pipe" })
+      : execFileSync(NODE, [scriptPath, ...extraArgs], { cwd: ROOT, encoding: "utf-8", stdio: "pipe" });
     console.log(result);
   } catch (e) {
     if (e.stdout) console.log(e.stdout);
@@ -109,14 +66,14 @@ function run(cmd, extraArgs = []) {
 function listCommands() {
   console.log("\nvue3-temp-skill 脚本命令\n");
   console.log("运行时匹配器（AI 调用）:");
-  console.log("  python scripts/match.py \"<需求>\"     # 获取精确模块匹配");
-  console.log("  python scripts/match.py --batch        # 批量测试 15 场景\n");
+  console.log(`  ${process.platform === "win32" ? "py -3" : "python3"} scripts/match.py \"<需求>\"     # 获取精确模块匹配`);
+  console.log(`  ${process.platform === "win32" ? "py -3" : "python3"} scripts/match.py --batch        # 批量测试 15 场景\n`);
   console.log("开发与审计命令:");
   for (const [cmd, cfg] of Object.entries(commands)) {
     const argHint = cfg.args === "pass" ? " <参数>" : "";
-    console.log(`  node scripts/cli.mjs --${cmd.padEnd(10)} ${cfg.desc}`);
+    console.log(`  node scripts/cli.mjs --${cmd.padEnd(10)}${argHint} ${cfg.desc}`);
   }
-  console.log(`  node scripts/cli.mjs --all          全量审计（validate + audit + content + deps）`);
+  console.log(`  node scripts/cli.mjs --all          最小发布检查（validate）`);
   console.log(`  node scripts/cli.mjs --list          列出所有命令\n`);
 }
 
@@ -141,7 +98,7 @@ switch (flag) {
 
   case "all": {
     console.log("=== 全量审计 ===\n");
-    for (const cmd of ["validate", "audit", "content", "deps"]) {
+    for (const cmd of ["validate"]) {
       console.log(`\n--- ${cmd} ---\n`);
       try {
         run(cmd);

package/scripts/handoff.mjs

@@ -0,0 +1,108 @@
+#!/usr/bin/env node
+
+/**
+ * 设计交接的轻量工具。
+ *
+ * init: 校验 design-handoff/v1 并把状态放在用户目录。
+ * check: 校验状态和目标项目的关键接线，不要求无关文件全部变更。
+ */
+
+import { createHash } from "node:crypto";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { execFileSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const STATE_ROOT = path.join(os.homedir(), ".workbuddy", "state", "vue3-temp-skill");
+
+function parseArgs(argv) {
+  const result = { project: process.cwd(), file: null, stateDir: null, requireSession: false };
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg === "--project" && argv[i + 1]) result.project = path.resolve(argv[++i]);
+    else if (arg === "--file" && argv[i + 1]) result.file = path.resolve(argv[++i]);
+    else if (arg === "--state-dir" && argv[i + 1]) result.stateDir = path.resolve(argv[++i]);
+    else if (arg === "--require-session") result.requireSession = true;
+  }
+  const projectId = createHash("sha256").update(result.project.toLowerCase()).digest("hex").slice(0, 16);
+  result.stateDir ||= path.join(STATE_ROOT, projectId);
+  result.sessionPath = path.join(result.stateDir, "handoff.json");
+  return result;
+}
+
+function readJson(file) {
+  try {
+    // 设计工具导出的 JSON 常带 UTF-8 BOM，直接 parse 会失败
+    const raw = readFileSync(file, "utf8").replace(/^\uFEFF/, "");
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+
+function validateHandoff(handoff) {
+  const errors = [];
+  if (handoff?.$schema !== "design-handoff/v1") errors.push("需要 $schema: design-handoff/v1");
+  for (const key of ["meta", "shell", "geometry", "tokens"]) {
+    if (!handoff?.[key]) errors.push(`缺少 ${key}`);
+  }
+  if (handoff?.structureRequirements && !handoff?.interactionSpecs) errors.push("有 structureRequirements 时必须同时提供 interactionSpecs");
+  if (handoff?.tokens?.primaryScale && handoff.tokens.primaryScale.length !== 10) errors.push("tokens.primaryScale 必须为 10 项");
+  return errors;
+}
+
+function projectChecks(project, handoff) {
+  const checks = [];
+  const required = [
+    "package.json",
+    "src/layout/components/lay-navbar/index.vue",
+    "src/layout/components/lay-tag/index.vue",
+  ];
+  for (const rel of required) checks.push({ rel, ok: existsSync(path.join(project, rel)) });
+  if (handoff?.tokens) checks.push({ rel: "src/styles/design-tokens.scss", ok: existsSync(path.join(project, "src/styles/design-tokens.scss")) });
+  return checks;
+}
+
+function init(args) {
+  if (!args.file) throw new Error("handoff init 需要 --file <handoff.json>");
+  if (!existsSync(args.file)) throw new Error(`找不到 handoff 文件：${args.file}`);
+  const handoff = readJson(args.file);
+  if (handoff === null) throw new Error(`handoff 文件不是合法 JSON：${args.file}`);
+  const errors = validateHandoff(handoff);
+  if (errors.length) throw new Error(`handoff JSON 无效：${errors.join("；")}`);
+  mkdirSync(args.stateDir, { recursive: true });
+  writeFileSync(args.sessionPath, JSON.stringify({ version: 1, project: args.project, createdAt: new Date().toISOString(), handoff }, null, 2), "utf8");
+  console.log(`✓ 已初始化设计交接状态：${args.sessionPath}`);
+}
+
+function check(args) {
+  if (!existsSync(args.sessionPath)) {
+    if (args.requireSession) throw new Error("没有设计交接状态，请先执行 handoff init");
+    console.log("无设计交接状态，跳过检查");
+    return;
+  }
+  const state = readJson(args.sessionPath);
+  const errors = validateHandoff(state?.handoff);
+  const checks = projectChecks(args.project, state?.handoff);
+  const missing = checks.filter(item => !item.ok).map(item => item.rel);
+  if (missing.length) errors.push(`目标项目缺少关键文件：${missing.join(", ")}`);
+  if (errors.length) throw new Error(`handoff 检查失败：${errors.join("；")}`);
+  console.log(`✓ handoff 检查通过：${checks.length} 个关键接线已确认`);
+}
+
+function main() {
+  const [command = "check", ...rest] = process.argv.slice(2);
+  const args = parseArgs(rest);
+  if (command === "init") init(args);
+  else if (command === "check") check(args);
+  else throw new Error("用法：node scripts/handoff.mjs init|check --project <项目> [--file <handoff.json>] [--require-session]");
+}
+
+try {
+  main();
+} catch (error) {
+  console.error(`✗ ${error.message}`);
+  process.exit(1);
+}