Guides

Utilisation du transfert de projet UAIX avec des agents de codage

Guide pratique pour l'utilisation d'un bundle Project Handoff de dépôt local à travers Codex, Claude Code, Cursor, GitHub Copilot, Gemini Code Assist, des agents locaux, des fournisseurs et des humains sans créer de revendications d'adaptateur officielles.

  • Dossier UAIX-DOC-0414
  • Chemin /fr-fr/guides/project-handoff-coding-agents/
  • Utilisation Dossier public canonique

Statut du document

Page des normes publiques Publié le UAIX dans le cadre du dossier actuel des normes publiques
Code
UAIX-DOC-0414
Surface
Guides
Accès
Public et accessible par lien

Comment utiliser cette page

Utilisez ce guide pour garder Codex, Claude Code, Cursor, GitHub Copilot, Gemini Code Assist, les agents locaux, les fournisseurs et les humains pointés vers le même bundle Project Handoff de dépôt local sans réclamer d'adaptateurs officiels.

Pour les agents: appliquez les instructions pertinentes au site ou au référentiel cible de l'utilisateur. Ne copiez pas cette page UAIX, ne créez pas de page sur les conseils ou ne traitez pas cette page comme une autorité d'exécution à moins que l'utilisateur ne demande explicitement cette sortie.

Utiliser à côté

Transfert de projetGuide OpenAI/CodexGuide budgétaire contextuelTransfert de fichiers agent

Transfert entre agents

Un bundle local pour de nombreuses surfaces d'agents de codage

Point Codex, Claude Code, Cursor, GitHub Copilot, Gemini Code Assist, les agents locaux, les fournisseurs et les humains dans les fichiers AGENTS.md, .uai/readme.human et .uai sans transformer les fichiers de pointeur en adaptateurs officiels.

Porte d'entrée

AGENTS.md reste canonique

Les fichiers spécifiques à l'outil doivent être de minuscules redirections vers le bundle de transfert partagé afin que les contraintes et l'état actuel ne dérivent pas.

Enregistrements

Les fichiers .uai portent un état typé

Les enregistrements de contexte, de pile, de contraintes, de progression, de décisions, d'opérations et de plans de test permettent d'inspecter la mémoire durable du projet.

Normes requises

Pas de codage sans fichiers de portée de code requis

Les packages projet/développeur nécessitent également .uai/coding-standards .uai. Les agents liés à la programmation doivent traiter les normes de codage, architecture .uai et next-recursive-prompt .uai comme configuration requise. Ils doivent déduire les profils de langage/framework/données/API/sécurité applicables à partir de la base de code visible, des manifestes, des tests, des CI, des fichiers de déploiement, des routes, des schémas et des instructions du propriétaire, préserver les meilleurs modèles locaux existants, appliquer les tests DRY, une et une seule fois, SOLID et automatisés, traiter l'invite récursive comme une mémoire chaude dérivée uniquement, l'utiliser pour la suite ou les demandes directement liées, énumérer l'apport de transfert de fichiers actif associé car l'apport remplace ou étend la boucle stockée et arrêter lorsque les normes, les preuves d'architecture, les preuves de la boucle suivante, les preuves d'admission ou les contrôles ne peuvent pas être établis.

Limite

La compatibilité n'est pas une certification

Il s'agit de modèles de collecte pratiques, et non d'adaptateurs officiels, de SDK, de CLI, de validateurs d'importation hébergés ou de revendications d'approbation.

Utiliser à côté

Transfert de projetModèle principal AGENTS.md, .uai/readme.human et .uai.Guide OpenAI/CodexLimite d'exécution OpenAI et modèle de réécriture.Guide budgétaire contextuelEmpêchez un ensemble partagé de devenir une archive partagée.Transfert de fichiers agentRéception et traitement des dossiers abandonnés.Feuille de routeLimites actuelles et prévues des outils.
Invite de ramassageDébut du transfert local partagé
Read AGENTS.md first, then .uai/readme.human, then the listed .uai files. For code work, read or create .uai/coding-standards.uai, infer the applicable language/framework profiles from the codebase, preserve good local patterns, keep .uai/next-recursive-prompt.uai as derived hot-memory for continuation or directly related requests, and map automated tests before editing. Summarize current truth, constraints, expected touchpoints, and targeted checks before editing.

