Diese Seite ist eine Übersetzung der englischen Dokumentation. Befehle, Bezeichner und Beispiele bleiben unverändert. Runtime 7.24.4 · SDK 2.6.7. Englische Fassung

Katalog für Skills und Plugins

Status: Aktiv Umfang: öffentlich, aktueller Stand Zuletzt geprüft: 2026-08-12 Verantwortlich: AX-Code-Laufzeit

Auffindbares Register der eingebauten Skills und wie Projektskills hinzugefügt werden.

Das Standardmenü / ist eine Steuerungsebene (/plan, /review, /debug, /status, /model). Ältere eingebaute Skills bleiben nur für den Agenten (Skill-Tool). Das Paket für Backend-Zuverlässigkeit ist auch als Slash-Befehle aufgeführt.

Eingebaute Skills (ausgeliefert unter `packages/ax-code/skills/`)

Skill	Zweck	Slash
`debug-n-fix`	Debuggen, dann mit Prüfung korrigieren	`/debug` verwenden
`debug-only`	Untersuchung ohne Codeänderungen	Nur Agent
`improve-overall`	Breite Qualitätsverbesserungen	Nur Agent
`improve-security`	Sicherheitsbezogene Verbesserungen	Nur Agent
`mcp`	Anleitung zur MCP-Einrichtung	`/mcp` verwenden
`run`	Die App starten und beobachten	Nur Agent
`simplify`	Kürzlich geänderten Code straffen	Nur Agent
`verify`	Bericht zur Laufzeitprüfung	Nur Agent
`verified-change`	Erst nach einem fehlschlagenden Signal bearbeiten, dann dieselbe Prüfung erneut ausführen	`/verified-change`
`safe-db-migration`	Schemaänderungen erweitern, nachfüllen und verengen, mit Rücknahmehinweisen	`/safe-db-migration`
`api-contract`	Öffentliche API- oder Schemaentwicklung zuerst ergänzend	`/api-contract`
`incident-observability`	Nachweisgestützte Störungsdiagnose vor einem Patch	`/incident-observability`
`auth-boundaries`	Authentifizierung und Autorisierung, Mandantenisolation, negative Tests	`/auth-boundaries`
`queue-worker`	Idempotente Änderungen an Warteschlange und Worker sowie doppelte Zustellung	`/queue-worker`
`ruby-on-rails`	Rails-Konventionen, ohne den Rails-Prozess zu starten	Nur Agent

Skills verwenden SKILL.md mit YAML-Frontmatter (name, description, optional paths, allowed-tools).

Projektskills

Legen Sie Skills unter einem dieser Orte ab:

.ax-code/skill/<name>/SKILL.md oder .ax-code/skills/<name>/SKILL.md
.agents/skills/<name>/SKILL.md (Kompatibilität mit Agents / Codex)
.claude/skills/<name>/SKILL.md (Kompatibilität mit Claude Code)
.opencode/skills/<name>/SKILL.md

Auflisten und prüfen:

ax-code            # TUI skill dialog
# or use the skill tool from a session

Aufrufsteuerungen

AX Code liest diese optionalen Steuerungen, wenn ein Skill entdeckt wird:

Ort	Feld	Wirkung
Frontmatter `SKILL.md`	`disable-model-invocation: true`	Den ausdrücklichen Befehl `/skill-name` behalten, den Skill aber von der Modellentdeckung und direkten Tool-Ladungen des Modells ausschließen.
Frontmatter `SKILL.md`	`user-invocable: false`	Den Skill aus Slash-Befehlen weglassen. Der Modellaufruf bleibt verfügbar, sofern er nicht getrennt deaktiviert ist.
Geschwister `agents/openai.yaml`	`policy.allow_implicit_invocation: false`	Ausdrücklichen Slash-Aufruf verlangen, auch für Skills, die über `.agents/skills` importiert werden.

Verwenden Sie YAML-Booleans true und false. Fehlende Steuerungen bewahren die Vorgaben. Wenn mehrere Quellen widersprechen, gewinnt eine einschränkende Erklärung. Ungültige Steuerungstypen oder eine fehlerhafte Sidecar-Richtlinie deaktivieren beide Aufrufmodi und erzeugen Aufrufdiagnosen im Skill-Inventar und in den Laufzeitprotokollen. Korrigieren Sie die Metadaten, bevor Sie den Skill verwenden. Der optionale Sidecar muss kleiner als 64 KiB sein. YAML-Dokumenttrenner und Aliase werden dort nicht unterstützt.

Diese Steuerungen regeln den Skill-Aufruf, unabhängig von vorhandenen Agentenberechtigungen. Eine natürlichsprachliche Erwähnung eines nur manuellen Skills berechtigt das Modell nicht, ihn zu laden. Rufen Sie seinen Slash-Befehl auf. Erklärte allowed-tools bleiben Ablaufanweisungen und gewähren keine Berechtigungen.

Begrenzte Entdeckung

