KI-Agenten-Skills

Opfield ist die Infrastruktur-Control-Plane für Coding-Agenten: Sie arbeiten ohne direkten SSH-Zugriff, und Sie müssen nicht jedem Agenten Ihren Deployment-Prozess von Grund auf beibringen. Die öffentlichen Opfield-Skills erklären, wie Opfield-Ressourcen, Berechtigungen, Tasks, Builds, Auslieferung, Diagnose, Prüfung und Rollback funktionieren: using-opfield ist der Einstiegspunkt, und je ein Skill pro Produktbereich geht in die Details. Der Remote-MCP-Server von Opfield gibt dem Agenten dann authentifizierten Zugriff auf die Ressourcen, die sein Benutzer sehen darf.

Die beiden Ebenen haben unterschiedliche Aufgaben:

Agenten-Skill: wiederverwendbares Betriebswissen, das in Codex, Claude Code, Cursor und andere kompatible Agenten installiert wird.
Opfield MCP: Live-Werkzeuge aus Ihrer Opfield-Installation, geschützt durch OAuth, Ressourcen-Scopes, den Leistungsumfang des Tarifs, Bestätigungen und Audit-Protokollierung.

Die Opfield-Skills installieren

Installieren Sie aus einem Projekt heraus, in dem der Agent Opfield verwenden soll, den vollständigen Satz:

npx skills add opfield/opfield-skills --skill '*'

Das Installationsprogramm lässt Sie die kompatiblen Agenten auswählen, die auf Ihrem Rechner konfiguriert sind. Um die Skills projektübergreifend verfügbar zu machen, installieren Sie sie global mit -g. Um einen einzelnen Skill zu installieren, nennen Sie ihn, zum Beispiel --skill publishing-html-pages; using-opfield allein leitet den Agenten zu den anderen Skills und sagt ihm, wo er sie lesen kann.

Skill	Inhalt
`using-opfield`	Verbindung über MCP, Erkennung von Werkzeugen, Sicherheitsregeln, Tasks und Prüfung; leitet zu den folgenden Skills weiter
`publishing-html-pages`	Generierte HTML-Berichte und statische Websites in Pages veröffentlichen und den Link teilen
`deploying-workloads`	Container, Blue/Green-Deployments, Compose-Projekte, Git-Builds, Volumes und Migration
`high-availability`	Einen Workload mit Replikaten oder Failover auf mehreren Docker Nodes betreiben
`ingress-and-domains`	Domains, DNS, TLS, Routen, Access Lists, Secure Links und Wartungsmodus
`internal-pki`	Private Zertifizierungsstellen und interne Zertifikate
`databases`	Verwaltetes und externes PostgreSQL, Key-Value-Stores und ClickHouse, Bindings, Abfragen und Backups
`storage`	Speicherverbindungen, verwalteter Objektspeicher, Kopieraufträge und die MinIO-Migration
`managing-nodes`	Nodes registrieren, aktualisieren und reparieren, Konsole und Dateien
`observability`	Logging, SIEM-Export, Alarme, Webhooks, Statusseiten und das Audit-Log
`access-control`	Benutzer, Gruppen, Scopes, API-Tokens und OAuth-Freigaben

Der Skill ist einfaches Markdown mit gezielten Referenzen. Sie können ihn vor der Installation im Repository opfield/opfield-skills prüfen und bei einer Installation auf Projektebene unter Versionskontrolle halten.

Als natives Plugin installieren

Claude Code und Codex können denselben kanonischen Skill auch als natives Plugin installieren. Wählen Sie für einen Agenten entweder den Weg über das Plugin oder npx skills; beides zu installieren ist unnötig.

Für Claude Code:

claude plugin marketplace add opfield/opfield-skills
claude plugin install opfield@opfield-skills

Für Codex:

codex plugin marketplace add opfield/opfield-skills --ref main
codex plugin add opfield@opfield-skills

Starten Sie nach dem Installieren oder Aktualisieren des Plugins eine neue Sitzung. Das Repository enthält keine dauerhaft aktiven Hooks: Die Installation allein verbindet sich nicht mit Opfield und ändert keine Infrastruktur.

Die vollständigen Befehle zu Installation, Update und Prüfung werden in der Datei INSTALL.md des Repositorys gepflegt.

