Leitfaden für Cloud Skills

Ziel des Benutzers

Erstellen, überprüfen, veröffentlichen und rufen Sie wiederverwendbare prozedurale Skills (wie Runbooks, Checklisten und Standardarbeitsanweisungen) über verbundene Agenten hinweg ab, ohne manuelles Kopieren und Einfügen, wiederholte Konfiguration pro Agent oder Überlastung des Kontextfensters.

Verfügbarkeit und Voraussetzungen

Cloud Skills befindet sich derzeit in der Preview in der Memory Console unter https://xmemo.dev/me#skills. Stellen Sie sicher, dass Ihre Umgebung die folgenden Anforderungen erfüllt, bevor Sie Skills erstellen oder abrufen:

• Funktionsaktivierung: Aktiv, wenn prozedurale Cloud Skills für Ihr Konto freigeschaltet sind.
• Auswahl des Arbeitsbereichs: Der persönliche Bereich (https://xmemo.dev/me#skills) speichert private Skills. Der Team-Bereich (https://xmemo.dev/me?space=<team_id>#skills) teilt Skills mit authentifizierten Teammitgliedern unter rollenbasierter Governance.
• Agent-Token-Bereiche: Der Agentenabruf erfordert den Bereich skills:read oder memory:read. Das Erstellen von Skills und Veröffentlichen von Revisionen erfordert den Bereich skills:write oder memory:write.
• Unterstützte Client-Profile: Die MCP-Werkzeuge recall_cloud_skill und save_cloud_skill sind in den Client-Profilen cursor-plugin und ordinary-full verfügbar; generische öffentliche Oberflächen und Chat-Schnittstellen stellen Werkzeuge zur Skill-Erstellung nicht direkt bereit.

1. Zu Cloud Skills in der Memory Console navigieren

Öffnen Sie die Memory Console und wählen Sie den Bereich Cloud Skills aus:

• Persönlicher Bereich: Öffnen Sie https://xmemo.dev/me#skills, um Ihre persönlichen prozeduralen Runbooks zu verwalten.
• Team-Bereich: Öffnen Sie https://xmemo.dev/me?space=<team_id>#skills, um geteilte organisatorische Skills zu verwalten.
• Konsolenoberfläche: Das Bedienfeld zeigt die Liste der Skills, die Suchleiste ("Search skills by name, slug, or keywords...") sowie die primären Aktionen: "New Skill" und "Import Skill".

2. Prozeduralen Skill und deklarierte Komponenten erstellen

Klicken Sie auf "New Skill", um das Modal zur Skill-Erstellung zu öffnen. Konfigurieren Sie die Skill-Metadaten, grundlegenden Anweisungen und Komponentenressourcen:

• Skill Name: Geben Sie "Incident Response Checklist" ein (Pflichtfeld).
• Slug: Geben Sie eine kleingeschriebene Kennung "incident-response-checklist" ein (1–64 alphanumerische Zeichen oder Bindestriche).
• Description: Geben Sie "Standard operating procedure for triaging and resolving high-severity production incidents." ein.
• Instructions: Verfassen Sie grundlegende prozedurale Anweisungen in Markdown (begrenzt auf 64 KiB UTF-8).
• Components: Fügen Sie die Vorlagenkomponente templates/triage-template.md vom Typ template hinzu, die den Incident-Fragebogen enthält.

# Incident Response Checklist

When a high-severity production alert triggers:
1. Identify the impacted service and declare an incident channel.
2. Verify service error rates and recent deployment events.
3. Complete the triage questionnaire at `templates/triage-template.md`.
4. Apply documented mitigation or initiate canary rollback.
5. Record timeline events and assign follow-up action items.

3. Skill-Revision überprüfen und veröffentlichen

Speichern Sie die Skill-Revision und beobachten Sie das Verhalten der Veröffentlichung im persönlichen und im Team-Bereich:

• Persönliche Veröffentlichung: In einem persönlichen Arbeitsbereich überführt das Speichern mit Veröffentlichungsabsicht die Revision v1 direkt in "Published", wodurch sie für autorisierte Agenten sofort auffindbar wird.
• Workflow für Team-Reviews: In einem Team-Arbeitsbereich erstellt das Speichern die Revision v1 mit dem Status "proposed". Teammitglieder können die Anweisungen prüfen, Komponenten-Diffs einsehen und die Ausführung testen, bevor ein Team-Eigentümer oder Administrator die Revision veröffentlicht.
• Entwurfsstadium: Wenn die Veröffentlichungsabsicht nicht markiert ist, verbleibt die Revision im Status "Draft" zur privaten Bearbeitung und zum Testen, ohne für die Agentensuche freigegeben zu werden.

4. Schrittweisen Agentenabruf überprüfen

Verbundene Agenten fragen veröffentlichte Skills bei Bedarf über drei progressive Stufen ab und rufen sie ab, um Kontextbudgets zu schonen:

• Stufe 0 (Erkennung): Der Agent sucht anhand einer Aufgabenabfrage und erhält kompakte Deskriptoren ohne vollständige Anweisungen.
• Stufe 1 (Basisanweisungen): Der Agent ruft Basisanweisungen und das Komponentenmanifest mithilfe des Skill-Slugs ab.
• Stufe 2 (Gepinnte Ressource): Der Agent ruft die deklarierte Vorlagenkomponente ab, indem er die exakte revision_id aus Stufe 1 übergibt.

# Level 0: Discover relevant skills by task query
recall_cloud_skill(query="incident response")

# Level 1: Retrieve root instructions and component manifest
recall_cloud_skill(slug="incident-response-checklist")

# Level 2: Retrieve pinned component resource without resource tearing
recall_cloud_skill(
  slug="incident-response-checklist",
  revision_id="<revision-id-from-level-1>",
  resource="templates/triage-template.md",
)

5. Verfahren aktualisieren und Revisionsunveränderlichkeit überprüfen

Wenn sich betriebliche Anforderungen ändern, aktualisieren Sie den Skill, um eine neue unveränderliche Revision zu erstellen:

• Skill-Details öffnen: Wählen Sie in der Konsole "Incident Response Checklist" und klicken Sie auf "New Revision".
• Anweisungen anpassen: Fügen Sie vor dem Rollback einen obligatorischen Canary-Verifizierungsschritt hinzu.
• Neue Revision speichern: Das Speichern der Inhalte erhöht den Revisionszähler auf v2 und erzeugt eine neue unveränderliche revision_id und einen neuen canonical_hash.
• Schutz durch Revisions-Pinning: Laufende Agenten-Workflows, die an Revision v1 gebunden sind, lesen weiterhin v1-Ressourcen ohne Datenzerreißen, während neue Stufe-1-Abfragen automatisch die veröffentlichte Revision v2 auflösen.

Beobachtbares Ergebnis

Eine erfolgreiche Erstellung und Veröffentlichung von Cloud Skills führt zu sichtbaren Änderungen in der Konsole und den Agentenschnittstellen:

• Konsolen-Status-Badge: Die Skill-Karte zeigt das Badge "Published", das aktive Revisions-Tag (wie v1 oder v2) und die Anzahl der Komponenten.
• Ressourcen-Explorer: Die Detailansicht zeigt die deklarierte Komponente templates/triage-template.md mit Syntaxvorschau und Kopieraktionen.
• Agent-Recall-Umschlag: Stufe 1 liefert eine typisierte Stammantwort mit instruction_body, revision_id und Ressourcenliste. Stufe 2 liefert den exakten Komponententext.
• Exportverfügbarkeit: Klicken Sie in der Detailansicht auf "Export", um ein Source Capsule ZIP-Archiv herunterzuladen, das SKILL.md, Manifest-Metadaten und deklarierte Komponenten enthält.

Worauf Agenten zugreifen können

Agenten und menschliche Benutzer agieren unter strengen Authentifizierungs- und Fähigkeitsgrenzen:

• Client-Profile: Die MCP-Werkzeuge recall_cloud_skill und save_cloud_skill sind vertraglich in den Profilen cursor-plugin und ordinary-full freigegeben; generische öffentliche und Chat-Client-Profile stellen sie nicht bereit.
• Durchsetzung von Berechtigungsbereichen: Agenten authentifizieren sich mit API-Schlüsseln oder OAuth-Tokens mit den Bereichen skills:read oder skills:write. Tokens für den persönlichen Speicher können Team-Skills nicht einsehen, sofern sie nicht explizit an dieses Team gebunden sind.
• Schutz von Entwürfen und Vorschlägen: Agenten können in der Stufe-0-Abfrageerkennung weder Entwurfsrevisionen, vorgeschlagene Revisionen im Review noch archivierte Skills auffinden oder abrufen.
• Prompt-ausführbare Anleitungen: Verbundene Agenten interpretieren prozedurale Anweisungen direkt als Prompt-Kontext; Skills führen keinen automatischen Code auf dem Host aus.

Freigabe- und Lebenszyklusgrenzen

Cloud Skills wahren eine klare Mandantentrennung zwischen persönlichen Runbooks und kollaborativen Teamressourcen:

• Bereichsgrenzen: Persönliche Skills (/me#skills) sind für den Ersteller privat. Team-Skills (?space=<team_id>#skills) werden mit authentifizierten Teammitgliedern geteilt.
• Team-Genehmigung: Team-Revisionen erfordern die Überprüfung durch Eigentümer oder Administratoren vor dem Übergang vom Status "proposed" zu "published".
• Archivierung im Vergleich zum Löschen: Das Archivieren eines Skills (DELETE /v1/skills/{skill_id}) deaktiviert die Erkennung durch Agenten und blendet ihn aus der aktiven Liste aus, während die unveränderliche Revisionshistorie erhalten bleibt.
• Unveränderlichkeit von Revisionen: Revisionen sind unveränderliche, inhaltsadressierte Snapshots; das Speichern von Aktualisierungen erstellt eine neue Revision, anstatt bestehende Datensätze zu überschreiben.
• Banner zur Kandidatenprüfung: Die Konsole kann ein Kandidatenbanner mit den Aktionen Promote und Dismiss anzeigen, wenn ein Kandidat vorliegt; Kandidaten erfordern eine manuelle Überprüfung.

Fehlerbehebung

Diagnostizieren und beheben Sie häufige Probleme bei Cloud Skills anhand der folgenden Schritte:

• Ressourcenabruffehler (REVISION_PINNING_VIOLATION): Ressourcenanfragen der Stufe 2 erfordern eine explizite revision_id. Fehlt diese, verweigert der Server die Anfrage, um Datenzerreißen zu verhindern. Lösung: Übergeben Sie die in der Stufe-1-Antwort zurückgegebene revision_id.
• Skill nicht gefunden (SKILL_NOT_FOUND): Vergewissern Sie sich, dass der Slug exakt übereinstimmt und die Abfrage im richtigen Arbeitsbereich ausgeführt wird (Personal vs Team ?space=<team_id>).
• Zugriff verweigert (403 Forbidden): Überprüfen Sie, ob das Agent-Token skills:read (zum Abrufen) oder skills:write (zum Speichern) enthält und der authentifizierte Benutzer zum Zielteam gehört.
• Team-Revision verbleibt im vorgeschlagenen Zustand: Ein Agent, der einen Team-Skill abfragt, erhält die aktuell veröffentlichte Revision, bis ein Team-Eigentümer oder Administrator die vorgeschlagene Revision prüft und veröffentlicht.
• Laufzeitumgebung nicht verfügbar (503): Wird zurückgegeben, wenn das Cloud Skills-Subsystem in Ihrer Bereitstellungsumgebung deaktiviert oder nicht konfiguriert ist.

Verwandte Referenzen

Konsultieren Sie verwandte Dokumentationen für konzeptionelle Architektur, Werkzeugparameter und Teamzusammenarbeit:

• Konzepte zu Cloud Skills: /docs/concepts/cloud-skills für Drei-Schichten-Architektur, Komponentenmodelle und Revisions-Pinning.
• recall_cloud_skill Referenz: /docs/tools/recall-cloud-skill für Parameterschemata und Antwortformate.
• save_cloud_skill Referenz: /docs/tools/save-cloud-skill für Erstellungsparameter und Komponenten-Upload-Formate.
• Memory Console: /docs/guides/memory-console für Weboberflächen-Layout, Bereichsauswahl und Einstellungen.
• Teams: /docs/capabilities/teams für Zusammenarbeit im Team-Arbeitsbereich und Rollenberechtigungen.