---
name: create-crud-command-for-ecs
overview: 设计并编写一个在指定模块下创建业务功能的标准化指令规范，触发 ruoyi-backend 技能自动生成 CRUD 代码
todos:
  - id: create-cmd-spec
    content: 创建 CMD.md 指令规范文件，包含完整指令语法、参数说明、示例
    status: pending
  - id: update-skill-md
    content: 更新 SKILL.md，在开发工作流程章节添加指令使用说明
    status: pending
    dependencies:
      - create-cmd-spec
---

## 用户需求

设计并创建一套在 RuoYi-Cloud-Plus 项目指定模块下创建业务功能的指令规范文件。

## 功能概述

- 创建 `CMD.md` 指令规范文件，定义标准化的代码生成指令格式
- 支持多种触发方式：/生成、生成功能、创建功能、create
- 支持两种生成模式：纯消费者模式（consumer）和完整 CRUD 模式（full）
- 支持 YAML 格式字段定义内联
- 更新 `SKILL.md` 添加指令使用说明

## 核心特性

1. **模块指定**：支持 `module`、`sub`、`name` 三级结构
2. **生成模式**：

- consumer：纯消费者，仅生成 Controller（ECS 现有模式）
- full：完整 CRUD，生成 Domain/Bo/Vo/Mapper/Service/ServiceImpl/Controller

3. **可选功能**：Dubbo 暴露、导入导出、多租户支持
4. **字段定义**：YAML 格式内联，支持完整字段属性

## 输出文件

1. `d:/dt_ykt/ykt_server/.workbuddy/skills/ruoyi-backend/CMD.md`（新建）
2. `d:/dt_ykt/ykt_server/.workbuddy/skills/ruoyi-backend/SKILL.md`（更新）

## 技术方案

### 1. 指令设计原则

- **简洁优先**：最小化必填参数，提供合理的默认值
- **灵活扩展**：支持内联 YAML 字段定义，也支持引用需求模板
- **模式匹配**：根据 `mode` 参数自动选择生成策略
- **一致性**：与现有 ruoyi-backend 技能模板保持完全一致

### 2. 生成模式

| 模式 | 描述 | 生成文件 |
| --- | --- | --- |
| consumer | 纯消费者，仅 Controller | Controller.java |
| full | 完整 CRUD | Domain, Bo, Vo, Mapper, Service, ServiceImpl, Controller |
| full+dubbo | 完整+暴露 | 上述 + RemoteService, RemoteServiceImpl |


### 3. 指令参数规范

| 参数 | 默认值 | 说明 |
| --- | --- | --- |
| `module` | 必填 | 模块名：ruoyi-ecs, ruoyi-backstage, ruoyi-system |
| `sub` | 必填 | 子模块名：basics, course, student |
| `name` | 必填 | 功能名：course, teacher, classroom |
| `table` | t_{module}_{name} | 数据库表名 |
| `mode` | full | 模式：consumer/full |
| `dubbo` | false | 是否暴露 Dubbo 接口 |
| `import` | false | 是否支持导入导出 |
| `tenant` | true | 是否多租户 |
| `fields` | - | YAML 字段定义 |


### 4. ECS 模块特殊处理

- ECS 模块默认使用 consumer 模式
- Controller 路径：`org.dromara.ecs.controller.{sub}.{Name}Controller`
- 权限前缀：`ecs:{name}:{operation}`

# Agent Extensions

本任务不涉及 Agent Extensions 使用。