ai-engineering-init 1.7.0 → 1.10.0

package/.codex/skills/progress/SKILL.md

@@ -1,178 +1,249 @@
----
-name: progress
-description: |
-  当需要分析项目开发进度、查看模块完成情况时自动使用此 Skill。
-
-  触发场景：
-  - 需要查看项目整体开发进度
-  - 需要分析各模块的完成度
-  - 需要统计代码中的 TODO/FIXME
-  - 需要生成项目进度报告
-
-  触发词：项目进度、progress、进度报告、完成度、开发进度、模块进度、进度分析、进度梳理
----
-
 # /progress - 项目进度梳理
 
 作为项目进度分析助手，帮您快速分析后端开发进度、识别完成度和待办事项。
 
-## 🎯 执行流程
+## 执行流程
 
-### 第一步：扫描后端模块（强制执行）
+### 第一步：扫描业务模块（强制执行）
 
 ```bash
-# 查找所有业务模块
-Glob pattern: "ruoyi-modules/ruoyi-*/src/main/java/**/controller/*Controller.java"
-
-# 排除系统模块（不统计进度）
-# - ruoyi-system （系统管理框架）
-# - ruoyi-generator （代码生成器）
-# - ruoyi-common （公共库）
+# 查找核心业务模块的 Controller
+Glob pattern: "sys-canteen/src/main/java/**/controller/*Controller.java"
+Glob pattern: "sys-kitchen/src/main/java/**/controller/*Controller.java"
+Glob pattern: "sys-drp/src/main/java/**/controller/*Controller.java"
+Glob pattern: "sys-common/src/main/java/**/controller/*Controller.java"
+
+# 基础设施模块（不统计进度）：
+# - core-base（公共配置、工具类）
+# - core-aggregator（聚合器）
+# - sys-open（开放接口模块）
+# - sys-logistics（物流模块）
 ```
 
-自动检测到的模块示例：
-- `ruoyi-demo`
-- `ruoyi-business`
-- 其他自定义业务模块
+自动检测的核心业务模块：
+- `sys-canteen`：食堂业务（订单、菜品、用户）
+- `sys-kitchen`：后场厨房（备餐、出餐、排班）
+- `sys-drp`：供应链（采购、库存、配送）
+- `sys-common`：公共业务（支付、通知、对接）
 
 ### 第二步：分析代码完整性
 
-对每个功能检查 **7 个必需的文件**：
+对每个功能检查 **8 个必需的文件**（leniu 四层架构）：
 
 | 类型 | 文件 | 完整文件路径 | 必须 | 说明 |
 |------|------|------------|------|------|
