ReferenzSkillsSkill-Updates und Lebenszyklus

Skill

Skill-Updates und Lebenszyklus

Prüfen Sie Versionen, aktualisieren Sie Releases, verwalten Sie Backups und entfernen Sie die lokale eigenständige Skill-Laufzeitumgebung sicher.

Getrennte Versionen für Skill und CLI

Die eigenständige Skill-Laufzeitumgebung und die XMemo CLI sind unabhängige Pakete mit separaten Versionsnummern und Veröffentlichungszyklen. Das Aktualisieren des einen Pakets verändert nicht automatisch das andere.

  • Eigenständiges Skill-Paket: Version 1.1.35 (@xmemo/skill@1.1.35), überprüfbar über node scripts/xmemo-skill.mjs --version oder doctor.
  • XMemo CLI-Paket: Version 0.4.x / 1.x (@xmemo/client@0.4.187), überprüfbar über xmemo --version.
  • Unabhängige Aktualisierungen: Das Aktualisieren von @xmemo/client über npm aktualisiert den CLI-Orchestrator, ändert jedoch keine bereits installierten Skill-Verzeichnisse, bis xmemo skill update ausgeführt wird.
  • Subresource Integrity (SRI): Die CLI überprüft Paket-Tarballs mittels sha512 SRI, bevor Dateien in Agent-Skill-Verzeichnisse extrahiert werden.
# Inspect standalone Skill version:
node scripts/xmemo-skill.mjs --version

# Inspect XMemo CLI version:
xmemo --version

# Inspect detailed runtime health and discovery status:
node scripts/xmemo-skill.mjs doctor

CLI-Befehle für den Skill-Lebenszyklus

Die XMemo CLI bietet dedizierte Befehle, um den Installationsstatus zu prüfen, Installationen über Agent-Clients hinweg durchzuführen, auf neuere Releases zu aktualisieren und Skills sicher zu entfernen.

  • Status: xmemo skill status [--client <id>|--all] [--json] prüft installierte Skills und meldet Version, Client-ID und Zielpfad.
  • Installieren: xmemo skill install [--client <id>|--all] [--project] [--global] [--dir <path>] [--dry-run] [--yes] [--force] [--json].
  • Aktualisieren: xmemo skill update [--client <id>|--all] [--dry-run] [--yes] [--json] aktualisiert installierte Skills auf das neueste festgeschriebene Release.
  • Entfernen: xmemo skill remove --client <id> [--project] [--yes] [--json] entfernt verifizierte Skill-Ordner sicher.
# Check status across all detected clients:
xmemo skill status --all

# Update an installed skill with preview:
xmemo skill update --client codex --dry-run
xmemo skill update --client codex --yes

# Install to a specific client:
xmemo skill install --client claude-code --yes

Umgang mit vorhandenen Installationen, Backups und Wiederherstellung

Um versehentliches Überschreiben oder den Verlust von Anpassungen zu verhindern, verweigert das Installationsprogramm das Überschreiben eines vorhandenen Verzeichnisses ohne explizite Bestätigung und erstellt automatisch Backups.

  • Verweigerung des Überschreibens: Das erneute Ausführen der Installation in einem bestehenden Skill-Verzeichnis stoppt und meldet eine vorhandene Installation, sofern nicht --force (oder XMEMO_SKILL_FORCE=1) übergeben wird.
  • Automatischer Speicherort für Backups: Wenn --force oder skill update eine Installation ersetzt, wird die vorherige Version nach ~/.xmemo/backups/skills/<client_id>/<name>-<timestamp> verschoben (oder nach ~/.xmemo/backups/skills/custom/<basename>-<timestamp> für benutzerdefinierte Verzeichnisse).
  • Trennung vom Laden durch Agenten: Backups verbleiben sicher in ~/.xmemo/backups/ außerhalb der aktiven Skill-Suchpfade des Agenten, was doppelte Werkzeugregistrierungen verhindert.
  • Wiederherstellung: Um ein Update rückgängig zu machen, stellen Sie das gesicherte Backup-Verzeichnis aus ~/.xmemo/backups/skills/<client_id>/ wieder im aktiven Agent-Skill-Ordner her.
# Force re-install with automatic backup creation:
xmemo skill install --client codex --force --yes

# Inspect preserved backups:
ls -la ~/.xmemo/backups/skills/codex/

Was nach dem Entfernen erhalten bleibt

Das Entfernen eines Skills ist ein lokaler Dateisystemvorgang, der die Verknüpfung des Skill-Verzeichnisses aufhebt. Anmeldedaten, lokale Konfigurationen oder entfernte Erinnerungen werden dabei nicht gelöscht.

  • Lokales Skill-Verzeichnis entfernt: xmemo skill remove löscht ausschließlich das verifizierte xmemo-memory-Verzeichnis und verweigert fremde Ordner.
  • Anmeldedaten bleiben intakt: ~/.xmemo/skill-credentials.json und die Umgebungsvariable XMEMO_KEY bleiben unberührt.
  • Konfiguration bleibt intakt: Lokale Einstellungen unter ~/.xmemo/ bleiben erhalten.
  • Entfernte Erinnerungen bleiben intakt: Gespeicherte Erinnerungen, Wissenseinträge und TODOs auf xmemo.dev werden durch das Entfernen von Skills nicht gelöscht.
  • Vollständige Bereinigung der Anmeldedaten: Führen Sie vor dem Entfernen node scripts/xmemo-skill.mjs logout aus, um das aktive Sitzungstoken zu widerrufen, oder löschen Sie ~/.xmemo/skill-credentials.json manuell.
  • Endgültige Löschung von Erinnerungen: Entfernte Erinnerungen bleiben zugänglich, bis sie über node scripts/xmemo-skill.mjs forget --id <id> --confirm als gelöscht markiert oder über die Memory Console endgültig bereinigt werden.
# Step 1: Revoke active session credentials (optional):
node scripts/xmemo-skill.mjs logout

# Step 2: Remove the installed skill directory:
xmemo skill remove --client codex --yes

Skill-Updates und Lebenszyklus

Skills sind der Anweisungs- und Befehlspfad für Agenten, die einen gehosteten MCP-Server nicht direkt einbinden.

XMemo Skills öffnen

Quelle: XMemo Skills