Saltar al contenido principal
Devin Local ofrece varias formas de personalizar cómo trabaja el agente en tus proyectos. Usa esta tabla para elegir la más adecuada: Como Devin Local comparte su entorno de agente con Devin CLI, todas las personalizaciones usan el formato y el mecanismo de descubrimiento de Devin CLI, de modo que una personalización que escribas para uno funciona también en el otro. Para reutilizar las reglas del proyecto y los flujos de trabajo de otro agente tanto en Desktop como en Cloud, empieza con el prompt de migración.

Personalizar

La página Personalizar de la ventana de agentes incluye las pestañas Plugins, Habilidades, MCPs, Hooks, Rules y Subagentes. Cada pestaña muestra lo que el agente tiene cargado, además de lo que ofrecen tu repositorio, tu organización y tu cuenta. Para abrirla, haz clic en Personalizar en la barra lateral del agente.

Rules

Las Rules son instrucciones persistentes que definen cómo se comporta el agente en tu proyecto. Se incorporan al contexto del agente al inicio de cada sesión, lo que garantiza un comportamiento coherente en todo tu equipo. Entre los usos habituales de las reglas se encuentran los estándares de código, las directrices de arquitectura, las bibliotecas preferidas, las convenciones de pruebas y las restricciones específicas del proyecto.

AGENTS.md

La forma más sencilla de agregar reglas es crear un archivo AGENTS.md en la raíz de tu proyecto. Usa Markdown simple, sin frontmatter:
AGENTS.md, AGENTS.local.md (para reglas personales que mantienes fuera del control de versiones) y AGENT.md se leen como reglas siempre activas. El agente los lee en la raíz del espacio de trabajo y en cada directorio situado entre la raíz del espacio de trabajo y el directorio en el que está trabajando, por lo que un AGENTS.md en un subdirectorio aporta instrucciones específicas para ese directorio.

Archivos de Rules

