斜杠命令

在会话中，使用斜杠命令执行快捷操作、管理会话状态，并自定义常用工作流。

内置斜杠命令

TraeCode CLI 提供以下内置斜杠命令。

自定义斜杠命令

你可以将常用的提示词定义为 Markdown 文件，并由 TraeCode CLI 将其作为自定义斜杠命令来执行。

语法

自定义斜杠命令的语法如下：

/<command-name> [arguments]

参数说明如下：

创建自定义斜杠命令

1. 使用 mkdir -p .traecli/commands 命令，在项目的根目录中创建 .traecli/commands 目录。
2. 使用 cd .traecli/commands 命令，进入 .traecli/commands 目录。
3. 在 .traecli/commands 目录下创建 Markdown 格式的自定义斜杠命令配置文件。
4. 配置自定义斜杠命令并保存。
   Frontmatter 字段说明如下：

   Frontmatter	描述	示例
   description	该自定义斜杠命令的简介。	Review code changes with context
   argument-hint	斜杠命令（/）所需的参数。在用户进行斜杠命令自动补全时，会向用户显示这一提示。	argument-hint: add [tagId] | remove [tagId] | list
   tools	指定可使用的工具。多个工具间使用逗号分隔。	Read,Write,mcp__{$mcp_server_name}__{$tool_name}
   model	指定所使用的模型。	kimi-k2

   示例如下：

   ---
   description: Review code changes with context
   argument-hint: <file-pattern>
   model: kimi-k2
   tools: Read
   ---
   
   ## Code Review Request
   
   Files to review: $1
   
   Current git diff: !`git diff HEAD -- $1`
   
   File structure: !`find . -name "$1" -type f | head -10`
   
   ## Your task
   
   Please perform a thorough code review of the specified files focusing on:
   
   1. **Code Quality**: Check for best practices, readability, and maintainability
   2. **Security**: Look for potential security vulnerabilities
   3. **Performance**: Identify potential performance issues
   4. **Testing**: Suggest areas that need test coverage
   5. **Documentation**: Check if code is properly documented
   
   Provide specific suggestions for improvement with line numbers where applicable.
   

其他功能

TraeCode CLI 提供了一系列特殊语法，用于在命令定义中动态引用参数、设定默认值以及插入系统命令执行结果，从而极大增强了自定义命令的灵活性和复用性。

$ARGUMENTS

$ARGUMENTS 占位符会捕获传递给该命令的所有参数，多个参数之间使用空格分隔。示例如下：

# 命令定义
echo 'Deploying service: $ARGUMENTS to the staging environment' > .traecli/commands/deploy-service.md

# 用法
> /deploy-service auth-api v2.3.1
# $ARGUMENTS 变成: "auth-api v2.3.1"

$N

你可以像在 Shell 脚本中一样，通过位置参数 $N 来单独访问特定的参数。示例如下：

# Command definition
echo 'Deploy service $1 to environment $2 with version $3' > .traecli/commands/deploy-service.md

# 用法
> /deploy-service auth staging v1.4.2
# $1 变成 "auth"，$2 变成 "staging"，$3 变成 "v1.4.2"

!command``

!command`` 用于执行指定命令，并将其标准输出结果作为文本内容直接插入到当前位置。

例如，在以下命令定义中，!cat VERSION会在 TRAE CLI 处理该文件时被执行。 TRAE CLI 会运行cat VERSION，然后获取它的标准输出（例如 1.4.0），最后将 !cat VERSION 这一段替换成输出内容。

# 命令定义 
echo "Project version: !`cat VERSION`" > traecli/commands/show-version.md

# 替换后的文本
Project version: 1.4.0

${N:-DefaultValue}

${N:-DefaultValue} 用来为变量提供默认值。

• 如果变量 N 没有被定义或值为空，使用 DefaultValue 作为替代值。
• 如果变量 N 已被定义且值非空，使用变量本身的值。

示例如下：

# 命令定义
echo 'Deploying to environment: ${1:-staging}' > .traecli/commands/deploy.md

# 用法
# 情况一：用户提供了参数和定义 $1="production"
> /deploy production
# ${1:-staging} 变成 "production"

# 情况二：用户未提供参数，$1 未定义
> /deploy
# ${1:-staging} becomes "staging"