Comandos

Los comandos personalizados te permiten especificar un prompt que deseas ejecutar cuando ese comando se ejecuta en tu sesión.

/my-command

Los comandos personalizados se suman a los comandos integrados como /init, /undo, /redo, /help. Más información.

Crear archivos de comandos

Crea archivos markdown en el directorio commands/ para definir comandos personalizados.

Crea .dropstone/commands/test.md:

---
description: Run tests with coverage
agent: build
model: dropstone/dropstone-pro
---

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

El frontmatter define las propiedades del comando. El contenido se convierte en la plantilla.

Usa el comando escribiendo / seguido del nombre del comando.

/test

Configurar

Puedes agregar comandos personalizados a través de la configuración de Dropstone o creando archivos markdown en el directorio commands/.

JSON

Usa la opción command en tu configuración de Dropstone:

{
  "$schema": "https://dropstone.io/schema/config.json",
  "command": {
    // This becomes the name of the command
    "test": {
      // This is the prompt that will be sent to the LLM
      "template": "Run the full test suite with coverage report and show any failures.\nFocus on the failing tests and suggest fixes.",
      // Shown as the description in the slash command palette
      "description": "Run tests with coverage",
      "agent": "build",
      "model": "dropstone/dropstone-pro"
    }
  }
}

Ahora puedes ejecutar este comando desde cualquier sesión:

/test

Markdown

También puedes definir comandos usando archivos markdown. Colócalos en:

• Global: ~/.config/dropstone/commands/
• Por proyecto: .dropstone/commands/

---
description: Run tests with coverage
agent: build
model: dropstone/dropstone-pro
---

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

El nombre del archivo markdown se convierte en el nombre del comando. Por ejemplo, test.md te permite ejecutar:

/test

Configuración del prompt

Los prompts para los comandos personalizados admiten varios placeholders especiales y sintaxis.

Argumentos

Pasa argumentos a comandos usando el placeholder $ARGUMENTS.

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

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

Ejecuta el comando con argumentos:

/component Button

Y $ARGUMENTS será reemplazado con Button.

También puedes acceder a argumentos individuales usando parámetros posicionales:

• $1 - Primer argumento
• $2 - Segundo argumento
• $3 - Tercer argumento
• Y así sucesivamente...

Por ejemplo:

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

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

Ejecuta el comando:

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

Esto reemplaza:

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

Salida del shell

Usa !command para inyectar la salida del comando shell en tu prompt.

Por ejemplo, para crear un comando personalizado que analice la cobertura de pruebas:

---
description: Analyze test coverage
---

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

Based on these results, suggest improvements to increase coverage.

O para revisar cambios recientes:

---
description: Review recent changes
---

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

Review these changes and suggest any improvements.

Los comandos se ejecutan en el directorio raíz de tu proyecto y su salida se convierte en parte del prompt.

Referencias de archivos

Incluye archivos en tu comando usando @ seguido del nombre del archivo.

---
description: Review component
---

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

El contenido del archivo se incluye automáticamente en el prompt.

Opciones

Veamos las opciones de configuración en detalle.

Template

La opción template define el prompt que se enviará al LLM cuando se ejecute el comando.

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

Esta es una opción de configuración requerida.

Description

Usa la opción description para proporcionar una breve descripción de lo que hace el comando.

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

Se muestra junto al comando en la paleta de comandos slash.

Agent

Usa la configuración agent para especificar opcionalmente qué agente debe ejecutar este comando. Si este es un subagente, el comando activará una invocación de subagente por defecto. Para desactivar este comportamiento, establece subtask en false.

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

Esta es una opción de configuración opcional. Si no se especifica, por defecto usa tu agente actual.

Subtask

Usa el booleano subtask para forzar que el comando active una invocación de subagente. Esto es útil si deseas que el comando no contamine tu contexto principal y forzará al agente a actuar como un subagente, incluso si mode está establecido en primary en la configuración del agente.

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

Esta es una opción de configuración opcional.

Model

Usa la configuración model para anular el modelo predeterminado para este comando.

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

Esta es una opción de configuración opcional.

Integrados

Dropstone incluye varios comandos integrados como /init, /undo, /redo, /help. Más información.