命令

---
description: 可选描述（在 /help 中显示）
---
 
你的提示内容在这里。
使用 {{args}} 进行参数注入。

---
description: 根据暂存的更改生成提交信息
---
 
请根据以下差异生成一个提交信息：
 
```diff
!{git diff --staged}
```

#### 4. 文件内容注入 (`@{...}`)

| 文件类型     | 支持状态               | 处理方式                    |
| ------------ | ---------------------- | --------------------------- |
| 文本文件     | ✅ 完全支持             | 直接注入内容                |
| 图片/PDF     | ✅ 多模态支持           | 编码后注入                  |
| 二进制文件   | ⚠️ 有限支持             | 可能被跳过或截断            |
| 目录         | ✅ 递归注入             | 遵循 .gitignore 规则        |

示例：代码审查命令

```markdown
---
description: 基于最佳实践的代码审查
---

审查 {{args}}，参考标准：

@{docs/code-standards.md}
```

### 实际创建示例

#### "纯函数重构" 命令创建步骤表

| 操作                         | 命令/代码                                 |
| ---------------------------- | ----------------------------------------- |
| 1. 创建目录结构              | `mkdir -p ~/.qwen/commands/refactor`      |
| 2. 创建命令文件              | `touch ~/.qwen/commands/refactor/pure.md` |
| 3. 编辑命令内容              | 参考下面的完整代码。                      |
| 4. 测试命令                  | `@file.js` → `/refactor:pure`             |

```markdown
---
description: 将代码重构为纯函数
---

请分析当前上下文中的代码，将其重构为纯函数。
要求：

1. 提供重构后的代码
2. 解释关键变更和纯函数特性的实现
3. 保持函数功能不变
```

### 自定义命令最佳实践总结

#### 命令设计建议表

| 实践要点           | 推荐做法                         | 避免事项                                    |
| ------------------ | -------------------------------- | ------------------------------------------- |
| 命令命名           | 使用命名空间进行组织             | 避免过于通用的名称                          |
| 参数处理           | 明确使用 `{{args}}`              | 依赖默认追加（容易混淆）                    |
| 错误处理           | 利用 Shell 错误输出              | 忽略执行失败                                |
| 文件组织           | 按功能在目录中组织               | 所有命令放在根目录                          |
| 描述字段           | 始终提供清晰描述                 | 依赖自动生成的描述                          |

#### 安全功能提醒表

| 安全机制 | 保护效果 | 用户操作 |
| -------- | -------- | -------- |
| Shell 转义 | 防止命令注入 | 自动处理 |
| 执行确认 | 避免意外执行 | 对话框确认 |
| 错误报告 | 帮助诊断问题 | 查看错误信息 |