Personalizador de Antigravity (ag-customizer)

¿Qué hace Personalizador de Antigravity (ag-customizer)?

Utiliza este skill para diseñar, estructurar, configurar, migrar y validar personalizaciones de Google Antigravity de forma autónoma, tanto a nivel de espacio de trabajo como global.

---

Matriz de Decisión Rápida

Determina qué mecanismo de personalización resuelve mejor el problema:

Necesidad	Mecanismo	Ubicación del Archivo	Guía de Referencia
Enseñar al agente un runbook multi-paso, procedimiento o comando slash	Skill	.agents/skills/<name>/SKILL.md o ~/.gemini/antigravity/skills/<name>/SKILL.md	guia-skills.md
Imponer restricciones persistentes, estándares de codificación o reglas de estilo	Regla	.agents/rules/<name>.md, AGENTS.md o ~/.gemini/GEMINI.md	guia-reglas.md
Conectar servicios externos, bases de datos locales o herramientas personalizadas	Servidor MCP	.agents/mcp_config.json o ~/.gemini/config/mcp_config.json	guia-mcp.md
Interceptar eventos del ciclo de vida (controlar comandos, inyectar avisos, detener watchdog)	Hook de Ciclo de Vida	.agents/hooks.json o ~/.gemini/config/hooks.json	guia-hooks.md
Agrupar skills, reglas, hooks y MCP en un paquete compartible	Plugin	.agents/plugins/<name>/ o ~/.gemini/config/plugins/<name>/	plugins-y-configs.md
Registrar rutas no estándar o compartir personalizaciones mediante VCS	Configuración JSON	.agents/skills.json o .agents/plugins.json	plugins-y-configs.md
Actualizar flujos de trabajo obsoletos a skills modernos de comando slash	Migración de Workflows	.agents/workflows/*.md -> .agents/skills/<name>/SKILL.md	migracion-workflows.md

---

Flujos de Trabajo Operativos

1. Añadir un Nuevo Skill

1. Determinar el Ámbito:
   • Espacio de Trabajo: .agents/skills/<name>/ (incluido en el repositorio para uso del equipo).
   • Global: ~/.gemini/antigravity/skills/<name>/ (disponible en todos los proyectos).
2. Estructurar el Directorio:

   <raiz_personalizacion>/skills/<nombre-skill>/
   ├── SKILL.md             # Obligatorio: Punto de entrada con frontmatter YAML
   ├── scripts/             # Opcional: Scripts auxiliares (ejecutar con patrón --help)
   ├── references/          # Opcional: Manuales completos y documentación pesada
   └── examples/            # Opcional: Código de muestra o referencias de salida
   

3. Redactar el Frontmatter:
   • name: Minúsculas y con guiones (ej. nextjs-otel, docker-deploy). Esto también lo registra como comando slash (/<name>).
   • description: 1-3 frases en tercera persona, indicando explícitamente qué hace el skill y frases/escenarios de activación específicos para que el agente lo active.
4. Aplicar Divulgación Progresiva:
   • Mantén el SKILL.md principal centrado estrechamente en la secuencia de pasos operativos y criterios de finalización.
   • Traslada el material de referencia profundo a archivos references/<topic>.md y enlácelos de forma relativa.
   • Consulta guia-skills.md para plantillas de estructura.
5. Verificación de Duplicación en Obsidian:
   • Al actualizar o crear skills en este espacio de trabajo, refleja la carpeta del skill en d:/Scripts/Obsidian/skills/<name>/ según las directrices del repositorio.

---

2. Crear una Regla

1. Determinar Ámbito y Formato:
   • Regla de Espacio de Trabajo: .agents/rules/<nombre-regla>.md o AGENTS.md en la raíz del proyecto.
   • Regla Global: ~/.gemini/GEMINI.md.
2. Elegir Modo de Activación (para .agents/rules/*.md):
   • always_on: Se inyecta incondicionalmente en cada turno. Úsalo con moderación para preservar el contexto.
   • model_decision: Se divulga cuando el agente determina la relevancia según la descripción.
   • glob: Se activa automáticamente cuando se tocan o abren archivos coincidentes (ej. *.tsx, src/api/**/*.ts).
   • manual: Solo se carga cuando se invoca explícitamente mediante @mención en el chat (ej. @mi-regla.md).
3. Redactar el Contenido:
   • Mantente dentro del límite de 12.000 caracteres por archivo.
   • Expresa los comportamientos deseados en positivo ("Haz X", "Estructura siempre Y") en lugar de prohibiciones negativas.
   • Usa @nombre-de-archivo para enlazar archivos de contexto complementarios si es necesario.
   • Consulta guia-reglas.md para la sintaxis completa y el frontmatter de activación.

---

3. Configurar un Servidor MCP

