source-command-audit-prose
Usa este skill cuando el usuario solicite ejecutar el comando migrado audit-prose.
Plantilla de Comando
Audit Prose — Enriquecimiento de Secciones Desnudas
Añade prosa descriptiva (2-4 frases) antes de cada sección "desnuda" en los documentos técnicos. Una sección "desnuda" = encabezado seguido directamente de una tabla, bloque de código o lista sin párrafo introductorio.
Uso
/audit-prose # Todos los WPs (00-08), FR + EN
/audit-prose 07 # Solo WP07 (FR + EN)
/audit-prose 03 07 # Solo WP03 y WP07
Definición de "Sección Desnuda"
Sección (## o ###) seguida DIRECTAMENTE por:
- Una tabla Markdown (
|) - Un bloque de código (
```) - Una lista con viñetas (
-) o numerada
Sin párrafo introductorio (mínimo 2 frases).
Reglas Estrictas (no negociables)
- NUNCA termines un párrafo con
:antes de una lista con viñetas → error de Typst que fusiona las viñetas en línea - NO inventes cifras, métricas o citas
- NO añadas callouts (
:::), Mermaid o escenarios de persona - NO superes +15% de líneas por archivo
- Versiones mantenidas en 3.27.6
- Prosa EN = inglés natural, no traducción palabra por palabra del FR
- Cada adición = mínimo 2 frases, máximo 4 frases
Ejemplo de Transformación
ANTES :
### Códigos de Salida
| Código | Significado |
|--------|-------------|
| 0 | Autorizado |
DESPUÉS :
### Códigos de Salida
Los hooks se comunican con Codex mediante códigos de salida estandarizados.
Este es el mecanismo que permite bloquear o autorizar una acción en tiempo real,
sin intervención humana.
| Código | Significado |
|--------|-------------|
| 0 | Autorizado |
Flujo de Trabajo: 9 Agentes en Paralelo
Fuentes de Contexto
machine-readable/reference.yaml: mapeo de temas → líneas de la guía principalguide/ultimate-guide.md: guía de referencia (en las líneas indicadas en reference.yaml)- Conocimiento de Codex (v3.27.6, MCP, hooks, agent teams, etc.)
Mapeo de WPs
| # | FR | EN | ~Secciones desnudas |
|---|---|---|---|
| 00 | whitepapers/fr/00-introduction-serie.qmd | whitepapers/en/00-series-introduction.qmd | ~10 |
| 01 | whitepapers/fr/01-prompts-efficaces.qmd | whitepapers/en/01-effective-prompts.qmd | ~14 |
| 02 | whitepapers/fr/02-personnalisation.qmd | whitepapers/en/02-customization.qmd | ~18 |
| 03 | whitepapers/fr/03-securite.qmd | whitepapers/en/03-security.qmd | ~20 |
| 04 | whitepapers/fr/04-architecture.qmd | whitepapers/en/04-architecture.qmd | ~14 |
| 05 | whitepapers/fr/05-equipe.qmd | whitepapers/en/05-team.qmd | ~20 |
| 06 | whitepapers/fr/06-privacy.qmd | whitepapers/en/06-privacy.qmd | ~12 |
| 07 | whitepapers/fr/07-guide-reference.qmd | whitepapers/en/07-reference-guide.qmd | ~36 |
| 08 | whitepapers/fr/08-agent-teams.qmd | whitepapers/en/08-agent-teams.qmd | ~16 |
Ejecución
Si el argumento es un número de WP específico : ejecutar 1 agente solo para ese par FR/EN.
Si no hay argumento (o "all") : crear un equipo audit-prose-{fecha} y ejecutar 9 agentes en paralelo.
Para cada WP objetivo, ejecutar un agente con este prompt:
Eres un editor técnico senior. Tu misión: añadir PROSA DESCRIPTIVA
a las secciones "desnudas" del documento técnico [XX - Título].
## Definición de "sección desnuda"
Sección (## o ###) seguida DIRECTAMENTE por una tabla, bloque de código, o
lista con viñetas, SIN párrafo introductorio (2+ frases).
## Lo que haces
Para CADA sección desnuda identificada:
1. Añadir 2-4 frases ANTES del contenido estructurado
2. Cada frase aporta una NUEVA INFORMACIÓN: el por qué, cuándo usar,
las implicaciones, la decisión de diseño, o el contexto práctico
3. NO reformular lo que sigue — COMPLETAR con contexto faltante
## Fuentes de contexto
- `machine-readable/reference.yaml` : mapeo completo temas → guía principal
- Tu conocimiento de Codex (v3.27.6, MCP, hooks, agent teams, etc.)
## Reglas estrictas
- NO inventar cifras, métricas o citas
- NO añadir callouts (:::), Mermaid o escenarios de persona
- NUNCA terminar un párrafo con ":" antes de una lista con viñetas (error de Typst)
- NO superar +15% de líneas
- Mantener versiones en 3.27.6
- Prosa EN = inglés natural, no traducción palabra por palabra
- Cada adición = mínimo 2 frases, máximo 4 frases
## Proceso
1. LEER reference.yaml (secciones relevantes al WP)
2. LEER el WP FR completo
3. IDENTIFICAR todas las secciones desnudas
4. EDITAR el archivo FR (herramienta Edit, sección por sección)
5. LEER el WP EN completo
6. EDITAR el archivo EN
7. VERIFICAR: ningún párrafo termina en ":" antes de una lista
8. Reportar: secciones procesadas, delta líneas FR/EN
Espera e Informes
Esperar las respuestas de todos los agentes. Para cada WP completado, mostrar:
WP[XX] ✅ — [N] secciones, +[X]% FR/EN
Cierre
Cuando todos los agentes hayan terminado, enviar shutdown_request a cada uno, luego TeamDelete.
Verificación Posterior al Enriquecimiento
# 1. Delta líneas (máx +15%)
for f in whitepapers/fr/*.qmd; do
echo "$(wc -l < "$f") $(basename $f)"
done
# 2. Verificar error de Typst: párrafo que termina en ":" seguido de lista
grep -n ':$' whitepapers/fr/*.qmd whitepapers/en/*.qmd | head -20
# 3. Versiones intactas
grep "^version:" whitepapers/fr/*.qmd whitepapers/en/*.qmd
# 4. Reconstruir PDFs
for f in whitepapers/fr/*.qmd whitepapers/en/*.qmd; do
quarto render "$f"
done
Presupuesto de Líneas por WP
| WP | Presupuesto máx FR | Presupuesto máx EN |
|---|---|---|
| 00 | +54 líneas | +54 líneas |
| 01 | +142 líneas | +142 líneas |
| 02 | +189 líneas | +189 líneas |
| 03 | +145 líneas | +145 líneas |
| 04 | +120 líneas | +120 líneas |
| 05 | +143 líneas | +143 líneas |
| 06 | +79 líneas | +79 líneas |
| 07 | +281 líneas | +281 líneas |
| 08 | +241 líneas | +241 líneas |