RéférenceCompétencesMises à jour et cycle de vie de la Skill

Skill

Mises à jour et cycle de vie de la Skill

Inspectez les versions, mettez à jour les versions publiées, gérez les sauvegardes et supprimez en toute sécurité le runtime local autonome de la Skill.

Versions distinctes de la Skill et du CLI

Le runtime autonome de la Skill et le CLI XMemo sont des paquets indépendants possédant des numéros de version et des cycles de publication séparés. La mise à jour de l'un ne modifie pas automatiquement l'autre.

  • Paquet de Skill autonome : version 1.1.35 (@xmemo/skill@1.1.35), inspectable via node scripts/xmemo-skill.mjs --version ou doctor.
  • Paquet CLI XMemo : version 0.4.x / 1.x (@xmemo/client@0.4.187), inspectable via xmemo --version.
  • Mises à jour indépendantes : la mise à jour de @xmemo/client via npm met à jour l'orchestrateur CLI, mais ne modifie pas les répertoires de skills déjà installés tant que xmemo skill update n'est pas exécuté.
  • Subresource Integrity (SRI) : le CLI vérifie les archives tarball de paquets au moyen de sha512 SRI avant d'extraire les fichiers dans les répertoires de skills de l'agent.
# 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

Commandes CLI du cycle de vie de la skill

Le CLI XMemo fournit des commandes dédiées pour inspecter l'état de l'installation, installer sur plusieurs clients agents, mettre à jour vers des versions plus récentes et supprimer des skills en toute sécurité.

  • État : xmemo skill status [--client <id>|--all] [--json] inspecte les skills installées et indique la version, l'identifiant du client et le chemin de destination.
  • Installation : xmemo skill install [--client <id>|--all] [--project] [--global] [--dir <path>] [--dry-run] [--yes] [--force] [--json].
  • Mise à jour : xmemo skill update [--client <id>|--all] [--dry-run] [--yes] [--json] met à jour les skills installées vers la dernière version épinglée.
  • Suppression : xmemo skill remove --client <id> [--project] [--yes] [--json] supprime en toute sécurité les dossiers de skill vérifiés.
# 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

Gestion des installations existantes, sauvegardes et récupération

Pour éviter les écrasements accidentels ou la perte de personnalisations, le programme d'installation refuse d'écraser un répertoire existant sans confirmation explicite et conserve automatiquement des sauvegardes.

  • Refus d'écrasement : la réexécution de l'installation sur un répertoire de skill existant s'interrompt et signale une installation existante, sauf si --force (ou XMEMO_SKILL_FORCE=1) est transmis.
  • Emplacement automatisé des sauvegardes : lorsque --force ou skill update remplace une installation, la version précédente est déplacée vers ~/.xmemo/backups/skills/<client_id>/<name>-<timestamp> (ou ~/.xmemo/backups/skills/custom/<basename>-<timestamp> pour les répertoires personnalisés).
  • Isolation du chargement des agents : les sauvegardes résident en toute sécurité dans ~/.xmemo/backups/, en dehors des chemins de recherche de skills actives de l'agent, ce qui évite les enregistrements d'outils en double.
  • Récupération : pour annuler une mise à jour, restaurez le répertoire de sauvegarde conservé depuis ~/.xmemo/backups/skills/<client_id>/ vers le dossier actif de skills de l'agent.
# Force re-install with automatic backup creation:
xmemo skill install --client codex --force --yes

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

Ce que la suppression laisse derrière elle

La suppression d'une skill est une opération locale du système de fichiers qui dissocie le répertoire de la skill. Elle n'efface ni vos identifiants, ni votre configuration locale, ni vos mémoires distantes.

  • Répertoire local de la skill supprimé : xmemo skill remove supprime uniquement le répertoire vérifié xmemo-memory et refuse les dossiers tiers.
  • Les identifiants restent intacts : ~/.xmemo/skill-credentials.json et la variable d'environnement XMEMO_KEY restent intacts.
  • La configuration reste intacte : les paramètres locaux sous ~/.xmemo/ demeurent intacts.
  • Les mémoires distantes restent intactes : les mémoires stockées, les éléments Knowledge et les TODO sur xmemo.dev ne sont pas supprimés lors du retrait de la skill.
  • Nettoyage complet des identifiants : exécutez node scripts/xmemo-skill.mjs logout avant la suppression pour révoquer le jeton de session actif, ou supprimez manuellement ~/.xmemo/skill-credentials.json.
  • Purge des mémoires : les mémoires distantes restent accessibles jusqu'à leur suppression réversible via node scripts/xmemo-skill.mjs forget --id <id> --confirm ou leur purge via la Memory Console.
# 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

Mises à jour et cycle de vie de la Skill

Les Skills constituent le canal d'instructions et de commandes pour les agents qui n'intègrent pas directement un serveur MCP hébergé.

Ouvrir XMemo Skills

Source : XMemo Skills