Imported from ellmos-ai/skills (
skills/dev/docs-analysis/ES/SKILL.md). Install upstream withnpx skills add ellmos-ai/skills --skill ES. Copyright stays with the author.
name: docs-analysis version: 1.0.0 type: skill author: Lukas Geiger created: 2026-03-15 updated: 2026-03-15 description: Análisis de requisitos de documentos: Analiza los documentos de concepto y requisitos en la carpeta docs/, verifica los requisitos con el código actual y crea un informe de diferencias consolidado.
standalone: true anthropic_compatible: true bach_compatible: false bach_origin: true category: dev tags: [docs-analysis, requirements, code-review, diff-report, quality-assurance] language: es status: active dependencies: {'tools': [], 'services': [], 'protocols': [], 'python': []} provenance: {'origin': 'bach', 'origin_path': 'system/skills/workflows/docs-analyse.md', 'origin_version': '1.2.0', 'origin_repo': 'github.com/ellmos-ai/bach', 'last_sync_from_origin': '2026-03-15', 'last_sync_to_origin': None, 'local_changes_since_sync': True}
Español — Versión oficial en español de
docs-analysis.
Análisis de Requisitos de Documentos (Español)
Analiza todos los documentos de concepto y requisitos, verifica sus requisitos con el código actual y crea un informe de diferencias consolidado.
Descripción general y propósito
Analiza todos los documentos de concepto y requisitos en la carpeta ../docs/, verifica sus requisitos con el código actual y crea un informe de diferencias consolidado.
Convención de nomenclatura
Prefijo y sufijo
Todos los documentos analizados reciben:
- Prefijo:
conN_donde N = versión de análisis (1, 2, 3, ...) - Sufijo:
_XXdonde XX = porcentaje de cumplimiento (redondeado al 10 más cercano)
Umbral de archivado
- >= 75% cumplido: El documento se mueve a
../docs/_archive/ - < 75% cumplido: El documento permanece en
../docs/con prefijo/sufijo - Umbral configurable (predeterminado: 75)
Proceso
Fase 1: Recopilar documentos
- Listar todos los archivos *.md y *.txt en ../docs/ (raíz)
- Filtrar README.txt
Fase 2: Extraer requisitos
Para cada documento:
- Leer contenido
- Identificar requisitos (listas de verificación, tablas, marcadores MISSING/TODO)
- Categorizar: Structure, Code, API, DB Schema, CLI, Feature
Fase 3: Verificación de código
Para cada requisito:
- Determinar el método de verificación (Glob, Grep, Read)
- Ejecutar la verificación
- Marcar como: FULFILLED, PARTIAL, MISSING
Fase 4: Evaluación
- Contar requisitos cumplidos vs. pendientes
- Calcular porcentaje de cumplimiento (%)
- Decidir: archivar (>= 75%) o mantener (< 75%)
Fase 5: Generar salida
- Crear REQUIREMENTS_ANALYSIS.md (resumen)
- Crear consense_diff.md (solo requisitos pendientes, por prioridad)
Fase 6: Control de versiones
- Escanear en busca del prefijo conN_ más alto
- Nueva versión = más alta + 1
Fase 7: Renombrar y mover
- Aplicar nuevo prefijo/sufijo a los documentos
- Archivar o mantener
Salida
| Archivo | Descripción |
|---|---|
conN_REQUIREMENTS_ANALYSIS.md |
Análisis completo (versión N) |
consense_diff_N.md |
Requisitos pendientes consolidados |
_archive/conN_*_XX.* |
Documentos archivados (>=75%) |
Clasificación de prioridad
| Prioridad | Criterios |
|---|---|
| P1 | Funcionalidad principal ausente, sistema no utilizable |
| P2 | Función importante ausente, alternativa posible |
| P3 | Deseable, mejora la UX |
| P4 | Cosmético, documentación, calidad de código |
Registro de cambios
1.0.0 (2026-03-15)
- Adaptado de BACH v3.8.0
Adaptado de BACH v3.8.0 | Versión independiente