@qilitt-mickey/vue3-temp-skill 1.1.33 → 1.1.35

package/README.md

@@ -115,29 +115,31 @@ npx @qilitt-mickey/vue3-temp-skill@latest install all
 
 ### 设计落地（可选）
 
-handoff JSON 可以来自对话、临时文件或管道。状态默认保存在用户级状态目录，**不在业务项目创建 `.handoff/`**：
+本技能是**通用**的，不依赖任何宿主目录。状态默认保存在**项目内 `.design-handoff/`**，便于随项目携带和跨环境复用。
 
-- 默认路径：`~/.workbuddy/state/vue3-temp-skill/<项目哈希>/handoff.json`
-- Windows 示例：`%USERPROFILE%\.workbuddy\state\vue3-temp-skill\<项目哈希>\handoff.json`
+设计技能产出两类内容（均为标准产出，不一定落盘）：
+
+- **设计 HTML**：完整自包含页面，AI 直接阅读获取精确 px 值
+- **`design-handoff/v1` JSON**：结构化契约，是工程落地的机器输入
+
+`handoff.mjs` 不解析 HTML，只读 JSON 契约 + 扫描真实项目当前态，生成可执行的实施 diff。
 
 ```bash
-# 动手前：校验 JSON 规格并建立 session
+# 1) 生成实施计划（读 JSON + 扫描项目，输出 Markdown diff）
+node scripts/handoff.mjs plan --project ./my-vue-app --design-json C:/temp/handoff.json
+# 也可直接指向设计 HTML 作为视觉参照：追加 --design-html C:/temp/design.html
+# 不传 --design-json 时，按序自动发现：<项目>/.design-handoff/handoff.json、<项目>/design/design-handoff.json
+
+# 2) 动手前：校验 JSON 规格并建立 session（可选）
 node scripts/handoff.mjs init  --project ./my-vue-app --file C:/temp/handoff.json
 
-# 落地后：确认关键接线存在
+# 3) 落地后：确认关键接线存在
 node scripts/handoff.mjs check --project ./my-vue-app --require-session
 ```
 
-也支持显式指定状态目录（适合 CI 或多工作区）：追加 `--state-dir <项目外状态目录>`。
-
-通过 npm 包 CLI：
-
-```bash
-npx @qilitt-mickey/vue3-temp-skill handoff init  --project ./my-vue-app --file C:/temp/handoff.json
-npx @qilitt-mickey/vue3-temp-skill handoff check --project ./my-vue-app --require-session
-```
+显式指定状态目录：追加 `--state-dir <目录>`（默认 `<项目>/.design-handoff/`）。
 
-`handoff.mjs` 只做两件事：确认 JSON 规格完整，确认目标项目存在落地所需关键接线。它不统计改动文件数量，也不要求全项目遍历。
+`handoff.mjs` 职责：`plan` 生成逐区域改动清单；`init/check` 只确认 JSON 规格完整 + 目标项目存在关键接线。它不统计改动文件数量，也不要求全项目遍历。
 
 ## 与模版的关系
 

package/SKILL.md

