Docs/Herramientas y ayuda

Agentes codificadores

Un proyecto realizado con nx new incluye las reglas que un agente codificador necesita para escribir código Nexy a su manera: el orden de trabajo, el código y las reglas de escritura, y una habilidad por tema. Esta página dice lo que obtiene, adónde va y cómo mantenerlo actualizado. Trabajar en Nexy en sí es un trabajo diferente: leer la raíz del repositorio AGENTS.md.

Lo que nx new agrega

AGENTS.md es breve y personalizado. Un proyecto Vue enrutado por el cliente dice "enrutado por el cliente, Vue, con el estilo Tailwind"; A un proyecto API se le dice que no hay vistas. Solo se copian las habilidades que encajan: un proyecto React obtiene nexy-react y ninguna habilidad Vue, un proyecto de servidor obtiene las habilidades .nexy y Markdown, un proyecto API no obtiene ninguna habilidad sobre las vistas.

Para omitirlo todo, cree el proyecto con nx new --no-agents.

las habilidades

Las reglas que imponen: auditar la experiencia antes de crear una vista, escribir la prueba fallida primero, una función realiza un tratamiento, una clase conlleva una intención, una carpeta contiene un conjunto de intenciones relacionadas, sin emoji, íconos SVG reales, texto sin formato escrito para personas y sin scripts DOM escritos a mano en React, Vue, Svelte, Solid o Preact.

Agréguelos a un proyecto existente

nx skills

Ejecútelo en la raíz del proyecto. Lee nexyconfig.py y package.json para encontrar la pila, copia las habilidades correspondientes y escribe AGENTS.md y CLAUDE.md cuando faltan.

Nunca sobrescribe un archivo que usted escribió: un AGENTS.md o CLAUDE.md existente se conserva y el comando se lo indica. Agregue la lista de habilidades a su propio archivo manualmente si la desea allí. Una habilidad propia en .claude/skills/ o .agents/skills/ se deja sola; sólo se actualizan las habilidades nexy-*.

Ejecute nx skills nuevamente después de actualizar Nexy para actualizar las copias y confirme el resultado para que todo el equipo lo comparta.

Cómo los encuentra un agente

• AGENTS.md (o CLAUDE.md, que lo importa) se lee al inicio de cada sesión. Nombra las habilidades.
• Cada habilidad comienza con un nombre y una descripción que dice qué cubre y cuándo cargarla. El agente los lee primero y abre una habilidad solo cuando la tarea coincide.

Las habilidades siguen el formato de habilidades del agente abierto, por lo que otros agentes que leen las carpetas SKILL.md también pueden usarlas.

lo que no hacen

Las habilidades le dicen a un agente cómo trabajar; no hacen que su salida sea correcta. Guarde sus propios cheques:

• Lea lo que cambió el agente.
• Ejecute nx check, nx test y nx build. Las habilidades exigen esto y que se informe del resultado, no que se resuma.
• Auditar las dependencias que agrega el agente (nexy-security explica cómo).

Los ejemplos en las habilidades son verificados por las propias pruebas de Nexy: las importaciones existen, los campos de configuración existen, los comandos existen, los Python análisis. Eso capta la deriva, no el error de juicio.

Mapa

Un agente responde más rápido cuando sabe qué página contiene la respuesta.

Invariantes del proyecto

1. Se genera __nexy__/. Nunca lo edites, nunca lo confirmes. Elimínelo para forzar una compilación limpia.
2. Un archivo por URL. index.nexy y index.py para la misma ruta es un error, no una regla de prioridad.
3. Nombres reservados dentro de src/routes/: layout.nexy, loading.nexy, errors.nexy, notfound.nexy, dependencies.py, __init__.py. No los utilices para contenido.
4. .nexy el front-matter es Python que se ejecuta por solicitud. Sin efectos secundarios a nivel de módulo: sin identificadores de archivos, sin conexiones de bases de datos, sin llamadas de red al importar.
5. .py en src/routes/ es un controlador de API. Los métodos son nombres de funciones (GET, POST, ...).
6. La configuración se encuentra en nexyconfig.py, no en variables de entorno ni en constantes dispersas.
7. El escape automático está desactivado en las plantillas .nexy: escape de los valores que no son de confianza con | e.

nx dev      # developmentnx build    # production buildnx start    # production servernx test     # pytest, --client adds vitest

Cuando los documentos y el código no estén de acuerdo, confíe en el código y dígalo: nexy/core/config.py contiene todas las opciones, nexy/modules/routers/fbrouter/ las reglas de enrutamiento, nexy/modules/compiler/ cómo .nexy los archivos se convierten en módulos.

Próximos pasos

• CLI: nx new y nx skills
• Convenciones de archivo: nombres reservados y reglas de enrutamiento
• Glosario: las palabras en las que se basan estas reglas
• Seguridad: la versión reduce los puntos de habilidad de seguridad a

Copiar la página como Markdown Editar en GitHub