@specpow/framework 0.5.21 → 0.5.23

package/builtin/schemas/mes-crud-module/templates/spec.md

@@ -0,0 +1,94 @@
+# MES CRUD 接口规范: {{Entity}}
+
+> 模块: {{module}} | 实体: {{Entity}} | 表: {{table_name}}
+
+## ADDED Requirements
+
+### API-001: 分页查询
+系统应当提供 `POST /{{entity}}/search` 接口，接收 `PageForm<{{Entity}}>` 请求体，返回分页结果。
+
+**验收标准:**
+- **Given** 数据库中存在 {{Entity}} 记录
+- **When** 用户请求 `POST /{{entity}}/search`，请求体为 `{ "size": 20, "current": 1, "condition": {} }`
+- **Then** 返回 `ResponseWrapper<Page<{{Entity}}>>`，包含 records 数组和 total 总数
+
+### API-002: 详情查询
+系统应当提供 `GET /{{entity}}/get/{id}` 接口。
+
+**验收标准:**
+- **Given** 存在 ID 为 1 的记录
+- **When** 用户请求 `GET /{{entity}}/get/1`
+- **Then** 返回 `ResponseWrapper<{{Entity}}>`，data 为该记录详情
+
+### API-003: 新增
+系统应当提供 `POST /{{entity}}/add` 接口，接收实体 JSON。
+
+**验收标准:**
+- **Given** 用户提供必填字段，请求体为合法的 {{Entity}} JSON
+- **When** 用户请求 `POST /{{entity}}/add`
+- **Then** 创建记录（雪花 ID 自动生成，审计字段自动填充），返回 `ResponseWrapper<String>` 成功
+
+### API-004: 修改
+系统应当提供 `PUT /{{entity}}/update` 接口。
+
+**验收标准:**
+- **Given** 存在待修改的记录
+- **When** 用户请求 `PUT /{{entity}}/update`，请求体包含 id 和修改字段
+- **Then** 更新记录（last_updated_by/last_updated_date 自动更新），返回 `ResponseWrapper<String>` 成功
+
+### API-005: 批量删除
+系统应当提供 `DELETE /{{entity}}/delete` 接口，接收 ID 数组。
+
+**验收标准:**
+- **Given** 存在待删除的记录
+- **When** 用户请求 `DELETE /{{entity}}/delete`，请求体为 `[1, 2, 3]`
+- **Then** 删除指定记录，返回 `ResponseWrapper<String>` 成功
+
+### API-006: 不分页列表
+系统应当提供 `POST /{{entity}}/list` 接口。
+
+**验收标准:**
+- **Given** 数据库中存在匹配记录
+- **When** 用户请求 `POST /{{entity}}/list`
+- **Then** 返回 `ResponseWrapper<List<{{Entity}}>>`（限制最多 10000 条）
+
+### API-007: Excel 导出
+系统应当提供 `POST /{{entity}}/export` 接口。
+
+**验收标准:**
+- **Given** 存在可导出的记录
+- **When** 用户请求 `POST /{{entity}}/export`
+- **Then** 返回 Excel 文件流（EasyExcel），文件名包含模块名
+
+---
+
+## 前端接口规范
+
+### FE-001: API 接口文件
+系统应当在 `src/api/{{domain}}/{{entity}}.js` 中封装以下方法：
+- `search{{Entity}}(data)` — POST /{{entity}}/search
+- `save{{Entity}}(data)` — POST /{{entity}}/add 或 PUT /{{entity}}/update（根据是否有 id 判断）
+- `delete{{Entity}}(ids)` — DELETE /{{entity}}/delete
+- `list{{Entity}}(data)` — POST /{{entity}}/list
+- `export{{Entity}}(data)` — POST /{{entity}}/export
+
+**验收标准:**
+- **Given** API 文件已创建
+- **When** 前端页面调用 API 方法
+- **Then** 正确发送 HTTP 请求并返回 Promise
+
+### FE-002: 列表页
+系统应当在 `src/views/{{domain}}/{{entity}}/index.vue` 中实现列表页。
+
+**验收标准:**
+- **Given** 用户有查看权限
+- **When** 用户访问列表页
+- **Then** 展示搜索条件表单 + 数据表格 + 分页，支持新增/编辑/查看/删除/导出操作
+
+### FE-003: 表单页
+系统应当在 `src/views/{{domain}}/{{entity}}/{{entity}}-form.vue` 中实现表单页。
+
+**验收标准:**
+- **Given** 用户点击新增或编辑按钮
+- **When** 表单页展示
+- **Then** 展示可编辑表单，必填字段有验证规则，提交后返回列表

