自定义命令模板

把常用任务保存成 Markdown 命令模板，可在不同会话复用同样的提示结构。项目模板优先于同名用户模板。

文件与名称

路径分隔符转换为冒号，因此可按 git、refactor 等目录组织。项目文件位于 .qwen/commands，用户文件位于 ~/.qwen/commands。

---
description: Review a selected module using the project standards
---

Review {{args}}. Explain concrete defects and the supporting evidence.

@{docs/code-standards.md}

description 可选，显示在 /help；正文必需。示例引用文件需在项目中存在，路径不是内置文件。

参数

{{args}} 在普通提示中直接注入参数文本；没有标记但调用带参数时，原提示后加两个换行再追加参数。没有参数则原样发送。

动态处理顺序为文件内容 @{...} → shell !{...} → 参数 {{args}}。shell 内的参数按上下文进行转义，不应自行拼成未经核对的可执行字符串。

动态内容

@{path} 支持文本、图片/PDF，以及按忽略规则递归的目录；二进制可能跳过或截断。它与用户输入中的 @path 形式不同。

!{command} 执行后将结果插入提示，例如 !{git diff --staged} 可提供暂存差异。官方命令章描述先解析与转义、再显示执行确认、执行并注入输出；实际执行还受当前权限和沙箱模式约束，不要把模板当作纯静态文本。

TOML 迁移

旧 TOML 仍兼容，但已弃用，检测到时会提示迁移。旧 prompt 是必填字符串，description 可选；新建内容应使用 Markdown，避免继续依赖将来会移除的格式。

命令名称最好体现任务范围；模板中的 shell 错误应被看见，不能忽略失败后把残缺输出当作完整上下文。