Reprise et transfert d'agent

Objectif de l'utilisateur et périmètre du flux

Ce flux de travail pratique permet aux développeurs et aux agents IA de reprendre des sessions interrompues, de restaurer le contexte actif après des redémarrages de CLI/IDE et de transférer le travail en cours entre différents agents (tels que Claude Code, Codex, Cursor ou Hermes) sans perdre les décisions d'architecture, les blocages actifs ni la continuité des tâches. Le flux de travail garantit que les transferts de contexte transmettent un état structuré et délimité plutôt que de déverser des historiques de conversation illimités ou de divulguer des identifiants.

Disponibilité et prérequis

Les fonctionnalités nécessaires à la reprise et au transfert sont accessibles via la Skill XMemo autonome et les profils de client MCP natifs avec des limites d'autorisation explicites :

• Skill autonome (Claude Code, Codex, OpenClaw) : commandes textuelles issues du fichier 1.1.35 help.mjs servi : save-state et restore-state (lignes 88-95), restart-snapshot et restart-restore (lignes 104-111), recall-context (lignes 84-87), remember (lignes 72-75) et todo-add/list/done (lignes 112-123).
• Profil MCP claude-plugin : inclut update_state, create_restart_snapshot, restore_restart_snapshot, record_event, recall_context, remember, recall, todo, create_pending_decision et resolve_decision.
• Profils MCP cursor-plugin et ordinary-full : incluent update_state, create_restart_snapshot, restore_restart_snapshot, record_event, recall_context, remember, recall, update_project_decision, update_project_todo, list_memory_todos, complete_memory_todo et query_audit.
• Profils MCP generic-public, chatgpt-public et public-only : exposent des projections récapitulatives en lecture seule comme get_project_summary(project_id, focus) et memory_overview ; les outils d'écriture nécessitent une session de plugin authentifiée.
• Prérequis : jeton d'authentification actif (XMEMO_KEY ou fichier local skill-credentials.json) avec portée memory:write pour la persistance des points de contrôle et memory:read pour la récupération contextuelle.

Une tâche complète : transfert synthétique multi-agents

Dans ce scénario synthétique, l'Agent Alpha (exécuté dans Claude Code CLI) travaille sur la refonte du pool de connexions à la base de données dans le projet proj_payments_v2, consigne une décision explicite et un élément bloquant, scelle un instantané de redémarrage (restart snapshot) et transmet l'exécution à l'Agent Beta (exécuté dans Cursor IDE).

Capturer l'état actif et l'élément bloquant

L'Agent Alpha consigne sa tâche actuelle et l'élément bloquant actif avant le transfert à l'aide de save-state ou update_state :

node scripts/xmemo-skill.mjs save-state --key active_task --content "Refactoring database connection pooling to asyncpg: blocked on internal CA bundle" --ttl_seconds 86400

Créer un instantané de redémarrage pour assurer la continuité

L'Agent Alpha capture l'ensemble du paquet de continuité de session avant le transfert à l'aide de restart-snapshot ou create_restart_snapshot :

node scripts/xmemo-skill.mjs restart-snapshot --state_key active_task --session_id sess_alpha_0928 --ttl_seconds 604800

Reprendre et restaurer dans la session de l'agent récepteur

L'Agent Beta démarre dans Cursor IDE, restaure l'instantané et récupère le contexte d'arrière-plan délimité :

node scripts/xmemo-skill.mjs restart-restore --source_session_id sess_alpha_0928 --target_session_id sess_beta_0929
node scripts/xmemo-skill.mjs recall-context --query "internal CA bundle TLS root pin database pooling" --max_items 5 --max_tokens 2000

Résultat observable

Un transfert réussi génère une confirmation explicite et vérifiable dans la réponse de l'outil, sans fioritures conversationnelles :

