Przejdź do głównej zawartości

Polecenia

Tworz polecany dla powtarzalnych zadań.

Polecenia ustawienia monitu, które może zostać uruchomione po uruchomieniu tego polecenia w TUI.

/my-command

Polecenia stanowią dodatek do dostarczonych, takich jak /init, /undo, /redo, /share, /help. Dowiedz się więcej.


Utwórz źródło plikówwe

Utwórz pliki Markdown w katalogu commands/, aby móc korzystać z usług polecanych.

Utwórz .opencode/commands/test.md:

.opencode/commands/test.md
---
description: Run tests with coverage
agent: build
model: anthropic/claude-3-5-sonnet-20241022
---
Run the full test suite with coverage report and show any failures.
Focus on the failing tests and suggest fixes.

Frontmatter posiada właściwości. Treść staje się szablonem.

polecany, w rejestrze /, a następnie polecany.

"/test"

Skonfiguruj

Dostęp do sieci przez połączenie opencode lub udostępnia pliki w katalogu commands/.


JSON

opcja opcja command w swoim opencode config:

opencode.jsonc
{
"$schema": "https://opencode.ai/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.",
// This is shown as the description in the TUI
"description": "Run tests with coverage",
"agent": "build",
"model": "anthropic/claude-3-5-sonnet-20241022"
}
}
}

Teraz możesz wybrać opcję w TUI:

/test

Markdown

Można także definiować polecenia za pomocą plików Markdown. Trzymaj je w:

  • Globalnie: ~/.config/opencode/commands/
  • Na projekt: .opencode/commands/
~/.config/opencode/commands/test.md
---
description: Run tests with coverage
agent: build
model: anthropic/claude-3-5-sonnet-20241022
---
Run the full test suite with coverage report and show any failures.
Focus on the failing tests and suggest fixes.

Nazwa pliku Markdown staje się nazwą referencyjną. Na przykład test.md pozwala biegniesz:

/test

Szybko kliknij

Monity dotyczące niestandardowych urządzeń obsługujących kilka specjalnych symboli zastępczych i składni.


Argumentacja

Przekazuj argumentację do ręki, używając symbolu zastępczego $ARGUMENTS.

.opencode/commands/component.md
---
description: Create a new component
---
Create a new React component named $ARGUMENTS with TypeScript support.
Include proper typing and basic structure.

Uruchomienie reakcji z argumentami:

/component Button

A $ARGUMENTS pozostanie pozostawione przez Button.

Dostępność do poszczególnych argumentów można również uzyskać za pomocą parametrów funkcjonalnych:

  • $1 - Pierwszy argument
  • $2 - Drugi argument
  • $3 - Trzeci argument
  • Biorę dalej…

Na przykład:

.opencode/commands/create-file.md
---
description: Create a new file with content
---
Create a file named $1 in the directory $2
with the following content: $3

Uruchomienie decyzji:

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

Aby przechowywać:

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

Wyjście z pamięci

urządzenie _!command, aby wstawić dane wyjściowe polecenie bash wykonaj obciążenie.

Na przykład, aby sprawdzić narzędzie analityczne:

.opencode/commands/analyze-coverage.md
---
description: Analyze test coverage
---
Here are the current test results:
!`npm test`
Based on these results, suggest improvements to increase coverage.

Lub aby ostatnia zmiana:

.opencode/commands/review-changes.md
---
description: Review recent changes
---
Recent git commits:
!`git log --oneline -10`
Review these changes and suggest any improvements.

Polecenia są uruchamiane w systemie wyjściowym, a ich dane wyjściowe są uruchamiane.


Referencje plików

Dołącz pliki do swojego polecenia, używając @, zawierającego plik.

.opencode/commands/review-component.md
---
description: Review component
---
Review the component in @src/components/Button.tsx.
Check for performance issues and suggest improvements.

Zawartość pliku jest automatycznie umieszczana w pliku.


Opcje

Przyjrzyjmy się szczegółowo opcjom konfiguracji.


Szablon

Opcja template została rozstrzygnięta, która została wysłana do LLM po wykonaniu polecenia.

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

Jest to wymagana opcja konfiguracji.


Opis

Możliwość użycia description, aby skrócony opis działania polecenia.

opencode.json
{
"command": {
"test": {
"description": "Run tests with coverage"
}
}
}

Jest podany jako opis w TUI po wpisaniu polecenia.


Agent

Zastosowanie zastosowania agent, aby określić, który [agent] (./agents) powinien zostać naprawiony do wyboru. Jeśli jest to podagent, rozwiązanie to ujawnione, podagenta. Aby móc, ustawa subtask na false.

opencode.json
{
"command": {
"review": {
"agent": "plan"
}
}
}

Jest to opcjonalna opcja konfiguracji. Jeśli nie jest dostępny, dostępny jest agentem.


Podzadanie

Użyj wartości logicznej subtask, aby wymusić wywołanie podagenta polecenia. Jest to narzędzie, jeśli chcesz, aby decyzja nie zanieczyszczała kontekstu i zmusiło agenta do działania jako subagent, nawet jeśli mode jest podłączony na primary w konfiguracji agent.

opencode.json
{
"command": {
"analyze": {
"subtask": true
}
}
}

Jest to opcjonalna opcja konfiguracji.


Model

Używając konstrukcji model, aby znaleźć ukryty model dla tego polecenia.

opencode.json
{
"command": {
"analyze": {
"model": "anthropic/claude-3-5-sonnet-20241022"
}
}
}

Jest to opcjonalna opcja konfiguracji.


Wbudowany

opencode zawiera kilka istniejących urządzeń, takich jak /init, /undo, /redo, /share, /help; dowiedz się więcej.

Jeśli zdefiniujesz tę samą nazwę, nastąpi decyzja.