Perintah

Perintah khusus memungkinkan Anda menentukan prompt yang ingin dijalankan saat perintah tersebut dieksekusi dalam sesi Anda.

/my-command

Perintah khusus ditambahkan ke perintah bawaan seperti /init, /undo, /redo, /help. Pelajari lebih lanjut.

Buat file perintah

Buat file markdown di direktori commands/ untuk mendefinisikan perintah khusus.

Buat .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.

Frontmatter mendefinisikan properti perintah. Konten menjadi template.

Gunakan perintah dengan mengetik / diikuti nama perintah.

/test

Konfigurasi

Anda dapat menambahkan perintah khusus melalui konfigurasi Dropstone atau dengan membuat file markdown di direktori commands/.

JSON

Gunakan opsi command dalam config Dropstone Anda:

{
  "$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"
    }
  }
}

Sekarang Anda dapat menjalankan perintah ini dari sesi mana pun:

/test

Markdown

Anda juga dapat mendefinisikan perintah menggunakan file markdown. Tempatkan di:

• Global: ~/.config/dropstone/commands/
• Per-project: .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.

Nama file markdown menjadi nama perintah. Misalnya, test.md memungkinkan Anda menjalankan:

/test

Konfigurasi prompt

Prompt untuk perintah khusus mendukung beberapa placeholder dan sintaks khusus.

Argumen

Teruskan argumen ke perintah menggunakan placeholder $ARGUMENTS.

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

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

Jalankan perintah dengan argumen:

/component Button

Dan $ARGUMENTS akan diganti dengan Button.

Anda juga dapat mengakses argumen individual menggunakan parameter posisional:

• $1 - Argumen pertama
• $2 - Argumen kedua
• $3 - Argumen ketiga
• Dan seterusnya...

Contohnya:

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

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

Jalankan perintah:

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

Ini mengganti:

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

Output shell

Gunakan !command untuk menyuntikkan output perintah shell ke dalam prompt Anda.

Misalnya, untuk membuat perintah khusus yang menganalisis cakupan pengujian:

---
description: Analyze test coverage
---

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

Based on these results, suggest improvements to increase coverage.

Atau untuk meninjau perubahan terbaru:

---
description: Review recent changes
---

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

Review these changes and suggest any improvements.

Perintah berjalan di direktori root proyek Anda dan outputnya menjadi bagian dari prompt.

Referensi file

Sertakan file dalam perintah Anda menggunakan @ diikuti nama file.

---
description: Review component
---

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

Konten file secara otomatis disertakan dalam prompt.

Opsi

Mari kita lihat opsi konfigurasi secara detail.

Template

Opsi template mendefinisikan prompt yang akan dikirim ke LLM saat perintah dieksekusi.

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

Ini adalah opsi konfigurasi yang diperlukan.

Deskripsi

Gunakan opsi description untuk memberikan deskripsi singkat tentang apa yang dilakukan perintah.

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

Ini ditampilkan di sebelah perintah dalam palet perintah slash.

Agen

Gunakan config agent untuk secara opsional menentukan agen mana yang harus menjalankan perintah ini. Jika ini adalah subagen, perintah akan memicu invokasi subagen secara default. Untuk menonaktifkan perilaku ini, atur subtask ke false.

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

Ini adalah opsi konfigurasi yang opsional. Jika tidak ditentukan, default ke agen Anda saat ini.

Subtask

Gunakan boolean subtask untuk memaksa perintah memicu invokasi subagen. Ini berguna jika Anda ingin perintah tidak mengotori konteks utama Anda dan akan memaksa agen untuk bertindak sebagai subagen, bahkan jika mode diatur ke primary pada konfigurasi agen.

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

Ini adalah opsi konfigurasi yang opsional.

Model

Gunakan config model untuk mengganti model default untuk perintah ini.

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

Ini adalah opsi konfigurasi yang opsional.

Bawaan

Dropstone menyertakan beberapa perintah bawaan seperti /init, /undo, /redo, /help. Pelajari lebih lanjut.