Habilidades agile-design-doc
📦

agile-design-doc

Seguro

Generar Documentos de Diseño Ágiles

Los equipos de desarrollo necesitan documentos de diseño concisos que se alineen con los principios de MVP y eviten el sobre-ingeniería. Esta habilidad genera documentos de diseño técnicos enfocados con diagramas Mermaid, detalles de implementación y criterios de éxito claros.

Soporta: Claude Codex Code(CC)
📊 70 Adecuado
1

Descargar el ZIP de la skill

2

Subir en Claude

Ve a Configuración → Capacidades → Skills → Subir skill

3

Activa y empieza a usar

Pruébalo

Usando "agile-design-doc". Generate a design document for a user authentication feature in a Python Flask application

Resultado esperado:

  • Design Document: User Authentication
  • Target: Flask-based REST API
  • Key Features: Login, Register, Token Refresh
  • Mermaid sequence diagram showing auth flow
  • Code examples for auth endpoints

Usando "agile-design-doc". Create a design doc for a payment processing module integration

Resultado esperado:

  • Payment Module Integration Design
  • Data Models: Order, Payment, Transaction
  • API Endpoints with request/response schemas
  • Sequence diagram: Order -> Payment Gateway -> Callback
  • Error handling and retry strategies

Auditoría de seguridad

Seguro
v1 • 3/10/2026

Security audit completed. All 39 static findings are false positives. The skill contains only markdown documentation templates with example code blocks (Python, JSON, Mermaid diagrams). No actual code execution, cryptographic algorithms, or malicious patterns exist. This is a legitimate documentation generation skill for agile development teams.

2
Archivos escaneados
315
Líneas analizadas
4
hallazgos
1
Auditorías totales

Problemas de riesgo alto (2)

False Positive: Weak Cryptographic Algorithm Detection
Static analyzer incorrectly flagged YAML frontmatter fields as cryptographic code. Lines 2-3 contain name: and description: fields, not cryptographic algorithms.
False Positive: High File Entropy Detection
Static analyzer flagged YAML frontmatter delimiter as potential encrypted content. Line 1 contains standard --- markdown separator.
Problemas de riesgo medio (1)
False Positive: Ruby/Shell Backtick Execution
Static analyzer detected backticks and flagged as shell execution. These are markdown code fences used for syntax highlighting in documentation. No actual code execution occurs.
Problemas de riesgo bajo (1)
False Positive: System Reconnaissance
Static analyzer flagged mermaid diagram definitions as system reconnaissance. These are standard sequence diagrams showing component interactions, not network scanning.
Auditado por: claude

Puntuación de calidad

41
Arquitectura
100
Mantenibilidad
85
Contenido
50
Comunidad
78
Seguridad
83
Cumplimiento de la especificación

Lo que puedes crear

Sprint de Diseño Rápido

Generar rápidamente un documento de diseño para una nueva funcionalidad durante la planificación del sprint

Alineación Entre Equipos

Crear documentos de diseño estandarizados que ayuden a los equipos de backend, frontend y QA a entender los requisitos

Documentación Técnica

Generar documentación de referencia para módulos del sistema existentes

Prueba estos prompts

Diseño de Nueva Funcionalidad
Generate a design document for a new [feature name] feature. The feature should [brief description]. Consider using [tech stack].
Documento de Diseño API
Create a design document for a REST API that handles [resource]. Include data models, endpoints, and sequence diagrams.
Integración de Módulos
Generate a design document showing how to integrate [new module] with the existing [existing system]. Show the interaction flow.
Diseño de Modelo de Datos
Design the data models and relationships for [domain area]. Include key entities, attributes, and how they interact.

Mejores prácticas

  • Comienza analizando el stack tecnológico existente desde los archivos de configuración del proyecto
  • Enfócate en el alcance MVP - documenta primero la funcionalidad principal
  • Usa diagramas Mermaid para visualizar las interacciones de componentes
  • Incluye ejemplos de código para las rutas críticas de implementación

Evitar

  • Agregar funcionalidades innecesarias que podrían postponerse a iteraciones posteriores
  • Escribir explicaciones de contexto extensas en lugar de enfocarse en la implementación
  • Ignorar componentes existentes y duplicar funcionalidad
  • Incluir todos los casos edge posibles en lugar de enfocarse en los happy paths

Preguntas frecuentes

What information should I provide for the best results?
Proporciona el nombre de la funcionalidad, su propósito, el stack tecnológico del proyecto y cualquier componente existente que deba reutilizarse.
Can this skill generate code for any programming language?
La habilidad proporciona ejemplos en Python, Java, JavaScript y Go según la configuración de tu proyecto.
How detailed are the generated diagrams?
Los diagramas de secuencia Mermaid muestran las interacciones principales de componentes. Puedes solicitar diagramas más detallados según sea necesario.
Does this skill connect to external systems?
No, esta habilidad solo genera texto de documentación. No realiza solicitudes de red ni ejecuta código.
Can I use this for legacy system documentation?
Sí, proporciona los detalles del sistema existente y la habilidad ayudará a documentar la arquitectura actual.
How do I refine the generated document?
Revisa la salida y proporciona retroalimentación. La habilidad puede iterar en secciones específicas según sea necesario.

Detalles del desarrollador

Estructura de archivos