package/builtin/schemas/mes-crud-module/templates/tasks.md

@@ -0,0 +1,208 @@
+# MES CRUD 任务列表: {{Entity}}
+
+## 全局约束
+
+- 后端: `modules-center/{{module}}-center/{{module}}-service/`
+- 前端: `implat-ui/src/`
+- 数据库: Oracle
+- 分支: `feature/{{entity}}-crud`
+
+---
+
+## 后端任务
+
+### Task-001: 建表 SQL（Oracle）
+
+- 文件: `sql/{{table_name}}.sql`
+- 依赖: 无
+- 描述: 创建数据库表，字段与提案中的字段清单对应
+- 代码模板:
+
+```sql
+CREATE TABLE {{table_name}} (
+  id                    NUMBER(19)      NOT NULL,
+  -- 业务字段（根据提案补充）
+  is_effect             NUMBER(1)       DEFAULT 1,
+  created_by            VARCHAR2(64)    DEFAULT '',
+  created_date          TIMESTAMP       DEFAULT SYSTIMESTAMP,
+  last_updated_by       VARCHAR2(64)    DEFAULT '',
+  last_updated_date     TIMESTAMP       DEFAULT SYSTIMESTAMP,
+  CONSTRAINT pk_{{table_name}} PRIMARY KEY (id)
+);
+COMMENT ON TABLE {{table_name}} IS '{{table_comment}}';
+```
+
+- 验证: SQL 可在 Oracle 客户端执行
+
+### Task-002: 创建 Entity 实体类
+
+- 文件: `modules-center/{{module}}-center/{{module}}-service/src/main/java/com/twsz/mom/{{module}}/model/{{Entity}}.java`
+- 依赖: Task-001
+- 描述: 继承 `BaseModel`，声明业务字段。审计字段（createdBy 等）和主键（id）由 BaseModel 自动提供。
+- 代码模板:
+
+```java
+package com.twsz.mom.{{module}}.model;
+
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.twsz.mom.common.ds.model.BaseModel;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+@Data
+@EqualsAndHashCode(callSuper = true)
+@JsonInclude(JsonInclude.Include.NON_NULL)
+@TableName("{{table_name}}")
+public class {{Entity}} extends BaseModel {
+    // 业务字段（审计字段由 BaseModel → TimeModel 提供）
+    private Integer isEffect;
+    // ... 根据提案中的字段清单补充
+}
+```
+
+- 验证: 编译通过
+
+### Task-003: 创建 Mapper 接口 + XML
+
+- 文件:
+  - `modules-center/{{module}}-center/{{module}}-service/src/main/java/com/twsz/mom/{{module}}/mapper/{{Entity}}Mapper.java`
+  - `modules-center/{{module}}-center/{{module}}-service/src/main/resources/mapper/{{Entity}}Mapper.xml`
+- 依赖: Task-002
+- 描述: 继承 `BaseMapper<{{Entity}}>`，XML 包含标准的 Columns/Where/Joins 片段
+- 代码模板（Mapper 接口）:
+
+```java
+package com.twsz.mom.{{module}}.mapper;
+
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import com.baomidou.mybatisplus.core.metadata.IPage;
+import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
+import com.twsz.mom.{{module}}.model.{{Entity}};
+import org.apache.ibatis.annotations.Mapper;
+import org.apache.ibatis.annotations.Param;
+import java.util.List;
+
+@Mapper
+public interface {{Entity}}Mapper extends BaseMapper<{{Entity}}> {
+    IPage<{{Entity}}> pageSearch(Page<{{Entity}}> page, @Param("entity") {{Entity}} entity);
+    List<{{Entity}}> list(@Param("entity") {{Entity}} entity);
+}
+```
+
+- 代码模板（XML）: 参见 design.md 中的标准 XML 模板
+- 验证: 编译通过，namespace 与 Mapper 接口全限定名匹配
+
+### Task-004: 创建 Service 接口 + 实现
+
+- 文件:
+  - `modules-center/{{module}}-center/{{module}}-service/src/main/java/com/twsz/mom/{{module}}/service/{{Entity}}Service.java`
+  - `modules-center/{{module}}-center/{{module}}-service/src/main/java/com/twsz/mom/{{module}}/service/impl/{{Entity}}ServiceImpl.java`
+- 依赖: Task-003
+- 描述: 继承 `IService<{{Entity}}>` / `ServiceImpl<Mapper, Entity>`，实现标准 CRUD 方法
+- 代码模板: 参见 design.md 中的 Service 模板
+- 验证: 编译通过
+
+### Task-005: 创建 Controller
+
+- 文件: `modules-center/{{module}}-center/{{module}}-service/src/main/java/com/twsz/mom/{{module}}/controller/{{Entity}}Controller.java`
+- 依赖: Task-004
+- 描述: `@RestController`，`@RequestMapping("/{{entity}}")`，返回 `ResponseWrapper<T>`
+- 代码模板: 参见 design.md 中的 Controller 模板
+- 验证: 编译通过，启动后可访问接口
+
+---
+
+## 前端任务
+
+### Task-006: 创建 API 接口文件
+
+- 文件: `implat-ui/src/api/{{domain}}/{{entity}}.js`
+- 依赖: Task-005
+- 描述: 封装 search/save/delete/list/export 五个标准方法
+- 代码模板:
+
+```js
+import axios from '@/libs/request'
+import { exportExcel } from '../file'
+
+const apiPrefix = '/{{entity}}'
+
+const search{{Entity}} = data =>
+    axios.request({ url: `${apiPrefix}/search`, method: 'POST', data })
+
+const save{{Entity}} = data => {
+    const url = data.id ? `${apiPrefix}/update` : `${apiPrefix}/add`
+    const method = data.id ? 'PUT' : 'POST'
+    return axios.request({ url, method, data })
+}
+
+const delete{{Entity}} = ids =>
+    axios.request({ url: `${apiPrefix}/delete`, method: 'DELETE', data: Array.isArray(ids) ? ids : [ids] })
+
+const list{{Entity}} = data =>
+    axios.request({ url: `${apiPrefix}/list`, method: 'POST', data })
+
+const export{{Entity}} = data =>
+    exportExcel(`${apiPrefix}/export`, data)
+
+export default { search{{Entity}}, save{{Entity}}, delete{{Entity}}, list{{Entity}}, export{{Entity}} }
+```
+
+- 验证: 无语法错误
+
+### Task-007: 创建列表页
+
+- 文件: `implat-ui/src/views/{{domain}}/{{entity}}/index.vue`
+- 依赖: Task-006
+- 描述: 使用 `indexPage` mixin + `<search-table>` 组件，配置 option 对象和 tableColumns
+- 代码模板: 参见 design.md 中的列表页模板
+- 关键约定:
+  - `mixins: [indexPage]` — 提供 showIndexPage/add/edit/view/refresh/triggerBack
+  - `option.search.query` — 绑定 API search 方法
+  - `option.delete.method` — 绑定 API delete 方法
+  - `$t('key||中文')` — i18n 格式
+- 验证: 页面可渲染，表格可加载数据
+
+### Task-008: 创建表单页
+
+- 文件: `implat-ui/src/views/{{domain}}/{{entity}}/{{entity}}-form.vue`
+- 依赖: Task-006
+- 描述: 使用 `<master-sub>` 组件 + `BaseMixin`，实现新增/编辑表单
+- 代码模板: 参见 design.md 中的表单页模板
+- 关键约定:
+  - `mixins: [BaseMixin]` — 提供 loading/asyncLoading
+  - `this.$refs.mform.validate()` — 表单验证
+  - `this.$emit('on-success', data)` — 提交成功回调
+  - `class="form"` — 自动两列布局
+- 验证: 表单验证生效，提交成功返回列表
+
+### Task-009: 菜单注册
+
+- 文件: `sql/menu_{{entity}}.sql`
+- 依赖: Task-008
+- 描述: 向 `c_sys_resource` 表插入菜单和按钮权限记录
+- 代码模板: 参见 menu-register.md
+- 权限标识:
+  - `{{module}}:{{entity}}:view` — 查看
+  - `{{module}}:{{entity}}:add` — 新增
+  - `{{module}}:{{entity}}:edit` — 修改
+  - `{{module}}:{{entity}}:delete` — 删除
+  - `{{module}}:{{entity}}:export` — 导出
+- 验证: 执行 SQL 后刷新缓存，菜单可见
+
+---
+
+## 任务依赖图
+
+```
+Task-001 (建表)
+  └─ Task-002 (Entity)
+       └─ Task-003 (Mapper + XML)
+            └─ Task-004 (Service)
+                 └─ Task-005 (Controller)
+                      └─ Task-006 (API 接口)
+                           ├─ Task-007 (列表页)
+                           └─ Task-008 (表单页)
+                                └─ Task-009 (菜单注册)
+```