@@ -75,9 +75,11 @@ tags: [vue3, typescript, element-plus, pinia, vite, unocss, crud, demo, code-qua
 
 ### 4. 设计交接
 
-- 发现 `$schema: design-handoff/v1` 后，读取 `references/design-handoff.md`。
-- 动手前初始化 handoff session；设计决定视觉、结构和交互意图，本技能只负责映射到真实模板并保留业务逻辑。
+- 发现 `$schema: design-handoff/v1` 或设计 HTML 后，读取 `references/design-handoff.md`。
+- **先跑 `node scripts/handoff.mjs plan --project <项目> [--design-json <path>] [--design-html <path>]`** 生成逐区域实施 diff；AI 按 diff 顺序改代码，设计 HTML 作为精确 px 值的视觉参照（AI 直接读，本技能不解析 HTML）。
+- 动手前可选 `handoff init` 保存当次规格；设计决定视觉、结构和交互意图，本技能只负责映射到真实模板并保留业务逻辑。
 - 只修改 handoff 明确覆盖的文件和页面；不为通过检查虚构修改、不强制全项目遍历。
+- 业务按钮（如「增加一行可编辑数据」「表格提交」）只调样式/位置，绝不删除。
 - 项目级视觉改造只有在用户明确要求时才执行；单页 Demo 默认只处理当前页面及必要共享组件。
 
 ### 5. 验证与交付

package/bin/cli.js

@@ -348,7 +348,8 @@ ${bold("命令:")}
   update [target]     更新已安装的技能（默认更新全部已安装目标）
   uninstall [target]  卸载技能（默认卸载全部已安装目标）
   list                查看已安装的目标和版本
-  handoff init        校验 handoff JSON 规格，在用户级目录建立会话（不污染业务项目）
+  handoff init        校验 handoff JSON 规格，在项目内 .design-handoff/ 建立会话
+  handoff plan        读 JSON + 扫描项目，生成逐区域实施 diff（Markdown）
   handoff check       确认目标项目存在设计落地所需的关键接线
 
 ${bold("目标 (target):")}
@@ -614,19 +615,32 @@ function cmdHandoff(sub, args, projectDir) {
   const requireSession = args.includes("--require-session");
   const scriptDir = path.join(SKILL_DIR, "scripts");
 
-  if (sub !== "init" && sub !== "check") {
-    console.error(red("✗ handoff 子命令: init | check"));
+  if (sub !== "init" && sub !== "check" && sub !== "plan") {
+    console.error(red("✗ handoff 子命令: init | check | plan"));
     console.error(dim("  handoff init  --project <dir> --file <handoff.json> [--state-dir <dir>]"));
     console.error(dim("  handoff check --project <dir> [--state-dir <dir>] [--require-session]"));
-    console.error(dim("  默认状态目录见 README.md「设计落地」"));
+    console.error(dim("  handoff plan  --project <dir> [--design-json <path>] [--design-html <path>] [--view <path>]"));
+    console.error(dim("  默认状态目录：<项目>/.design-handoff/（通用，不依赖宿主）"));
     process.exit(1);
   }
 
+  const designJsonIdx = args.indexOf("--design-json");
+  const designJson = designJsonIdx !== -1 ? path.resolve(args[designJsonIdx + 1]) : null;
+  const designHtmlIdx = args.indexOf("--design-html");
+  const designHtml = designHtmlIdx !== -1 ? path.resolve(args[designHtmlIdx + 1]) : null;
+  const viewIdx = args.indexOf("--view");
+  const view = viewIdx !== -1 ? path.resolve(args[viewIdx + 1]) : null;
+
   const script = path.join(scriptDir, "handoff.mjs");
   const childArgs = [script, sub, "--project", proj];
   if (sub === "init" && handoffFile) childArgs.push("--file", handoffFile);
   if (stateDir) childArgs.push("--state-dir", stateDir);
   if (sub === "check" && requireSession) childArgs.push("--require-session");
+  if (sub === "plan") {
+    if (designJson) childArgs.push("--design-json", designJson);
+    if (designHtml) childArgs.push("--design-html", designHtml);
+    if (view) childArgs.push("--view", view);
+  }
 
   try {
     execFileSync(process.execPath, childArgs, { stdio: "inherit" });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qilitt-mickey/vue3-temp-skill",
-  "version": "1.1.33",
+  "version": "1.1.35",
   "description": "Vue 3 企业级中后台项目开发规范技能包 — core-kernel 架构、按需功能模块",
   "bin": {
     "vue3-temp-skill": "./bin/cli.js"
@@ -25,6 +25,7 @@
     "release:major": "node release.js major",
     "check": "node scripts/check.mjs",
     "prepack": "node scripts/check.mjs",
+    "audit": "node scripts/field-schema-audit.mjs",
     "validate": "node scripts/validate.mjs",
     "match": "python scripts/match.py",
     "match:batch": "python scripts/match.py --batch",

package/references/addon-enable.md

@@ -1,5 +1,5 @@
 ---
-skill: addon-enable
+name: addon-enable
 description: 精简模板 addon 启用手册。记录出厂删除的依赖及须恢复的每一处代码/配置；命中 chart/vant/file-viewer 等 addon 或装依赖时必读。
 scope: project
 tags: [addon, enable, restore, tsconfig, vant, echarts, file-viewer, slim-template]

package/references/api-check.md

@@ -1,5 +1,5 @@
 ---
-skill: api-check
+name: api-check
 description: 前后端接口联调核对清单。对接后端或生成 API 后对照契约；写法细则见 http-api。
 scope: project
 tags: [api, backend, integration, contract, http, checklist, mock]

package/references/auth-pages.md

@@ -1,5 +1,5 @@
 ---
-skill: auth-pages
+name: auth-pages
 description: 登录/注册/忘记密码认证流程、API 模式、userStore 集成、路由配置
 scope: project
 tags: [登录, 注册, 忘记密码, 重置密码, 认证, auth, login, register, signup, forgot-password, 找回密码]

package/references/base-code-dict.md

@@ -1,5 +1,5 @@
 ---
-skill: base-code-dict
+name: base-code-dict
 description: 基础代码字典获取、缓存、useApp().baseCodeGet、filterValue
 scope: project
 tags: [字典, baseCode, 码表, 下拉字典, 数据字典]

package/references/chart-echarts.md

@@ -1,5 +1,5 @@
 ---
-skill: chart-echarts
+name: chart-echarts
 description: ECharts 图表与 ReEchart 封装。词云等扩展按项目依赖。
 scope: project
 tags: [echarts, ReEchart, chart, wordcloud, 折线图, 柱状图, 饼图, 统计图, 雷达图, 散点图, 热力图, 趋势图, 地图, 甘特图, K线图]

package/references/code-quality.md

@@ -1,5 +1,5 @@
 ---
-skill: code-quality
+name: code-quality
 description: 生成后强制质量闸门。写完/改完代码后重读本清单、对照落盘文件、必跑 lint:fix 与 type-check，最终回复含「代码质量审查」结果块。
 scope: project
 tags: [code-review, quality, checklist, lint, typescript, vue3, security, performance, gate]

package/references/core-kernel.md

@@ -1,5 +1,5 @@
 ---
-skill: core-kernel
+name: core-kernel
 description: 始终加载的架构内核。硬约束、应用壳摘要、样式契约、工程摘要。业务开发前必读。
 scope: project
 tags: [vue3, kernel, conventions, layout, router, http, crud, inventory]