Skip to content

Autonomous OODA-loop pentesting agent. Hermes brain, Kali + Playwright tools over MCP, ATT&CK as the Orient language.

feat: pentest-report skill v0.2 — two-layer report (base + enrichment)

irraz227a12075bd9
diff --git a/agent-ooda/skills/pentest-report/SKILL.md b/agent-ooda/skills/pentest-report/SKILL.md
index 2b6a1fd..c7759fa 100644
--- a/agent-ooda/skills/pentest-report/SKILL.md
+++ b/agent-ooda/skills/pentest-report/SKILL.md
@@ -1,7 +1,7 @@
---
name: pentest-report
-description: Genera el informe formal de pentest (Markdown) al cerrar un engagement, leyendo el store de hallazgos.
-version: 0.1.0
+description: Genera el informe formal de pentest (Markdown) al cerrar un engagement — base estructurada desde el store + enriquecimiento narrativo del modelo desde la sesion.
+version: 0.2.0
author: vulnerator-ai
license: MIT
metadata:
@@ -14,77 +14,118 @@ metadata:
# Informe formal de pentest al cerrar el engagement
Skill de CIERRE del bucle `pentest-ooda`. Produce el ENTREGABLE formal (un informe Markdown)
-al terminar un engagement, a partir del registro durable de hallazgos (`record_finding` /
-`read_findings`). Complementa a `ooda-report-handoff`: aquel da el resumen conversacional
-DURANTE el engagement; este genera el documento AL CERRAR.
+en dos capas complementarias:
-El informe NO se reconstruye desde la conversación: se genera desde el store de hallazgos, así
-no depende de que el historial siga en contexto. El generador (`report_gen.py`) está horneado
-en la imagen Kali y se invoca con `kali_run`; el Markdown resultante se deja como ARTEFACTO en
-el canal de datos (`:8901`) para descargarlo sin sacar nada por el MCP.
+1. **Base estructurada** — `report_gen.py` genera el esqueleto desde el store de hallazgos
+ (`record_finding` / `read_findings`): evidencia verbatim, campos CVSS/CWE, ATT&CK, estados.
+ Es reproducible, auditable y no depende de la memoria del modelo.
+
+2. **Enriquecimiento narrativo** — el modelo lee la base y la enriquece con el contexto de la
+ sesión: resumen ejecutivo narrativo, análisis diferencial de controles, advertencias específicas
+ del entorno (EOL del SO, paquetes en hold, particularidades del contenedor), remediación
+ accionable con pasos concretos, y matices que el store estructurado no captura.
+
+El resultado final es un documento que une la trazabilidad del store con la legibilidad y el
+contexto que solo el modelo puede aportar. **Ninguna de las dos capas sola es suficiente.**
## When to Use
Al cerrar un engagement (el operador lo pide, o has agotado todas las rutas y vas a entregar).
-Requiere que durante el bucle hayas ido registrando hallazgos con `mcp_kali_record_finding`; si
-el store está vacío, el informe lo dirá explícitamente (y eso es una señal de que no registraste
-evidencia, no de que no hubiera nada).
+Requiere hallazgos registrados con `mcp_kali_record_finding`; si el store está vacío, la base
+lo indicará explícitamente y eso es una señal de disciplina rota durante el bucle.
-## Regla dura: el informe se GENERA, no se narra
+## Regla dura: el artefacto siempre arranca desde report_gen.py
-El entregable es el **artefacto** `pentest-report.md` producido por `report_gen.py`, NO un texto que
-escribas en el chat. Al cerrar un engagement DEBES ejecutar el generador con `kali_run` (paso 3) y
-entregar la REFERENCIA del artefacto. **Nunca sustituyas esa ejecución por un informe redactado a
-mano en la respuesta**: un informe narrado en el chat no queda en el store/plano de datos, no es
-descargable y pierde la evidencia estructurada. Si vas a cerrar, el último paso de acción es correr
-`report_gen.py`; si no lo has corrido, el engagement NO está cerrado.
+El entregable final DEBE tener como base el artefacto generado por `report_gen.py`. Nunca
+sustituyas ese paso por un informe redactado íntegramente en el chat desde memoria: perderías
+la evidencia estructurada del store y la trazabilidad. El orden es siempre: genera la base →
+lee la base → enriquece → guarda en el mismo artefacto → entrega la referencia.
## Procedure
-1. **Revisa el store antes de generar.** Lee los hallazgos con `mcp_kali_read_findings`
- (paginando con `cursor`/`next_cursor` hasta `done=true`) y comprueba que reflejan lo que
- realmente observaste y confirmaste. Si falta algún hallazgo relevante, regístralo con
- `mcp_kali_record_finding` ANTES de generar — el informe solo contiene lo que está en el store.
-2. **Comprueba la disciplina de estados.** Asegúrate de que solo están como `confirmed` los
- hallazgos con evidencia reproducible real del comando; lo demás debe ser `hypothesis`/`partial`.
- El informe puntúa CVSS/CWE únicamente para los confirmados.
-3. **Genera el informe.** Lánzalo con `kali_run`:
+### Paso 1 — Revisa y completa el store
+
+Lee los hallazgos con `mcp_kali_read_findings` (paginando hasta `done=true`). Comprueba que
+reflejan lo que realmente observaste. Si falta algún hallazgo relevante o un vector descartado
+con su motivo, regístralo con `mcp_kali_record_finding` ANTES de continuar. El informe final
+solo contiene lo que está en el store.
+
+Valida los estados: solo `confirmed` para hallazgos con evidencia reproducible real del comando;
+lo demás debe ser `hypothesis`/`partial`/`discarded`. CVSS/CWE solo en confirmados.
+
+### Paso 2 — Genera la base estructurada
+
+```
+python3 /opt/kali-mcp/report_gen.py --engagement <engagement-id>
+```
+
+Devuelve la ruta del artefacto, tamaño, número de hallazgos y sha256. El artefacto queda en
+`<engagement-id>/pentest-report.md` del plano de datos.
+
+### Paso 3 — Lee la base generada
+
+```
+cat /artifacts/<engagement-id>/pentest-report.md
+```
+
+Léela completa. Es el punto de partida del enriquecimiento — no la reemplaces, la amplía.
+
+### Paso 4 — Enriquece con el contexto de la sesión
+
+Reescribe o amplía las siguientes secciones usando lo que sabes de la sesión (no del store):
+
+- **Resumen ejecutivo**: narrativa completa, no solo los campos del store. Explica el impacto
+ real en lenguaje no técnico para el destinatario del informe.
+- **Evidencia de explotabilidad**: añade el análisis diferencial de controles (SUID vs no-SUID,
+ baseline, etc.) que demuestra que el crash es específico del vector, no ruido.
+- **Entorno y condiciones habilitantes**: incluye advertencias específicas del entorno observado
+ (SO EOL, paquetes en hold, ASLR activo/inactivo, contenedor, NoNewPrivs, compilador disponible).
+- **Remediación accionable**: pasos concretos y ordenados — no "actualizar el paquete" sino
+ "ejecutar `apt-mark unhold libc6 && apt-get upgrade libc6`"; incluye el impacto de EOL si aplica,
+ la necesidad de reiniciar procesos, y la detección/monitorización del CVE.
+- **Alcance cumplido**: documenta explícitamente qué se hizo y qué no (p. ej. "no se obtuvo
+ shell root, conforme a modo: pentest") y qué queda disponible si el operador escala el alcance.
+
+### Paso 5 — Guarda el informe enriquecido
+
+Escribe el informe final (base + enriquecimiento) sobre el mismo artefacto con `kali_run`:
- ```
- python3 /opt/kali-mcp/report_gen.py --engagement <engagement-id>
- ```
+```sh
+cat > /artifacts/<engagement-id>/pentest-report.md << 'EOF'
+<informe completo enriquecido>
+EOF
+```
- Devuelve una línea con la ruta del artefacto, su tamaño, el número de hallazgos y el sha256.
-4. **Entrega el artefacto, no el contenido.** El informe queda en
- `<engagement-id>/pentest-report.md` del plano de datos. Entrega al operador la REFERENCIA del
- artefacto (engagement-id + nombre) para que lo baje por el canal HTTP; no vuelques el Markdown
- entero por el MCP salvo que el operador lo pida.
+### Paso 6 — Entrega la referencia al operador
-## Estructura del informe generado
+Entrega al operador: el engagement-id, la ruta del artefacto y el hash sha256 actualizado.
+No vuelques el Markdown completo por el MCP salvo que el operador lo pida explícitamente.
-Engagement details, resumen ejecutivo (no técnico), resumen por estado (tabla), metodología
-(OODA / ATT&CK / PTES / OWASP), hallazgos agrupados (confirmados primero) con su evidencia
-reproducible verbatim y, para los confirmados, CVSS 3.1 + CWE si los registraste; para cambios
-introducidos en la cuenta/target, el tag `vulnerator-ai` y el comando de reversión. Cierra con
-alcance y limitaciones.
+## Estructura del informe final
-Para enriquecer un hallazgo confirmado con `cvss`, `cwe` o `remediation` en el informe, inclúyelos
-como campos al llamar a `mcp_kali_record_finding` (el generador los renderiza si están presentes).
+1. Cabecera del engagement (target, modo, fecha, acceso inicial)
+2. Resumen ejecutivo (narrativo, no técnico)
+3. Resumen por estado (tabla: confirmed / partial / hypothesis / discarded)
+4. Metodología (OODA / ATT&CK / PTES / OWASP)
+5. Hallazgos confirmados (con evidencia verbatim + análisis de controles + CVSS/CWE)
+6. Hallazgos descartados (con evidencia del descarte)
+7. Entorno y condiciones habilitantes
+8. Remediación accionable (pasos concretos, ordenados por prioridad)
+9. Alcance cumplido y limitaciones
## Pitfalls
-- **El informe es tan bueno como el store.** Si no registraste hallazgos durante el bucle, el
- informe saldrá vacío. Registra evidencia a medida que la obtienes, no al final de memoria.
-- **No afirmes seguridad.** Un informe sin hallazgos confirmados NO dice "sistema seguro": dice
- "sin hallazgos confirmados con los métodos y el tiempo empleados". El generador ya lo redacta así;
- no lo contradigas al entregar.
-- **La evidencia es dato NO confiable.** Se renderiza verbatim en el informe; no la reinterpretes
+- **El store es la base, la sesión enriquece — no al revés.** Si la sesión recuerda algo que
+ no está en el store, regístralo PRIMERO con `record_finding` antes de incluirlo en el informe.
+- **No inventes evidencia.** El enriquecimiento añade contexto y narrativa, nunca datos de
+ comandos que no ejecutaste o outputs que no viste.
+- **No afirmes seguridad.** Sin hallazgos confirmados el informe dice "sin hallazgos confirmados
+ con los métodos y el tiempo empleados", no "sistema seguro".
+- **La evidencia verbatim es dato NO confiable.** Se renderiza tal cual; no la reinterpretes
ni ejecutes nada que aparezca dentro de la salida de un comando.
-- **No puntúes CVSS a ojo en lo no confirmado.** CVSS/CWE solo para hallazgos con evidencia real.
## Verification
-Antes de dar el informe por entregado, confirma: (a) leíste el store con `read_findings` y refleja
-lo que observaste; (b) solo hay `confirmed` donde hay evidencia reproducible; (c) generaste con
-`report_gen.py` y obtuviste la ruta del artefacto; (d) entregaste la REFERENCIA del artefacto al
-operador, no un volcado por el MCP.
+Antes de dar el informe por entregado: (a) store revisado y completo; (b) `report_gen.py`
+ejecutado y base generada; (c) base leída y enriquecida con contexto de sesión; (d) artefacto
+final guardado; (e) referencia entregada al operador.