package/builtin/schemas/mes-prd-to-code/schema.yaml

@@ -0,0 +1,365 @@
+# MES PRD to Code Schema
+# 功能文档 → 技术文档 → 完整代码
+# 工件流: parse → confirm-scope → tech-design → tasks → code
+
+name: mes-prd-to-code
+description: |
+  MES 项目专属 Schema：从业务功能文档端到端生成技术文档和完整代码。
+
+  输入：功能文档（*.md + *-流程图.drawio + *.html）
+  输出：技术设计文档 + 实施任务清单 + 完整可编译代码
+
+  核心能力：
+  - 自动解析结构化功能文档（字段表、DDL、业务逻辑、接口定义）
+  - 苏格拉底式对话确认模块归属、实施范围、实现细节
+  - 适配 MES 项目规范（Oracle + BaseModel + ResponseWrapper + Vue2/ViewUI）
+  - 支持多模块文档（识别子模块、依赖图、用户选择范围）
+  - 不预定义模式，跟随功能文档描述生成对应代码
+
+  项目结构（相对路径，相对于项目根目录）：
+  - 后端: mom-master/（Spring Boot + MyBatis-Plus + Oracle）
+  - 前端: implat-ui/（Vue2 + ViewUI + VXETable）
+  - 功能文档: 由用户提供文件路径
+
+apply:
+  requires:
+    - code    # 实施前必须完成所有工件
+
+artifacts:
+  - id: parse
+    name: 功能文档解析
+    description: 解析功能文档，提取结构化信息，识别子模块和依赖关系
+    requires: []
+    template: parse.md
+    instruction: |
+      读取用户提供的功能文档文件，完成以下解析工作：
+
+      ## 1. 文件识别
+      - 读取 *.md 文件（主功能文档）
+      - 读取 *-流程图.drawio 文件（如有，提取流程逻辑）
+      - 读取 *.html 文件（如有，提取原型界面信息）
+
+      ## 2. 子模块识别
+      - 扫描文档中的"模块一/模块二/..."或"功能一/功能二/..."标记
+      - 如果没有显式分模块，将整份文档视为单个模块
+      - 对每个子模块提取：名称、类型（新建CRUD/修改已有/外部接口/记录表）
+
+      ## 3. 每个子模块的信息提取
+
+      ### 3.1 功能简介
+      - 菜单路径 → 推断前端目录归属
+      - 使用人员 → 权限设计参考
+      - 功能描述 → 模块概述
+
+      ### 3.2 字段/数据提取
+      - 主表字段表 → Entity 字段列表
+      - 子表字段表（如有）→ 子表 Entity 字段列表
+      - 字段类型映射：
+        - VARCHAR → String
+        - INT/BIGINT → Long
+        - DECIMAL → BigDecimal
+        - DATETIME/DATE → Date
+        - TINYINT → Integer
+
+      ### 3.3 数据表结构
+      - 提取表名、字段、类型、约束
+      - 标记需要适配的项：
+        - AUTO_INCREMENT → 雪花算法
+        - MySQL 类型 → Oracle 类型
+        - 非标准审计字段 → BaseModel 审计字段
+
+      ### 3.4 业务逻辑
+      - 提取"补充逻辑"/"特殊逻辑"/"业务逻辑"章节
+      - 提取校验规则（唯一性、非空、格式校验等）
+      - 提取导入/导出规则
+      - 从流程图提取状态流转（如有）
+
+      ### 3.5 接口定义
+      - 提取外部接口（如有）的方法、路径、请求/响应格式
+      - 标记调用方向（设备→MES / MES→外部系统）
+
+      ### 3.6 按钮/操作
+      - 提取按钮清单 → API 接口清单
+      - 映射：新增/编辑/查看/删除/导入/导出 → 标准 CRUD 接口
+
+      ## 4. 依赖关系分析
+      - 分析子模块之间的数据依赖（A 模块的表被 B 模块引用）
+      - 分析子模块之间的功能依赖（B 模块修改 A 模块创建的功能）
+      - 绘制依赖关系图（ASCII）
+
+      ## 5. 输出格式
+      按 parse.md 模板输出解析报告，包含：
+      - 模块清单表
+      - 每个模块的字段清单、表结构、业务逻辑摘要
+      - 依赖关系图
+      - 需要用户确认的疑问点
+
+      注意：此阶段只做解析，不做任何技术决策。技术决策在后续对话中完成。
+    output: parse.md
+
+  - id: confirm-scope
+    name: 范围确认
+    description: 苏格拉底式对话确认模块归属、实施范围、架构决策
+    requires: [parse]
+    template: confirm-scope.md
+    instruction: |
+      基于解析报告，以苏格拉底式对话与用户确认以下内容。
+      逐个问题提问，不要一次问多个。
+
+      ## 必须确认的问题
+
+      ### Q0: 项目根目录
+      - 提问："项目根目录在哪里？（mom-master 和 implat-ui 所在的目录）"
+      - 说明：后续所有代码路径将基于此目录生成
+      - 使用 codegraph_explore 或 ls 验证目录结构是否正确
+
+      ### Q1: 实施范围（仅多模块时）
+      如果解析出多个子模块：
+      - 展示模块清单和依赖关系图
+      - 提问："识别到 N 个子模块，依赖关系如下: ... 本次实施哪些？"
+      - 等待用户选择
+
+      ### Q2: 后端模块归属
+      - 提问："后端代码归属哪个 center？"
+      - 给出建议（根据功能文档的菜单路径推断）
+      - 选项参考：modules-center 下的 material-center / production-center / quality-center 等
+
+      ### Q3: 后端包路径
+      - 提问："后端包路径？"
+      - 给出建议：com.twsz.mom.{module}.{sub-package}
+      - 参照已有代码的包结构
+
+      ### Q4: 前端目录
+      - 提问："前端页面和 API 放在哪个目录？"
+      - 给出建议：
+        - API: src/api/{domain}/
+        - 页面: src/views/{domain}/{entity}/
+
+      ### Q5: 已有代码影响
+      - 使用 codegraph_explore 扫描是否已有相关代码
+      - 如果有：展示已有代码，提问是否需要修改
+      - 如果没有：标注为全部新建
+
+      ### Q6: 特殊技术决策
+      根据解析结果自动判断是否需要询问：
+      - 如果有"单据编号"字段 → 确认是否使用 @AutoGenCode
+      - 如果有状态字段 → 确认是否需要状态流转（审核/弃审）
+      - 如果有外部接口 → 确认接口鉴权方式
+      - 如果涉及已有模块修改 → 确认修改范围和回归测试
+
+      ## 确认结果记录
+      将所有确认结果写入 confirm-scope 记录中，作为技术文档的输入。
+      格式：
+      ```
+      ## 确认结果
+      - 实施范围: [模块列表]
+      - 后端 center: xxx
+      - 后端包路径: com.twsz.mom.xxx
+      - 前端 API 目录: src/api/xxx/
+      - 前端页面目录: src/views/xxx/
+      - 编号生成: @AutoGenCode / 无
+      - 状态流转: 有(审核/弃审) / 无
+      - 已有代码影响: [列表]
+      ```
+
+  - id: tech-design
+    name: 技术设计文档
+    description: 基于确认结果生成完整技术设计文档
+    requires: [parse, confirm-scope]
+    template: tech-design.md
+    instruction: |
+      基于解析报告和确认结果，生成完整的技术设计文档。
+
+      ## 文档结构
+
+      ### 1. 数据库设计
+      - 将功能文档的 DDL 适配为 Oracle 语法
+      - 适配规则：
+        - INT/BIGINT AUTO_INCREMENT → NUMBER(19) 雪花算法
+        - VARCHAR(n) → VARCHAR2(n)
+        - DATETIME → DATE
+        - CURRENT_TIMESTAMP → SYSDATE
+        - 审计字段统一为: created_by, created_date, last_updated_by, last_updated_date
+        - 去除 is_deleted 逻辑删除字段（MES 使用物理删除）
+      - 包含完整 DDL + 索引 + 注释
+      - 标注建表方式: dbx MCP（优先）/ SQL 脚本
+
+      ### 2. API 接口设计
+      - 标准 CRUD 接口（根据功能文档的按钮/操作推导）：
+        - POST /{entity}/search — 分页查询
+        - POST /{entity}/add — 新增
+        - PUT /{entity}/update — 修改
+        - DELETE /{entity}/delete — 批量删除
+        - POST /{entity}/export — 导出
+        - POST /{entity}/uploadExcel — 导入（如有）
+      - 外部接口（如功能文档有定义）：
+        - 按功能文档定义的路径和方法
+        - 请求/响应格式按功能文档
+      - 每个接口给出：
+        - 请求示例 JSON
+        - 响应示例 JSON
+        - 错误码
+
+      ### 3. 后端代码结构
+      对每个 Entity 给出：
+
+      #### Entity（完整代码模板）
+      - 继承 BaseModel
+      - @TableName, @Data, @EqualsAndHashCode(callSuper=false)
+      - @TableId(type=IdType.ASSIGN_ID) + @JsonSerialize(ToStringSerializer)
+      - @AutoGenCode（如有编号字段）
+      - @ExcelProperty（每个业务字段）
+      - 给出完整 Java 代码
+
+      #### Mapper（完整代码模板）
+      - 接口继承 BaseMapper<T>
+      - 方法: pageSearch + list
+      - XML: Columns/Where 片段 + 查询语句
+      - 给出完整代码
+
+      #### Service（方法签名 + 关键逻辑）
+      - 接口方法签名
+      - 关键业务逻辑用伪代码描述：
+        - 校验规则
+        - 唯一性检查
+        - 事务控制
+        - 导入逻辑
+      - 不要求完整实现代码
+
+      #### Controller（完整代码模板）
+      - @RestController + @RequestMapping
+      - 每个方法的签名和参数
+      - 给出完整代码
+
+      ### 4. 前端代码结构
+      对每个页面给出：
+
+      #### API 文件
+      - 完整 JS 代码（import + 各方法）
+
+      #### 列表页（配置描述）
+      - 搜索条件字段
+      - 表格列定义（列名、key、slot）
+      - 工具栏按钮
+      - 组件: search-table + indexPage mixin
+
+      #### 表单页（配置描述）
+      - 表单字段列表（控件类型、必填、校验规则）
+      - 组件: master-sub + Form
+      - 提交逻辑
+
+      ### 5. 业务逻辑流程
+      - 用 ASCII 流程图描述核心业务操作
+      - 标注校验点和异常处理
+      - 如有状态流转，画出状态机
+
+      ### 6. 集成点 + 菜单权限
+      - 被其他模块调用的方式
+      - 菜单注册 SQL（c_sys_resource）
+
+      ## 对话 2: 实现确认
+      生成技术文档初稿后，以苏格拉底式对话确认：
+      - 表名和字段名是否确认？
+      - API 路径是否正确？
+      - 前端组件选型是否符合预期？
+      - 特殊校验规则是否完整？
+      - 用户确认后更新技术文档
+
+      ## 输出
+      最终版 tech-design.md
+
+    output: tech-design.md
+
+  - id: tasks
+    name: 实施任务清单
+    description: 基于技术文档拆分实施任务，每个任务含完整代码
+    requires: [tech-design]
+    template: tasks.md
+    instruction: |
+      基于技术设计文档，拆分为可执行的实施任务列表。
+
+      ## 任务拆分原则
+      1. 每个任务足够小（2-5 分钟完成）
+      2. 包含精确的文件路径（匹配 MES 项目包结构）
+      3. 包含完整的代码（从技术文档的模板中提取）
+      4. 包含验证步骤
+      5. 任务之间尽量独立
+
+      ## 任务顺序
+      按以下顺序排列：
+
+      ### 数据库任务
+      1. 建表 DDL（标注 dbx MCP 或 SQL 脚本）
+
+      ### 后端任务（每个 Entity 一组）
+      2. Entity 实体类（完整代码）
+      3. Mapper 接口（完整代码）
+      4. Mapper XML（完整代码）
+      5. Service 接口（完整代码）
+      6. ServiceImpl 实现（完整代码，含业务逻辑）
+      7. Controller（完整代码）
+
+      ### 前端任务（每个页面一组）
+      8. API 文件（完整代码）
+      9. 列表页 index.vue（完整代码）
+      10. 表单页 form.vue（完整代码）
+
+      ### 配置任务
+      11. 菜单注册 SQL
+
+      ### 如有外部接口
+      12. 外部接口 Controller（独立路径）
+      13. 外部接口 Service 逻辑
+
+      ## 任务格式
+      ```
+      - [ ] Task-NNN: <标题>
+        文件: <精确路径>
+        描述: <具体实现指令>
+        代码:
+        ```java/vue/js/sql
+        <完整代码>
+        ```
+        验证: <验证步骤>
+        依赖: Task-XXX
+      ```
+
+      ## 任务依赖图
+      用 ASCII 图展示任务依赖关系
+
+    output: tasks.md
+
+  - id: code
+    name: 代码生成
+    description: 按任务清单生成完整代码文件
+    requires: [tasks]
+    template: code-generation.md
+    instruction: |
+      按任务清单逐个生成代码文件。
+
+      ## 执行方式
+      1. 按任务依赖顺序执行
+      2. 每个任务：
+         a. 从 tasks.md 中取出代码
+         b. 写入精确的文件路径
+         c. 验证文件创建成功
+      3. 数据库任务：通过 dbx MCP 或输出 SQL 脚本
+
+      ## 代码规范检查
+      生成的代码必须符合以下 MES 规范：
+      - Java 8 语法，不使用 Java 9+ 特性
+      - Lombok 注解（@Data, @Builder 等）
+      - SLF4J 日志（@Slf4j），不用 System.out.println
+      - LambdaQueryWrapper，不用字符串字段名
+      - ResponseWrapper<T> 统一响应
+      - BaseModel 继承
+      - Vue 2 Options API
+      - View Design 4 组件
+      - indexPage mixin / master-sub 组件
+
+      ## 输出
+      - 所有代码文件已写入磁盘
+      - 生成文件清单
+      - 标注需要用户手动执行的操作（如建表 SQL、菜单注册 SQL）
+
+    output: code-generation.md