Utilisez cette forme dans un pointeur spécifique à un outil lorsque l'outil ne préfère pas automatiquement AGENTS.md.

Un ensemble de transfert, de nombreuses surfaces d’agent.UAIX Project Handoff conserve une mémoire de projet durable dans des fichiers locaux de dépôt afin que Codex, Claude Code, Cursor, GitHub Copilot, Gemini Code Assist, les agents locaux, les fournisseurs et les humains puissent charger le même état actuel avant le début du travail.

Ceci est un guide pratique de compatibilité. Il n’annonce pas les adaptateurs UAIX officiels pour ces produits et ne transforme pas les fichiers de pointeurs spécifiques aux outils en nouvelles sources de vérité.

Limite de support actuelle

  • Le modèle pris en charge est la mémoire du référentiel local: AGENTS.md, .uai/readme.human, les enregistrements .uai saisis et les dossiers d’admission agent-file-handoff/ sélectionnés.
  • Les fichiers spécifiques aux outils peuvent pointer vers cet ensemble, mais ils doivent rester légers et ne doivent pas dupliquer la politique, les revendications de support, l’état de la feuille de route ou la vérité du projet.
  • Ces mappages sont des modèles de compatibilité, et non des adaptateurs officiels, des intégrations certifiées, des SDK, des CLI, des validateurs d’importation hébergés, des rédacteurs de référentiels automatiques ou des revendications d’approbation.
  • Les environnements d’exécution des agents peuvent exécuter des tâches, demander des approbations, appeler des outils ou produire des traces. Project Handoff préserve la mémoire du projet et la limite de révision.

Règle de configuration de la portée du code

Pas de codage sans .uai/coding-standards.uai.Les packages projet/développeur nécessitent également .uai/coding-standards.uai, .uai/architecture.uai et .uai/next-recursive-prompt.uai. Lorsque l’humain demande de mettre à jour architecture.uai et coding-standards.uai, l’agent récepteur doit d’abord approfondir la base de code, déduire les langages et les frameworks applicables à partir de la base de code, et dériver l’architecture, les conventions, la posture de test et les normes à partir de preuves sources visibles avant de modifier ces fichiers.

Les projets matures doivent être traités comme des systèmes déjà opiniâtres: préserver les modèles locaux existants à moins que des preuves claires, des instructions du propriétaire ou des tests justifient un changement. Les projets nouveaux ou inédits peuvent s’appuyer sur les valeurs par défaut de l’industrie, mais ces valeurs par défaut doivent être étiquetées comme des conseils de configuration déduits plutôt que comme une vérité observée du projet.

Cartographie des outils

Surface Meilleure entrée locale Gardez-le mince en
Manuscrit Racine AGENTS.md, .uai/readme.human, les fichiers .uai chargés et la compétence de dépôt sélectionnée .agents/skills/uaix-handoff/. Utilisez AGENTS.md comme porte d’entrée et conservez la compétence comme guide de flux de travail, et non comme vérité de projet.
Claude Code Pointeur racine CLAUDE.md qui importe ou redirige vers AGENTS.md. Laissez les fichiers spécifiques à Claude dire par où commencer; conserver les contraintes et l’état dans le bundle de transfert partagé.
Curseur Une règle de curseur minimale ou une note de projet indiquant de lire AGENTS.md, puis .uai/readme.human, puis les fichiers .uai répertoriés. Évitez de copier de longues règles dans les paramètres du curseur lorsque la même règle appartient à AGENTS.md ou .uai/constraints.uai.
Copilote GitHub .github/copilot-instructions.md comme pointeur court lorsqu’un dépôt a besoin d’instructions du référentiel Copilot. Utilisez le fichier Copilot uniquement pour les ordres de transfert et les rappels de sécurité; conserver l’état du projet durable dans .uai.
Assistance au code Gémeaux Un GEMINI.md racine ou un pointeur d’instruction d’espace de travail équivalent, lorsque cela est utile pour ce dépôt. Limitez la formulation spécifique à Gemini à la manière dont il doit charger le bundle partagé et signaler les vérifications.
Autres agents locaux Commencez à partir de AGENTS.md et résolvez uniquement les références @uai[] du dépôt local. Bloquez les échappements du répertoire parent, l’admission d’exécutables, les inclusions générées masquées et les demandes de support non prises en charge.