Das Modell erhält anfangs Skill-Zusammenfassungen, nicht die vollen Anweisungen. Jeder Skill-Metadatenblock im Systemprompt und in der Toolbeschreibung hat ein Budget von 8.000 Zeichen. Beschreibungen werden gekürzt, bevor Einträge weggelassen werden. Empfehlungen mit Dateitreffer haben Vorrang, wenn die Liste dieses Budget weiterhin überschreitet. Ein Hinweis auf Weglassung erklärt, wie weitere Zusammenfassungen geholt werden. Das ist eine Zeichengrenze, keine Tokenzahl und keine Leistungsgarantie.

Das Tool skill hat zwei sich gegenseitig ausschließende Modi:

{"name":"api-contract"} lädt einen Skill über die vorhandene Berechtigungsprüfung.
{"query":"database"} sucht geeignete Namen und Beschreibungen, ohne Skill-Körper zu laden.
{"query":"","offset":20} setzt eine Auflistung mit dem genauen nextOffset aus dem vorherigen Ergebnis fort.

Die Suche ist literal und ohne Unterscheidung der Großschreibung. Leere Abfragen listen geeignete Skills. Folgen Sie nextOffset, bis es fehlt. Nur manuelle und wegen Berechtigung abgelehnte Skills sind von der Modellentdeckung ausgeschlossen. Übergroße einzelne Metadateneinträge werden mit einem Hinweis übersprungen. Namen und Quellvorrang bleiben unverändert.

Plugins

Konfigurieren Sie Plugins in ax-code.json:

{
  "plugin": ["file:///absolute/path/to/plugin.js"]
}

Plugins implementieren Hooks @ax-code/plugin (tool.execute.before, tool.execute.after, shell.env, Auth und Weiteres).

Lebensdauer des Rückrufs

Plugin-Fabriken erhalten optionales lifecycle in ihrer Eingabe. lifecycle.signal bricht ab, wenn die Instanz freigegeben oder das Plugin außer Betrieb genommen wird. Registrieren Sie Zeitgeber, Beobachter und Abonnements mit lifecycle.onDispose(cleanup). Die zurückgegebene Funktion hebt dieses Aufräumen auf. Registrierungen laufen höchstens einmal. Eine Registrierung nach der Freigabe startet das Aufräumen sofort. Aufräumrückrufe starten in umgekehrter Registrierungsreihenfolge, jeder mit einem Budget von einer Sekunde, und dürfen gleichzeitig enden.

Transform-Hooks erhalten ein optionales drittes Argument { signal }. Konfigurations- und Ereignis-Hooks erhalten es als zweites Argument. Dieses Signal bricht Arbeit ab, solange der Rückruf aussteht. Verwenden Sie lifecycle.signal für Arbeit, die dem Plugin über einen Rückruf hinaus gehört. Übergeben Sie Signale an abbrechbare Operationen. Rückrufe für Initialisierung, Konfiguration, Ereignisse und Transform haben eine Frist von 15 Sekunden. Eine Zeitüberschreitung nimmt das Plugin für diese Instanz außer Betrieb und bricht seine Lebensdauer ab. Vorhandene Fabriken und Transform-Hooks mit zwei Argumenten funktionieren weiterhin. Die Ausführung eigener Tools und die interaktive Authentifizierung behalten ihre vorhandenen Ausführungsverträge.

Transform-Eingaben sind nur lesende Beobachtungen einfacher Daten. Mutieren Sie den Ausgabeentwurf und warten Sie alle Änderungen ab, bevor Sie zurückkehren. Erfolgreiche Ausgabemutationen werden in Registrierungsreihenfolge sichtbar. Fehlgeschlagene oder verspätete Änderungen werden verworfen. Änderungen der Ereignisnutzlast werden nie veröffentlicht. Eine Berechtigungsablehnung bleibt eine Ablehnung, und fehlgeschlagene oder außer Betrieb genommene Berechtigungshooks verlangen eine Nachfrage, außer eine Ablehnung existiert bereits.

Arrays und einfache Objekte sind vom Laufzeitzustand gelöst. Schemata, Funktionen und Klasseninstanzen behalten ihre Identität und müssen als nur lesend behandelt werden. Plugins bleiben vertrauenswürdiges JavaScript, das im Laufzeitprozess läuft: Abbruch ist kooperativ und kann synchrone Endlosschleifen nicht stoppen oder äußere Wirkungen rückgängig machen.

Hook-Pakete

Siehe Hooks für die fünf offiziellen Lebenszykluspakete (format-after-edit, block-force-push, require-tests-on-stop, protect-env-files, log-bash-commands).

Auswertungs-Harness

Führen Sie die Suite der agentischen Laufzeitschranke und die Suite der Ensemble-Richtlinie für mehrere Modi aus:

cd packages/ax-code
pnpm exec vitest run test/harness/agentic-runtime-eval.test.ts
pnpm exec vitest run test/harness/multi-mode-ensemble-eval.test.ts

Siehe auch Ausführungsmodi für lokal, Cloud, hybrid, Council und Arena.