-| Entity | `Xxx.java` | `domain/Xxx.java` | ✅ | 数据模型 |
-| BO | `XxxBo.java` | `domain/bo/XxxBo.java` | ✅ | 业务对象 |
-| VO | `XxxVo.java` | `domain/vo/XxxVo.java` | ✅ | 视图对象 |
-| Service 接口 | `IXxxService.java` | `service/IXxxService.java` | ✅ | 服务定义 |
-| Service 实现 | `XxxServiceImpl.java` | `service/impl/XxxServiceImpl.java` | ✅ | 服务实现 |
-| Mapper | `XxxMapper.java` | `mapper/XxxMapper.java` | ✅ | 数据访问 |
-| Controller | `XxxController.java` | `controller/XxxController.java` | ✅ | 接口层 |
+| Entity | `XxxInfo.java` | `common/model/XxxInfo.java` | ✅ | 数据模型 |
+| DTO | `XxxInfoDTO.java` | `web/dto/XxxInfoDTO.java` | ✅ | 请求参数 |
+| VO | `XxxInfoVO.java` | `web/vo/XxxInfoVO.java` | ✅ | 返回对象 |
+| Mapper | `XxxInfoMapper.java` | `common/mapper/XxxInfoMapper.java` | ✅ | Mapper 接口 |
+| MapperXML | `XxxInfoMapper.xml` | `common/mapper/XxxInfoMapper.xml` | ✅ | SQL 映射（同目录） |
+| Service | `XxxInfoService.java` | `common/service/impl/XxxInfoService.java` | ✅ | 单表 CRUD |
+| Business | `XxxWebBusiness.java` | `web/business/impl/XxxWebBusiness.java` | ✅ | 业务编排 |
+| Controller | `XxxWebController.java` | `web/controller/XxxWebController.java` | ✅ | 接口层 |
 
 ### 第三步：扫描代码待办（TODO/FIXME）
 
 ```bash
 # 扫描需要处理的代码注释
-Grep pattern: "TODO:|FIXME:" path: ruoyi-modules/ glob: "*.java" output_mode: content -B 1
+Grep pattern: "TODO:|FIXME:" path: sys-canteen/,sys-kitchen/,sys-drp/,sys-common/ glob: "*.java" output_mode: content -B 1
+```
+
+### 第四步：扫描 OpenSpec 变更状态（如有）
+
+```bash
+# 检查是否有活跃的 OpenSpec 变更
+Glob pattern: "openspec/changes/*/tasks.md"
+
+# 对每个找到的变更：
+# 1. 读取 proposal.md 获取变更概述
+# 2. 读取 tasks.md 统计任务完成情况（[ ] 未完成 / [x] 已完成）
+# 3. 检查是否有 design.md、specs/ 等制品
 ```
 
-### 第四步：代码质量分析
+### 第五步：代码质量分析
 
 ```bash
 # 检查代码规范性
-Grep pattern: "package com\.ruoyi\." path: ruoyi-modules/ glob: "*.java" output_mode: files_with_matches
-Grep pattern: "BeanUtil\.copy|BeanUtils\.copy" path: ruoyi-modules/ glob: "*.java" output_mode: files_with_matches
+Grep pattern: "package org\.dromara\." path: sys-canteen/,sys-kitchen/,sys-drp/ glob: "*.java" output_mode: files_with_matches
+Grep pattern: "MapstructUtils|ServiceException" path: sys-canteen/,sys-kitchen/,sys-drp/ glob: "*.java" output_mode: files_with_matches
+Grep pattern: "createBy|createTime|updateBy|updateTime" path: sys-canteen/,sys-kitchen/,sys-drp/ glob: "*.java" output_mode: files_with_matches
+Grep pattern: "delFlag.*=.*0\b" path: sys-canteen/,sys-kitchen/,sys-drp/ glob: "*.java" output_mode: files_with_matches
 ```
 
 ---
 
