Przejdź do treści
Dokumentacja V1
Lokalizacja plików

Umiejętności Agenta

Umiejętności agenta pozwalają opencode odkryć instrukcje wielokrotnego użytku z repozytorium lub katalogu domowego. Umiejętności są ładowane na żądanie za pośrednictwem natywnego narzędzia skill — agenci widzą dostępne umiejętności i w razie potrzeby mogą załadować pełną zawartość.


Utwórz jeden folder na nazwę umiejętności i umieść w nim SKILL.md. opencode przeszukuje te lokalizacje:

  • Project config: .opencode/skills/<name>/SKILL.md
  • Global config: ~/.config/opencode/skills/<name>/SKILL.md
  • Project Claude-compatible: .claude/skills/<name>/SKILL.md
  • Global Claude-compatible: ~/.claude/skills/<name>/SKILL.md
  • Project agent-compatible: .agents/skills/<name>/SKILL.md
  • Global agent-compatible: ~/.agents/skills/<name>/SKILL.md

W przypadku ścieżek lokalnych projektu opencode przechodzi od bieżącego katalogu roboczego, aż dotrze do drzewa roboczego git. Ładuje po drodze dowolne pasujące skills/*/SKILL.md w .opencode/ i dowolne pasujące .claude/skills/*/SKILL.md lub .agents/skills/*/SKILL.md.

Ładowane są także definicje globalne z ~/.config/opencode/skills/*/SKILL.md, ~/.claude/skills/*/SKILL.md i ~/.agents/skills/*/SKILL.md.


Każdy SKILL.md musi zaczynać się od treści YAML. Rozpoznawane są tylko te pola:

  • name (wymagane)
  • description (wymagane)
  • license (opcjonalnie)
  • compatibility (opcjonalnie)
  • metadata (opcjonalnie, mapa string-to-string)

Nieznane pola frontmatter są ignorowane.


name musi:

  • Mieć od 1 do 64 znaków
  • Należy używać małych liter alfanumerycznych i oddzielać je pojedynczym łącznikiem
  • Nie zaczyna się ani nie kończy na -
  • Nie może zawierać następujących po sobie --
  • Dopasuj nazwę katalogu zawierającą SKILL.md

Odpowiednik wyrażenia regularnego:

^[a-z0-9]+(-[a-z0-9]+)*$

description musi mieć od 1 do 1024 znaków. Zadbaj o to, aby agent mógł dokonać prawidłowego wyboru.


Utwórz .opencode/skills/git-release/SKILL.md w ten sposób:

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.

opencode wymienia dostępne umiejętności w opisie narzędzia skill. Każdy wpis zawiera nazwę i opis umiejętności:

<available_skills>
  <skill>
    <name>git-release</name>
    <description>Create consistent releases and changelogs</description>
  </skill>
</available_skills>

Agent ładuje umiejętność wywołując narzędzie:

skill({ name: "git-release" })

Kontroluj, do których umiejętności agenci mogą uzyskać dostęp, używając uprawnień opartych na wzorcach w opencode.json:

JSON
{
  "permission": {
    "skill": {
      "*": "allow",
      "pr-review": "allow",
      "internal-*": "deny",
      "experimental-*": "ask"
    }
  }
}
PermissionBehavior
allowUmiejętność ładuje się natychmiast
denyUmiejętność ukryta przed agentem, dostęp odrzucony
askUżytkownik proszony o zatwierdzenie przed załadowaniem

Wzorce obsługują symbole wieloznaczne: internal-* odpowiada internal-docs, internal-tools itd.


Nadaj konkretnym agentom inne uprawnienia niż globalne ustawienia domyślne.

Dla agentów niestandardowych (w temacie agentów):

YAML
---
permission:
  skill:
    "documents-*": "allow"
---

Dla agentów wbudowanych (w opencode.json):

JSON
{
  "agent": {
    "plan": {
      "permission": {
        "skill": {
          "internal-*": "allow"
        }
      }
    }
  }
}

Całkowicie wyłącz umiejętności agentów, którzy nie powinni ich używać:

Dla agentów niestandardowych (w temacie agentów):

YAML
---
tools:
  skill: false
---

W przypadku agentów wbudowanych:

JSON
{
  "agent": {
    "plan": {
      "tools": {
        "skill": false
      }
    }
  }
}

Jeśli opcja jest wyłączona, sekcja <available_skills> jest całkowicie pomijana.


Jeśli umiejętność nie pojawi się:

  1. Sprawdź, czy SKILL.md jest napisane wielkimi literami
  2. Sprawdź, czy frontmatter zawiera name i description
  3. Upewnij się, że nazwy umiejętności są unikalne we wszystkich lokalizacjach
  4. Sprawdź uprawnienia — umiejętności z deny są ukryte przed agentami