name: create-command description: “创建新斜杠命令”
创建新斜杠命令
基于用户需求,在 .cursor/commands/(带 trellis- 前缀)和 .claude/commands/trellis/ 目录中创建新的斜杠命令。
用法
/trellis:create-command <命令名称> <描述>
示例:
/trellis:create-command review-pr 检查PR代码变更是否符合项目指南
执行步骤
1. 解析输入
从用户输入中提取:
- 命令名称:使用烤肉串式命名(例如
review-pr) - 描述:命令应完成什么
2. 分析需求
根据描述确定命令类型:
- 初始化:阅读文档,建立上下文
- 预开发:阅读指南,检查依赖
- 代码检查:验证代码质量和指南合规性
- 记录:记录进度、问题、结构变更
- 生成:生成文档、代码模板
3. 生成命令内容
基于命令类型,生成适当的内容:
简单命令(1-3行):
简洁指令描述要做什么
复杂命令(带步骤):
# 命令标题
命令描述
## 步骤
### 1. 第一步
具体操作
### 2. 第二步
具体操作
## 输出格式(如果需要)
模板
4. 创建文件
在两个目录中创建:
.cursor/commands/trellis-<命令名称>.md.claude/commands/trellis/<命令名称>.md
5. 确认创建
输出结果:
[OK] 创建斜杠命令: /<命令名称>
文件路径:
- .cursor/commands/trellis-<命令名称>.md
- .claude/commands/trellis/<命令名称>.md
用法:
/trellis:<命令名称>
描述:
<描述>
命令内容指南
[OK] 好的命令内容
- 清晰简洁:立即可理解
- 可执行:AI可以直接遵循步骤
- 范围明确:明确要做什么和不做什么的边界
- 有输出:指定预期输出格式(如果需要)
[X] 避免
- 太模糊:例如,“优化代码”
- 太复杂:单个命令不应超过100行
- 重复功能:首先检查是否存在类似命令
命名约定
| 命令类型 | 前缀 | 示例 |
|---|---|---|
| 会话开始 | start |
start |
| 预开发 | before- |
before-frontend-dev |
| 检查 | check- |
check-frontend |
| 记录 | record- |
record-session |
| 生成 | generate- |
generate-api-doc |
| 更新 | update- |
update-changelog |
| 其他 | 动词优先 | review-code、sync-data |
示例
输入
/trellis:create-command review-pr 检查PR代码变更是否符合项目指南
生成的命令内容
# PR代码审查
检查当前PR代码变更是否符合项目指南。
## 步骤
### 1. 获取变更文件
```bash
git diff main...HEAD --name-only
2. 分类审查
前端文件 (apps/web/):
- 参考
.trellis/spec/frontend/index.md
后端文件 (packages/api/):
- 参考
.trellis/spec/backend/index.md
3. 输出审查报告
格式:
PR审查报告
变更文件
- [文件列表]
检查结果
- [OK] 通过项
- [X] 发现问题
建议
- [改进建议]