Ir al contenido
github/awesome-copilot

Crear una especificación de arquitectura técnica de alto nivel para una épica de desarrollo a partir de un documento de requisitos del producto

GitHub CopilotClaude CodeOpenAI CodexCursorGemini CLIDevin / Windsurf

Acerca de esta habilidad

Una habilidad basada en un prompt que indica al agente que actúe como ingeniero de software sénior. El agente convierte el documento de requisitos del producto de la épica (Epic PRD) en una especificación de arquitectura técnica en formato Markdown. La especificación incluye una visión general del enfoque técnico, un diagrama Mermaid del sistema dividido en capas, una lista de las funcionalidades principales y los habilitadores técnicos, las tecnologías utilizadas, una estimación del valor técnico y una estimación del tamaño en tallas de camiseta (S/M/L/XL). El resultado se guarda en la ruta /docs/ways-of-work/plan/{epic-name}/arch.md.
Empieza aquí

¿Cómo se utiliza esta habilidad?

1. Prepare el contenido del documento de requisitos del producto de la épica (Epic PRD), ya sea como archivo Markdown o como texto, y defina un nombre corto para la épica. 2. Pida al agente que aplique la habilidad breakdown-epic-arch y pegue el contenido del documento en la solicitud o indique su archivo. Ejemplo de solicitud del usuario: «Este es el documento de requisitos de la épica del sistema de notificaciones. Crea su especificación de arquitectura técnica de alto nivel y guárdala con el nombre de épica notifications». 3. El agente generará la especificación con las seis secciones definidas: la visión general, un diagrama Mermaid con las capas de usuario, aplicación, servicios, datos e infraestructura, las funcionalidades y los habilitadores técnicos, las tecnologías, el valor técnico y la estimación del tamaño. 4. Verifique que el archivo se haya guardado en la ruta /docs/ways-of-work/plan/notifications/arch.md y, a continuación, revise el diagrama en una herramienta que muestre Mermaid. 5. Ajuste las tecnologías propuestas si su proyecto no utiliza la pila supuesta por la habilidad y pida al agente que actualice la especificación en consecuencia.

Requisitos y limitaciones

- La habilidad requiere el contenido del documento de requisitos del producto de la épica (Epic PRD) como entrada principal. - No requiere cuentas ni claves de acceso. Para guardar el resultado automáticamente en la ruta especificada, el agente debe tener permiso de escritura sobre los archivos del repositorio. - La habilidad supone una pila tecnológica predefinida: TypeScript y Next.js con App Router, Turborepo, tRPC, Stack Auth para la autenticación, contenedores Docker, PostgreSQL, Qdrant, Redis y n8n. Si la pila de su proyecto es diferente, deberá ajustar los resultados manualmente. - Para mostrar el diagrama se necesita una herramienta o plataforma compatible con Mermaid. - La habilidad no escribe código; se limita a pseudocódigo cuando es necesario. No ejecuta nada ni valida la arquitectura propuesta. - Las estimaciones del valor técnico y del tamaño son aproximadas y requieren revisión humana. - La habilidad procede de una fuente con licencia MIT.

Instalación según el agente

Descarga y descomprime el ZIP. Contiene la carpeta breakdown-epic-arch y el archivo SKILL.md con los adjuntos originales y la licencia.

GitHub Copilot
  1. Crea esta ruta dentro de tu proyecto si no existe:.github/skills/
  2. Copia la carpeta completa de la habilidad en esta ruta:.github/skills/breakdown-epic-arch/SKILL.md
  3. Abre el proyecto en el agente o actualiza la lista y busca breakdown-epic-arch.
  4. Solicita la tarea del ejemplo y selecciona la habilidad. Concede solo los permisos necesarios.
Guía GitHub Copilot documentación oficial ↗
Claude Code
  1. Crea esta ruta dentro de tu proyecto si no existe:.claude/skills/
  2. Copia la carpeta completa de la habilidad en esta ruta:.claude/skills/breakdown-epic-arch/SKILL.md
  3. Abre el proyecto en el agente o actualiza la lista y busca breakdown-epic-arch.
  4. Solicita la tarea del ejemplo y selecciona la habilidad. Concede solo los permisos necesarios.
Guía Claude Code documentación oficial ↗
OpenAI Codex
  1. Crea esta ruta dentro de tu proyecto si no existe:.agents/skills/
  2. Copia la carpeta completa de la habilidad en esta ruta:.agents/skills/breakdown-epic-arch/SKILL.md
  3. Abre el proyecto en el agente o actualiza la lista y busca breakdown-epic-arch.
  4. Solicita la tarea del ejemplo y selecciona la habilidad. Concede solo los permisos necesarios.
Guía OpenAI Codex documentación oficial ↗
Cursor
  1. Crea esta ruta dentro de tu proyecto si no existe:.cursor/skills/
  2. Copia la carpeta completa de la habilidad en esta ruta:.cursor/skills/breakdown-epic-arch/SKILL.md
  3. Abre el proyecto en el agente o actualiza la lista y busca breakdown-epic-arch.
  4. Solicita la tarea del ejemplo y selecciona la habilidad. Concede solo los permisos necesarios.
Guía Cursor documentación oficial ↗
Gemini CLI
  1. Crea esta ruta dentro de tu proyecto si no existe:.gemini/skills/
  2. Copia la carpeta completa de la habilidad en esta ruta:.gemini/skills/breakdown-epic-arch/SKILL.md
  3. Abre el proyecto en el agente o actualiza la lista y busca breakdown-epic-arch.
  4. Solicita la tarea del ejemplo y selecciona la habilidad. Concede solo los permisos necesarios.
Guía Gemini CLI documentación oficial ↗
Devin / Windsurf
  1. Crea esta ruta dentro de tu proyecto si no existe:.devin/skills/
  2. Copia la carpeta completa de la habilidad en esta ruta:.devin/skills/breakdown-epic-arch/SKILL.md
  3. Abre el proyecto en el agente o actualiza la lista y busca breakdown-epic-arch.
  4. Solicita la tarea del ejemplo y selecciona la habilidad. Concede solo los permisos necesarios.
Guía Devin / Windsurf documentación oficial ↗

Los archivos mantienen su idioma para conservar nombres y rutas. La compatibilidad se clasifica mediante revisión, no mediante pruebas en todas las versiones.