docs: añadir issue 010 para consolidar skills de issues

Nueva issue para unificar skills de issues con flags. Actualizar README de issues con sección de mejoras a skills. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-27 02:15:28 +01:00
parent 7f4c481e73
commit 8055ec216e
2 changed files with 122 additions and 0 deletions
@@ -0,0 +1,116 @@
+# 0010 — Consolidar Skills de Issues en una Skill Unificada
+
+## Metadata
+
+| Campo | Valor |
+|-------|-------|
+| **ID** | 0010 |
+| **Estado** | 🟡 pendiente |
+| **Prioridad** | media |
+| **Tipo** | refactor |
+
+## Dependencias
+
+Ninguna.
+
+**Desbloquea:** mejor mantenibilidad del sistema de skills
+
+---
+
+## Objetivo
+
+Consolidar las 6 skills de gestión de issues (`create-issue`, `auto-create`, `quick-issue`, `fix-issue`, `auto-fix`, `issues-status`) en 2 skills unificadas con flags, reduciendo duplicación y simplificando el mantenimiento.
+
+## Contexto
+
+- Actualmente hay 3 variantes de creación (`create-issue`, `auto-create`, `quick-issue`) que difieren solo en el nivel de confirmación
+- Hay 2 variantes de implementación (`fix-issue`, `auto-fix`) que difieren solo en confirmación
+- Las 3 skills de análisis/ejecución paralela (`sort-issues`, `parallel-issues`, `execute-parallel`) son un pipeline secuencial que podría ser un solo flujo
+- Mantener 6+ skills con lógica casi idéntica genera drift y bugs silenciosos
+
+## Arquitectura
+
+```
+skills/
+├── issue/SKILL.md              — NUEVA: unifica create + auto-create + quick-issue
+├── fix/SKILL.md                — NUEVA: unifica fix-issue + auto-fix
+├── issues-status/SKILL.md      — SE MANTIENE (es diferente)
+├── parallel-pipeline/SKILL.md  — NUEVA: unifica sort + parallel + execute
+│
+├── create-issue/               — DEPRECAR
+├── auto-create/                — DEPRECAR
+├── quick-issue/                — DEPRECAR
+├── fix-issue/                  — DEPRECAR
+├── auto-fix/                   — DEPRECAR
+├── sort-issues/                — DEPRECAR
+├── parallel-issues/            — DEPRECAR
+└── execute-parallel/           — DEPRECAR
+```
+
+## Tareas
+
+### Fase 1: Skill `/issue` unificada
+
+- [ ] **1.1** Crear `skills/issue/SKILL.md` que acepte flags:
+  - `/issue` → modo interactivo con confirmación (actual `create-issue`)
+  - `/issue --auto` → sin confirmación (actual `auto-create`)
+  - `/issue --quick --text "descripción"` → minimal desde TUI (actual `quick-issue`)
+- [ ] **1.2** Extraer lógica común: detección de número, slug, template, git integration
+- [ ] **1.3** Tests: verificar los 3 modos producen el mismo resultado
+
+### Fase 2: Skill `/fix` unificada
+
+- [ ] **2.1** Crear `skills/fix/SKILL.md` que acepte flags:
+  - `/fix <NNNN>` → modo interactivo con confirmación (actual `fix-issue`)
+  - `/fix <NNNN> --auto` → sin confirmación (actual `auto-fix`)
+- [ ] **2.2** Extraer lógica común: lectura de issue, branch, implementación, tests, cierre
+
+### Fase 3: Skill `/parallel` unificada
+
+- [ ] **3.1** Crear `skills/parallel-pipeline/SKILL.md` que combine:
+  - Análisis de dependencias (actual `sort-issues`)
+  - Generación de plan paralelo (actual `parallel-issues`)
+  - Ejecución con worktrees (actual `execute-parallel`)
+- [ ] **3.2** Flags: `--dry-run`, `--group N`, `--sequential`, `--plan-only`
+
+### Fase 4: Migración y limpieza
+
+- [ ] **4.1** Mantener skills antiguas como aliases temporales (1 semana)
+- [ ] **4.2** Eliminar skills deprecadas
+- [ ] **4.3** Actualizar `skills/README.md`
+- [ ] **4.4** Actualizar documentación en issues que referencien las skills antiguas
+
+## Ejemplo de uso
+
+```bash
+# Antes (3 skills distintas):
+/create-issue
+/auto-create
+/quick-issue --text "bug en parser"
+
+# Después (1 skill con flags):
+/issue
+/issue --auto
+/issue --quick --text "bug en parser"
+
+# Antes (2 skills distintas):
+/fix-issue 0010
+/auto-fix 0010
+
+# Después:
+/fix 0010
+/fix 0010 --auto
+```
+
+## Decisiones de diseño
+
+- **Flags sobre skills separadas**: Reduce de 8 skills a 3, misma funcionalidad. El flag `--auto` es más intuitivo que recordar `auto-fix` vs `fix-issue`
+- **`issues-status` se mantiene separada**: Es un dashboard de consulta, no comparte lógica con creación/implementación
+- **Pipeline paralelo como skill única**: sort → plan → execute es siempre secuencial, no tiene sentido invocarlos por separado
+
+## Criterios de aceptación
+
+- [ ] Las 3 nuevas skills cubren 100% de la funcionalidad de las 8 antiguas
+- [ ] Los flags son consistentes entre skills (`--auto`, `--dry-run`)
+- [ ] Skills antiguas eliminadas sin romper nada
+- [ ] README.md de skills actualizado
@@ -21,6 +21,12 @@ Sistema local de issues para trackear mejoras y nuevos agentes.
 | 008 | [frontend-lib](008-improve-frontend-lib.md) - Versionado, testing | Media | Pendiente |
 | 009 | [gitea](009-improve-gitea.md) - Actions, templates | Media | Pendiente |

+## Mejoras a Skills
+
+| # | Issue | Prioridad | Estado |
+|---|-------|-----------|--------|
+| 010 | [consolidate-issue-skills](010-consolidate-issue-skills.md) - Unificar skills de issues con flags | Media | Pendiente |
+
 ## Agentes Completados

 | Agente | Descripción | Fecha |