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

package/README.md

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

package/SKILL.md

@@ -12,8 +12,8 @@ tags: [vue3, typescript, element-plus, vant, pinia, vite, unocss, crud, componen
 > 2. **始终加载** `core-kernel` + `project-inventory`（生成前必读）
 > 3. 加载命中的功能模块详细规范（`references/`）
 > 4. **以本 Skill 内示例为准编写代码**（复用已有封装；选型表指定的库勿擅自替换）
-> 5. **生成完成后强制执行 `code-quality` 闸门**（见工作流第 6 步）：重读清单 → 对照刚改文件自查 → 跑 `pnpm type-check` → 不通过就地修正 → 最终回复必须含「代码质量审查」结果块  
-> ⚠️ 仅在「命中模块」里写出 `code-quality` **不算**执行审查；没有审查结果块 = 任务未完成
+> 5. **生成完成后强制执行 `code-quality` 闸门**（见工作流第 6 步）：重读清单 → 对照刚改文件自查 → 必跑 `pnpm lint:fix` + `pnpm type-check` → 不通过就地修正 → 最终回复必须含「代码质量审查」结果块  
+> ⚠️ 仅在「命中模块」里写出 `code-quality` **不算**执行审查；没有审查结果块 = 任务未完成；只跑 type-check 未跑 lint:fix 也不算完成
 
 ---
 
@@ -63,7 +63,7 @@ tags: [vue3, typescript, element-plus, vant, pinia, vite, unocss, crud, componen
 
 | 模块 | 文件 | 职责 |
 |------|------|------|
-| **code-quality** | `references/code-quality.md` | **写完/改完代码之后**再执行：对照清单自查 + `pnpm type-check` + 输出审查结果块；失败则修正后重跑 |
+| **code-quality** | `references/code-quality.md` | **写完/改完代码之后**再执行：对照清单自查 + `pnpm lint:fix` + `pnpm type-check` + 输出审查结果块；失败则修正后重跑 |
 
 > `code-quality` **不要**只放进「命中模块」列表交差。它是闸门：生成前可预览清单，但**正式审查必须在落盘之后**，并在最终回复中可见。
 
@@ -246,8 +246,8 @@ reset();    // 重置（配合 formRef.resetFields）
 
 1. **重读** `references/code-quality.md`（生成后再读一次，不要只靠记忆）。
 2. **对照刚写入/修改的文件**逐项过清单（尤其：选型、HTTP/`Result`、列表布局、权限、无多余 console）。
-3. **跑命令**（在业务项目根目录）：优先 `pnpm type-check`；若项目有 `pnpm lint` 且改动含 `.vue/.ts`，尽量一并跑。失败则修代码后重跑，直到通过或明确阻塞原因。
-4. **就地修正**：审查发现的问题必须改完再进入第 7 步；禁止带着已知规范问题收工。
+3. **跑命令**（在业务项目根目录，**两项均必跑**）：先 `pnpm lint:fix`（无则 `pnpm lint` / `pnpm exec eslint . --fix`），再 `pnpm type-check`（无则 `pnpm exec vue-tsc --noEmit`）。失败则修代码后重跑两条，直到全部通过或明确阻塞原因。禁止只跑 type-check 就收工。
+4. **就地修正**：审查发现的问题必须改完再进入第 7 步；禁止带着已知规范 / lint 问题收工。
 5. **写入最终回复的「代码质量审查」结果块**（格式见下）；无此块视为任务未完成。
 
 #### 最终回复必含结构
@@ -259,7 +259,7 @@ reset();    // 重置（配合 formRef.resetFields）
 ## 代码质量审查
 - 闸门：已执行 code-quality（生成后）
 - 清单：选型 / 类型 / 组件 / API / 安全 / 业务 / 列表布局(如适用) / 风格 → 通过 | 已修正：…
-- 命令：`pnpm type-check` → 通过 | 失败原因…
+- 命令：`pnpm lint:fix` → 通过 | 失败原因…；`pnpm type-check` → 通过 | 失败原因…
 - 待确认：…
 
 ## 变更说明

package/package.json

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

package/references/code-quality.md

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