-## 📊 输出格式
+## 输出格式
 
 ```markdown
-# 📊 项目进度报告
+# 项目进度报告
 
 **生成时间**：YYYY-MM-DD HH:mm
 **检查范围**：全量后端代码
 
 ---
 
-## 🎯 项目概况
+## 项目概况
 
-- **项目名称**：RuoYi-Vue-Plus 纯后端版
-- **技术栈**：Spring Boot 3 + MyBatis Plus + Sa-Token
-- **数据库**：MySQL/MariaDB
+- **项目名称**：leniu-tengyun-core 云食堂
+- **技术栈**：Spring Boot 3.x + pigx-framework + MyBatis-Plus + JDK 21
+- **架构**：四层架构（Controller → Business → Service → Mapper）
+- **双库**：系统库（全局配置）+ 商户库（租户业务数据）
 - **当前阶段**：[开发中/测试中/已上线]
 
 ---
 
-## 📈 后端模块进度汇总
+## 后端模块进度汇总
 
 | 模块 | 功能数 | 完成数 | 完成率 | 状态 |
 |------|--------|--------|--------|------|
-| demo | 3 | 3 | 100% | ✅ 已完成 |
-| business | 5 | 3 | 60% | 🔄 进行中 |
-| **合计** | **8** | **6** | **75%** | 🔄 进行中 |
+| sys-canteen（食堂业务） | X | X | XX% | [状态] |
+| sys-kitchen（后场厨房） | X | X | XX% | [状态] |
+| sys-drp（供应链） | X | X | XX% | [状态] |
+| sys-common（公共业务） | X | X | XX% | [状态] |
+| **合计** | **X** | **X** | **XX%** | [状态] |
 
 ---
 
-## 📋 功能详情分析
+## 功能详情分析
+
+### [模块名] 模块 (XX% 完成)
 
-### demo 模块 (100% 完成)
+| 功能 | Entity | DTO | VO | Mapper | XML | Service | Business | Controller | 完成度 | 备注 |
+|------|--------|-----|----|--------|-----|---------|----------|------------|--------|------|
+| [功能名] | ✅/❌ | ✅/❌ | ✅/❌ | ✅/❌ | ✅/❌ | ✅/❌ | ✅/❌ | ✅/❌ | XX% | [备注] |
 
-| 功能 | Entity | BO | VO | Service | Mapper | Controller | 完成度 |
-|------|--------|----|----|---------|--------|------------|--------|
-| Notice | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | 100% |
-| Config | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | 100% |
-| Test | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | 100% |
+**说明**：
+- ✅ 已完成
+- ⚠️ 部分完成/需改进
+- ❌ 待完成
 
 ---
 
-## 🔍 代码质量分析
+## OpenSpec 变更状态（如有活跃变更）
+
+| 变更名称 | 状态 | 任务完成 | 概述 |
+|---------|------|---------|------|
+| `[change-name]` | 进行中 | X/Y | [proposal 概述] |
+
+> 使用 `/opsx:apply [变更名]` 继续实现未完成的任务，或 `/opsx:verify [变更名]` 验证已完成的变更。
+
+---
+
+## 代码质量分析
 
 | 指标 | 评分 | 说明 |
 |------|------|------|
-| 代码规范性 | 良好 ✅ | 包名规范、类名规范 |
-| 注释完整度 | 待补充 ⚠️ | 部分功能缺少业务注释 |
-| 权限注解完整度 | 需改进 ⚠️ | 部分接口缺少 @SaCheckPermission |
-| 对象转换规范 | 良好 ✅ | 正确使用 MapstructUtils |
+| 包名规范 | 良好 ✅ | 所有包名符合 net.xnzn.core.* |
+| 审计字段 | 良好 ✅ | 使用 crby/crtime/upby/uptime |
+| del_flag 语义 | 良好 ✅ | 正确使用 2=正常，1=删除 |
+| 权限注解完整度 | 待补充 ⚠️ | 部分接口缺少 @RequiresAuthentication |
+| 对象转换规范 | 良好 ✅ | 正确使用 BeanUtil.copyProperties() |
+| 请求封装规范 | 待补充 ⚠️ | 部分 POST 接口未使用 LeRequest<T> |
+| 事务注解完整 | 良好 ✅ | 写操作均有 @Transactional |
 
 ---
 
-## 📝 代码待办事项
+## 代码待办事项
 
 ### TODO 项 (X 个)
 
 | 文件 | 行号 | 类型 | 内容 | 优先级 |
 |------|------|------|------|--------|
-| `UserServiceImpl.java` | 87 | TODO | 优化用户查询性能 | 中 |
+| `[文件名].java` | [行号] | TODO | [描述] | [优先级] |
 
 ### FIXME 项 (X 个)
 
 | 文件 | 行号 | 类型 | 内容 | 优先级 |
 |------|------|------|------|--------|
-| `PaymentService.java` | 156 | FIXME | 修复退款金额计算错误 | 高 |
+| `[文件名].java` | [行号] | FIXME | [描述] | [优先级] |
 
 ---
 
-## 💡 改进建议
+## 改进建议
 
 ### 高优先级（需立即处理）
 
-1. **补充缺失的 BO/VO**
+1. **补充缺失的 Business 层**
+   - [模块名] 缺少 [功能名]WebBusiness 编排层
+   - 影响：复杂业务逻辑无处放置
+   - 建议：使用 `/crud [功能名]` 快速生成
+
 2. **完善权限注解**
+   - 发现 X 个接口缺少 @RequiresAuthentication/@RequiresGuest
+   - 影响：权限控制不严格
+   - 建议：使用 `/check` 进行完整检查
+
 3. **修复 FIXME 问题**
+   - [FIXME 描述]
+   - 影响：[影响范围]
+   - 优先级：🔴 高
 
 ### 中优先级（逐步完善）
 
 1. **补充接口注释**
+   - [模块名] 缺少业务逻辑注释
+   - 建议：为关键方法添加 JavaDoc
+
 2. **优化查询性能**
+   - [Service 文件名] 大数据量查询需优化
+   - 建议：添加分页、完善 buildWrapper 查询条件
+
+3. **完善 Mapper XML**
+   - [模块名] 部分复杂查询需要补充 XML SQL
+   - 建议：XML 文件与 Mapper.java 放在同一目录
 
 ---
 
-## 📊 完成度判定标准
+## 检查通过项
+
+- [x] 包名规范（net.xnzn.core.*）
+- [x] 对象转换（BeanUtil.copyProperties()）
+- [x] 审计字段（crby/crtime/upby/uptime）
+- [x] 逻辑删除（del_flag: 2=正常，1=删除）
+- [x] Mapper 继承（BaseMapper<Entity>）
+- [x] 无 tenant_id 字段（双库物理隔离）
+
+---
+
+## 完成度判定标准
 
 | 完成率 | 状态 | 说明 | 推荐行动 |
 |--------|------|------|---------|
-| 100% | ✅ 已完成 | 全部 7 个文件均已完成 | 可进行代码审查 |
-| 71-99% | 🟢 基本完成 | 缺少 1-2 个文件 | 补充缺失文件 |
-| 50-70% | 🟡 进行中 | 缺少 2-3 个文件 | 加快开发进度 |
+| 100% | ✅ 已完成 | 全部 8 个文件均已完成 | 可进行代码审查 |
+| 75-99% | 🟢 基本完成 | 缺少 1-2 个文件 | 补充缺失文件 |
+| 50-74% | 🟡 进行中 | 缺少 2-4 个文件 | 加快开发进度 |
 | 1-49% | 🔴 早期阶段 | 仅有少量文件 | 继续开发 |
 | 0% | ⚫ 待开发 | 无相关文件 | 使用 `/dev` 开始开发 |
 
 ---
 
-## 🚀 快速操作
+## 快速操作
+
+根据上面的分析结果，您可以使用以下命令快速完成开发：
 
 ```bash
 # 1. 快速生成缺失功能
-/crud Payment
+/crud [功能名]
 
 # 2. 检查并修复代码规范
-/check business
+/check [模块名]
 
-# 3. 继续开发新功能
+# 3. 继续开发新功能（含表设计）
 /dev 新功能名称
+
+# 4. 快速添加待办任务
+/add-todo [任务描述]，[优先级]
 ```
+
+---
+
+## 说明
+
+- 本报告统计核心业务模块（sys-canteen、sys-kitchen、sys-drp、sys-common）
+- 基础设施模块（core-base、core-aggregator、sys-open、sys-logistics）不统计进度
+- 完成率基于 8 个必需文件的存在情况判定（leniu 四层架构）
+- 代码待办基于 TODO/FIXME 注释统计
+- 建议定期运行此命令以追踪项目进度
 ```
 
 ---
@@ -181,8 +252,8 @@ Grep pattern: "BeanUtil\.copy|BeanUtils\.copy" path: ruoyi-modules/ glob: "*.jav
 
 ```
 用户：/progress
-用户：/progress business （仅检查 business 模块）
-用户：/progress demo （仅检查 demo 模块）
+用户：/progress canteen （仅检查 sys-canteen 模块）
+用户：/progress kitchen （仅检查 sys-kitchen 模块）
 
 Claude：
 🔍 正在扫描项目结构...