Elvis Li
Back to all posts
Engineering

IA Disciplinada: Inyectando las Habilidades de Agente de Google en Antigravity

#ai#software-engineering#antigravity#github

Seamos realistas: el código generado por IA es rápido, pero a menudo es una pesadilla de mantenimiento. Si has estado usando herramientas como Antigravity en una Mac, sabes que la velocidad está ahí, pero la disciplina generalmente no.

Para solucionar esto, el liderazgo de ingeniería de Google lanzó Agent Skills, un conjunto de 20 habilidades atómicas y 7 comandos que obligan a la IA a seguir estándares internos de ingeniería de software. Así es como puedes incorporar estos estándares en tu entorno local de MacBook.

El Valor Central: Anti-Racionalización

La IA tiende a "alucinar" su salida para evitar escribir pruebas o se salta la fase de documentación porque es "demasiado simple".

El marco de trabajo Agent Skills introduce la Anti-racionalización. Si la IA intenta saltarse un paso, el sistema se opone. Aplica la Regla de Beyoncé ("Si te gustó, deberías haberle puesto una prueba") y asegura que cada línea de código esté respaldada por una Especificación antes de que se escriba la primera línea.

1. Configurando tu Mac M3

Dado que estamos en Apple Silicon, queremos mantener nuestras herramientas nativas y nuestras rutas limpias. Comenzaremos con Homebrew y la CLI de GitHub (gh).

1.1 Instalar Herramientas y Autenticar

Abre tu terminal y ejecuta lo siguiente para asegurarte de que tu entorno esté listo:

# Instalar Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Asegurarse de que Brew esté en tu ruta
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
eval "$(/opt/homebrew/bin/brew shellenv)"

# Instalar GitHub CLI e Iniciar Sesión
brew install gh
gh auth login

Después de ejecutar gh auth login. Sigue las instrucciones exactamente: selecciona GitHub.com -> HTTPS -> Yes (para autenticar) -> Login with a web browser.

Consejo Pro: Tu terminal mostrará un código de 8 caracteres (como 1234-ABCD). Presiona Enter para abrir GitHub en tu navegador, pega ese código en el cuadro y haz clic en el botón verde Autorizar (Authorize) para vincular tu cuenta.

1.2 Inyectar Habilidades en Antigravity

Antigravity busca una estructura de directorio específica para "aprender" nuevos comportamientos. Vamos a clonar los estándares de ingeniería de Google directamente en la carpeta oculta del agente de tu proyecto.

# Navega a la raíz de tu proyecto
cd ~/your-project-path

# Crea el directorio estándar para las habilidades de IA
mkdir -p .agent/skills

# Clona el repositorio de Habilidades de Agente de Google
gh repo clone addyosmani/agent-skills .agent/skills/engineering-standards

# Limpia los datos de git anidados para que puedas rastrearlos en tu propio repositorio
rm -rf .agent/skills/engineering-standards/.git

1.3 Activar el "Cerebro"

Ahora que las habilidades están en su lugar, necesitas despertarlas. Reinicia Antigravity o simplemente ejecuta esto en su consola:

/reload-skills

Probando la configuración: Escribe esto en el chat de Antigravity:

"Me gustaría empezar una nueva función. Usa la habilidad /spec para ayudarme a definir los requisitos."

Si la IA comienza a interrogarte sobre objetivos, escenarios de usuario y requisitos no funcionales en lugar de simplemente escribir código, has inyectado con éxito los estándares de Google en tu entorno local.

2. Mejores Prácticas de Git

Quieres que tu equipo use estas mismas habilidades, pero no quieres contaminar tu repositorio con los "registros de pensamiento" o los datos de sesión de la IA. Añade esto a tu .gitignore:

# --- Configuración del Agente de IA ---
# Ignorar los datos de tiempo de ejecución del cerebro
.agent/workspaces/
.agent/logs/
.agent/cache/
.agent/sessions/

# MANTENER las habilidades
!.agent/skills/

2.1 La Inmersión Profunda: Por qué Importa la Estrategia de Git

Podrías preguntarte por qué somos tan exigentes con nuestro .gitignore. Aquí está el desglose:

2.1.1 Por qué no deberías ignorar .agent/skills

La carpeta agent-skills es esencialmente el "Procedimiento Operativo Estándar" de tu IA.

Coherencia: Si no confirmas (commit) esta carpeta, tus compañeros de equipo (o tú en una máquina diferente) solo obtendrán una IA "genérica". Perderás el acceso a habilidades avanzadas como /spec o /review.

Control de Versiones: Si ajustas un SKILL.md (por ejemplo, aumentando la cobertura de prueba requerida del 80% al 90%), esa lógica debería vivir y evolucionar junto con tu código fuente.

2.1.2 Por qué debes ignorar otros subdirectorios

Privacidad y Seguridad: Carpetas como .agent/sessions o workspaces pueden contener el historial de conversaciones en bruto, datos intermedios sensibles o fragmentos de tu proceso de trabajo. Definitivamente no quieres que eso se envíe a un servidor.

Cero Utilidad: Los registros (logs) y la caché se generan localmente y son específicos de tu máquina. Confirmarlos solo infla el repositorio y crea conflictos de fusión innecesarios.

3. Pasando de "Chatbot" a "Ingeniero"

Una vez que reinicias Antigravity, la IA ya no es solo un chatbot. En lugar de decir "Constrúyeme una página de inicio de sesión", empiezas a utilizar los comandos con barra:

  1. /spec: Obliga a la IA a escribir primero una especificación técnica.
  2. /plan: Divide esa especificación en una lista de tareas.
  3. /review: Audita el trabajo contra los estándares de "Clean Code".

Toma 60 segundos adicionales ejecutar un /spec, pero te ahorra 3 horas de depuración de deuda técnica más adelante. Si usas una Mac M3, tienes la potencia; ahora tienes los estándares.