@qilitt-mickey/vue3-temp-skill 1.1.29 → 1.1.30
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +8 -7
- package/SKILL.md +19 -23
- package/package.json +1 -1
- package/references/code-quality.md +22 -20
- package/references/core-kernel.md +2 -12
- package/references/design-handoff.md +795 -939
- package/references/design-system.md +1 -1
- package/references/design-verify.md +314 -0
- package/references/layout-theme.md +1 -1
- package/scripts/analyze-deps.mjs +1 -1
- package/scripts/generate-index.mjs +2 -2
- package/scripts/modules.json +11 -1
- package/scripts/validate.mjs +3 -3
package/README.md
CHANGED
|
@@ -33,7 +33,7 @@ Vue 3 企业级中后台项目开发规范技能包 — 按团队规范生成代
|
|
|
33
33
|
| 始终 | core-kernel |
|
|
34
34
|
| 闸门 | code-quality |
|
|
35
35
|
| 按需资产 | project-inventory、**addon-enable** |
|
|
36
|
-
| 标准业务 | http-api、crud-pages、detail-page、data-writeback、permission-auth、layout-theme、design-system、design-handoff、icons、feedback-loading、base-code-dict、api-check、ui-components |
|
|
36
|
+
| 标准业务 | http-api、crud-pages、detail-page、data-writeback、permission-auth、layout-theme、design-system、design-handoff、design-verify、icons、feedback-loading、base-code-dict、api-check、ui-components |
|
|
37
37
|
| 专项 | form-advanced、table-vxe、tree-table、chart-echarts、file-management、download-export、rich-text、graph-relation、workflow-bpmn、flowchart-g6、data-mapping、websocket-realtime、mobile-h5、wechat-js、verify-captcha、qrcode-barcode、feedback-ui、seamless-scroll、particles、data-compare、data-screen、directives-advanced |
|
|
38
38
|
|
|
39
39
|
## 安装
|
|
@@ -44,11 +44,12 @@ Node.js >= 22.12.0
|
|
|
44
44
|
npx @qilitt-mickey/vue3-temp-skill@latest install all
|
|
45
45
|
```
|
|
46
46
|
|
|
47
|
-
| 目标 |
|
|
48
|
-
|
|
49
|
-
|
|
|
50
|
-
|
|
|
51
|
-
|
|
47
|
+
| 目标 | 说明 |
|
|
48
|
+
|------|------|
|
|
49
|
+
| 个人 Skill 目录 | 安装器写入当前 AI 环境支持的 Skill 目录 |
|
|
50
|
+
| 项目级说明 | 部分环境支持写入项目内说明文件 |
|
|
51
|
+
|
|
52
|
+
具体路径因 AI 环境而异,安装完成后以安装器输出为准。
|
|
52
53
|
|
|
53
54
|
## 生成工作流(AI)
|
|
54
55
|
|
|
@@ -73,4 +74,4 @@ npx @qilitt-mickey/vue3-temp-skill@latest install all
|
|
|
73
74
|
- **标准样板**:在本包 `references/`,不在模板 `views/`
|
|
74
75
|
- 壳层以当前项目源码为准;规范与安装表以本包为准
|
|
75
76
|
- HTTP:`axios@1.19.0` 固定版本,仅经 `@/utils/http`
|
|
76
|
-
-
|
|
77
|
+
- **设计协同**:定制 UI 由**设计技能**出稿(含 `design-handoff/v1` JSON)→ 本 Skill 工程落地;不引入其他设计 Skill
|
package/SKILL.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: vue3-temp-skill
|
|
3
|
-
description: Vue 3 企业级中后台项目开发规范技能包。用户通过 /vue3-temp-skill 命令描述需求,AI 自动匹配对应规范模块生成代码,并在生成后自动执行代码质量审查。
|
|
2
|
+
name: "vue3-temp-skill"
|
|
3
|
+
description: "Vue 3 企业级中后台项目开发规范技能包。用户通过 /vue3-temp-skill 命令描述需求,AI 自动匹配对应规范模块生成代码,并在生成后自动执行代码质量审查。"
|
|
4
4
|
scope: project
|
|
5
5
|
tags: [vue3, typescript, element-plus, vant, pinia, vite, unocss, crud, component, api, permission, mobile, code-review, compare]
|
|
6
6
|
---
|
|
@@ -44,11 +44,11 @@ tags: [vue3, typescript, element-plus, vant, pinia, vite, unocss, crud, componen
|
|
|
44
44
|
|
|
45
45
|
- 面向由 **vue3-web-temp** 脚手架搭出的业务项目(目录名/安装路径因人而异,以当前工作区为准)
|
|
46
46
|
- **文档分工**:人类读模板 `README.md`;AI 读模板 `AGENTS.md` + 本 Skill;样板与细则在本包 `references/`
|
|
47
|
-
-
|
|
47
|
+
- **设计协同**:定制 UI 由**设计技能**出稿(含 `design-handoff/v1` JSON)→ 本 Skill 工程落地;不引入其他设计 Skill
|
|
48
48
|
- **精简出厂**:模板 `views/` 仅保留登录/首页等壳页面;**业务标准样板**在本包 `references/`(如 `crud-pages`、`detail-page`)
|
|
49
49
|
- **依赖分层**:`package.json` 仅 **core**;**addon** 默认不装;缺包时装依赖后须按 `addon-enable.md` **逐文件恢复配置**(非自动)
|
|
50
50
|
- 壳层行为(顶部 tag / 侧栏 / keep-alive / `useDetail`)以**当前项目**已有实现为准
|
|
51
|
-
- **双轨**:无设计 handoff → 保持模版出厂;有设计落地 → 读 `design-handoff.md` 逐文件修改清单(含 1:1 还原要求 F1-F14 / P1-P7
|
|
51
|
+
- **双轨**:无设计 handoff → 保持模版出厂;有设计落地 → 读 `design-handoff.md` 逐文件修改清单(含 1:1 还原要求 F1-F14 / P1-P7)+ `design-verify.md` 还原度验证
|
|
52
52
|
- **设计优先级**:当设计技能产出(`design-handoff/v1` JSON)存在时,视觉层面(布局/间距/圆角/阴影/色彩/组件结构)以设计技能产出为准,本技能出厂默认值按设计产出替换。详见下方「设计优先级与 handoff 强制执行」段
|
|
53
53
|
|
|
54
54
|
## 使用方式
|
|
@@ -65,7 +65,6 @@ tags: [vue3, typescript, element-plus, vant, pinia, vite, unocss, crud, componen
|
|
|
65
65
|
4. 无对应能力 → 标注「待确认」,未经同意不引入新依赖
|
|
66
66
|
5. 权威性优先级:`仓库已有封装` > `本 Skill 示例` > 通用 Vue 习惯
|
|
67
67
|
6. 命中 addon / 缺依赖:读 `project-inventory` 第九/十节 + **`addon-enable.md`**(逐文件恢复代码);精确版本安装,禁止 `@latest`
|
|
68
|
-
7. **`docs/**` 不参与业务落盘**:模板 `docs/` 为静态文档/演示说明,禁止随 `src/` 等业务改动同步修改;仅用户明确要求维护文档时才改
|
|
69
68
|
|
|
70
69
|
## 完整性守则(全模块强制)
|
|
71
70
|
|
|
@@ -78,7 +77,7 @@ tags: [vue3, typescript, element-plus, vant, pinia, vite, unocss, crud, componen
|
|
|
78
77
|
|
|
79
78
|
## 设计落地(handoff)
|
|
80
79
|
|
|
81
|
-
|
|
80
|
+
设计技能每次产出时**始终自动附加 `design-handoff/v1` JSON**。本技能检测到 JSON 后**强制加载** `references/design-handoff.md`,按 C/T/F/Co/S/P 六步全流程执行(配置→令牌→框架→共享组件→样式→页面),**任一步跳过 = 硬失败**。执行完毕后**强制加载** `references/design-verify.md` 逐项验证还原度(区域级 + 逐属性 CSS 校验)。设计产出优先级高于本技能出厂默认值,页面保留业务逻辑、重写视觉结构。用户无需提及「JSON」或「handoff」——这是两技能间的自动协议。完整规则与逐项清单见 `design-handoff.md`,验证流程见 `design-verify.md`。
|
|
82
81
|
|
|
83
82
|
### 项目级模式 vs 单页模式
|
|
84
83
|
|
|
@@ -100,17 +99,14 @@ tags: [vue3, typescript, element-plus, vant, pinia, vite, unocss, crud, componen
|
|
|
100
99
|
|
|
101
100
|
设计 skill 定义了"表格工具栏""操作列""导航栏"等设计概念,本技能通过映射表自动找到项目中对应的组件进行修改。映射表见 `design-handoff.md` 第八章(共享组件级落地)。共享组件在 Co 步骤(F 步骤之后、S 步骤之前)统一修改,**一处修改,全局生效**,不需要在每个页面重复处理。
|
|
102
101
|
|
|
103
|
-
###
|
|
102
|
+
### 设计产出落盘范围
|
|
104
103
|
|
|
105
|
-
|
|
106
|
-
-
|
|
107
|
-
-
|
|
108
|
-
- ❌
|
|
109
|
-
- ✅ 设计修改只落在 `src/`、`public/`、`platform-config.json` 等业务代码中
|
|
110
|
-
- ✅ 设计规范直接读取设计 skill 的 references 文件,不另存
|
|
111
|
-
- ✅ 设计产出 HTML 仅在对话中作为参考对照,不写入项目
|
|
104
|
+
设计落地时,所有修改只落在 `src/`、`public/`、`platform-config.json` 等业务代码中:
|
|
105
|
+
- ✅ 设计规范读取**设计技能**的 `references/` 文件,不另存到项目
|
|
106
|
+
- ✅ 设计产出 HTML 仅在对话中作为参考对照,**不写入项目文件**
|
|
107
|
+
- ❌ 不得把设计 HTML / 规范文档写入项目内非业务目录
|
|
112
108
|
|
|
113
|
-
|
|
109
|
+
违反此规则即硬失败。
|
|
114
110
|
|
|
115
111
|
## 模块路由表
|
|
116
112
|
|
|
@@ -127,7 +123,7 @@ tags: [vue3, typescript, element-plus, vant, pinia, vite, unocss, crud, componen
|
|
|
127
123
|
| addon / 查 Re* 名 / 装依赖 | `references/project-inventory.md` |
|
|
128
124
|
| **启用精简模板已删的 addon(装包 + 改配置)** | `references/addon-enable.md`(与功能模块同读) |
|
|
129
125
|
| 写完代码后(闸门,非功能命中) | `references/code-quality.md` |
|
|
130
|
-
| 设计交接块 / **design-handoff/v1 JSON** / 上游令牌产出落地 | `references/design-handoff.md`(逐文件修改清单)+ `design-system.md`(项目设计系统说明) |
|
|
126
|
+
| 设计交接块 / **design-handoff/v1 JSON** / 上游令牌产出落地 | `references/design-handoff.md`(逐文件修改清单)+ `design-verify.md`(还原度验证)+ `design-system.md`(项目设计系统说明) |
|
|
131
127
|
| **设计模式**(设计 Skill 产出存在时触发) | `crud-pages.md` 设计模式样板 + `design-handoff.md` 1:1 还原要求(F1-F14 / P1-P7) |
|
|
132
128
|
|
|
133
129
|
### 标准业务面
|
|
@@ -181,7 +177,7 @@ tags: [vue3, typescript, element-plus, vant, pinia, vite, unocss, crud, componen
|
|
|
181
177
|
1. 单模块 → 该模块 + `core-kernel`;结束后执行 `code-quality`
|
|
182
178
|
2. 多模块 → 同时加载(例:客户列表 = `crud-pages` + `permission-auth` + `http-api`)
|
|
183
179
|
3. 未命中模块 → 仅 `core-kernel`,向用户确认是否专项
|
|
184
|
-
4. 默认不改 `vite.config.ts` / `build
|
|
180
|
+
4. 默认不改 `vite.config.ts` / `build/**`;**例外**:按 `addon-enable.md` 恢复 FileViewer / VantResolver / Vconsole 等占位插件时允许改 `build/plugins/*`
|
|
185
181
|
5. 效果匹配:
|
|
186
182
|
- 启用 echarts / vant / file-viewer / 富文本等已删 addon → 功能模块 + **`addon-enable`**
|
|
187
183
|
- 弹窗、对话框、抽屉 → `form-advanced`
|
|
@@ -203,7 +199,7 @@ tags: [vue3, typescript, element-plus, vant, pinia, vite, unocss, crud, componen
|
|
|
203
199
|
- 批量操作、表格排序 → `crud-pages`
|
|
204
200
|
- 趋势图、地图、甘特图 → `chart-echarts`
|
|
205
201
|
- 附件上传、断点续传 → `file-management`
|
|
206
|
-
- 按 XX / UI 规范适配、设计交接块、整站风格重构 → `design-system`(项目设计系统说明)+ `layout-theme`;有令牌/交接产出时加读 `design-handoff.md`(逐文件修改清单,含 C/T/F/Co/S/P 全流程 + 共享组件映射 +
|
|
202
|
+
- 按 XX / UI 规范适配、设计交接块、整站风格重构 → `design-system`(项目设计系统说明)+ `layout-theme`;有令牌/交接产出时加读 `design-handoff.md`(逐文件修改清单,含 C/T/F/Co/S/P 全流程 + 共享组件映射 + 项目级模式)+ `design-verify.md`(还原度验证)
|
|
207
203
|
- 列表→独立详情/编辑页 → `crud-pages` + `detail-page`
|
|
208
204
|
- 图表(折线/柱状/饼图) → `chart-echarts`
|
|
209
205
|
- 数据大屏、看板 → `data-screen`
|
|
@@ -227,7 +223,7 @@ tags: [vue3, typescript, element-plus, vant, pinia, vite, unocss, crud, componen
|
|
|
227
223
|
## 工作流
|
|
228
224
|
|
|
229
225
|
1. **需求分析**:列出功能模块 ID(不含 `code-quality`)
|
|
230
|
-
2. **加载**:`core-kernel` + 命中模块;addon/缺包时加读 `project-inventory` + **`addon-enable`**;**检测 design-handoff/v1 JSON 是否存在** — 若存在,强制加载 `design-handoff`(逐文件修改清单,含 C/T/F/Co/S/P 全流程 + 共享组件映射 + 项目级模式)+ `design-system.md`,并按设计产出优先级执行
|
|
226
|
+
2. **加载**:`core-kernel` + 命中模块;addon/缺包时加读 `project-inventory` + **`addon-enable`**;**检测 design-handoff/v1 JSON 是否存在** — 若存在,强制加载 `design-handoff`(逐文件修改清单,含 C/T/F/Co/S/P 全流程 + 共享组件映射 + 项目级模式)+ `design-verify`(还原度验证)+ `design-system.md`,并按设计产出优先级执行
|
|
231
227
|
3. **模式判断**:有 handoff JSON 时,读取 `meta.transformScope`:
|
|
232
228
|
- `project` → 进入**项目级模式**:先扫描 `src/router/modules/` 构建页面清单,输出「待改造页面清单」供用户确认
|
|
233
229
|
- `single-page` 或未设置 → 单页模式,仅处理当前页面
|
|
@@ -237,11 +233,10 @@ tags: [vue3, typescript, element-plus, vant, pinia, vite, unocss, crud, componen
|
|
|
237
233
|
- 单页模式:C/T/F/Co/S + 当前页面 P 步骤
|
|
238
234
|
- 项目级模式:C/T/F/Co/S(全局一次) + 逐页面执行 P 步骤,标记完成状态
|
|
239
235
|
- **有 handoff JSON 时,页面结构以设计输出为准,保留业务逻辑**
|
|
240
|
-
|
|
241
|
-
7. **设计还原度验证**:有 handoff JSON 时必须执行,按 `design-handoff.md` 第十章逐区域逐元素对照设计规范验证,输出「设计还原度验证报告」,未通过项必须修正
|
|
236
|
+
7. **设计还原度验证**:有 handoff JSON 时必须执行,加载 `design-verify.md` 按其流程逐区域逐元素对照设计规范验证(10.1-10.7 区域级 + 10.8 逐属性 CSS 校验),输出「设计还原度验证报告」+「逐属性 CSS 校验报告」,未通过项必须修正
|
|
242
237
|
8. **功能完整性核查**:有 handoff JSON 时必须执行,按 `design-handoff.md` 第十一章逐项核查功能是否正常(框架/共享组件/页面),样式改造不得破坏原有功能,发现问题立即修正
|
|
243
238
|
9. **code-quality**:按 `references/code-quality.md` 执行;**有 handoff JSON 时,额外执行 handoff 落地完整性校验**(项目级模式需校验全页面完成度 + 共享组件修改 + 设计还原度 + 功能完整性)
|
|
244
|
-
10. **输出**:变更说明(含已改配置文件列表)+ 设计还原度验证报告 + 功能完整性核查报告 + 待确认项;**项目级模式未全部完成时,输出进度 + 待改造页面清单 + 「继续」指令提示**
|
|
239
|
+
10. **输出**:变更说明(含已改配置文件列表)+ 设计还原度验证报告 + 逐属性 CSS 校验报告 + 功能完整性核查报告 + 待确认项;**项目级模式未全部完成时,输出进度 + 待改造页面清单 + 「继续」指令提示**
|
|
245
240
|
|
|
246
241
|
### 最终回复结构
|
|
247
242
|
|
|
@@ -253,7 +248,8 @@ tags: [vue3, typescript, element-plus, vant, pinia, vite, unocss, crud, componen
|
|
|
253
248
|
- 闸门:已执行 code-quality(生成后)
|
|
254
249
|
- 清单:选型 / 类型 / 组件 / API / 安全 / 业务 / 列表→详情(如适用) / 列表布局(如适用) / 风格 / addon启用(如适用) → 通过 | 已修正:…
|
|
255
250
|
- 硬失败:无 | 已拦截并修正:…
|
|
256
|
-
- handoff 落地(如有 JSON):C/T/F/S/P 全流程已执行 → 通过 | 未完成项:…(硬失败)
|
|
251
|
+
- handoff 落地(如有 JSON):C/T/F/Co/S/P 全流程已执行 → 通过 | 未完成项:…(硬失败)
|
|
252
|
+
- 还原度验证(如有 JSON):design-verify.md 区域级 + 逐属性校验已执行 → 通过 | 偏差项:…(已修正 / 待确认)
|
|
257
253
|
- 命令:`pnpm lint:fix` → …;`pnpm type-check` → …
|
|
258
254
|
- 待确认:…
|
|
259
255
|
|
package/package.json
CHANGED
|
@@ -126,26 +126,28 @@ lint / type-check **过了也不能放过**下列项。发现即改代码,禁
|
|
|
126
126
|
- [ ] 框架组件(navbar/sidebar/tabs/app-main)已全局修改
|
|
127
127
|
- [ ] 元素隐藏清单已逐项检查并处理(顶栏/侧栏/列表/共享组件 四类)
|
|
128
128
|
- [ ] 无遗漏页面(对照路由清单逐一核对)
|
|
129
|
-
- [ ] 所有页面的多余元素(「展示列表」「左侧按钮...」等)均已清除
|
|
130
|
-
|
|
131
|
-
#### 设计还原度验证(有 handoff JSON 时必须执行)
|
|
132
|
-
|
|
133
|
-
> 验证依据:设计 skill 的规范文件(design-tokens.md / unified-framework.md / list-page.md / component-spec.md)
|
|
134
|
-
> 验证方法:代码级对照——读取设计规范预期值 → 检查项目代码实际值 → 比对是否一致
|
|
135
|
-
> 验证顺序:框架层 → 页面层 → 共享组件层 → 细节项 → 元素清理
|
|
136
|
-
|
|
137
|
-
- [ ] **框架层还原度**:顶栏高度/元素/折叠位置、侧栏宽度/背景/激活态、页签高度/激活态、内容区背景/padding,共 10 项已逐项对照
|
|
138
|
-
- [ ] **页面层还原度**:卡片阴影圆角、标题区字号/padding、筛选区背景/分隔线、工具栏布局/按钮、表格表头/行高/hover、操作列样式、分页布局、模块分割线/间距,共 12 项已逐项对照
|
|
139
|
-
- [ ] **共享组件还原度**:ReTableBar(按钮样式/布局/分页集成)、ReTableOperate(文字链接/分隔线/更多箭头/折叠逻辑)、RePagination(样式/布局),共 10 项已逐项对照
|
|
140
|
-
- [ ] **核心组件还原度**:按钮(高度/圆角/主色三态)、输入框(高度/圆角/focus 光环)、Tag(5 种状态色)、下拉菜单、空状态,已逐项对照
|
|
141
|
-
- [ ] **细节项还原度**:图标大小 16px、分隔线 #F0F0F0、hover 文字加深不变浅、行高正确、字重正确、圆角统一、阴影自然、更多按钮有箭头、操作列有竖分隔线、页签下划线居中、操作列 sticky、选择列 48px、状态标签颜色对应、卡片有阴影,共 15 项已逐项检查
|
|
142
|
-
- [ ] **令牌溯源检查**:颜色/尺寸/间距均通过 CSS 变量传递,变量值与 design-tokens.md 一致,无裸 hex/px 值
|
|
143
|
-
- [ ] **元素清理检查**:设置按钮、展示列表标题、示例按钮、操作列多余图标等已全部移除
|
|
144
|
-
- [ ] **已输出「设计还原度验证报告」**(格式见 design-
|
|
145
|
-
- [ ]
|
|
146
|
-
- [ ]
|
|
147
|
-
- [ ]
|
|
148
|
-
|
|
129
|
+
- [ ] 所有页面的多余元素(「展示列表」「左侧按钮...」等)均已清除
|
|
130
|
+
|
|
131
|
+
#### 设计还原度验证(有 handoff JSON 时必须执行)
|
|
132
|
+
|
|
133
|
+
> 验证依据:设计 skill 的规范文件(design-tokens.md / unified-framework.md / list-page.md / component-spec.md)
|
|
134
|
+
> 验证方法:代码级对照——读取设计规范预期值 → 检查项目代码实际值 → 比对是否一致
|
|
135
|
+
> 验证顺序:框架层 → 页面层 → 共享组件层 → 细节项 → 元素清理
|
|
136
|
+
|
|
137
|
+
- [ ] **框架层还原度**:顶栏高度/元素/折叠位置、侧栏宽度/背景/激活态、页签高度/激活态、内容区背景/padding,共 10 项已逐项对照
|
|
138
|
+
- [ ] **页面层还原度**:卡片阴影圆角、标题区字号/padding、筛选区背景/分隔线、工具栏布局/按钮、表格表头/行高/hover、操作列样式、分页布局、模块分割线/间距,共 12 项已逐项对照
|
|
139
|
+
- [ ] **共享组件还原度**:ReTableBar(按钮样式/布局/分页集成)、ReTableOperate(文字链接/分隔线/更多箭头/折叠逻辑)、RePagination(样式/布局),共 10 项已逐项对照
|
|
140
|
+
- [ ] **核心组件还原度**:按钮(高度/圆角/主色三态)、输入框(高度/圆角/focus 光环)、Tag(5 种状态色)、下拉菜单、空状态,已逐项对照
|
|
141
|
+
- [ ] **细节项还原度**:图标大小 16px、分隔线 #F0F0F0、hover 文字加深不变浅、行高正确、字重正确、圆角统一、阴影自然、更多按钮有箭头、操作列有竖分隔线、页签下划线居中、操作列 sticky、选择列 48px、状态标签颜色对应、卡片有阴影,共 15 项已逐项检查
|
|
142
|
+
- [ ] **令牌溯源检查**:颜色/尺寸/间距均通过 CSS 变量传递,变量值与 design-tokens.md 一致,无裸 hex/px 值
|
|
143
|
+
- [ ] **元素清理检查**:设置按钮、展示列表标题、示例按钮、操作列多余图标等已全部移除
|
|
144
|
+
- [ ] **已输出「设计还原度验证报告」**(格式见 `design-verify.md` 10.7),包含整体还原度、各层通过率、偏差项及修正方案
|
|
145
|
+
- [ ] **逐属性 CSS 校验已执行**(`design-verify.md` 10.8):从设计源文件提取 CSS 属性清单,逐条比对项目代码,不一致项已修正并回读校验通过
|
|
146
|
+
- [ ] **已输出「逐属性 CSS 校验报告」**(格式见 `design-verify.md` 10.8.5),包含校验范围、偏差明细、待确认项
|
|
147
|
+
- [ ] **设计落盘范围**:设计产出 HTML 未写入项目文件,设计规范未另存到非业务目录,所有修改只在 src/ 等业务代码中
|
|
148
|
+
- [ ] **功能完整性核查**:样式改造后原有功能全部正常(框架层/共享组件层/页面层均已逐项核查,无按钮失效、事件丢失、数据绑定断裂等功能回归问题)
|
|
149
|
+
- [ ] **已输出「功能完整性核查报告」**(格式见 design-handoff.md 第十一章 11.7),包含整体通过率、各层核查结果、发现的问题及修正方案
|
|
150
|
+
|
|
149
151
|
> ⚠️ 硬约束:设计还原度验证未通过的项,必须修正后重新验证,直至全部通过。禁止带着未修正的偏差项进入后续环节。
|
|
150
152
|
|
|
151
153
|
## 选型与硬约束
|
|
@@ -27,7 +27,6 @@ tags: [vue3, kernel, conventions, layout, router, http, crud, inventory]
|
|
|
27
27
|
| 12 | 列表布局按 **`crud-pages` 标准样板**(`el-card.vts-page-card`+`content`、无 `100vh` 减顶栏定高、`tableHeight`、`otherRef`、分页在 ReTableBar 内;仅表格体内滚动) |
|
|
28
28
|
| 13 | addon 按 `project-inventory` 第九节精确版本安装;禁止 `@latest` |
|
|
29
29
|
| 14 | 样式契约见下文「样式契约」 |
|
|
30
|
-
| 15 | **`docs/**` 禁止随业务改动**:模板 `docs/` 为静态文档/演示(如 `style-templates/`),不参与业务落盘;除非用户明确要求维护文档,否则不得修改、同步或「对齐」其中文件 |
|
|
31
30
|
|
|
32
31
|
## 二、应用壳
|
|
33
32
|
|
|
@@ -157,16 +156,7 @@ export function getCustomerList(data: CustomerQuery, url: string) {
|
|
|
157
156
|
| addon 构建 | FileViewer / vConsole 等在精简模板中为占位;安装后按对应模块恢复 `build/plugins/*` |
|
|
158
157
|
| addon 类型检查 | 未装 addon 时相关路径在 `tsconfig exclude`;**装包后须手动移除**对应项 → 见 `project-inventory` **第十节**(非自动) |
|
|
159
158
|
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
### docs/ 目录(只读)
|
|
163
|
-
|
|
164
|
-
| 项 | 说明 |
|
|
165
|
-
|----|------|
|
|
166
|
-
| 用途 | 人类可读文档、UI 风格演示页(`docs/style-templates/`)等 |
|
|
167
|
-
| 与业务关系 | **不参与**业务开发落盘;其中示例代码**不跟随** `src/` 等业务实现同步修改 |
|
|
168
|
-
| AI 行为 | 默认**不读、不改、不引用为落盘目标**;仅用户明确要求更新文档本身时可改 |
|
|
169
|
-
| 参考方式 | 风格选型可**只读浏览**演示页后与用户沟通;中后台功能页仍按 Skill 标准样板在 `src/` 实现 |
|
|
159
|
+
非用户要求,不改 `vite.config.ts` / `build/**`。
|
|
170
160
|
|
|
171
161
|
## 八、环境变量
|
|
172
162
|
|
|
@@ -180,6 +170,6 @@ export function getCustomerList(data: CustomerQuery, url: string) {
|
|
|
180
170
|
| 列表/表单 CRUD | `crud-pages` |
|
|
181
171
|
| 详情跳转 | `detail-page` |
|
|
182
172
|
| 主题布局 | `layout-theme` |
|
|
183
|
-
| 设计规范适配 | `design-system` + 有产出时 `design-handoff` |
|
|
173
|
+
| 设计规范适配 | `design-system` + 有产出时 `design-handoff` + `design-verify` |
|
|
184
174
|
| 版本/安装 | `project-inventory` |
|
|
185
175
|
| 生成后审查 | `code-quality` |
|