菜单
Convierte una idea o feature vaga en una spec ejecutable con las 5 preguntas (contexto, objetivo, restricciones, tareas y verificación) antes de escribir código. Úsala cuando el usuario describa algo que quiere construir y pida una spec, o planear el trabajo antes de implementar.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | scope |
| description | Convierte una idea o feature vaga en una spec ejecutable con las 5 preguntas (contexto, objetivo, restricciones, tareas y verificación) antes de escribir código. Úsala cuando el usuario describa algo que quiere construir y pida una spec, o planear el trabajo antes de implementar. |
Convierte la idea del usuario en una spec y guárdala en specs/<slug>.md. Lee primero CLAUDE.md / AGENTS.md si existen (de ahí salen las convenciones y restricciones globales). Pregunta solo si estás bloqueado. No escribas código todavía.
Trabajas en dos pasos:
## Flujo con DOS diagramas ASCII (secuencia + flujo) y detente: muéstraselos al usuario y pídele que confirme que ese es el comportamiento que quiere. Aquí es donde se aprueban las decisiones que el agente, si no, inventaría (ventanas de tiempo, casos borde, qué pasa si no hay datos). No sigas hasta el "sí".La spec debe tener exactamente estas secciones:
# <Nombre de la feature>
## Contexto
- Qué existe hoy (stack, carpetas) que debes respetar.
- Patrones a seguir (nombra un archivo del repo que ya lo hace bien).
- Decisiones ya tomadas (para no re-discutirlas).
## Objetivo
El resultado concreto y acotado. Una frase, no "mejorar X".
## Flujo
Diagrama de SECUENCIA. Por defecto entrega la versión **comprimida** (lista ordenada de pasos); solo si el usuario pide el detalle, dale la **completa** con lifelines.
Comprimida (default):
SECUENCIA (orden temporal ↓)
Completa (solo si la piden) — cada participante con su lifeline vertical (`│`), el tiempo hacia ABAJO; llamadas flecha sólida (`──▶`), retornos punteada (`◀ ─ ─`):
Actor Componente OtroComp │ │ │ │ acción │ │ │────────────▶│ │ │ │ llamada() │ │ │─────────────▶│ │ │◀ ─ retorno ─ │ │◀─ respuesta │ │ ▼ ▼ ▼
Diagrama de FLUJO (las decisiones y ramas — acá viven los casos borde):
entrada │ ▼ ¿condición? ──no──▶ rama A │ sí ▼ acción ──▶ resultado
## Restricciones
- Qué NO tocar (auth, modelo de datos, contratos de API).
- Sin dependencias nuevas salvo que sea necesario y justificado.
## Fuera de alcance
- Lo que NO va en esta feature.
## Tareas
### T1: <título corto>
- **Hacer:** <cambio específico>
- **Archivos:** <rutas que tocará>
- **Verify:** <comando o check manual específico>
### T2: ...
## Done (validación final)
- [ ] <comando build/test pasa>
- [ ] Manual: <qué revisar end-to-end>
Reglas al escribirla:
Al terminar, hazte el test de completitud: ¿un agente nuevo, sin más contexto que esta spec, podría implementar T1? Si no, falta detalle.
Revisa los cambios (el diff) como un ingeniero senior contra la spec, mirando alcance, correctitud, simplicidad y consistencia. Úsala antes de commitear o mergear, cuando se pida revisar el código o el diff.
Reviews the changes (the diff) as a senior engineer against the spec, looking at scope, correctness, simplicity and consistency. Use it before committing or merging, when a review of the code or the diff is requested.
Implements ONE single task from an existing spec, without touching anything else. Use it when a spec file exists in the specs folder and the user asks to run or implement a concrete task (for example T1 or T2).
Verifies that a task is actually done by running its Verify step and showing the real output, no self-reporting. Use it after implementing a task, when you want to confirm it truly works and not just that the agent claims so.
Turns a vague idea or feature into an executable spec using the 5 questions (context, goal, constraints, tasks and verification) before writing any code. Use it when the user describes something they want to build and asks for a spec, or to plan the work before implementing.
Writes the commit message for the staged changes, in conventional commits format and explaining the why. Use it when you want to commit or generate the commit message.