Perintah

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

/my-command

Perintah kustom merupakan tambahan dari perintah bawaan seperti /init, /undo, /redo, /help. Pelajari lebih lanjut.

Membuat file perintah

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

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 dengan nama perintah.

/test

Konfigurasi

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

JSON

Gunakan opsi command di config Dropstone Anda:

{
  "$schema": "https://dropstone.io/schema/config.json",
  "command": {
    // Ini menjadi nama perintah
    "test": {
      // Ini adalah prompt yang akan dikirim ke LLM
      "template": "Run the full test suite with coverage report and show any failures.\nFocus on the failing tests and suggest fixes.",
      // Ditampilkan sebagai deskripsi di palet perintah slash
      "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-proyek: .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 kustom mendukung beberapa placeholder dan sintaks khusus.

Argumen

Berikan 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 posisi:

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

Misalnya:

---
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 kustom 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 dijalankan di direktori root proyek Anda dan outputnya menjadi bagian dari prompt.

Referensi file

Sertakan file dalam perintah Anda menggunakan @ diikuti dengan nama file.

---
description: Review component
---

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

Konten file akan disertakan dalam prompt secara otomatis.

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

Deskripsi

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

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

Ini ditampilkan di samping perintah di palet perintah slash.

Agent

Gunakan konfigurasi agent untuk secara opsional menentukan agent mana yang harus mengeksekusi perintah ini. Jika ini adalah subagent, perintah akan memicu pemanggilan subagent secara default. Untuk menonaktifkan perilaku ini, atur subtask ke false.

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

Ini adalah opsi konfigurasi opsional. Jika tidak ditentukan, defaultnya adalah agent Anda saat ini.

Subtask

Gunakan boolean subtask untuk memaksa perintah memicu pemanggilan subagent. Ini berguna jika Anda ingin perintah tidak mencemari konteks utama Anda dan akan memaksa agent untuk bertindak sebagai subagent, bahkan jika mode diatur ke primary pada konfigurasi agent.

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

Ini adalah opsi konfigurasi opsional.

Model

Gunakan konfigurasi model untuk mengganti model default untuk perintah ini.

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

Ini adalah opsi konfigurasi opsional.

Bawaan

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

Perintah bawaan /review menjalankan tinjauan multi-fase — sudut pandang pencari, verifikasi independen, lalu daftar temuan yang dibatasi. Kontrol kedalamannya dengan review.effort.