Para tener más control, coloca una regla por archivo en .devin/rules/*.md. Cada archivo puede indicar cuándo se aplica mediante el campo trigger del frontmatter:
.devin/global_rules.md es un único archivo siempre activo. Coloca los mismos archivos en tu directorio de inicio (~/.devin/rules/*.md, ~/.devin/global_rules.md) para aplicarlos a todos los proyectos. Los archivos legacy .windsurf/rules/*.md, .windsurf/global_rules.md y .windsurfrules se importan de forma predeterminada. Se cargan los archivos de reglas de .devin/rules/ y de .windsurf/rules/; si existen ambos archivos global_rules.md, solo se carga .devin/global_rules.md. Consulta reglas y AGENTS.md para ver la lista completa de archivos, la configuración de importación y las reglas de otras herramientas.

Prácticas recomendadas

  • Mantén las reglas breves y específicas. Las reglas forman parte del contexto de cada sesión, por lo que consumen tokens en cada mensaje.
  • Recurre preferentemente a una skill para todo lo que el agente solo necesite en ocasiones, y usa una regla para indicarle qué skills debe usar en escenarios concretos.
  • Da formato a las reglas con viñetas, listas numeradas y encabezados de Markdown. Son más fáciles de seguir que un párrafo largo.
  • Evita reglas genéricas como «escribe buen código».

Skills

Las tareas de ingeniería más complejas suelen requerir algo más que buenos prompts. Pueden necesitar scripts de referencia, plantillas, listas de comprobación y otros archivos auxiliares. Las skills te permiten agrupar todo esto en carpetas que el agente puede invocar. Las skills usan divulgación progresiva: de forma predeterminada, el modelo solo ve el name y la description de la skill. El contenido completo de SKILL.md y los archivos auxiliares solo se cargan cuando el agente decide invocar la skill o cuando la invocas tú. Así, tu ventana de contexto se mantiene ligera aunque tengas muchas skills definidas.

Crear un skill

Crea un directorio con un archivo SKILL.md cuyo frontmatter YAML defina el nombre y la descripción del skill:
  • name: Identificador único de la skill (letras minúsculas, números y guiones). Se usa para invocarla.
  • description: Breve explicación que se muestra al modelo para ayudarle a decidir cuándo invocar la skill. Indica de forma específica qué hace la skill y cuándo usarla.
Coloca los archivos auxiliares en la carpeta de la skill, junto a SKILL.md. El agente tendrá acceso a ellos cuando se invoque la skill:

Invocación de skills

Cuando tu solicitud coincide con la descripción de una skill, el agente la invoca automáticamente y sigue sus instrucciones. También puedes invocar una skill por su nombre con /skill-name para asegurarte de que se use.

Ámbitos de las skills

Consulta la documentación de skills de Devin CLI para obtener información sobre los desencadenadores de skills, los permisos y las skills de terceros, y Creación de skills para ver instrucciones sobre cómo crearlas.

Plugins

Los Plugins son paquetes instalables que aportan skills, reglas, hooks, servidores MCP y subagentes al agente. Puedes instalar un plugin desde un repositorio de GitHub, una URL de git, una subcarpeta de un repositorio o una carpeta local; sus skills quedan disponibles como comandos /<plugin>:<skill>. Consulta plugins para obtener información sobre el formato de los plugins, los comandos devin plugins y la gobernanza.
Aquí, Plugins hace referencia a los plugins del agente de Devin. No tienen nada que ver con los plugins de Windsurf, que llevan Devin a JetBrains, VS Code y otros editores, ni con las extensiones del editor que instalas en Devin Desktop: ambos amplían el IDE, no el agente.

Servidores MCP

MCP (Model Context Protocol) es un protocolo que permite al agente usar herramientas de servicios externos, como GitHub, bases de datos y sistemas de seguimiento de incidencias. Consulta la documentación oficial de MCP para obtener más información.

Instalar servidores MCP

Abre la página Customize desde la ventana Agents y haz clic en MCPs. Elige el ámbito con el selector Install MCPs for de la parte superior, por ejemplo, This computer.
  • This computer muestra los servidores que tu agente local carga para las carpetas abiertas en la ventana. Puedes activar o desactivar un servidor, abrir su archivo de configuración o actualizar la lista.
  • Available muestra los servidores de tus registros MCP. Haz clic en Install en un servidor para agregarlo.
Los Admin de Enterprise gestionan los registros en la configuración del equipo, en MCP & ACP. La pestaña MCP registry incluye un interruptor que permite, además de los de la lista de permitidos de MCP, los servidores que coincidan con una entrada del registro, y una opción Registry (Configure) para indicar las URL de los registros. Cuando hay varios registros configurados, Devin Desktop usa la unión de todos ellos. Los registros personalizados deben seguir el esquema oficial del registro MCP.

Configuración

Los servidores MCP se configuran en archivos de configuración de tu máquina local. La ubicación del archivo depende del ámbito: Devin Local admite los transportes stdio, Streamable HTTP y SSE, además de OAuth para cada uno de ellos.

Permisos

De forma predeterminada, el agente solicita aprobación antes de llamar a cualquier herramienta MCP. Consulta Permisos de MCP para saber cómo permitir una herramienta o un servidor, y cómo los administradores pueden permitir de forma predeterminada las integraciones de confianza.

Reautenticación

Cuando caducan las credenciales de OAuth almacenadas de un servidor, este muestra el estado Needs authentication. Este estado aparece en la lista This computer, en la card Available y en la página de detalles del servidor. Haz clic en Authenticate para borrar las credenciales almacenadas y volver a ejecutar el flujo de autorización en el navegador.

Hooks

Los hooks ejecutan lógica personalizada en determinados eventos del ciclo de vida del agente, por ejemplo, antes de una llamada a herramienta. Cada hook es un comando de shell o un prompt para un LLM. Usa hooks para hacer cumplir políticas, agregar contexto, registrar acciones, modificar permisos o integrarte con sistemas externos. Los hooks se configuran en .devin/hooks.v1.json, ya sea en tu proyecto o a nivel de usuario. Por ejemplo, este hook ejecuta un script antes de cada comando de shell y puede bloquear el comando:
Los hooks no se cargan ni se ejecutan mientras un workspace está abierto en Modo Restringido. Consulta hooks para ver los eventos de hook, el formato de configuración, los códigos de salida y ejemplos.