coding-agent

Files (1)

• SKILL.md

SKILL.md (first lines)

# Coding Agent Skill

## Cuándo usar esta skill
- Delegar una tarea de programación compleja a un agente especializado
- Ejecutar refactorizaciones grandes de forma autónoma
- Hacer implementaciones multi-archivo mientras el agente gestiona el contexto
- Quieres que el agente escriba, testee, y corrija código de forma autónoma

## Agentes disponibles

### Claude Code (Anthropic)
```bash
# Instalar
npm install -g @anthropic-ai/claude-code

# Uso básico
claude "Implementa un endpoint REST para gestión de usuarios con Express y TypeScript"

# Con contexto de directorio
cd /mi-proyecto
claude "Refactoriza todos los componentes en src/components para usar React.memo donde sea beneficioso"

# Modo no interactivo (para CI/CD)
claude --dangerously-skip-permissions --print "Escribe tests unitarios para todos los archivos en src/utils/"

# Con contexto específico
claude --add-to-context="REQUIREMENTS.md" "Implementa las funcionalidades descritas en los requisitos"
```

### Codex CLI (OpenAI)
```bash
# Instalar
npm install -g @openai/codex

# Uso básico
codex "crea una función Python para parsear archivos CSV con manejo de errores"

# Modo quiet (para automatización)
codex --quiet "añade type hints a todos los archivos Python en este directorio"

# Con archivo de entrada
codex "explica este código y sugiere mejoras" < mi-archivo.py
```

### Aider (popular, open source)
```bash
# Instalar
pip install aider-chat

# Initiar sesión con archivos específicos
aider src/api/users.py src/models/user.py

# Comandos dentro de aider:
# /add archivo.py    — Añadir archivo al contexto
# /drop archivo.py   — Quitar archivo del contexto
# /run npm test      — Ejecutar comando
# /diff              — Ver cambios actuales
# /undo              — Deshacer último cambio

# Con modelo específico
aider --model gpt-4o src/app.py

# Modo sin git (para experimentación)
aider --no-git src/experiment.py

# Batch mode con instrucciones de archivo
echo "Añade manejo de errores a todas las funciones async" | aider --yes mi-archivo.py
```

### OpenCode
```bash
# Ver documentación actualizada en: https://github.com/opencode-ai/opencode
npx opencode "implementa autenticación JWT en este proyecto"
```

## Mejores prácticas para usar coding agents

### 1. Instrucciones efectivas

```markdown
✅ Instrucciones claras y específicas:
"Refactoriza la función `processUsers` en `src/utils/users.js` para:
1. Usar TypeScript con tipos explícitos
2. Añadir manejo de errores con try/catch
3. Retornar un Result<T, E> type en lugar de throw
4. Añadir JSDoc comments
Mantén la funcionalidad existente y el API público idéntico."

❌ Instrucciones vagas:
"Mejora el código de usuarios"
```

### 2. Dar contexto relevante
```bash
# Proporcionar archivos de contexto relevantes
claude --add-to-context="docs/architecture.md" \
       --add-to-context="src/types/index.ts" \
       "Implementa el módulo de notificaciones siguiendo la arquitectura existente"

# O crear un prompt file
cat > agent-task.md << 'EOF'
## Tarea: Implementar sistema de caché

### Contexto
- Proyecto: API REST con Node.js/Express
- Base de datos: PostgreSQL
- Ya existe lib/db.ts con la conexión

### Requisitos
1. Implementar caché con Redis para las queries más frecuentes
2. TTL configurable por tipo de query
3. Invalidar caché en mutations
4. Métricas de hit/miss ratio

### Archivos a crear/modificar
- src/lib/cache.ts (nuevo)
- src/lib/db.ts (modificar para usar caché)
- .env.example (añadir REDIS_URL)
EOF

From garri333/Skills, MIT.

More from garri333/Skills