agent-skill-tdd MCP — Casos de uso, Instalar & Demo en vivo

Por qué usarlo

Características clave

Flujo de 6 pasos: Serena -> Investigar -> Aclarar -> Documentar -> Revisión de Diseño -> TDD
Documentos .requirements/ con marca de tiempo por tarea
Confirmación explícita de requisitos antes de codificar
Revisión de arquitectura vía Lad MCP antes de la implementación
Revisión entre pares por cambio en cada edición
Agnóstico de agentes — Claude Code, Codex, Cursor, Windsurf, Antigravity

Demo en vivo

Cómo se ve en la práctica

agent-skill-tdd-skill.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "agent-skill-tdd-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Shelpuk-AI-Technology-Consulting/agent-skill-tdd",
        "~/.claude/skills/agent-skill-tdd"
      ],
      "_inferred": true
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "agent-skill-tdd-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Shelpuk-AI-Technology-Consulting/agent-skill-tdd",
        "~/.claude/skills/agent-skill-tdd"
      ],
      "_inferred": true
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "agent-skill-tdd-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Shelpuk-AI-Technology-Consulting/agent-skill-tdd",
        "~/.claude/skills/agent-skill-tdd"
      ],
      "_inferred": true
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "agent-skill-tdd-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Shelpuk-AI-Technology-Consulting/agent-skill-tdd",
        "~/.claude/skills/agent-skill-tdd"
      ],
      "_inferred": true
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "agent-skill-tdd-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Shelpuk-AI-Technology-Consulting/agent-skill-tdd",
        "~/.claude/skills/agent-skill-tdd"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "agent-skill-tdd-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/Shelpuk-AI-Technology-Consulting/agent-skill-tdd",
          "~/.claude/skills/agent-skill-tdd"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add agent-skill-tdd-skill -- git clone https://github.com/Shelpuk-AI-Technology-Consulting/agent-skill-tdd ~/.claude/skills/agent-skill-tdd

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: agent-skill-tdd

Implementar una nueva característica con disciplina TDD completa

👤 Equipos donde los codificadores IA saltan a la implementación y pierden requisitos ⏱ ~120 min intermediate

Cuándo usarlo: Característica no trivial donde 'solo escribirla' te ha causado problemas antes.

Requisitos previos

Skill clonada — git clone https://github.com/Shelpuk-AI-Technology-Consulting/agent-skill-tdd ~/.claude/skills/agent-skill-tdd
Serena disponible — Instala el servidor Serena MCP
Lad MCP para revisión de diseño — Instala el servidor Lad MCP

Flujo

Comienza con la skill

Usa agent-skill-tdd. Quiero agregar una característica de 'búsquedas guardadas'. Comienza desde el paso 1 — activa Serena e investiga.✓ Copiado

→ Claude lee el código, resume el estado actual
Aclarar requisitos

Confirma que lo que acabo de decir se asigna a estos criterios de aceptación — aún no codifiques.✓ Copiado

→ Ir y venir hasta confirmar; archivo .requirements/ guardado
Revisión de diseño vía Lad

Ejecuta revisión de diseño — ajuste de arquitectura, puntos críticos.✓ Copiado

→ Crítica de diseño, no solo aprobación
Ciclo TDD

Ahora comienza TDD — escribe una prueba fallida, código mínimo para pasar, refactoriza. Revisa cada paso entre pares.✓ Copiado

→ Ciclos rojo-verde-refactor, cada uno revisado

Resultado: Característica entregada con pruebas, historial de requisitos y justificación de diseño preservados.

Errores comunes

Saltarse aclarar para 'ahorrar tiempo' — Ahí es donde se pierde la mayor parte del valor de la codificación IA — mantén la línea

Combinar con: filesystem · github

Corregir un error después de escribir el comportamiento correcto

👤 Desarrolladores cansados de correcciones IA que rompen otras rutas ⏱ ~60 min intermediate

Cuándo usarlo: Un error sutil donde la reproducción es mitad de la batalla.

Flujo

Investigar + documentar

Usa agent-skill-tdd en modo bug. Síntoma: <descripción>. Escribe la reproducción + comportamiento esperado a .requirements/ primero.✓ Copiado

→ Documento con marca de tiempo con Estado Actual y Deseado
Escribir una prueba fallida

Prueba que expresa el comportamiento esperado — actualmente fallando.✓ Copiado

→ Prueba roja
Corregir + revisión entre pares

Corrección mínima para ponerse verde. Revisión entre pares.✓ Copiado

→ Verde + notas de revisión

Resultado: Una corrección de error con una prueba que previene regresiones.

Detente antes de implementar — valida que comprendas la especificación

👤 Equipos donde malinterpretar la especificación causa retrabajos ⏱ ~30 min beginner

Cuándo usarlo: El ticket es ambiguo y sospechas que estás a punto de construir lo incorrecto.

Flujo

Solo ejecuta pasos 1–4

Usa agent-skill-tdd — investiga + aclara + documenta + revisión de diseño. Detente antes de codificar.✓ Copiado

→ Documento de requisitos + revisión de diseño sin tocar código

Resultado: Descubres que malinterpretaste el ticket o das luz verde con confianza.

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

agent-skill-tdd-skill + filesystem

Mantén .requirements/ en el repositorio para que futuros agentes lo lean

Envía .requirements/ a git para que la próxima sesión tenga contexto.✓ Copiado

agent-skill-tdd-skill + github

Vincula el documento de requisitos en la descripción del PR

Cuando abras el PR, pega la ruta del archivo .requirements/ en la descripción.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
activate_serena	ruta del repositorio	Paso 1	0 — local
investigate	descripción de la tarea	Paso 2	0
clarify	tarea, respuestas del usuario	Paso 3	0
document_requirements	requisitos confirmados	Paso 4	0
design_review	requisitos + repositorio	Paso 5	0
tdd_cycle	requisitos	Paso 6	0

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Ninguno de la skill; Serena y Lad tienen sus propias huellas
Tokens por llamada: Moderado — cada paso es un viaje de ida y vuelta
Monetario: Gratis
Consejo: El 6-paso completo es excesivo para tareas triviales — ejecuta pasos 1–4 solo en trabajos pequeños

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: Ninguno

Salida de datos: Solo vía Serena/Lad si está configurado

Resolución de problemas

Errores comunes y soluciones

Serena no disponible

Instala el servidor Serena MCP y regístralo con tu agente

Documento de requisitos no creado

Asegúrate de tener acceso de escritura del sistema de archivos a .requirements/

Verificar: ls .requirements/

El paso de revisión de diseño parece un trámite

Fuerza un enfoque adversarial: '¿cuál es la objeción más fuerte a este diseño?'

Alternativas

agent-skill-tdd vs otros

Alternativa	Cuándo usarla	Contrapartida
claude-gpt-workflow	Quieres revisión entre modelos en lugar de disciplina TDD autorreferencial	Mayor costo de API
planning-with-files-skill	Quieres persistencia entre sesiones pero menos rigor TDD	Sin aplicación de pruebas primero

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills