ai-engineering-init 1.1.0

package/.claude/commands/next.md

@@ -0,0 +1,251 @@
+# /next - 下一步建议
+
+作为项目开发顾问，根据当前项目状态，为您建议下一步应该做什么。
+
+## 执行流程
+
+### 第一步：快速扫描项目状态
+
+```bash
+# 查看最近 Git 提交记录
+git log -5 --oneline
+
+# 扫描所有业务模块中的 TODO/FIXME
+Grep pattern: "TODO:|FIXME:" path: sys-canteen/,sys-kitchen/,sys-drp/,sys-common/ glob: "*.java" output_mode: content -B 2
+
+# 检查代码规范问题
+Grep pattern: "package org\.dromara\.|package com\.ruoyi\." 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
+```
+
+### 第二步：分析开发阶段
+
+根据代码完整性和功能数量判断：
+
+| 阶段 | 特征 | 功能完成率 |
+|------|------|----------|
+| 🟢 初期 | 基础框架搭建，功能模块较少 | < 30% |
+| 🟡 中期 | 核心功能开发中，模块逐步完善 | 30-70% |
+| 🔴 后期 | 功能基本完成，处于优化阶段 | > 70% |
+
+### 第三步：分类问题和建议
+
+- **紧急问题**：安全漏洞、严重 Bug、编译错误
+- **重要问题**：功能缺陷、设计问题、规范问题
+- **优化建议**：性能优化、代码重构、文档完善
+
+---
+
+## 输出格式
+
+```markdown
+# 下一步建议
+
+**分析时间**：YYYY-MM-DD HH:mm
+**分析范围**：全量后端代码
+
+---
+
+## 当前状态
+
+### Git 提交分析
+- **最近一次提交**：[commit message] ([commit hash])
+- **最近在做**：[根据提交记录推断]
+- **提交频率**：[活跃/不活跃]
+
+### 代码状态
+- **开发阶段**：🟡 中期（核心功能开发中）
+- **代码质量**：良好（包名符合 net.xnzn.core.*）
+- **规范问题**：3 个接口缺少 @RequiresAuthentication 注解
+
+### 代码待办统计
+- **TODO 项**：X 个
+- **FIXME 项**：X 个
+- **编译/运行错误**：无
+
+---
+
+## 建议优先级
+
+### 🔴 高优先级（必须立即处理）
+
+1. **修复 FIXME 问题**
+   - 位置：sys-canteen/.../service/impl/XxxService.java:156
+   - 问题：业务逻辑存在已知错误
+   - 原因：影响核心业务正确性
+   - 影响：可能导致数据异常
+   - **快速修复**：`/check` 找出所有 FIXME 并逐一解决
+
+2. **补充缺失的权限注解**
+   - 位置：sys-canteen 模块 3 个接口
+   - 问题：缺少 @RequiresAuthentication 或 @RequiresGuest 注解
+   - 原因：权限控制不完整
+   - 影响：系统存在未授权访问风险
+   - **快速修复**：`/check canteen` 查出所有问题接口
+
+3. **完善代码规范**
+   - 问题：部分接口 POST 请求未使用 LeRequest<T> 封装
+   - 原因：请求封装规范不一致
+   - 影响：后续维护成本高
+   - **快速修复**：`/check` 全量检查
+
+### 🟡 中优先级（近期应该做）
+
+1. **补充缺失功能模块**
+   - 建议模块：[根据扫描结果列出未完成的业务模块]
+   - 完成率：目前 X%，建议提升到 80%
+   - **快速开发**：`/crud [表名]` 快速生成 CRUD 代码
+
+2. **优化 Service 查询层**
+   - 建议模块：[根据扫描结果列出查询不完善的模块]
+   - 问题：buildWrapper 查询条件需要完善
+   - 价值：提升查询效率，支持更复杂的搜索
+   - **参考代码**：`sys-canteen/.../order/common/service/impl/OrderInfoService.java`
+
+3. **补充接口文档注释**
+   - 建议范围：所有 Controller 接口
+   - 目标：添加 @Api、@ApiOperation Swagger 文档注解、JavaDoc 方法注释
+   - 价值：便于接口文档自动生成
+
+### 🟢 低优先级（可以考虑）
+
+1. **性能优化**
+   - 建议项：添加查询缓存、分页优化
+   - 触发条件：数据量大时
+
+2. **代码重构**
+   - 建议项：提取通用工具类、统一错误处理
+
+3. **单元测试**
+   - 建议项：为核心 Service 添加单元测试
+   - 触发条件：功能稳定后
+
+---
+
+## 具体行动建议
+
+### 如果您想继续开发新功能：
+
+**推荐 1：完善业务模块**
+- 建议实现：[根据扫描结果列出未完成的功能]
+- 所属模块：[sys-canteen / sys-kitchen / sys-drp / sys-common]
+- **快速开始**：
+  ```bash
+  /crud [表名]          # 快速生成 CRUD 代码
+  /check [模块名]       # 检查并修复规范问题
+  ```
+
+**推荐 2：开发新的业务功能**
+- 建议实现：[根据项目进展推荐下一个业务功能]
+- **快速开始**：
+  ```bash
+  /dev 功能名称   # 使用向导开发新功能（含表设计）
+  ```
+
+### 如果您想优化代码质量：
+
+**推荐 1：规范检查和修复**
+- 建议优化：修复所有代码规范问题
+- **快速检查**：
+  ```bash
+  /check               # 全量检查
+  /check canteen       # 按模块检查
+  ```
+
+**推荐 2：Service 层优化**
+- 建议优化：完善 buildWrapper 实现，支持更复杂的查询
+- **参考代码**：`sys-canteen/.../order/common/service/impl/OrderInfoService.java`
+
+**推荐 3：注释和文档**
+- 建议优化：添加 JavaDoc 注释
+- 位置：所有 Controller 接口和关键 Service 方法
+
+### 如果您想修复现存问题：
+
+**按严重程度排序的问题列表**：
+
+#### 🔴 严重问题（立即修复）
+- **FIXME 问题**：[根据扫描结果列出 FIXME 位置和内容]
+- **权限注解缺失**：[根据扫描结果列出缺少 @RequiresAuthentication 的接口]
+- **命令**：`/check [模块名]`
+
+#### 🟡 重要问题（本周修复）
+- **LeRequest 封装缺失**：[根据扫描结果列出未使用 LeRequest<T> 的 POST 接口]
+- **del_flag 值错误**：[扫描是否有 delFlag=0 的设置]
+- **命令**：`/check [模块名]`
+
+#### 🟢 建议问题（择机修复）
+- **缺少接口文档**：所有 Controller
+- **缺少业务注释**：部分 Service 方法
+- **命令**：逐一完善
+
+---
+
+## 开发建议
+
+### 开发流程建议
+
+1. **明确需求**：使用 `/start` 快速了解项目结构
+2. **检查规范**：使用 `/check` 检查代码质量
+3. **分析进度**：使用 `/progress` 了解完成情况
+4. **开始开发**：使用 `/dev` 或 `/crud` 快速生成代码
+5. **添加待办**：使用 `/add-todo` 跟踪任务
+6. **获取建议**：使用 `/next` 确定下一步方向
+
+### 最佳实践
+
+| 实践 | 说明 |
+|------|------|
+| 四层职责清晰 | Controller 路由 → Business 编排 → Service 单表 → Mapper ORM |
+| 查询构建 | 在 Service 层用 LambdaQueryWrapper 构建，禁止在 Controller 层 |
+| 对象转换 | 使用 BeanUtil.copyProperties()，禁止 MapstructUtils |
+| 权限管理 | 所有接口必须有 @RequiresAuthentication 或 @RequiresGuest |
+| 请求封装 | POST 请求体统一使用 LeRequest<T>，通过 request.getContent() 获取参数 |
+| 注释完整 | 关键方法必须有 JavaDoc 注释 |
+| 定期检查 | 每周至少一次运行 `/check` 和 `/progress` |
+
+### 技术选型建议
+
+| 场景 | 推荐方案 | 理由 |
+|------|--------|------|
+| 快速生成 CRUD | `/crud` 命令 | 已有表结构时最快 |
+| 从零开发功能 | `/dev` 命令 | 包含数据库设计和代码生成 |
+| 代码规范检查 | `/check` 命令 | 及时发现问题 |
+| 项目进度追踪 | `/progress` 命令 | 定期了解完成情况 |
+
+---
+
+## 需要确认的问题
+
+### 如果不确定下一步方向，请回答：
+
+- [ ] **您更希望继续开发功能，还是优化现有代码？**
+  - 选项 A：继续开发新功能（推荐 `/crud` 或 `/dev` 命令）
+  - 选项 B：优化现有代码（推荐 `/check` 和 `/progress` 命令）
+
+- [ ] **是否需要为新开发的功能添加到待办列表中？**
+  - 可使用 `/add-todo` 快速添加
+
+---
+
+## 相关命令
+
+| 命令 | 用途 | 何时使用 |
+|------|------|---------|
+| `/start` | 快速了解项目 | 初次接触项目 |
+| `/check` | 代码规范检查 | 开发完成后、定期检查 |
+| `/progress` | 查看项目进度 | 了解完成情况 |
+| `/next` | 获取建议 | 不知道下一步做什么 |
+| `/dev` | 开发新功能 | 从零开始开发 |
+| `/crud` | 快速生成代码 | 表已存在时 |
+| `/add-todo` | 添加待办任务 | 跟踪任务 |
+
+---
+
+## 说明
+
+- 本建议基于对当前项目代码的分析生成
+- 建议具体且可执行，不空泛
+- 会考虑开发的连贯性和代码质量
+- 如发现紧急问题会明确标注
+- 如不确定用户意图会主动询问

package/.claude/commands/progress.md

@@ -0,0 +1,242 @@
+# /progress - 项目进度梳理
+
+作为项目进度分析助手，帮您快速分析后端开发进度、识别完成度和待办事项。
+
+## 执行流程
+
+### 第一步：扫描业务模块（强制执行）
+
+```bash
+# 查找核心业务模块的 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（物流模块）
+```
+
+自动检测的核心业务模块：
+- `sys-canteen`：食堂业务（订单、菜品、用户）
+- `sys-kitchen`：后场厨房（备餐、出餐、排班）
+- `sys-drp`：供应链（采购、库存、配送）
+- `sys-common`：公共业务（支付、通知、对接）
+
+### 第二步：分析代码完整性
+
+对每个功能检查 **8 个必需的文件**（leniu 四层架构）：
+
+| 类型 | 文件 | 完整文件路径 | 必须 | 说明 |
+|------|------|------------|------|------|
+| 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: sys-canteen/,sys-kitchen/,sys-drp/,sys-common/ glob: "*.java" output_mode: content -B 1
+```
+
+### 第四步：代码质量分析
+
+```bash
+# 检查代码规范性
+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
+**检查范围**：全量后端代码
+
+---
+
+## 项目概况
+
+- **项目名称**：leniu-tengyun-core 云食堂
+- **技术栈**：Spring Boot 3.x + pigx-framework + MyBatis-Plus + JDK 21
+- **架构**：四层架构（Controller → Business → Service → Mapper）
+- **双库**：系统库（全局配置）+ 商户库（租户业务数据）
+- **当前阶段**：[开发中/测试中/已上线]
+
+---
+
+## 后端模块进度汇总
+
+| 模块 | 功能数 | 完成数 | 完成率 | 状态 |
+|------|--------|--------|--------|------|
+| sys-canteen（食堂业务） | X | X | XX% | [状态] |
+| sys-kitchen（后场厨房） | X | X | XX% | [状态] |
+| sys-drp（供应链） | X | X | XX% | [状态] |
+| sys-common（公共业务） | X | X | XX% | [状态] |
+| **合计** | **X** | **X** | **XX%** | [状态] |
+
+---
+
+## 功能详情分析
+
+### [模块名] 模块 (XX% 完成)
+
+| 功能 | Entity | DTO | VO | Mapper | XML | Service | Business | Controller | 完成度 | 备注 |
+|------|--------|-----|----|--------|-----|---------|----------|------------|--------|------|
+| [功能名] | ✅/❌ | ✅/❌ | ✅/❌ | ✅/❌ | ✅/❌ | ✅/❌ | ✅/❌ | ✅/❌ | XX% | [备注] |
+
+**说明**：
+- ✅ 已完成
+- ⚠️ 部分完成/需改进
+- ❌ 待完成
+
+---
+
+## 代码质量分析
+
+| 指标 | 评分 | 说明 |
+|------|------|------|
+| 包名规范 | 良好 ✅ | 所有包名符合 net.xnzn.core.* |
+| 审计字段 | 良好 ✅ | 使用 crby/crtime/upby/uptime |
+| del_flag 语义 | 良好 ✅ | 正确使用 2=正常，1=删除 |
+| 权限注解完整度 | 待补充 ⚠️ | 部分接口缺少 @RequiresAuthentication |
+| 对象转换规范 | 良好 ✅ | 正确使用 BeanUtil.copyProperties() |
+| 请求封装规范 | 待补充 ⚠️ | 部分 POST 接口未使用 LeRequest<T> |
+| 事务注解完整 | 良好 ✅ | 写操作均有 @Transactional |
+
+---
+
+## 代码待办事项
+
+### TODO 项 (X 个)
+
+| 文件 | 行号 | 类型 | 内容 | 优先级 |
+|------|------|------|------|--------|
+| `[文件名].java` | [行号] | TODO | [描述] | [优先级] |
+
+### FIXME 项 (X 个)
+
+| 文件 | 行号 | 类型 | 内容 | 优先级 |
+|------|------|------|------|--------|
+| `[文件名].java` | [行号] | FIXME | [描述] | [优先级] |
+
+---
+
+## 改进建议
+
+### 高优先级（需立即处理）
+
+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% | ✅ 已完成 | 全部 8 个文件均已完成 | 可进行代码审查 |
+| 75-99% | 🟢 基本完成 | 缺少 1-2 个文件 | 补充缺失文件 |
+| 50-74% | 🟡 进行中 | 缺少 2-4 个文件 | 加快开发进度 |
+| 1-49% | 🔴 早期阶段 | 仅有少量文件 | 继续开发 |
+| 0% | ⚫ 待开发 | 无相关文件 | 使用 `/dev` 开始开发 |
+
+---
+
+## 快速操作
+
+根据上面的分析结果，您可以使用以下命令快速完成开发：
+
+```bash
+# 1. 快速生成缺失功能
+/crud [功能名]
+
+# 2. 检查并修复代码规范
+/check [模块名]
+
+# 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 注释统计
+- 建议定期运行此命令以追踪项目进度
+```
+
+---
+
+## 使用示例
+
+```
+用户：/progress
+用户：/progress canteen （仅检查 sys-canteen 模块）
+用户：/progress kitchen （仅检查 sys-kitchen 模块）
+
+Claude：
+🔍 正在扫描项目结构...
+📊 分析代码完整性...
+🔍 扫描代码待办事项...
+
+[输出完整的进度报告]
+```

package/.claude/commands/start.md

@@ -0,0 +1,199 @@
+# /start - 项目快速了解
+
+新成员快速了解 leniu-tengyun-core（云食堂）项目的必看命令。
+
+---
+
+## 适用场景
+
+| 场景 | 说明 |
+|------|------|
+| **初次接触** | 新成员第一次接触项目 |
+| **项目交接** | 接手他人的项目 |
+| **重新梳理** | 距上次熟悉项目已久，需快速回顾 |
+| **窗口切换** | 在新的 Claude 会话中快速了解项目 |
+
+---
+
+## 执行流程
+
+### 第一步：扫描项目结构
+
+```bash
+# 扫描业务模块 Controller
+Glob pattern: "sys-canteen/src/main/java/net/xnzn/core/**/controller/*Controller.java"
+Glob pattern: "sys-kitchen/src/main/java/net/xnzn/core/**/controller/*Controller.java"
+Glob pattern: "sys-drp/src/main/java/net/xnzn/core/**/controller/*Controller.java"
+
+# 查看最近 3 条 Git 提交
+git log -3 --oneline
+```
+
+### 第二步：识别 leniu 模块结构
+
+**核心业务模块（统计进度）**：
+
+| 模块 | 说明 | 包名 |
+|------|------|------|
+| `sys-canteen` | 食堂业务（订单、菜品、用户）| `net.xnzn.core.canteen` |
+| `sys-kitchen` | 后场厨房（备餐、出餐、排班）| `net.xnzn.core.kitchen` |
+| `sys-drp` | 供应链（采购、库存、配送）| `net.xnzn.core.drp` |
+| `sys-common` | 公共业务（支付、通知、对接）| `net.xnzn.core.common` |
+
+**基础设施模块（不统计进度）**：
+- `core-base` - 公共配置、工具类
+- `core-aggregator` - 聚合器
+- `sys-open` - 开放接口模块
+- `sys-logistics` - 物流模块
+
+### 第三步：判断项目开发阶段
+
+```
+Controller 数量 = 0    → 全新项目
+Controller 数量 1-20   → 初期开发
+Controller 数量 21+    → 成熟项目
+```
+
+### 第四步：检查文档状态
+
+```bash
+Glob pattern: "docs/*.md"
+```
+
+---
+
+## 输出格式
+
+### 情况一：全新项目
+
+```markdown
+# 欢迎使用 leniu-tengyun-core（云食堂）
+
+**技术栈**：Spring Boot 3.x + pigx-framework + MyBatis-Plus + JDK 21
+**架构**：四层架构（Controller → Business → Service → Mapper）
+**双库**：系统库（全局配置）+ 商户库（租户业务数据）
+
+## 框架现状
+
+### 核心特性
+- 双库物理隔离（无 tenant_id 字段，通过请求头 MERCHANT-ID 路由）
+- JDK 21 + jakarta.validation.*
+- PageHelper 分页 + LeRequest<T> 请求封装
+- LeException 业务异常 + I18n 国际化
+
+## 快速开始
+
+1. 了解规范：查看 CLAUDE.md
+2. 初始化文档：/init-docs
+3. 开始开发：/dev 或 /crud
+```
+
+### 情况二：开发中项目
+
+```markdown
+# 欢迎回到 leniu-tengyun-core
+
+**项目阶段**：开发中
+**技术栈**：Spring Boot 3.x + JDK 21 + pigx-framework
+
+## 模块进度
+
+| 模块 | Controller 数 | 说明 |
+|------|--------------|------|
+| sys-canteen | X | 食堂业务 |
+| sys-kitchen | X | 后场厨房 |
+| sys-drp | X | 供应链 |
+
+## 最近提交
+
+[显示最近 3 条 git commit]
+
+## 代码质量速查
+
+| 检查项 | 状态 |
+|--------|------|
+| 包名 (net.xnzn.core.*) | ✅/⚠️ |
+| 审计字段 (crby/crtime) | ✅/⚠️ |
+| 认证注解 (@RequiresAuthentication) | ✅/⚠️ |
+
+## 建议操作
+
+```bash
+/progress    # 查看详细进度
+/check       # 检查代码规范
+/next        # 获取下一步建议
+```
+```
+
+### 第五步：文档建议
+
+若 `docs/` 目录不存在：
+
+```markdown
+## 建议
+
+检测到业务代码，但尚未初始化项目文档。
+
+执行 /init-docs 初始化：
+- 项目状态.md - 进度追踪
+- 需求文档.md - 业务需求
+- 待办清单.md - 任务清单
+```
+
+---
+
+## 新成员入门清单
+
+- [ ] 阅读 `CLAUDE.md` 了解 leniu 开发规范
+- [ ] 运行 `/start` 了解项目现状
+- [ ] 运行 `/progress` 查看详细进度
+- [ ] 了解双库架构（系统库 vs 商户库）
+- [ ] 了解四层架构（Controller → Business → Service → Mapper）
+- [ ] 根据 `/next` 建议选择任务
+
+---
+
+## 核心命令速览
+
+```bash
+/start          # 项目概览（当前命令）
+/progress       # 详细进度
+/check          # 代码规范检查
+/dev            # 开发新功能（含表设计）
+/crud           # 快速生成 CRUD（表已存在）
+/next           # 获取建议
+/sync           # 全量同步
+/init-docs      # 初始化文档
+/add-todo       # 添加待办
+```
+
+---
+
+## 常见问题
+
+### Q: leniu 架构和 RuoYi-Vue-Plus 有什么区别？
+
+| 对比 | RuoYi-Vue-Plus | leniu-tengyun-core |
+|------|----------------|-------------------|
+| 包名 | `org.dromara.*` | `net.xnzn.core.*` |
+| 租户 | 单库 `tenant_id` 字段 | 双库物理隔离 |
+| 审计字段 | createBy/createTime | crby/crtime |
+| del_flag | 0=正常 | 2=正常 |
+| 请求封装 | BO | LeRequest<T> |
+| 权限注解 | @SaCheckPermission | @RequiresAuthentication |
+| 异常 | ServiceException | LeException |
+| 多了一层 | 三层 | 四层（多 Business 层）|
+
+### Q: 怎么开发新功能？
+
+```bash
+/dev  # 含表结构设计的完整开发向导
+/crud # 表已存在时快速生成代码
+```
+
+### Q: 怎么追踪进度？
+
+```bash
+/progress  # 查看完成情况
+/sync      # 生成完整报告
+```