Von Ihrem Opfield bereitgestellte Skills

Jede Opfield-Installation stellt dieselben Skills über MCP bereit, passend zu ihrem eigenen Release: Der Index ist die Ressource opfield://skills, jede Datei ist opfield://skills/<name>/SKILL.md, und jeder Skill ist außerdem ein MCP-Prompt namens skill-<name>. Ein mit Opfield verbundener Agent kann sie lesen, ohne etwas zu installieren. Die Skills sind außerdem unter https://docs.opfield.dev/agent/<name>/SKILL.md veröffentlicht und in /agent/index.json sowie in llms.txt aufgeführt.

Den Agenten mit Opfield verbinden

Ein Administrator aktiviert zuerst Settings → Features → OAuth and MCP access → Enable MCP server und gibt dem Benutzer Use MCP (mcp:use) zusammen mit den gewöhnlichen Scopes für die Ressourcen, auf die der Agent zugreifen darf.

Für Codex:

codex mcp add opfield --url https://opfield.example.com/api/mcp
codex mcp login opfield
codex mcp list

Für Claude Code:

claude mcp add --transport http opfield --scope user https://opfield.example.com/api/mcp
claude mcp login opfield
claude mcp get opfield

Ersetzen Sie opfield.example.com durch den kanonischen öffentlichen Hostnamen Ihrer Opfield-Installation. Die Authentifizierung wird über Opfield OAuth in einem Browser abgeschlossen. Erstellen Sie für MCP kein API-Token und fügen Sie keines ein.

Zu Callback-Richtlinie, kompakter Werkzeugerkennung und Verbindungsfehlern nutzen Sie die vollständige Anleitung REST API und MCP.

Mit einer reinen Leseaufgabe beginnen

Prüfen Sie die Verbindung und die Berechtigungsgrenze, bevor Sie den Agenten um eine Änderung bitten:

Use $using-opfield. List the Opfield Nodes and workloads I can access,
summarize warnings and active Tasks, and recommend the safest next action.
Do not change anything.

Probieren Sie dann eine eingegrenzte Anfrage zur Auslieferung:

Use $using-opfield to inspect how this application is currently
published. Propose an Opfield-native update and rollback plan. Wait for my
approval before changing infrastructure.

Der Skill weist den Agenten an, zuerst den aktuellen Zustand zu lesen, die Zuständigkeit für Ressourcen zu wahren, direkte Änderungen am Host zu vermeiden, asynchrone Tasks zu verfolgen und die tatsächliche Ressource oder das HTTPS-Ergebnis zu prüfen, statt eine angenommene Anfrage als Erfolg zu werten.

Berechtigungen und Sicherheit

Erstellen Sie einen eigenen Opfield-Benutzer oder eine eigene Gruppe für den Agentenzugriff und vergeben Sie nur die nötigen Ressourcen und Aktionen. MCP umgeht die Opfield-Autorisierung nicht: Das Entfernen von mcp:use, eine Änderung der Gruppenmitgliedschaft oder das Einengen von Ressourcen-Scopes wirkt sich auf künftige Aufrufe über die bestehende Verbindung aus.

Ein Agent, dessen Benutzer nur in bestimmten Ordnern, Nodes oder Ressourcen arbeiten darf, bleibt innerhalb dieser Grenzen. Ist die Verbindung eingeschränkt, fügt Opfield beim Verbindungsaufbau eine Zusammenfassung dieses Zugriffs zu den Anweisungen des MCP-Servers hinzu. Die Skills using-opfield und access-control weisen den Agenten an, get_my_access aufzurufen oder opfield://access zu lesen, wenn eine Liste leer zurückkommt oder ein Erstellen auf oberster Ebene abgelehnt wird, und beim Erstellen folderId zu übergeben; ein abgelehntes Erstellen nennt außerdem die Ordner, die er verwenden darf. Siehe Herausfinden, worauf der Aufrufer zugreifen kann.

Verwenden Sie getrennte Identitäten und Opfield-Installationen für Entwicklung und Produktion. Ein Skill gibt einem Agenten Anweisungen, keine Befugnisse; was er tun kann, bestimmen die Scopes des verbundenen Benutzers und dessen ausdrückliche Anfrage.