Adoptez ceci dans un dépôt

  1. Créez la racine AGENTS.md comme porte d’entrée canonique face à l’agent.
  2. Créez .uai/readme.human pour l’explication du transfert lisible par l’homme.
  3. Créez des enregistrements .uai/ typés pour le contexte, la pile, les contraintes, les décisions, la progression, les opérations et les conseils du plan de test.
  4. Pour les solutions Visual Studio, conservez .uai/ à côté du véritable .sln ou .slnx, enregistrez chaque fichier .uai généré en tant qu’éléments de solution et vérifiez les fichiers de référence de solution qui existent avant de signaler le succès.
  5. Ajoutez agent-file-handoff/Content/ et agent-file-handoff/Improvement/ lorsque la réception des fichiers déposés fait partie du flux de travail; n’ajoutez pas de bucket d’archives de site source lorsqu’un stockage de mémoire durable configuré existe déjà.
  6. Ajoutez des fichiers de pointeur spécifiques à l’outil uniquement lorsque l’outil en bénéficie et gardez chaque pointeur dirigé vers AGENTS.md.
  7. Exécutez des vérifications locales ciblées pour la surface de transfert modifiée et enregistrez les bloqueurs restants sans revendiquer la conformité soutenue par le validateur.

Ne réclamez pas

  • Ne revendiquez pas la certification officielle UAIX, la conformité UAI-1, la conformité de transfert soutenue par le validateur ou l’approbation du fournisseur à partir de ce seul modèle.
  • Ne revendiquez pas la validation de téléchargement/importation .uai hébergée, les écritures automatiques dans le référentiel, la synchronisation automatique LLM Wiki, SDK, CLI ou la prise en charge officielle de l’adaptateur, sauf si des outils et des preuves publics existent.
  • Ne placez pas de secrets, d’informations d’identification, de données client brutes, d’opérations privilégiées, d’invites masquées ou de détails réservés à la production dans des fichiers de transfert portables.
  • N’ajoutez pas de collecte de CI, de tâches planifiées, d’observateurs, de démons, de dossiers de file d’attente ou de services permanents simplement pour rendre visible le transfert de fichiers de l’agent.

Invite de ramassage copiable

Exemple de code
You are working in this repository.

1. Read AGENTS.md first.
2. Read .uai/readme.human as briefing context.
3. Load every @uai[] file listed in AGENTS.md.
4. Inspect active agent-file-handoff/Content/ and agent-file-handoff/Improvement/ intake before broad work.
5. Summarize current project truth, hard constraints, expected touchpoints, and targeted checks before editing.
6. Do not claim certification, conformance, official adapter support, automatic writes, hosted import, SDK, CLI, or endorsement unless repo evidence proves it.
7. Do not place secrets, credentials, private data, or production-only details into handoff files.

Quel est le rapport avec les conseils OpenAI

Utilisez leGuide OpenAI et Codexlorsque la tâche se concentre sur les agents OpenAI, le Codex, les compétences, MCP, les sessions, les traces, les approbations ou les transferts d’exécution. Utilisez cette page lorsqu’un référentiel a besoin du même ensemble de transfert pour fonctionner sur plusieurs surfaces d’agent de codage sans inventer une vérité distincte pour chaque outil.

Enregistrements UAIX associés

Objectifs à long terme porteurs de code

Pour les objectifs à long terme portant du code, associez le transfert de l’agent de codage àExécution des objectifs à long termeet régénérez .uai/next-recursive-prompt.uai uniquement après une réécriture faisant autorité et des preuves finales.