Dropstone Docs

命令

为重复性任务创建自定义命令。

自定义命令让你指定一个提示词，在会话中执行该命令时运行。

/my-command

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

创建命令文件

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

创建 .dropstone/commands/test.md：

---
description: 运行带覆盖率的测试
agent: build
model: dropstone/dropstone-pro
---

运行完整的测试套件并生成覆盖率报告，显示任何失败。
重点关注失败的测试并建议修复方案。

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

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

/test

配置

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

JSON

在你的 Dropstone 配置 中使用 command 选项：

{
  "$schema": "https://dropstone.io/schema/config.json",
  "command": {
    // 这成为命令的名称
    "test": {
      // 这是将发送给 LLM 的提示词
      "template": "运行完整的测试套件并生成覆盖率报告，显示任何失败。\n重点关注失败的测试并建议修复方案。",
      // 在斜杠命令调色板中显示的描述
      "description": "运行带覆盖率的测试",
      "agent": "build",
      "model": "dropstone/dropstone-pro"
    }
  }
}

现在你可以从任何会话运行此命令：

/test

Markdown

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

  • 全局：~/.config/dropstone/commands/
  • 按项目：.dropstone/commands/
---
description: 运行带覆盖率的测试
agent: build
model: dropstone/dropstone-pro
---

运行完整的测试套件并生成覆盖率报告，显示任何失败。
重点关注失败的测试并建议修复方案。

markdown 文件名成为命令名称。例如，test.md 让你可以运行：

/test

提示词配置

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

参数

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

---
description: 创建新组件
---

创建一个名为 $ARGUMENTS 的新 React 组件，支持 TypeScript。
包括适当的类型定义和基本结构。

使用参数运行命令：

/component Button

$ARGUMENTS 将被替换为 Button。

你也可以使用位置参数访问单个参数：

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

例如：

---
description: 创建包含内容的新文件
---

在目录 $2 中创建名为 $1 的文件
内容如下：$3

运行命令：

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

这将替换：

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

Shell 输出

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

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

---
description: 分析测试覆盖率
---

当前测试结果：
!`npm test`

根据这些结果，建议改进以提高覆盖率。

或审查最近的更改：

---
description: 审查最近的更改
---

最近的 git 提交：
!`git log --oneline -10`

审查这些更改并建议任何改进。

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

文件引用

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

---
description: 审查组件
---

审查 @src/components/Button.tsx 中的组件。
检查性能问题并建议改进。

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

选项

让我们详细查看配置选项。

Template

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

{
  "command": {
    "test": {
      "template": "运行完整的测试套件并生成覆盖率报告，显示任何失败。\n重点关注失败的测试并建议修复方案。"
    }
  }
}

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

Description

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

{
  "command": {
    "test": {
      "description": "运行带覆盖率的测试"
    }
  }
}

这在斜杠命令调色板中的命令旁边显示。

Agent

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

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

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

Subtask

使用 subtask 布尔值强制命令触发子代理调用。 这在你希望命令不污染主要上下文时很有用，并将强制代理充当子代理， 即使在代理配置中 mode 设置为 primary。

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

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

Model

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

{
  "command": {
    "analyze": {
      "model": "dropstone/dropstone-pro"
    }
  }
}

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

内置命令

Dropstone 包括多个内置命令，如 /init、/undo、/redo、/help。了解更多。

Note:

自定义命令可以覆盖内置命令。如果你定义的自定义命令与内置命令同名，自定义命令优先。

Ctrl+I