Saltar al contenido
Entrar
Plano del curso

Misión 14 de 23

  1. La entrevista, a mano
  2. Conviértelo en una skill
  3. Pruébalo

De idea a especificación — que Claude te entreviste

Convierte una idea vaga en una especificación completa haciendo que Claude te entreviste, y guárdalo como skill para repetirlo en cada proyecto.

  • Flujo de trabajo
  • 10 min
  • 3 pasos
  • Revisada el

Al terminar sabrás

  • Pedirle a Claude que te entreviste antes de construir
  • Crear tu primera skill, /especificar, para repetirlo en cualquier proyecto
  • Terminar con una especificación en un archivo que guía todo lo demás

El plan de la lección anterior funciona cuando tú ya sabes lo que quieres. Muchas veces no: tienes una idea («una web para mi taller») y un montón de decisiones sin tomar. La solución es darle la vuelta: que Claude te pregunte a ti.

Claude Code tiene una herramienta para esto, AskUserQuestion: te hace preguntas con opciones para elegir (y siempre puedes escribir tu propia respuesta). Solo tienes que pedírselo.

La entrevista, a mano

Pídeselo a Claude
Quiero una web para mi taller de bicis. Antes de construir nada, entrevístame
con preguntas de opción múltiple sobre todo lo que necesites decidir: público,
objetivo, secciones, tono, diseño, contenido que tengo y lo que no,
formularios, publicación. Nada de preguntas obvias. Sigue hasta que no
queden dudas y escribe la especificación en docs/especificacion.md.

Responderás una tanda de preguntas y al final tendrás un documento con todo decidido. Ese documento es oro: lo reutilizas para planear, para construir y para revisar.

Conviértelo en una skill

Si lo vas a hacer en cada proyecto, guárdalo como skill: un archivo con instrucciones que invocas con /nombre. (En la lección 17 verás las skills a fondo.)

Crea el archivo .claude/skills/especificar/SKILL.md en tu proyecto (o en ~/.claude/skills/especificar/SKILL.md para tenerlo en todos) con esto:

Archivo Markdown
---
description: Entrevista al usuario para convertir una idea en una especificación completa. Úsala cuando haya que definir un proyecto o una funcionalidad antes de construirla.
disable-model-invocation: true
---

Vamos a especificar: $ARGUMENTS

1. Si existe docs/especificacion.md, léelo primero y pregunta solo lo que falte.
2. Entrevístame con la herramienta AskUserQuestion, en tandas de 2 a 4 preguntas
   con opciones concretas. Cubre: objetivo y público, alcance (qué entra y qué no),
   contenido disponible, diseño y tono, funcionalidades, datos y privacidad,
   publicación y qué tendré que hacer yo.
3. Nada de preguntas obvias ni de relleno. Si una respuesta abre dudas nuevas,
   profundiza.
4. Cuando no queden decisiones abiertas, escribe docs/especificacion.md con:
   resumen, decisiones tomadas, fuera de alcance, pendientes (lo que depende de mí)
   y criterios para dar el trabajo por terminado.
5. No escribas código.

Qué significa cada parte:

  • description: cuándo sirve la skill.
  • disable-model-invocation: true: solo se ejecuta cuando tú la llamas, no por su cuenta.
  • $ARGUMENTS: lo que escribas detrás del comando.

Úsala así:

Pídeselo a Claude
/especificar un formulario para pedir cita con recordatorio por WhatsApp

Pruébalo

  1. Crea la skill /especificar con el contenido de arriba.
  2. Úsala con la mejora que planeaste en la lección 13.
  3. Compara la especificación con tu plan: ¿qué no habías pensado?

Documentación oficial