Nur ein überprüftes Verfahren veröffentlichen
Geben Sie dauerhafte Anweisungen und optionale typisierte Komponenten an. Halten Sie Anmeldedaten und private Inhalte aus dem Skill-Text fern; das Tool speichert das Verfahren im authentifizierten persönlichen oder Team-Bereich.
Öffentliches MCP-Tool
save_cloud_skill
Zweck
Ein wiederverwendbares Cloud Skill erstellen oder aktualisieren und die nächste unveränderliche Revision seiner Anweisungen und typisierten Komponenten erzeugen.
Wann zu verwenden
- Ein bewährtes Agentenverfahren oder eine Arbeitsanweisung soll als wiederverwendbarer Skill veröffentlicht werden.
- Ein bestehendes Skill erhält eine neue Revision mit verbesserten Anweisungen oder Skriptkomponenten.
- Teamspezifische Automatisierungen sollen zentral verwaltet und versioniert bereitgestellt werden.
Wann NICHT zu verwenden
- Speichern Sie keine geheimen Anmeldedaten, Tokens oder privaten Schlüssel im Skill-Text oder in den Komponenten.
- Verwenden Sie es nicht für flüchtige Prompts oder einmalige Chat-Instruktionen.
- Verwenden Sie es nicht für allgemeine Wissensdokumente; nutzen Sie Knowledge Bases für Dokumentensammlungen.
- Erstellen Sie keine neuen Skills, wenn eine Ergänzung bestehender Erinnerungen via remember ausreicht.
Erforderlicher Scope
- cloud_skill:write (oder memory:write auf Systemen mit vereintem Berechtigungsmodell).
- Der Aufrufer muss berechtigt sein, Skills im persönlichen oder Team-Bereich zu veröffentlichen.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
name | string · erforderlich | Lesbarer Name des Skills (z. B. Deploy Service Runbook). |
instructions | string · erforderlich | Vollständige Markdown-Anweisungen und Verhaltensrichtlinien für den Skill. |
slug | string · Standard: derived from name | Eindeutiger URL-tauglicher Bezeichner für das Skill (z. B. deploy-service). |
description | string · Standard: empty | Kurzbeschreibung des Zwecks und der Einsatzszenarien für Suchindizes. |
publish | boolean · Standard: true | Gibt an, ob die neue Revision sofort als aktive Arbeitsversion freigegeben werden soll. |
components_json | JSON array string · Standard: [] | Optionales JSON-Array typisierter Komponenten (z. B. Skripte, Vorlagen, Referenzen). |
Rückgabeschema
Ein JSON CloudSkillResponseEnvelope mit object='cloud_skill', schema_version='xmemo.cloud_skill.v1', kind='root', render_status, warnings und data mit skill_id, slug, name, description, revision_id, revision_number, instructions, canonical_hash und einem typisierten Ressourcenmanifest.
Beispiele
save_cloud_skill({
name: "deployment-procedure",
instructions: "Check the release, run the smoke test, and report the result.",
slug: "deployment-procedure",
description: "A bounded deployment verification procedure",
publish: true
})Fehler
- 401/403: Unzureichende Schreibberechtigung für Cloud Skills.
- Validierungsfehler: Name oder Anweisungen fehlen, oder Komponenten verletzen das Komponentenschema.
- Namenskonflikt: Der angegebene Slug existiert bereits in einem anderen unberechtigten Bereich.
- Sicherheitsblockade: Skriptkomponenten enthalten verbotene Aufrufe oder unsichere Muster.
Zugehörige Tools
- recall_cloud_skill — Gespeicherte Skills und deren Revisionen vor einer Ausführung inspizieren.
- execute_cloud_skill — Ein freigegebenes Skript aus einer geprüften Skill-Revision ausführen.
- remember — Ergänzende Kontextdaten zum Einsatz des Skills im Speicher hinterlegen.
Quelle: Cloud Skills