QualiReq para VS Code
Revisa la calidad de requisitos de software, propone correcciones y genera casos de prueba sin salir del editor. Usa el mismo motor determinista que qualireq.vercel.app: 20 reglas sobre los 8 atributos de calidad de ISO/IEC/IEEE 29148 y técnicas de prueba de ISTQB. No usa IA: el mismo texto siempre da el mismo resultado.
La extensión trae tres piezas para el chat de VS Code: un participante @qualireq, un agente personalizado «QualiReq» con herramientas propias, y tres skills.
En el editor
Escribe un requisito por línea en un archivo .md o .txt, por ejemplo:
- RF-01 El sistema debe permitir al usuario ingresar una contraseña de entre 8 y 16 caracteres.
- RNF-01 El sistema debe ser rápido y fácil de usar.
- Sospechas en el panel Problemas. Cada sospecha indica la regla (por ejemplo
AMB-01), el atributo, la severidad y el motivo, y subraya el término que la produjo. Los archivos cuyo nombre contiene requisitos, requirements o .req se revisan solos; cualquier otro se revisa con QualiReq: Revisar requisitos del archivo (botón ✓ en la barra del editor).
- Arreglos rápidos (bombilla o Ctrl+.) para corregir la sospecha, agregar el término al diccionario de dominio o desactivar la regla en el espacio de trabajo.
- Barra de estado con la calidad global del archivo; un clic abre el informe.
En Markdown se ignoran los títulos, las tablas, los bloques de código y los párrafos de prosa; cuentan las viñetas, las líneas que empiezan con un identificador (RF-01, RNF-02…) y las que expresan una obligación («debe», «deberá»). En .txt cada línea es un requisito, igual que en la aplicación web.
| Comando |
Qué hace |
| QualiReq: Revisar requisitos del archivo |
Analiza el archivo y muestra las sospechas |
| QualiReq: Aplicar todas las correcciones |
Corrige todos los requisitos de una vez (Ctrl+Z lo deshace) |
| QualiReq: Generar casos de prueba |
Casos por valores límite y partición de equivalencia en Markdown, Gherkin, CSV o JSON |
| QualiReq: Ver informe de calidad |
Nota Q(r) por requisito, sospechas, correcciones y cobertura del generador |
| QualiReq: Ver catálogo de reglas |
Las 20 reglas con su ejemplo incorrecto y correcto |
| QualiReq: Quitar las sospechas del archivo |
Deja de revisar el archivo |
| QualiReq: Ver historial de revisiones |
Acciones anteriores y evolución de la calidad de cada archivo |
| QualiReq: Exportar historial (CSV) |
El historial en una hoja de cálculo, como evidencia |
| QualiReq: Ver registro (logs) |
Abre el registro de la extensión en el panel Salida |
| QualiReq: Borrar historial |
Vacía el historial de este espacio de trabajo |
Las correcciones proponen valores de referencia (2 s, 200 usuarios, 99,5 %) que el equipo debe validar antes de aprobar el requisito.
Registro e historial
- Registro (logs): panel Salida → QualiReq (o QualiReq: Ver registro (logs)). Cada línea lleva fecha, hora y nivel (
info, warning, error, y debug para las revisiones automáticas mientras escribes). Anota la activación con las versiones de la extensión y del motor, cada revisión, corrección, generación de casos, uso del chat y de las herramientas con su duración, los cambios de configuración y los errores. VS Code guarda el registro en disco: Developer: Open Extension Logs Folder. Para ver también los mensajes debug, usa Developer: Set Log Level… y elige QualiReq.
- Historial: cada acción explícita (revisar, corregir, arreglo rápido, generar casos, chat y herramientas) se guarda por espacio de trabajo con su fecha, archivo, calidad, requisitos, sospechas y casos, hasta 500 acciones. QualiReq: Ver historial de revisiones o
@qualireq /historial muestran la evolución de la nota de cada archivo, por ejemplo de 85 % a 100 % después de corregir.
- Privacidad: ni el registro ni el historial guardan el texto de los requisitos, solo el nombre del archivo y las métricas.
En el chat
| Pieza |
Cómo se usa |
Participante @qualireq |
@qualireq /revisar, /corregir, /casos, /reglas o /historial. Usa el archivo adjuntado con #, los requisitos escritos en el mensaje o el archivo abierto. Responde con el motor, sin modelo de lenguaje. |
| Agente QualiReq |
Elígelo en el selector de agentes. Revisa, corrige (mostrando los cambios antes de escribir) y genera casos usando las herramientas de la extensión. |
| Herramientas |
#qualireqAnalyze, #qualireqImprove, #qualireqCases y #qualireqRules, disponibles para cualquier agente en modo agente. Solo leen: ninguna modifica archivos. |
| Skills |
revisar-requisitos, corregir-requisitos y generar-casos-prueba: instrucciones que el agente carga cuando el pedido coincide. |
Configuración
| Opción |
Por defecto |
Uso |
qualireq.autoReviewPattern |
archivos con requisitos, requirements o .req en el nombre |
Qué archivos se revisan solos. Vacío: solo bajo demanda. |
qualireq.disabledRules |
[] |
Reglas desactivadas, por ejemplo ["PRI-01"]. |
qualireq.domainTerms |
[] |
Términos del dominio que no se marcan como ambiguos. |
Desarrollo
Desde la raíz del monorepo:
pnpm install
pnpm --filter qualireq-vscode test # pruebas unitarias (Vitest)
pnpm test:vscode # pruebas dentro de un VS Code real (@vscode/test-electron)
pnpm vscode:package # genera apps/vscode/dist/qualireq.vsix
Para probarla a mano, abre apps/vscode en VS Code y pulsa F5, o instala el .vsix con Extensiones: Instalar desde VSIX…. Las skills y el agente requieren una versión de VS Code con soporte para chatSkills y chatAgents; el participante y las herramientas necesitan GitHub Copilot Chat.
| |