@qilitt-mickey/vue3-temp-skill 1.1.3 → 1.1.5

package/README.md

@@ -6,9 +6,10 @@ Vue 3 企业级中后台项目开发规范技能包 — 让 AI 按团队规范
 
 外置 AI Skill：`/vue3-temp-skill <需求>` → 自动命中模块 → 按项目约定生成 → 自查。
 
-**设计要点（v1.1）**：
+**设计要点**：
 
-- **始终加载** `core-kernel` + `project-inventory` + `code-quality`
+- **始终加载** `core-kernel` + `project-inventory`（生成前）
+- **生成后强制闸门** `code-quality`：重读清单 → 对照落盘文件 → `pnpm lint:fix` + `pnpm type-check` → 最终回复必须含「代码质量审查」结果块（仅列入命中模块不算完成）
 - **Vite / 脚本 / 入口不单独成 Skill**（工程摘要在 core-kernel）
 - **组件 / Hook 分核心与附加**，专项能力按需命中
 - 按 `references/` 内完整示例编写；复用已有封装；选型表指定库勿擅自替换（新依赖须待确认）
@@ -30,13 +31,18 @@ Vue 3 企业级中后台项目开发规范技能包 — 让 AI 按团队规范
 
 ## 模块一览
 
-### 始终加载
+### 始终加载（生成前）
 
 | 模块 | 覆盖 |
 |------|------|
 | core-kernel | 硬约束、壳、CRUD 积木、工程摘要 |
 | project-inventory | 库精确版本 / 组件 / Hook / 选型对照 / **第九节安装表** |
-| code-quality | 生成后审查 |
+
+### 生成后强制闸门
+
+| 模块 | 覆盖 |
+|------|------|
+| code-quality | 清单自查 + `pnpm lint:fix` + `pnpm type-check` + 最终回复「代码质量审查」结果块 |
 
 ### 标准业务面
 
@@ -85,11 +91,12 @@ npx @qilitt-mickey/vue3-temp-skill@latest install all
 
 ## 生成工作流（AI）
 
-1. 解析需求 → 命中路由表  
-2. 读 core-kernel + inventory + code-quality  
+1. 解析需求 → 命中**功能**路由表  
+2. 读 core-kernel + inventory（生成前）  
 3. **addon**：查业务 `package.json`，缺失则按 inventory 第九节精确版本征得确认后 `pnpm add`（含 `-D` 插件）  
-4. 读功能模块；仓库有实现则对齐，用 Skill 示例  
-5. 生成 → 审查 → 修正输出  
+4. 读功能模块；仓库有 Re*/Hook/utils 则复用，页面写法用 Skill 示例  
+5. 生成落盘  
+6. **强制闸门 code-quality**：重读清单 → 自查刚改文件 → `pnpm lint:fix` + `pnpm type-check` → 修正 → 最终回复输出「代码质量审查」结果块（缺块 / 缺 lint:fix = 未完成）  
 
 ## 源码位置
 

package/SKILL.md

