|
|
@@ -0,0 +1,123 @@
|
|
|
+---
|
|
|
+description: 快速创建新的Roo Code指令，包括标准CRUD指令、自定义指令和常用工作流模板
|
|
|
+argument-hint: <指令类型> [实体名称] [模块名称]
|
|
|
+---
|
|
|
+
|
|
|
+# 创建指令
|
|
|
+
|
|
|
+根据指定的类型和参数快速创建新的Roo Code指令文件。
|
|
|
+
|
|
|
+## 使用方式
|
|
|
+
|
|
|
+- `/command-create crud User users` - 创建用户管理标准CRUD指令
|
|
|
+- `/command-create custom complex-report` - 创建复杂报表自定义指令
|
|
|
+- `/command-create mini-form Login` - 创建小程序登录表单指令
|
|
|
+
|
|
|
+## 指令类型
|
|
|
+
|
|
|
+### 1. 标准CRUD指令 (`crud`)
|
|
|
+创建包含完整增删改查功能的指令模板
|
|
|
+
|
|
|
+**参数**:
|
|
|
+- 实体名称 (PascalCase)
|
|
|
+- 模块名称 (snake_case)
|
|
|
+
|
|
|
+**示例**: `/command-create crud Product products`
|
|
|
+
|
|
|
+### 2. 自定义指令 (`custom`)
|
|
|
+创建灵活的自定义业务逻辑指令
|
|
|
+
|
|
|
+**参数**:
|
|
|
+- 指令名称 (kebab-case)
|
|
|
+
|
|
|
+**示例**: `/command-create custom data-analysis`
|
|
|
+
|
|
|
+### 3. 小程序表单指令 (`mini-form`)
|
|
|
+创建小程序表单页面指令模板
|
|
|
+
|
|
|
+**参数**:
|
|
|
+- 表单名称 (PascalCase)
|
|
|
+
|
|
|
+**示例**: `/command-create mini-form UserProfile`
|
|
|
+
|
|
|
+## 创建步骤
|
|
|
+
|
|
|
+### 步骤1: 确定指令类型
|
|
|
+根据业务需求选择合适的指令类型：
|
|
|
+- 简单数据管理 → 标准CRUD
|
|
|
+- 复杂业务逻辑 → 自定义指令
|
|
|
+- 小程序页面 → 小程序表单
|
|
|
+
|
|
|
+### 步骤2: 命名规范
|
|
|
+- 指令文件名使用 kebab-case
|
|
|
+- 实体名使用 PascalCase
|
|
|
+- 模块名使用 snake_case
|
|
|
+
|
|
|
+### 步骤3: 选择存放位置
|
|
|
+- 项目特定指令: `.roo/commands/`
|
|
|
+- 全局通用指令: `~/.roo/commands/`
|
|
|
+
|
|
|
+## 标准CRUD指令模板
|
|
|
+
|
|
|
+创建标准CRUD指令时，将自动生成：
|
|
|
+1. 实体定义文件
|
|
|
+2. Service类
|
|
|
+3. API路由
|
|
|
+4. 前端页面
|
|
|
+5. 客户端API调用
|
|
|
+
|
|
|
+## 自定义指令模板
|
|
|
+
|
|
|
+创建自定义指令时，提供：
|
|
|
+1. 基础指令框架
|
|
|
+2. 业务逻辑占位
|
|
|
+3. 错误处理模板
|
|
|
+4. 进度跟踪示例
|
|
|
+
|
|
|
+## 小程序表单指令模板
|
|
|
+
|
|
|
+创建小程序表单指令时，包含：
|
|
|
+1. 表单验证模式
|
|
|
+2. 页面组件结构
|
|
|
+3. 样式规范
|
|
|
+4. 提交处理逻辑
|
|
|
+
|
|
|
+## 最佳实践
|
|
|
+
|
|
|
+1. **指令命名**: 使用动词+名词结构，如 `generate-report`, `validate-data`
|
|
|
+2. **参数设计**: 明确指令所需的参数类型和格式
|
|
|
+3. **错误处理**: 包含完整的错误处理和用户反馈
|
|
|
+4. **文档说明**: 在指令顶部添加清晰的描述和使用示例
|
|
|
+5. **版本管理**: 将指令文件纳入版本控制系统
|
|
|
+
|
|
|
+## 示例指令文件结构
|
|
|
+
|
|
|
+```
|
|
|
+.roo/commands/
|
|
|
+├── crud-user-management.md # 用户管理CRUD
|
|
|
+├── custom-monthly-report.md # 月度报表生成
|
|
|
+├── mini-form-user-login.md # 小程序登录表单
|
|
|
+└── api-endpoint-generator.md # API端点生成器
|
|
|
+```
|
|
|
+
|
|
|
+## 快速创建检查清单
|
|
|
+
|
|
|
+- [ ] 确定指令类型和用途
|
|
|
+- [ ] 选择合适的命名规范
|
|
|
+- [ ] 定义清晰的参数结构
|
|
|
+- [ ] 添加详细的描述文档
|
|
|
+- [ ] 包含错误处理逻辑
|
|
|
+- [ ] 提供使用示例
|
|
|
+- [ ] 测试指令功能
|
|
|
+- [ ] 更新指令索引
|
|
|
+
|
|
|
+## 常见问题
|
|
|
+
|
|
|
+**Q: 如何创建跨项目的通用指令？**
|
|
|
+A: 将指令文件放在 `~/.roo/commands/` 目录下，所有项目都可访问
|
|
|
+
|
|
|
+**Q: 指令参数如何验证？**
|
|
|
+A: 在指令内容中使用正则表达式或条件判断来验证参数格式
|
|
|
+
|
|
|
+**Q: 如何共享团队指令？**
|
|
|
+A: 将指令文件提交到项目仓库的 `.roo/commands/` 目录，团队成员可同步使用
|
yourname