命令#

自定义命令允许你指定一个提示词，当在 TUI 中执行该命令时会运行这个提示词。

/my-command

自定义命令是 /init、/undo、/redo、/share、/help 等内置命令之外的补充。了解更多。

#创建命令文件

在 commands/ 目录中创建 markdown 文件来定义自定义命令。

创建 .mimocode/commands/test.md：

---
description: Run tests with coverage
agent: build
model: mimo/mimo-v2.5-pro
---

Run the full test suite with coverage report and show any failures.
Focus on the failing tests and suggest fixes.

frontmatter 定义命令属性，内容则成为模板。

通过输入 / 后跟命令名称来使用该命令。

"/test"

#配置

你可以通过 MiMo Code 配置或在 commands/ 目录中创建 markdown 文件来添加自定义命令。

#JSON

在 MiMo Code 配置中使用 command 选项：

1{
2  "$schema": "https://mimo.xiaomi.com//config.json",
3  "command": {
4    // This becomes the name of the command
5    "test": {
6      // This is the prompt that will be sent to the LLM
7      "template": "Run the full test suite with coverage report and show any failures.\nFocus on the failing tests and suggest fixes.",
8      // This is shown as the description in the TUI
9      "description": "Run tests with coverage",
10      "agent": "build",
11      "model": "mimo/mimo-v2.5-pro"
12    }
13  }
14}

现在你可以在 TUI 中运行这个命令：

/test

#Markdown

你还可以使用 markdown 文件定义命令。将它们放在：

• 全局：~/.config/mimocode/commands/
• 项目级：.mimocode/commands/

---
description: Run tests with coverage
agent: build
model: mimo/mimo-v2.5-pro
---

Run the full test suite with coverage report and show any failures.
Focus on the failing tests and suggest fixes.

markdown 文件名即为命令名。例如，test.md 允许你运行：

/test

#提示词配置

自定义命令的提示词支持多种特殊占位符和语法。

#参数

使用 $ARGUMENTS 占位符向命令传递参数。

---
description: Create a new component
---

Create a new React component named $ARGUMENTS with TypeScript support.
Include proper typing and basic structure.

带参数运行命令：

/component Button

$ARGUMENTS 将被替换为 Button。

你还可以使用位置参数访问各个参数：

• $1 - 第一个参数
• $2 - 第二个参数
• $3 - 第三个参数
• 以此类推...

例如：

---
description: Create a new file with content
---

Create a file named $1 in the directory $2
with the following content: $3

运行命令：

/create-file config.json src "{ \"key\": \"value\" }"

替换结果为：

• $1 替换为 config.json
• $2 替换为 src
• $3 替换为 { "key": "value" }

#Shell 输出

使用 !command 将 bash 命令输出注入到提示词中。

例如，创建一个分析测试覆盖率的自定义命令：

---
description: Analyze test coverage
---

Here are the current test results:
!`npm test`

Based on these results, suggest improvements to increase coverage.

或者查看最近的更改：

---
description: Review recent changes
---

Recent git commits:
!`git log --oneline -10`

Review these changes and suggest any improvements.

命令在项目的根目录中运行，其输出会成为提示词的一部分。

#文件引用

使用 @ 后跟文件名在命令中引用文件。

---
description: Review component
---

Review the component in @src/components/Button.tsx.
Check for performance issues and suggest improvements.

文件内容会自动包含在提示词中。

#选项

让我们详细了解各配置选项。

#Template

template 选项定义执行命令时发送给 LLM 的提示词。

{
  "command": {
    "test": {
      "template": "Run the full test suite with coverage report and show any failures.\nFocus on the failing tests and suggest fixes."
    }
  }
}

这是一个必需的配置选项。

#Description

使用 description 选项提供命令功能的简要描述。

{
  "command": {
    "test": {
      "description": "Run tests with coverage"
    }
  }
}

当你输入命令时，这将在 TUI 中显示为描述。

#Agent

使用 agent 配置可选地指定由哪个代理执行此命令。 如果这是一个子代理，该命令默认会触发子代理调用。 要禁用此行为，请将 subtask 设置为 false。

{
  "command": {
    "review": {
      "agent": "plan"
    }
  }
}

这是一个可选的配置选项。如果未指定，默认使用你当前的代理。

#Subtask

使用 subtask 布尔值强制命令触发子代理调用。 如果你希望命令不污染主要上下文，这会很有用，它会强制代理作为子代理运行， 即使代理配置中的 mode 设置为 primary。

{
  "command": {
    "analyze": {
      "subtask": true
    }
  }
}

这是一个可选的配置选项。

#Model

使用 model 配置覆盖此命令的默认模型。

{
  "command": {
    "analyze": {
      "model": "mimo/mimo-v2.5-pro"
    }
  }
}

这是一个可选的配置选项。