@@ -8,11 +8,12 @@ tags: [vue3, typescript, element-plus, vant, pinia, vite, unocss, crud, componen
 # Vue 3 项目开发规范技能包
 
 > 用户通过 `/vue3-temp-skill` + 自然语言描述需求，AI 应当：
-> 1. 分析需求，按下方**模块路由表**命中模块（可多模块）
-> 2. **始终加载** `core-kernel` + `code-quality`（含资产索引）
+> 1. 分析需求，按下方**模块路由表**命中功能模块（可多模块）
+> 2. **始终加载** `core-kernel` + `project-inventory`（生成前必读）
 > 3. 加载命中的功能模块详细规范（`references/`）
 > 4. **以本 Skill 内示例为准编写代码**（复用已有封装；选型表指定的库勿擅自替换）
-> 5. 生成完毕后执行质量审查；有问题就地修正
+> 5. **生成完成后强制执行 `code-quality` 闸门**（见工作流第 6 步）：重读清单 → 对照刚改文件自查 → 必跑 `pnpm lint:fix` + `pnpm type-check` → 不通过就地修正 → 最终回复必须含「代码质量审查」结果块  
+> ⚠️ 仅在「命中模块」里写出 `code-quality` **不算**执行审查；没有审查结果块 = 任务未完成；只跑 type-check 未跑 lint:fix 也不算完成
 
 ---
 
@@ -51,13 +52,20 @@ tags: [vue3, typescript, element-plus, vant, pinia, vite, unocss, crud, componen
 
 ## 模块路由表（AI 内部匹配用）
 
-### 始终加载（无需关键词）
+### 始终加载（生成前必读）
 
 | 模块 | 文件 | 职责 |
 |------|------|------|
 | **core-kernel** | `references/core-kernel.md` | 硬约束、应用壳、CRUD 积木、工程摘要、资产分层 |
-| **code-quality** | `references/code-quality.md` | 生成后审查清单 |
-| **project-inventory** | `references/project-inventory.md` | 库/组件/Hook/工具/选型对照（随 core 一并查阅） |
+| **project-inventory** | `references/project-inventory.md` | 库/组件/Hook/工具/选型对照 |
+
+### 生成后强制闸门（不是「命中模块」，写完代码后必须单独执行）
+
+| 模块 | 文件 | 职责 |
+|------|------|------|
+| **code-quality** | `references/code-quality.md` | **写完/改完代码之后**再执行：对照清单自查 + `pnpm lint:fix` + `pnpm type-check` + 输出审查结果块；失败则修正后重跑 |
+
+> `code-quality` **不要**只放进「命中模块」列表交差。它是闸门：生成前可预览清单，但**正式审查必须在落盘之后**，并在最终回复中可见。
 
 ### 标准业务面（按需）
 
@@ -104,8 +112,8 @@ tags: [vue3, typescript, element-plus, vant, pinia, vite, unocss, crud, componen
 
 ### 匹配规则
 
-1. 单模块清晰 → 该模块 + 始终加载三件套。  
-2. 多模块组合 → 同时加载（例：带权限客户列表 = `crud-pages` + `permission-auth` + `http-api`）。  
+1. 单模块清晰 → 该模块 + 始终加载（core-kernel + project-inventory）；结束后跑 code-quality 闸门。  
+2. 多模块组合 → 同时加载功能模块（例：带权限客户列表 = `crud-pages` + `permission-auth` + `http-api`），结束后同样强制 code-quality。  
 3. 兜底 → 仅始终加载，并询问是否专项能力。  
 4. 业务开发默认**不**改 `vite.config.ts` / `build/**`；仅当用户明确要求改构建时，参考 `core-kernel` 工程摘要后再动。  
 5. **按用户说的效果匹配**（不要求用户懂代码/指令名）：  
@@ -205,12 +213,13 @@ reset();    // 重置（配合 formRef.resetFields）
 
 ### 1. 需求分析
 
-提取字段、查询、交互；按路由表列出模块 ID。
+提取字段、查询、交互；按路由表列出**功能**模块 ID（不含把 `code-quality` 当功能命中）。
 
-### 2. 加载规范
+### 2. 加载规范（生成前）
 
-- 必读：`core-kernel.md`、`project-inventory.md`、`code-quality.md`
+- 必读：`core-kernel.md`、`project-inventory.md`
 - 加读：命中的功能模块 md
+- 可顺带浏览 `code-quality.md` 约束，但**不能替代**第 6 步正式审查
 
 ### 3. 依赖与插件探查（命中 addon 时必做）
 
@@ -226,15 +235,40 @@ reset();    // 重置（配合 formRef.resetFields）
 
 ### 5. 生成代码
 
-完整可运行：类型、API、页面、路由片段（如需要）、样式约定。
+完整可运行：类型、API、页面、路由片段（如需要）、样式约定。  
+**本步结束后不得直接结束对话**，必须进入第 6 步。
+
+### 6. 自动质量审查闸门（强制 · 生成后）
 
-### 6. 自动质量审查（必须）
+> 目标：杜绝「命中了 code-quality 但没真正审查」的假完成。
 
-见下方清单；不通过则修正后再输出。
+按顺序执行（缺一不可）：
+
+1. **重读** `references/code-quality.md`（生成后再读一次，不要只靠记忆）。
+2. **对照刚写入/修改的文件**逐项过清单（尤其：选型、HTTP/`Result`、列表布局、权限、无多余 console）。
+3. **跑命令**（在业务项目根目录，**两项均必跑**）：先 `pnpm lint:fix`（无则 `pnpm lint` / `pnpm exec eslint . --fix`），再 `pnpm type-check`（无则 `pnpm exec vue-tsc --noEmit`）。失败则修代码后重跑两条，直到全部通过或明确阻塞原因。禁止只跑 type-check 就收工。
+4. **就地修正**：审查发现的问题必须改完再进入第 7 步；禁止带着已知规范 / lint 问题收工。
+5. **写入最终回复的「代码质量审查」结果块**（格式见下）；无此块视为任务未完成。
+
+#### 最终回复必含结构
+
+```markdown
+## 命中模块
+- <功能模块…>（勿把 code-quality 仅列在此处代替审查）
+
+## 代码质量审查
+- 闸门：已执行 code-quality（生成后）
+- 清单：选型 / 类型 / 组件 / API / 安全 / 业务 / 列表布局(如适用) / 风格 → 通过 | 已修正：…
+- 命令：`pnpm lint:fix` → 通过 | 失败原因…；`pnpm type-check` → 通过 | 失败原因…
+- 待确认：…
+
+## 变更说明
+- …
+```
 
 ### 7. 输出
 
-说明命中了哪些模块；列出待确认项（接口路径、字段类型、是否允许新依赖 / 是否已安装 addon）。
+在完成第 6 步结果块之后，再说明变更与待确认项（接口路径、字段类型、是否允许新依赖 / 是否已安装 addon）。
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qilitt-mickey/vue3-temp-skill",
-  "version": "1.1.3",
+  "version": "1.1.5",
   "description": "Vue 3 企业级中后台项目开发规范技能包 — core-kernel 架构、按需功能模块",
   "bin": {
     "vue3-temp-skill": "./bin/cli.js"

package/references/code-quality.md

@@ -1,14 +1,38 @@
 ---
 skill: code-quality
-description: AI 生成代码的质量审查清单。在生成或修改任何 Vue/TypeScript 代码后，必须对照此清单逐项自查，确保代码符合项目规范。适用于代码审查、AI 代码自检、Code Review 场景。
+description: 生成后强制质量闸门。写完/改完 Vue/TS 代码后必须重读本清单、对照落盘文件自查、必跑 lint:fix 与 type-check，并在最终回复输出「代码质量审查」结果块。仅把本模块列入命中模块不算完成。
 scope: project
-tags: [code-review, quality, checklist, lint, typescript, vue3, security, performance]
+tags: [code-review, quality, checklist, lint, typescript, vue3, security, performance, gate]
 ---
 
-# 代码质量审查清单
+# 代码质量审查清单（生成后强制闸门）
+
+> **何时执行**：任意 `/vue3-temp-skill` 任务在**文件已写入或修改之后**，结束对话前必须执行本闸门。  
+> **不算完成**：只在「命中模块」里写 `code-quality`；或只跑了 type-check / 未跑 `lint:fix`；或未对照本清单；或最终回复无「代码质量审查」结果块。  
+> **须按** Skill 功能模块示例 + 本清单审查；不通过必须修正后再收工。
+
+## 强制执行协议（AI 必须按序做）
+
+1. **重读本文件**（生成后再读，禁止仅凭开场记忆勾选）。
+2. **列出本轮改动文件路径**，逐文件对照下方清单相关项。
+3. **执行命令**（业务项目根目录，**两项均必跑，缺一不可**）：
+   - 必跑：`pnpm lint:fix`（自动修复可修问题；若无该脚本则用 `pnpm lint`，再无则 `pnpm exec eslint . --fix`）
+   - 必跑：`pnpm type-check`（若无该脚本则用 `pnpm exec vue-tsc --noEmit`）
+   - 顺序建议：先 `lint:fix`，再 `type-check`（lint 可能改写文件，须以最终落盘结果过类型检查）
+4. **失败则修代码 → 重跑上述两条命令**，直到全部通过或写出明确阻塞（缺依赖、环境等）。`lint:fix` 后仍有无法自动修复的报错，必须手改后再跑，禁止跳过。
+5. **在最终回复追加结果块**（缺此块 = 未完成）：
+
+```markdown
+## 代码质量审查
+- 闸门：已执行 code-quality（生成后）
+- 改动文件：`path/a`、`path/b`、…
+- 清单：选型 ✅ / 类型 ✅ / 组件 ✅ / API ✅ / 安全 ✅ / 业务 ✅ / 列表布局 ✅或N/A / 风格 ✅
+- 已修正：…（无则写「无」）
+- 命令：`pnpm lint:fix` → 通过 | 失败：…；`pnpm type-check` → 通过 | 失败：…
+- 待确认：…
+```
 
-> **使用说明**：生成或修改代码后逐项对照。不通过必须修正后再输出。  
-> 须按 Skill 模块内示例与本清单审查。
+---
 
 ## 〇、项目选型（最高优先级）
 
@@ -253,25 +277,28 @@ const fullName = computed(() => `${user.firstName} ${user.lastName}`);
 
 ## 审查流程
 
-1. **生成代码后**：逐项对照以上清单。
-2. **发现问题**：立即修正，不要输出有问题的代码。
-3. **不确定项**：标注 `// TODO: 需要确认` 注释提醒开发者。
-4. **严重问题**：如果存在安全漏洞或类型错误，必须修正后再输出。
+1. **生成/改码落盘之后**（不是生成前）：执行上方「强制执行协议」。
+2. **发现问题**：立即修正并重跑 `pnpm lint:fix` + `pnpm type-check`，不要带着已知问题收工。
+3. **不确定项**：写入结果块「待确认」，必要时在代码加 `// TODO: 需要确认`。
+4. **严重问题**（安全 / 类型错误 / lint 报错 / 列表布局硬约束违反）：必须修正后再输出最终回复。
+5. **最终回复**：必须含「代码质量审查」结果块；禁止只用「命中模块含 code-quality」代替。
 
 ## 快速自检命令
 
-完成代码修改后，运行以下命令验证：
+完成代码修改后，运行以下命令验证（**均必跑**）：
 
 ```bash
-# TypeScript 类型检查
-npx vue-tsc --noEmit
+# 必跑：Lint 自动修复（优先用项目脚本）
+pnpm lint:fix
 
-# ESLint 检查
-npx eslint src/ --ext .vue,.ts,.tsx
+# 必跑：TypeScript 类型检查（优先用项目脚本）
+pnpm type-check
 
-# Stylelint 检查
-npx stylelint "src/**/*.{css,scss,vue}"
-
-# 全量检查（推荐）
+# 无 lint:fix 时的回退
 pnpm lint
+# 或
+pnpm exec eslint . --fix
+
+# 无 type-check 脚本时的回退
+pnpm exec vue-tsc --noEmit
 ```

package/references/core-kernel.md

@@ -359,7 +359,7 @@ function handleSizeChange(size: number) {
 
 | 项 | 说明 |
 |----|------|
-| 包管理 | pnpm；脚本 `dev` / `build` / `type-check` / `lint` |
+| 包管理 | pnpm；脚本 `dev` / `build` / `type-check` / `lint` / `lint:fix`（质量闸门必跑后两者） |
 | 默认插件 | Vue/JSX、AutoImport、SVG、UnoCSS、Favicon、Mock(`VITE_USE_MOCK`)、Gzip、Visualizer、混淆、DevTools |
 | 去 console | `build/build.ts`：非 `VITE_DEBUGGER` 时 Terser `drop_console`（**无** vite-plugin-remove-console） |
 | 功能附属插件 | FileViewer → `file-management`；vConsole → `mobile-h5`；精确版本与 `pnpm` 命令见 `project-inventory` 第九节 |