• Sortie de création d'instantané : create_restart_snapshot renvoie : "✅ Restart snapshot created. ID: snap_xxx Captured: state=1, events=1, reminders=0, decisions=1".
• Accusé de réception de restauration : restore_restart_snapshot restaure l'emplacement d'état actif, consigne un événement d'audit de restauration sous target_session_id et renvoie le contenu exact de l'état restauré ainsi que le motif du blocage.
• Ancrage contextuel : recall_context renvoie des éléments de mémoire structurés marqués avec le session_id d'origine, l'agent_id et les horodatages exacts de création, permettant à l'Agent Beta de vérifier immédiatement la source de la décision.

Ce à quoi les agents peuvent accéder

L'accès au contexte à travers les sessions est strictement délimité par les portées autorisées et la provenance :

• Contexte de mémoire délimité : les agents procédant à la restauration reçoivent des emplacements d'état structurés, des jalons de chronologie et des mémoires explicitement récupérées correspondant à la requête ; ils ne reçoivent pas de mémoires de développeur non pertinentes ni de projets étrangers.
• Cohérence de relecture des écritures propres (Read-Your-Writes) : les mises à jour d'état et les instantanés de redémarrage sont écrits immédiatement dans le magasin de métadonnées transactionnel, évitant les incohérences temporelles de cohérence éventuelle entre les agents impliqués.
• Provenance de l'appelant : le contexte rappelé inclut l'identité de l'appelant (source_identity, agent_id et node_id) afin que les agents ultérieurs puissent distinguer les directives d'utilisateurs humains des propositions automatisées d'agents homologues.

Limites de partage et de stockage

Des règles strictes de confidentialité et d'isolement de sécurité s'appliquent à toutes les opérations de reprise et de transfert :

• Aucun vidage de transcription brute : ne stockez jamais de transcriptions complètes de conversation ni de traces de réflexion de modèle dans l'état ou la mémoire. Le transfert transmet uniquement des résumés d'état structurés, des événements de décision explicites et des faits vérifiés.
• Zéro fuite d'identifiants : les jetons, clés d'API, mots de passe et en-têtes d'autorisation ne doivent jamais être inscrits dans state_key, content ou metadata_json.
• Frontière d'isolement de projet : les instantanés liés à project:proj_payments_v2 sont strictement inaccessibles aux sessions authentifiées sous un autre projet ou une portée personnelle sans autorisations d'équipe explicites.

Récupération en cas d'échec

Traitez les erreurs courantes de reprise et de transfert à l'aide de stratégies de secours déterministes :

• Instantané expiré ou TTL dépassé : lorsqu'un instantané dépasse ttl_seconds (7 jours par défaut pour les instantanés, 24 heures pour l'état actif), restore_restart_snapshot signale que l'instantané a expiré. Basculez vers get_project_context(project_id="proj_payments_v2") ou recall_context avec une requête ciblée sur le projet.
• ID de session manquant : si source_session_id est indisponible ou perdu, restaurez le dernier enregistrement d'état avec node scripts/xmemo-skill.mjs restore-state --key active_task ou listez les TODOs actifs avec todo-list.
• Discordance de portée ou de locataire : si un agent tente de restaurer un instantané à travers un locataire non autorisé ou une portée de projet discordante, le serveur refuse la requête avec HTTP 403 Forbidden. Vérifiez l'ID de projet associé dans la configuration de votre client.

Référence connexe

Pour en savoir plus sur l'architecture associée, les définitions de portée et les catalogues d'outils, consultez les guides suivants :

• Flux de travail entre agents : /docs/operations/cross-agent-workflow pour les concepts d'orchestration.
• Portées et isolement : /docs/concepts/scopes pour la hiérarchie de portées orthogonales à 4 niveaux.
• Espaces de travail de projet : /docs/concepts/projects pour les associations de projet et l'application des limites.
• Démarrage rapide : /docs/quickstart pour la configuration du client et l'authentification initiale.
• Référence des outils MCP : /docs/tools/recall-context et /docs/tools/remember pour les paramètres d'outils de bas niveau.