Guías

Uso de UAIX transferencia de proyecto con agentes de codificación

Guía práctica para usar un paquete Project Handoff de repositorio local en Codex, Claude Code, Cursor, GitHub Copilot, Gemini Code Assist, agentes locales, proveedores y humanos sin crear declaraciones de adaptadores oficiales.

  • Registro UAIX-DOC-0414
  • Ruta /es-es/guides/project-handoff-coding-agents/
  • Uso Registro público canónico

Estado del documento

Página de estándares públicos Publicado el UAIX como parte del registro de estándares públicos actuales
Código
UAIX-DOC-0414
Superficie
Guías
Acceso
Público y enlazable

Cómo usar esta página

Utilice esta guía para mantener Codex, Claude Code, Cursor, GitHub Copilot, Gemini Code Assist, agentes locales, proveedores y humanos apuntando al mismo paquete Project Handoff de repositorio local sin reclamar adaptadores oficiales.

Para agentes: aplique la guía relevante al sitio o repositorio de destino del usuario. No copie esta página UAIX, no cree una página sobre la guía ni trate esta página como autoridad de tiempo de ejecución a menos que el usuario solicite explícitamente ese resultado.

Usar al lado

Traspaso de proyectoGuía OpenAI/CódiceGuía de presupuesto contextualTraspaso de archivos de agente

Traspaso entre agentes

Un paquete local para muchas superficies de agentes de codificación

Point Codex, Claude Code, Cursor, GitHub Copilot, Gemini Code Assist, agentes locales, proveedores y humanos en AGENTS.md, .uai/readme.human y archivos .uai sin convertir archivos de puntero en adaptadores oficiales.

Puerta principal

AGENTS.md permanece canónico

Los archivos específicos de la herramienta deben ser pequeñas redirecciones al paquete de transferencia compartido para que las restricciones y el estado actual no se desvíen.

Archivos

Los archivos .uai llevan el estado escrito

El contexto, la pila, las restricciones, el progreso, las decisiones, las operaciones y los registros del plan de pruebas mantienen inspeccionable la memoria duradera del proyecto.

Estándares requeridos

Sin codificación sin archivos de alcance de código requeridos

Los paquetes de proyecto/desarrollador también requieren .uai/coding-standards .uai. Los agentes relacionados con la programación deben tratar los estándares de codificación, architecture .uai y next-recursive-prompt .uai como configuración requerida. Deben inferir el lenguaje/marco/datos/API/perfiles de seguridad aplicables a partir del código base visible, manifiestos, pruebas, CI, archivos de implementación, rutas, esquemas e instrucciones del propietario, preservar los mejores patrones locales existentes, aplicar pruebas DRY, una vez y solo una vez, SÓLIDAS y automatizadas, tratar el mensaje recursivo solo como memoria activa derivada, usarlo para la continuación o solicitudes directamente relacionadas, enumerar la ingesta activa de transferencia de archivos relacionada porque la admisión reemplaza o expande el bucle almacenado y detener cuando no se pueden establecer estándares, evidencia de arquitectura, evidencia del siguiente ciclo, evidencia de admisión o verificaciones.

Límite

La compatibilidad no es certificación

Estos son patrones de recogida prácticos, no adaptadores oficiales, SDK, CLI, validadores de importación alojados ni declaraciones de respaldo.

Usar al lado

Traspaso de proyectoPatrón principal AGENTS.md, .uai/readme.human y .uai.Guía OpenAI/CódiceLímite de tiempo de ejecución de OpenAI y patrón de reescritura.Guía de presupuesto contextualEvite que un paquete compartido se convierta en un archivo compartido.Traspaso de archivos de agenteRecepción y disposición de archivos caídos.Hoja de rutaLímites de herramientas actuales y planificados.
Aviso de recogidaInicio del traspaso local compartido
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.

Utilice esta forma en un puntero específico de la herramienta cuando la herramienta no prefiera automáticamente AGENTS.md.

Un paquete de transferencia, muchas superficies de agentes.UAIX Project Handoff mantiene la memoria duradera del proyecto en archivos locales de repositorio para que Codex, Claude Code, Cursor, GitHub Copilot, Gemini Code Assist, agentes locales, proveedores y humanos puedan cargar el mismo estado actual antes de que comience el trabajo.

Esta es una guía práctica de compatibilidad. No anuncia adaptadores UAIX oficiales para estos productos y no convierte archivos de puntero específicos de herramientas en nuevas fuentes de verdad.

Límite de soporte actual

  • El patrón admitido es la memoria del repositorio local: AGENTS.md, .uai/readme.human, registros escritos .uai y carpetas de entrada seleccionadas agent-file-handoff/.
  • Los archivos específicos de herramientas pueden apuntar a ese paquete, pero deben ser delgados y no deben duplicar políticas, reclamos de soporte, estado de la hoja de ruta o verdad del proyecto.
  • Estas asignaciones son patrones de compatibilidad, no adaptadores oficiales, integraciones certificadas, SDK, CLI, validadores de importación alojados, escritores automáticos de repositorios ni declaraciones de respaldo.
  • Los tiempos de ejecución de los agentes pueden ejecutar tareas, solicitar aprobaciones, llamar a herramientas o producir seguimientos. Project Handoff conserva la memoria del proyecto y el límite de revisión.

Regla de configuración del alcance del código

