summaryrefslogtreecommitdiffhomepage
path: root/packages/web/src/content/docs/pl/commands.mdx
blob: 757959098cee525c579dec6359a4b7f4e366fe0e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
---
title: Polecenia
description: Tworz polecany dla powtarzalnych zadań.
---

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

```bash frame="none"
/my-command
```

Polecenia stanowią dodatek do dostarczonych, takich jak `/init`, `/undo`, `/redo`, `/share`, `/help`. [Dowiedz się więcej](/docs/tui#commands).

---

## 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`:

```md title=".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.

```bash frame="none"
"/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](/docs/config):

```json title="opencode.jsonc" {4-12}
{
  "$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:

```bash frame="none"
/test
```

---

### Markdown

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

- Globalnie: `~/.config/opencode/commands/`
- Na projekt: `.opencode/commands/`

```markdown title="~/.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:

```bash frame="none"
/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`.

```md title=".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:

```bash frame="none"
/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:

```md title=".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:

```bash frame="none"
/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](/docs/tui#bash-commands) wykonaj obciążenie.

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

```md title=".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:

```md title=".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.

```md title=".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.

```json title="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.

```json title="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](/docs/agents/#subagents), rozwiązanie to ujawnione, podagenta.
Aby móc, ustawa `subtask` na `false`.

```json title="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](/docs/agents/#subagents) 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](/docs/agents).

```json title="opencode.json"
{
  "command": {
    "analyze": {
      "subtask": true
    }
  }
}
```

Jest to **opcjonalna** opcja konfiguracji.

---

### Model

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

```json title="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](/docs/tui#commands).

:::note
Polecenia mogą zostać usunięte.
:::

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