Cloud Skills

Prozeduraler Speicher und Skill-Architektur

Cloud Skills stellen benutzerdefinierten prozeduralen Speicher in XMemo bereit und ermöglichen Entwicklern sowie Teams, Standardbetriebsverfahren (SOPs), Runbooks, Checklisten und wiederverwendbare Prompts direkt im persistenten Speicher abzulegen. Einmal gespeichert, können verbundene Agenten über unterstützte Tools hinweg diese entdecken, abrufen und interpretieren – ganz ohne agentenspezifische Installation oder manuelles Kopieren von Prompts. Eine gespeicherte Cloud Skill unterscheidet sich von der installierten XMemo Skill Client-Laufzeit (@xmemo/skill, node scripts/xmemo-skill.mjs), die als agentenseitige Verbindungsbrücke dient.

• Preview-Funktion: Cloud Skills befindet sich derzeit in der Preview in der Memory Console (#skills).
• Identität und Asset: Jeder Skill verfügt über eine eindeutige skill_id, einen lesbaren Slug, Namen, Beschreibung, Eigentümerbereich (Personal oder Team) und Asset-Status (aktiv oder archiviert).
• Unveränderliche Revisionskette: Ein Skill enthält eine append-only Sequenz von SkillRevision-Snapshots. Jede Revision enthält revision_id, revision_number, instruction_body, canonical_hash und optionale typisierte SkillComponent-Ressourcen.
• Größenbeschränkungen: Root-Instruktionskörper sind auf 64 KiB UTF-8 beschränkt. Eine Revision kann bis zu 50 deklarierte Komponenten enthalten, wobei jede Komponente auf 128 KiB begrenzt ist.
• Komponenten-Ressourcentypen: Komponenten deklarieren explizite semantische Typen einschließlich reference, example, template, document, artifact und script.

Veröffentlichungslebenszyklus und Teamüberprüfung

Cloud Skill Revisionen durchlaufen einen strukturierten Lebenszyklus, um Produktionsabläufe zu schützen und gemeinsames Authoring zu unterstützen:

• draft: Anfänglicher Revisionszustand während der Erstellung und des privaten Stagings vor der öffentlichen Aktivierung.
• proposed: Innerhalb eines Team-Arbeitsbereichs erstellte Revisionen wechseln in den Status proposed und warten auf explizite Überprüfung und Aktivierung durch einen Team-Owner oder Admin.
• published: Die aktive Revision, die für Agenten-Discovery und standardmäßigen Level-1-Abruf berechtigt ist. Nur eine Revision pro Slug ist zu einem bestimmten Zeitpunkt als published gekennzeichnet.
• deprecated: Ältere oder abgelöste Revisionen können als deprecated markiert werden, um das Auslaufen zu signalisieren und gleichzeitig den historischen, reproduzierbaren Abruf zu bewahren.
• Persönliches vs. Team-Publishing: In persönlichen Arbeitsbereichen führt das Speichern mit Veröffentlichungsabsicht direkt zu published. In Team-Arbeitsbereichen verhindern vorgeschlagene Revisionen (proposed), dass ungeprüfte prozedurale Änderungen Agenten-Workflows beeinträchtigen.

Progressiver Abruf: Level 0, Level 1, Level 2

Verbundene Agenten rufen Skills bei Bedarf über Progressive Recall ab, um eine Überlastung der LLM-Kontextfenster mit ungenutzter Dokumentation zu vermeiden:

• Level 0 (Discovery): Die Abfragesuche liefert kompakte Deskriptoren (slug, name, description), die zur Benutzeraufgabe passen, ohne vollständige Anweisungen zu laden.
• Level 1 (Root Recall): Ruft die Stamm-Instruktionen des Skills und das Komponentenmanifest für einen bestimmten Slug ab, standardmäßig auf die veröffentlichte Revision mit Fallback auf die neueste Revision.
• Level 2 (Resource Recall): Ruft eine einzelne deklarierte Komponente ab (wie eine Checklisten-Vorlage oder ein Referenzschema), wobei der Aufrufer eine explizite revision_id angeben muss, um Ressourcen-Inkonsistenzen (resource tearing) zu vermeiden.

recall_cloud_skill(query="incident response")  # Level 0: lightweight descriptors
recall_cloud_skill(slug="incident-response-checklist")  # Level 1: root instructions + manifest
recall_cloud_skill(
  slug="incident-response-checklist",
  revision_id="<revision-id-from-level-1>",
  resource="templates/triage-template.md",
)  # Level 2: one pinned resource component

Revisions-Pinning verhindert Ressourceninkonsistenzen

Wenn ein Skill aktualisiert wird, erstellt XMemo die nächste unveränderliche Revision, anstatt historische Inhalte zu überschreiben. Der Level-1-Root-Abruf liefert Stamm-Instruktionen zusammen mit einer unveränderlichen revision_id und einem Komponentenmanifest. Level-2-Ressourcenanforderungen verlangen vom Aufrufer, genau diese revision_id anzupinnen. Veröffentlicht ein Autor eine neue Revision, während ein Agent einen Workflow ausführt, löst der angepinnte Lesevorgang des Agenten weiterhin genau den Snapshot auf, mit dem er begonnen hat, wodurch Ressourceninkonsistenzen eliminiert werden.

{
  "kind": "root",
  "data": {
    "skill_id": "skill_inc_triage_01",
    "revision_id": "rev_v1_inc_triage",
    "revision_number": 1,
    "canonical_hash": "c7b14d8e9f2a4c10...",
    "resources": [
      {
        "logical_path": "templates/triage-template.md",
        "type": "template",
        "content_hash": "e3b0c44298fc1c14..."
      }
    ]
  }
}

Import-, Export- und Authoring-Oberflächen

Entwickler können Cloud Skills interaktiv in der Webkonsole erstellen oder vorhandene Skills aus Standard-Distributionspaketen importieren:

• Konsolen-Authoring: Erstellen Sie Skills interaktiv in der Memory Console (#skills) mit Markdown-Editor und Komponentenverwaltung.
• Paketimport: Importieren Sie standardmäßige SKILL.md-Dateien (mit YAML-Frontmatter), mehrteilige ZIP-Archive oder Remote-Repositories über URLs (ClawHub oder GitHub).
• Revisions-Diffing: Vergleichen Sie Anweisungsänderungen und Komponentenmodifikationen zwischen zwei beliebigen Revisionen mit Diffing auf Wortebene.
• Source Capsule Export: Exportieren Sie jede Skill-Revision als verlustfreies Source Capsule ZIP-Archiv mit SKILL.md, Komponentenressourcen und Metadaten-Manifest.

Agenten-Zugriffsprofile und Sandbox-Isolation

Autorisierte Agenten greifen über vertraglich definierte MCP-Tools in unterstützten Client-Umgebungen auf Cloud Skills zu:

• Vertraglich vereinbarte MCP-Tools: Die Tools recall_cloud_skill (schreibgeschützt) und save_cloud_skill (Erstellung) werden vertraglich in den Client-Profilen cursor-plugin und ordinary-full bereitgestellt (config/mcp-documentation-contract.json). Sie werden nicht in generic-public-, chatgpt-public- oder claude-code-Profilen exponiert.
• Prompt-ausführbare Prozeduren: Die meisten Cloud Skills sind Standardbetriebsverfahren, die von Agenten direkt als Prompt-Anleitung ohne Codeausführung interpretiert werden.
• Sandbox-Ausführungsgrenze: Die optionale Backend-Skriptausführung über execute_cloud_skill ist eine fortgeschrittene serverseitige Funktion, die von der SandboxExecutionEngine gesteuert wird (heute in keinem Client-Profil freigegeben). Wenn eine lokale Containerisolation per bubblewrap fehlt, schlägt die Ausführung mit SANDBOX_UNAVAILABLE fehl (fail closed).

Verfügbarkeit und Lebenszyklusgrenzen

Cloud Skill Funktionen sind verfügbar, wenn prozedurale Cloud Skills für Ihr Konto aktiviert sind. Revisionen sind unveränderliche, inhaltsadressierte Snapshots, und das Speichern von Änderungen erstellt eine neue Revision, ohne vorherige Einträge zu überschreiben. Wenn Kandidaten-Skills vorhanden sind, zeigt die Konsole ein Überprüfungsbanner an, das eine explizite manuelle Hochstufung erfordert.