1. Determinar Ubicación del Archivo:
   • Espacio de trabajo: <workspace>/.agents/mcp_config.json
   • Global: ~/.gemini/config/mcp_config.json
2. Seleccionar Transporte:
   • stdio (Ejecutable local):

     {
       "mcpServers": {
         "mi-servidor": {
           "command": "npx",
           "args": ["-y", "@modelcontextprotocol/server-sqlite", "app.db"],
           "env": { "SQLITE_READONLY": "true" }
         }
       }
     }
     

   • Remoto (SSE / HTTP Transmisible):

     [!IMPORTANT] Usa siempre la clave serverUrl. Las claves heredadas url o httpUrl no son compatibles.

     {
       "mcpServers": {
         "mi-remoto": {
           "serverUrl": "https://api.example.com/mcp/",
           "headers": { "Authorization": "Bearer TU_TOKEN" }
         }
       }
     }
     

3. Autenticación:
   • Credenciales de Aplicación por Defecto de Google: "authProviderType": "google_credentials" (requiere gcloud auth application-default login).
   • OAuth: "oauth": { "clientId": "...", "clientSecret": "..." } con URI de redirección https://antigravity.google/oauth-callback.
4. Filtrado de Herramientas:
   • Deshabilitar herramientas temporalmente sin eliminar el servidor: "disabledTools": ["comando_destructivo"].
   • Consulta guia-mcp.md para configuraciones predefinidas.

---

4. Configurar Hooks de Ciclo de Vida

1. Archivo Objetivo: .agents/hooks.json (o ~/.gemini/config/hooks.json).
2. Eventos Compatibles:
   • PreToolUse: Coincide con nombres de herramientas (run_command, write_to_file, *) para controlar la ejecución (allow, deny, ask, force_ask) o sobrescribir argumentos superficialmente.
   • PostToolUse: Auditar salida, ejecutar linters o formatear código después de que la herramienta se complete.
   • PreInvocation: Inyectar contexto o instrucciones del sistema (injectSteps con ephemeralMessage) antes de que el modelo procese el turno.
   • PostInvocation: Forzar continuación (terminationBehavior: "force_continue") o detener.
   • Stop: Inspeccionar finalización de tarea (terminationReason, fullyIdle) y devolver decision: "continue" con reason para bloquear la salida prematura.
3. Reglas del Contrato:
   • La ejecución pasa contexto a través de stdin y recibe respuesta a través de stdout.
   • Todas las claves de carga útil JSON usan camelCase (conversationId, stepIdx, toolCall, etc.).
   • Los comandos se ejecutan de forma sincrónica y bloquean el bucle del agente hasta el tiempo de espera (por defecto 30s).
   • Consulta guia-hooks.md para plantillas en Python, PowerShell y Bash.

---

5. Empaquetar un Plugin o Configuración Compartida por VCS

1. Paquete de Plugin:
   • Agrupa skills, reglas, hooks y servidores MCP relacionados en .agents/plugins/<nombre-plugin>/.
   • Añade el manifiesto plugin.json ({"name": "mi-plugin"}).
   • Gestiona el estado de activación en config.json bajo "plugins": { "<nombre-plugin>": { "enabled": true } }.
2. Configuraciones JSON (skills.json / plugins.json):
   • Registra directorios externos o repositorios de equipo compartidos.
   • Soporta entries (rutas) y inherits (otras configuraciones) con filtros regex include_only y exclude.
   • Consulta plugins-y-configs.md para ejemplos de manifiestos completos.

---

6. Modernizar Flujos de Trabajo Heredados

1. Inspecciona en busca de .agents/workflows/*.md o ~/.gemini/config/workflows/*.md obsoletos.
2. Extrae las instrucciones operativas y genera un SKILL.md equivalente con el frontmatter YAML adecuado.
3. Archiva el archivo original como <nombre>.md.bak (preservación segura).
4. Consulta migracion-workflows.md para el runbook de migración automatizada.

---

Lista de Verificación de Validación

Antes de considerar completa cualquier personalización:

• Sintaxis JSON: Asegúrate de que todos los archivos .json se analicen correctamente sin errores de sintaxis ni comentarios.
• Verificación de Frontmatter: Verifica que SKILL.md contenga frontmatter YAML válido con name y description descriptiva.
• Presupuesto de Caracteres: Asegúrate de que los archivos Markdown de reglas estén dentro del límite de 12.000 caracteres.
• Conexión MCP: Verifica que los binarios de comando o las URL remotas existan y autentiquen.
• Contrato de Hook: Verifica que los scripts de hook acepten JSON camelCase en stdin y devuelvan JSON válido en stdout.
• Duplicación en Obsidian: Para skills en este espacio de trabajo, sincroniza la carpeta del skill creado con d:/Scripts/Obsidian/skills/<name>/.