mirror of
https://github.com/anomalyco/opencode.git
synced 2026-05-03 03:06:44 +00:00
223 lines
4.7 KiB
Plaintext
223 lines
4.7 KiB
Plaintext
---
|
|
title: "Ajan becerileri"
|
|
description: "SKILL.md ile tekrar kullanilabilir davranis tanimlayin"
|
|
---
|
|
|
|
Ajan becerileri, OpenCode'un deponuzdan veya ev dizininizden tekrar kullanilabilir talimatlari kesfetmesini saglar.
|
|
Beceriler, yerel `skill` araci uzerinden ihtiyac aninda yuklenir; ajanlar mevcut becerileri gorur ve gerektiginde tam icerigi yukler.
|
|
|
|
---
|
|
|
|
## Dosyalari yerlestirin
|
|
|
|
Her beceri adi icin bir klasor olusturun ve icine bir `SKILL.md` koyun.
|
|
OpenCode su konumlari tarar:
|
|
|
|
- Proje konfigurasyonu: `.opencode/skills/<name>/SKILL.md`
|
|
- Genel konfigurasyon: `~/.config/opencode/skills/<name>/SKILL.md`
|
|
- Proje Claude uyumlu: `.claude/skills/<name>/SKILL.md`
|
|
- Genel Claude uyumlu: `~/.claude/skills/<name>/SKILL.md`
|
|
- Proje agent uyumlu: `.agents/skills/<name>/SKILL.md`
|
|
- Genel agent uyumlu: `~/.agents/skills/<name>/SKILL.md`
|
|
|
|
---
|
|
|
|
## Kesfi anlayin
|
|
|
|
Proje yerel yollarinda OpenCode, mevcut calisma dizininizden baslayip git worktree kokune kadar yukari cikar.
|
|
Bu sirada `.opencode/` altindaki eslesen `skills/*/SKILL.md` dosyalarini ve `.claude/skills/*/SKILL.md` ya da `.agents/skills/*/SKILL.md` dosyalarini yukler.
|
|
|
|
Genel tanimlar da `~/.config/opencode/skills/*/SKILL.md`, `~/.claude/skills/*/SKILL.md` ve `~/.agents/skills/*/SKILL.md` yollarindan yuklenir.
|
|
|
|
---
|
|
|
|
## Frontmatter yazin
|
|
|
|
Her `SKILL.md`, YAML frontmatter ile baslamalidir.
|
|
Sadece su alanlar taninir:
|
|
|
|
- `name` (zorunlu)
|
|
- `description` (zorunlu)
|
|
- `license` (istege bagli)
|
|
- `compatibility` (istege bagli)
|
|
- `metadata` (istege bagli, string-to-string map)
|
|
|
|
Bilinmeyen frontmatter alanlari yok sayilir.
|
|
|
|
---
|
|
|
|
## Adlari dogrulayin
|
|
|
|
`name` su kurallari saglamalidir:
|
|
|
|
- 1-64 karakter olmali
|
|
- Kucuk harf alfanumerik ve tekli tire ayirici kullanmali
|
|
- `-` ile baslamamali veya bitmemeli
|
|
- Ardisik `--` icermemeli
|
|
- `SKILL.md` dosyasini barindiran klasor adi ile ayni olmali
|
|
|
|
Esdeger regex:
|
|
|
|
```text
|
|
^[a-z0-9]+(-[a-z0-9]+)*$
|
|
```
|
|
|
|
---
|
|
|
|
## Uzunluk kurallarina uyun
|
|
|
|
`description` 1-1024 karakter arasinda olmali.
|
|
Ajanin dogru secim yapmasi icin yeterince acik yazin.
|
|
|
|
---
|
|
|
|
## Ornek kullanin
|
|
|
|
`.opencode/skills/git-release/SKILL.md` dosyasini soyle olusturun:
|
|
|
|
```markdown
|
|
---
|
|
name: git-release
|
|
description: Create consistent releases and changelogs
|
|
license: MIT
|
|
compatibility: opencode
|
|
metadata:
|
|
audience: maintainers
|
|
workflow: github
|
|
---
|
|
|
|
## What I do
|
|
|
|
- Draft release notes from merged PRs
|
|
- Propose a version bump
|
|
- Provide a copy-pasteable `gh release create` command
|
|
|
|
## When to use me
|
|
|
|
Use this when you are preparing a tagged release.
|
|
Ask clarifying questions if the target versioning scheme is unclear.
|
|
```
|
|
|
|
---
|
|
|
|
## Arac aciklamasini taniyin
|
|
|
|
OpenCode, `skill` araci aciklamasinda mevcut becerileri listeler.
|
|
Her kayitta beceri adi ve aciklamasi yer alir:
|
|
|
|
```xml
|
|
<available_skills>
|
|
<skill>
|
|
<name>git-release</name>
|
|
<description>Create consistent releases and changelogs</description>
|
|
</skill>
|
|
</available_skills>
|
|
```
|
|
|
|
Ajan, araci cagirarak beceri yukler:
|
|
|
|
```
|
|
skill({ name: "git-release" })
|
|
```
|
|
|
|
---
|
|
|
|
## Izinleri yapilandirin
|
|
|
|
`opencode.json` icinde pattern tabanli izinlerle ajanlarin hangi becerilere erisecegini kontrol edin:
|
|
|
|
```json
|
|
{
|
|
"permission": {
|
|
"skill": {
|
|
"*": "allow",
|
|
"pr-review": "allow",
|
|
"internal-*": "deny",
|
|
"experimental-*": "ask"
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
| Permission | Behavior |
|
|
| ---------- | ------------------------------------------ |
|
|
| `allow` | Beceri hemen yuklenir |
|
|
| `deny` | Beceri ajandan gizlenir, erisim reddedilir |
|
|
| `ask` | Yukleme oncesi kullanicidan onay istenir |
|
|
|
|
Pattern'lar wildcard destekler: `internal-*`, `internal-docs`, `internal-tools` vb. adlarla eslesir.
|
|
|
|
---
|
|
|
|
## Ajan bazinda gecersiz kilin
|
|
|
|
Belirli ajanlara genel varsayimlardan farkli izinler verebilirsiniz.
|
|
|
|
**Ozel ajanlar icin** (agent frontmatter icinde):
|
|
|
|
```yaml
|
|
---
|
|
permission:
|
|
skill:
|
|
"documents-*": "allow"
|
|
---
|
|
```
|
|
|
|
**Yerlesik ajanlar icin** (`opencode.json` icinde):
|
|
|
|
```json
|
|
{
|
|
"agent": {
|
|
"plan": {
|
|
"permission": {
|
|
"skill": {
|
|
"internal-*": "allow"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## Skill aracini kapatin
|
|
|
|
Beceri kullanmamasi gereken ajanlar icin skill aracini tamamen kapatabilirsiniz:
|
|
|
|
**Ozel ajanlar icin**:
|
|
|
|
```yaml
|
|
---
|
|
tools:
|
|
skill: false
|
|
---
|
|
```
|
|
|
|
**Yerlesik ajanlar icin**:
|
|
|
|
```json
|
|
{
|
|
"agent": {
|
|
"plan": {
|
|
"tools": {
|
|
"skill": false
|
|
}
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
Devre disi oldugunda `<available_skills>` bolumu tamamen kaldirilir.
|
|
|
|
---
|
|
|
|
## Yukleme sorunlarini giderin
|
|
|
|
Bir beceri listede gorunmuyorsa:
|
|
|
|
1. `SKILL.md` adinin tamamen buyuk harfle yazildigini dogrulayin
|
|
2. Frontmatter icinde `name` ve `description` oldugunu kontrol edin
|
|
3. Tum konumlarda beceri adlarinin benzersiz oldugundan emin olun
|
|
4. Izinleri kontrol edin - `deny` olan beceriler ajanlardan gizlenir
|