refacil-sdd-ai 2.0.1 → 2.0.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +4 -2
- package/package.json +1 -1
- package/skills/apply/SKILL.md +1 -0
- package/skills/guide/SKILL.md +11 -0
- package/skills/review/SKILL.md +1 -1
- package/skills/setup/SKILL.md +2 -2
- package/skills/test/SKILL.md +3 -0
- package/skills/up-code/SKILL.md +18 -2
- package/skills/verify/SKILL.md +36 -5
package/README.md
CHANGED
|
@@ -67,7 +67,7 @@ Una vez instalado, estos comandos estan disponibles en Claude Code y Cursor:
|
|
|
67
67
|
| `/refacil:propose` | Crear propuesta de cambio (proposal + specs + design + tasks) |
|
|
68
68
|
| `/refacil:apply` | Implementar las tasks del cambio propuesto |
|
|
69
69
|
| `/refacil:test` | Generar tests unitarios desde los artefactos |
|
|
70
|
-
| `/refacil:verify` | Validar implementacion vs specs |
|
|
70
|
+
| `/refacil:verify` | Validar implementacion vs specs (con opcion de aplicar correcciones) |
|
|
71
71
|
| `/refacil:review` | Review con checklist de calidad del equipo |
|
|
72
72
|
| `/refacil:archive` | Archivar cambio completado |
|
|
73
73
|
| `/refacil:up-code` | Subir codigo a rama de desarrollo (con validacion de ramas protegidas) |
|
|
@@ -83,6 +83,8 @@ Una vez instalado, estos comandos estan disponibles en Claude Code y Cursor:
|
|
|
83
83
|
/refacil:apply
|
|
84
84
|
/refacil:test
|
|
85
85
|
/refacil:verify
|
|
86
|
+
# → Si hay correcciones: verify pregunta si aplicarlas automaticamente
|
|
87
|
+
# → Si aprueba: aplica fixes y re-verifica (max 2 rondas)
|
|
86
88
|
/refacil:review
|
|
87
89
|
/refacil:archive
|
|
88
90
|
/refacil:up-code
|
|
@@ -118,7 +120,7 @@ refacil-sdd-ai init → Skills en .claude/ y .cursor/
|
|
|
118
120
|
/refacil:propose → Artefactos en openspec/changes/
|
|
119
121
|
/refacil:apply → Codigo implementado
|
|
120
122
|
/refacil:test → Tests generados
|
|
121
|
-
/refacil:verify → Validacion PASS/FAIL
|
|
123
|
+
/refacil:verify → Validacion PASS/FAIL (puede aplicar fixes con aprobacion)
|
|
122
124
|
/refacil:review → Review con checklist
|
|
123
125
|
/refacil:archive → Cambio archivado
|
|
124
126
|
/refacil:up-code → Push a rama de desarrollo
|
package/package.json
CHANGED
package/skills/apply/SKILL.md
CHANGED
|
@@ -111,6 +111,7 @@ Al terminar la implementacion de OpenSpec, agrega este resumen:
|
|
|
111
111
|
Siguientes pasos:
|
|
112
112
|
1. /refacil:test — Generar tests unitarios
|
|
113
113
|
2. /refacil:verify — Validar implementacion vs specs
|
|
114
|
+
(si encuentra correcciones, te ofrece aplicarlas automaticamente)
|
|
114
115
|
```
|
|
115
116
|
|
|
116
117
|
## Reglas
|
package/skills/guide/SKILL.md
CHANGED
|
@@ -51,6 +51,17 @@ FLUJO PARA NUEVO FEATURE:
|
|
|
51
51
|
Valida que la implementacion cumple con las specs.
|
|
52
52
|
Revisa completitud, correccion y coherencia.
|
|
53
53
|
|
|
54
|
+
Si encuentra correcciones necesarias (CRITICAL o WARNING):
|
|
55
|
+
- Te muestra el reporte con los issues encontrados
|
|
56
|
+
- Te pregunta si quieres que aplique las correcciones automaticamente
|
|
57
|
+
- Si aceptas: aplica SOLO los fixes necesarios y re-verifica
|
|
58
|
+
- Maximo 2 rondas de correccion automatica
|
|
59
|
+
- Si despues de 2 rondas quedan issues, los lista para correccion manual
|
|
60
|
+
- Si no aceptas: lista los issues para que los corrijas manualmente
|
|
61
|
+
y luego ejecutes /refacil:verify de nuevo
|
|
62
|
+
|
|
63
|
+
Solo avanza a review cuando la verificacion pasa completamente.
|
|
64
|
+
|
|
54
65
|
6. /refacil:review
|
|
55
66
|
Review con el checklist de calidad del equipo.
|
|
56
67
|
Evalua conformidad con specs, codigo, arquitectura, testing,
|
package/skills/review/SKILL.md
CHANGED
|
@@ -106,4 +106,4 @@ Correcciones necesarias:
|
|
|
106
106
|
- Ser constructivo: no solo decir que falla, sino como corregirlo
|
|
107
107
|
- No ser excesivamente estricto con N/A — si no aplica, marcarlo
|
|
108
108
|
- Si todo es PASS, felicitar brevemente y sugerir `/refacil:archive`
|
|
109
|
-
- Si hay FAILs criticos (seguridad, tests), marcar como bloqueantes
|
|
109
|
+
- Si hay FAILs criticos (seguridad, tests), marcar como bloqueantes y sugerir `/refacil:verify` para aplicar correcciones con asistencia de la IA
|
package/skills/setup/SKILL.md
CHANGED
|
@@ -138,7 +138,7 @@ Si por cualquier razon no puedes generar un AGENTS.md completo (archivos no legi
|
|
|
138
138
|
| `/refacil:propose` | Crear propuesta de cambio |
|
|
139
139
|
| `/refacil:apply` | Implementar tasks del cambio |
|
|
140
140
|
| `/refacil:test` | Generar tests unitarios |
|
|
141
|
-
| `/refacil:verify` | Validar implementacion vs specs |
|
|
141
|
+
| `/refacil:verify` | Validar implementacion vs specs (con opcion de aplicar correcciones) |
|
|
142
142
|
| `/refacil:review` | Review con checklist de calidad |
|
|
143
143
|
| `/refacil:archive` | Archivar cambio completado |
|
|
144
144
|
| `/refacil:up-code` | Subir codigo a rama de desarrollo |
|
|
@@ -169,7 +169,7 @@ Si el usuario aprueba (o no tiene cambios), escribe el archivo en la raiz del pr
|
|
|
169
169
|
|
|
170
170
|
#### 7.1 Verificar skills de OpenSpec
|
|
171
171
|
|
|
172
|
-
Verifica que existan las 10 carpetas de skills de OpenSpec en `.claude/skills/`:
|
|
172
|
+
Verifica que existan las 10 carpetas de skills de OpenSpec en `.claude/skills/` y `.cursor/skills/`:
|
|
173
173
|
- `openspec-apply-change`
|
|
174
174
|
- `openspec-archive-change`
|
|
175
175
|
- `openspec-bulk-archive-change`
|
package/skills/test/SKILL.md
CHANGED
|
@@ -77,6 +77,9 @@ Si el usuario ejecuta `/refacil:test` sin argumentos:
|
|
|
77
77
|
Coverage archivos nuevos: [X]%
|
|
78
78
|
Coverage minimo requerido: 80%
|
|
79
79
|
Estado: CUMPLE / NO CUMPLE
|
|
80
|
+
|
|
81
|
+
Siguiente paso: /refacil:verify — Validar implementacion vs specs
|
|
82
|
+
(si encuentra correcciones, te ofrece aplicarlas automaticamente)
|
|
80
83
|
```
|
|
81
84
|
|
|
82
85
|
### Modo 2: Tests para archivo especifico (con argumento)
|
package/skills/up-code/SKILL.md
CHANGED
|
@@ -79,15 +79,31 @@ Ejecuta `git status` para verificar si hay cambios para subir.
|
|
|
79
79
|
|
|
80
80
|
Ejecuta `git push -u origin [rama-actual]` para subir los cambios.
|
|
81
81
|
|
|
82
|
-
### Paso 6: Confirmar
|
|
82
|
+
### Paso 6: Confirmar y crear PR
|
|
83
83
|
|
|
84
|
+
1. Muestra el resumen del push:
|
|
84
85
|
```
|
|
85
86
|
=== Codigo subido ===
|
|
86
87
|
Rama: [nombre-rama]
|
|
87
88
|
Commit: [hash-corto] [mensaje]
|
|
88
89
|
Remote: origin/[nombre-rama]
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
2. **Pregunta al usuario** hacia cual rama destino quiere crear el Pull Request. **No sugieras ni asumas** una rama por defecto. Simplemente pregunta:
|
|
93
|
+
```
|
|
94
|
+
Hacia cual rama quieres crear el Pull Request?
|
|
95
|
+
```
|
|
89
96
|
|
|
90
|
-
|
|
97
|
+
3. Una vez el usuario responda, obtén la URL del repositorio remoto con `git remote get-url origin` y determina el hosting para generar el link correcto de creación del PR:
|
|
98
|
+
- **GitHub** (url contiene `github.com`): `https://github.com/[owner]/[repo]/compare/[rama-destino]...[rama-actual]?expand=1`
|
|
99
|
+
- **Bitbucket** (url contiene `bitbucket.org`): `https://bitbucket.org/[workspace]/[repo]/pull-requests/new?source=[rama-actual]&dest=[rama-destino]`
|
|
100
|
+
- Si no se puede determinar el hosting, muestra ambos formatos para que el usuario elija.
|
|
101
|
+
|
|
102
|
+
Nota: para URLs SSH (`git@github.com:owner/repo.git` o `git@bitbucket.org:workspace/repo.git`), extrae owner/workspace y repo del path tras el `:`.
|
|
103
|
+
|
|
104
|
+
4. Muestra el link al usuario:
|
|
105
|
+
```
|
|
106
|
+
Crea tu PR aqui: [link]
|
|
91
107
|
```
|
|
92
108
|
|
|
93
109
|
## Reglas
|
package/skills/verify/SKILL.md
CHANGED
|
@@ -58,13 +58,44 @@ Correcciones necesarias:
|
|
|
58
58
|
2. [issues de tests]
|
|
59
59
|
```
|
|
60
60
|
|
|
61
|
-
### Paso 4:
|
|
61
|
+
### Paso 4: Resultado y siguiente paso
|
|
62
62
|
|
|
63
|
-
|
|
64
|
-
|
|
63
|
+
#### Si APROBADO (sin issues CRITICAL ni WARNING):
|
|
64
|
+
|
|
65
|
+
"Ejecuta `/refacil:review` para el review con checklist del equipo."
|
|
66
|
+
|
|
67
|
+
#### Si REQUIERE CORRECCIONES (hay issues CRITICAL o WARNING):
|
|
68
|
+
|
|
69
|
+
Presenta las correcciones necesarias y pregunta al usuario:
|
|
70
|
+
|
|
71
|
+
```
|
|
72
|
+
RESULTADO: REQUIERE CORRECCIONES
|
|
73
|
+
|
|
74
|
+
Correcciones necesarias:
|
|
75
|
+
1. [CRITICAL/WARNING] [descripcion del issue y como corregirlo]
|
|
76
|
+
2. [CRITICAL/WARNING] [descripcion del issue y como corregirlo]
|
|
77
|
+
|
|
78
|
+
Quieres que aplique estas correcciones? (si/no)
|
|
79
|
+
- Si: aplicare los fixes y re-verificare automaticamente
|
|
80
|
+
- No: puedes corregirlos manualmente y ejecutar /refacil:verify de nuevo
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
**Si el usuario acepta:**
|
|
84
|
+
|
|
85
|
+
1. Aplica SOLO las correcciones listadas — no agregar funcionalidad nueva, no refactorizar codigo no relacionado, no cambiar nada fuera del alcance de los issues reportados.
|
|
86
|
+
2. Si hay tests que necesitan ajuste por las correcciones, ajustarlos tambien.
|
|
87
|
+
3. Muestra un resumen breve de los archivos modificados.
|
|
88
|
+
4. Re-ejecuta automaticamente la verificacion completa (vuelve al Paso 1) para confirmar que las correcciones resolvieron los issues.
|
|
89
|
+
5. Si la re-verificacion encuentra nuevos issues, repite este ciclo (maximo 2 rondas de correccion automatica). Si despues de 2 rondas aun hay issues, lista los pendientes para correccion manual.
|
|
90
|
+
|
|
91
|
+
**Si el usuario no acepta:**
|
|
92
|
+
|
|
93
|
+
Lista los issues para que el usuario los corrija manualmente. Sugiere ejecutar `/refacil:verify` de nuevo cuando termine.
|
|
65
94
|
|
|
66
95
|
## Reglas
|
|
67
96
|
|
|
68
|
-
- NO modificar codigo
|
|
97
|
+
- Durante la fase de verificacion (Pasos 1-3): NO modificar codigo, solo analizar y reportar
|
|
98
|
+
- Las correcciones SOLO se aplican en el Paso 4, despues del reporte completo y con aprobacion explicita del usuario
|
|
99
|
+
- Las correcciones deben ser quirurgicas: solo lo necesario para resolver los issues reportados
|
|
69
100
|
- Ser estricto con los criterios de la spec
|
|
70
|
-
- Si algo no esta en la spec pero parece necesario, mencionarlo como observacion, no como
|
|
101
|
+
- Si algo no esta en la spec pero parece necesario, mencionarlo como SUGGESTION (observacion), no como CRITICAL/WARNING
|