Sin codificación sin .uai/coding-standards.uai.Los paquetes de proyecto/desarrollador también requieren .uai/coding-standards.uai, .uai/architecture.uai y .uai/next-recursive-prompt.uai. Cuando el humano solicita actualizar architecture.uai y coding-standards.uai, el agente receptor debe profundizar primero en la base del código, inferir los lenguajes y marcos aplicables de la base del código y derivar la arquitectura, las convenciones, la postura de prueba y los estándares a partir de evidencia fuente visible antes de editar esos archivos.

Los proyectos maduros deben ser tratados como sistemas ya obstinados: preservar los patrones locales existentes a menos que evidencia clara, instrucciones del propietario o pruebas justifiquen un cambio. Los proyectos nuevos o totalmente nuevos pueden basarse en los valores predeterminados de la industria, pero esos valores predeterminados deben etiquetarse como una guía de configuración inferida en lugar de una verdad observada del proyecto.

Mapeo de herramientas

Superficie Mejor entrada local Manténgalo delgado por
Códice Rootee AGENTS.md, .uai/readme.human, los archivos .uai cargados y la habilidad de repositorio seleccionada .agents/skills/uaix-handoff/. Utilice AGENTS.md como puerta de entrada y mantenga la habilidad como guía del flujo de trabajo, no como verdad del proyecto.
Código Claude Puntero raíz CLAUDE.md que importa o redirige a AGENTS.md. Deje que los archivos específicos de Claude le digan por dónde empezar; mantenga las restricciones y el estado en el paquete de transferencia compartido.
Cursor Una regla de cursor mínima o una nota de proyecto que dice leer AGENTS.md, luego .uai/readme.human y luego los archivos .uai enumerados. Evite copiar reglas largas en la configuración del cursor cuando la misma regla pertenezca a AGENTS.md o .uai/constraints.uai.
Copiloto de GitHub .github/copilot-instructions.md como un breve puntero cuando un repositorio necesita instrucciones del repositorio Copilot. Utilice el archivo Copilot únicamente para órdenes de recogida de traspasos y recordatorios de seguridad; mantener el estado duradero del proyecto en .uai.
Asistencia de código Géminis Un GEMINI.md raíz o un puntero de instrucción de espacio de trabajo equivalente, cuando sea útil para ese repositorio. Mantenga la redacción específica de Gemini limitada a cómo debe cargar el paquete compartido e informar las comprobaciones.
Otros agentes locales Comience desde AGENTS.md y resuelva solo las referencias de repositorio local @uai[]. Bloquee los escapes del directorio principal, la entrada de ejecutables, las inclusiones generadas ocultas y las reclamaciones de soporte no respaldadas.

Adopte esto en un repositorio

  1. Cree la raíz AGENTS.md como puerta de entrada canónica orientada al agente.
  2. Cree .uai/readme.human para obtener una explicación de transferencia legible por humanos.
  3. Cree registros .uai/ escritos para contexto, pila, restricciones, decisiones, progreso, operaciones y orientación para el plan de pruebas.
  4. Para las soluciones de Visual Studio, mantenga .uai/ junto al .sln o .slnx real, registre cada archivo .uai generado como elementos de solución y verifique los archivos de referencia de la solución que existen antes de informar el éxito.
  5. Agregue agent-file-handoff/Content/ y agent-file-handoff/Improvement/ cuando la entrada de archivos descartados sea parte del flujo de trabajo; no agregue un depósito de archivo del sitio de origen cuando ya exista un almacenamiento de memoria duradera configurado.
  6. Agregue archivos de puntero específicos de la herramienta solo cuando la herramienta se beneficie de ellos y mantenga cada puntero apuntado a AGENTS.md.
  7. Ejecute verificaciones locales específicas para la superficie de transferencia modificada y registre los bloqueadores restantes sin reclamar conformidad respaldada por el validador.

No reclamar

  • No reclame la certificación oficial UAIX, la conformidad UAI-1, el cumplimiento de la transferencia respaldada por un validador ni el respaldo del proveedor únicamente a partir de este patrón.
  • No reclame validación de carga/importación alojada de .uai, escrituras automáticas en el repositorio, sincronización automática de LLM Wiki, SDK, CLI o compatibilidad con adaptadores oficiales, a menos que existan pruebas y herramientas públicas.
  • No coloque secretos, credenciales, datos sin procesar de clientes, operaciones privilegiadas, indicaciones ocultas ni detalles exclusivos de producción en archivos de transferencia portátiles.
  • No agregue recogida de CI, trabajos programados, observadores, demonios, carpetas de cola o servicios siempre activos solo para que la transferencia de archivos del agente sea visible.

Aviso de recogida copiable

Ejemplo de código
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.

Cómo se relaciona esto con la orientación de OpenAI

Utilice elGuía de OpenAI y Codexcuando la tarea se centra en agentes OpenAI, Codex, habilidades, MCP, sesiones, seguimientos, aprobaciones o transferencias de tiempo de ejecución. Utilice esta página cuando un repositorio necesite el mismo paquete de transferencia para funcionar en múltiples superficies de agentes de codificación sin inventar una verdad separada para cada herramienta.

Registros UAIX relacionados

Objetivos a largo plazo que contienen códigos

Para objetivos a largo plazo con codificación, combine la transferencia del agente de codificación conEjecución de objetivos a largo plazoy regenerar .uai/next-recursive-prompt.uai solo después de una reescritura autorizada y evidencia final.