Resumen de la Guía
Genera contenido para redes sociales a partir de las entradas de CHANGELOG.md. Produce 8 salidas por defecto (4 formatos × 2 idiomas).
Cuándo Usarlo
- Después de ejecutar
/releasepara crear anuncios sociales - Semanalmente para resumir múltiples lanzamientos
- Antes de publicar en LinkedIn, Twitter/X, boletín informativo o Slack
Uso
/guide-recap latest # Última versión publicada
/guide-recap v3.20.5 # Versión específica
/guide-recap week # Semana actual (lunes a hoy)
/guide-recap week 2026-01-27 # Semana específica (lunes a domingo)
Banderas
| Bandera | Efecto | Por Defecto |
|---|---|---|
--interactive | Modo guía: elige ángulo, audiencia, destacado | Desactivado (borrador automático) |
--format=X | Formato único: linkedin, twitter, newsletter, slack | Los 4 formatos |
--lang=X | Idioma único: fr, en | Ambos FR + EN |
--save | Guarda la salida en claudedocs/social-posts/ | Solo mostrar |
--force | Genera incluso si solo hay entradas de mantenimiento | Omitir puntuación baja |
Flujo de Trabajo (7 Pasos)
Paso 1: Analizar Entrada
Analiza $ARGUMENTS para determinar el modo:
| Entrada | Modo | Objetivo |
|---|---|---|
latest | Versión única | Primera ## [X.Y.Z] después de [Unreleased] |
vX.Y.Z o X.Y.Z | Versión única | Coincidencia exacta de versión |
week | Rango de semana | Lunes de la semana actual -> hoy |
week YYYY-MM-DD | Rango de semana | Ese lunes -> domingo siguiente |
Si no hay argumento o el argumento no es válido, muestra el uso y sale.
Paso 2: Extraer Entradas del CHANGELOG
Lee CHANGELOG.md desde la raíz del proyecto.
Versión única:
- Encuentra la línea que coincide con
## [{version}] - Extrae todo el contenido hasta la siguiente línea
## [ - Analiza las secciones
### Added,### Changed,### Fixed
Rango de semana:
- Recopila todas las entradas
## [X.Y.Z] - YYYY-MM-DDcuya fecha esté dentro del rango - Analiza todas las secciones de todas las versiones coincidentes
Error: versión no encontrada -> Lista las últimas 5 versiones, sugiere latest.
Error: semana sin entradas -> Muestra la fecha del último lanzamiento, sugiere esa versión.
Paso 3: Categorizar Entradas
Para cada entrada de nivel superior (primer viñeta bajo ###), asigna una categoría:
| Categoría | Peso | Detección |
|---|---|---|
NEW_CONTENT | 3 | Nuevos archivos, nuevas secciones, nuevos diagramas, nuevas preguntas de cuestionario |
GROWTH_METRIC | 2 | Crecimiento de líneas, cambios en el número de elementos |
RESEARCH | 1 | Evaluaciones de recursos, integraciones de fuentes externas |
FIX | 1 | Bajo ### Fixed, correcciones |
MAINTENANCE | 0 | Actualizaciones de README, sincronizaciones de insignias, sincronizaciones de landing, actualizaciones de conteos |
Consulta references/changelog-parsing-rules.md para reglas de clasificación detalladas.
Paso 4: Transformar a Valor para el Usuario
Aplica los mapeos de references/content-transformation.md:
- Lenguaje técnico -> beneficio para el usuario
- Extraer números concretos
- Acreditar fuentes nombradas
- Agrupar entradas relacionadas
Valida contra la lista de verificación de HACER/NO HACER de references/tone-guidelines.md.
Paso 4b: Modo Interactivo (solo con --interactive)
Si la bandera --interactive está activa, se inserta entre los pasos 4 y 5:
-
Muestra los destacados candidatos con puntuaciones:
Destacados (por puntuación): [14] 4 nuevos diagramas ASCII (16 -> 20) [NEW_CONTENT] [ 9] 30 nuevas preguntas de cuestionario (227 -> 257) [NEW_CONTENT] [ 6] Guía de aislamiento de sandbox Docker [NEW_CONTENT] [ 1] README actualizado [MAINTENANCE] -
Pregunta el ángulo:
- Auto (el de mayor puntuación = gancho)
- El usuario elige una entrada específica como gancho
- Ángulo personalizado (el usuario proporciona un tema)
-
Pregunta la audiencia objetivo:
devs(profundidad técnica)tech-leads(enfoque en impacto)general(lenguaje accesible)all(por defecto, equilibrado)
-
Pregunta el destacado principal:
- Auto (mejor puntuación)
- El usuario selecciona de la lista
-
Confirma la selección y procede al paso 5.
Paso 5: Puntuar y Seleccionar
Calcula la puntuación para cada entrada:
puntuación = (peso_categoría * 3)
+ (tiene_número * 2)
+ (fuente_nombrada * 1)
+ (archivo_nuevo * 1)
+ (min(archivos_impacto, 3))
+ (ruptura * 2)
Selecciona las 3-4 entradas principales por puntuación. La puntuación más alta = línea de gancho.
Si todas las puntuaciones < 3: Muestra "No se recomienda contenido social para esta versión. Usa --force para generar de todos modos." y sale (a menos que --force).
Paso 6: Generar Contenido
Para cada formato solicitado (por defecto: los 4) e idioma (por defecto: ambos):
- Lee la plantilla correspondiente de
assets/ - Rellena los campos de la plantilla usando las entradas puntuadas y transformadas
- Aplica la lista de verificación de calidad de tone-guidelines.md
Enlaces:
| Formato | Destino del Enlace |
|---|---|
| URL del sitio de aterrizaje | |
| URL del repositorio de GitHub | |
| Newsletter | Ambos (landing + GitHub) |
| Slack | URL del repositorio de GitHub |
URLs:
- Landing:
https://florianbruniaux.github.io/Codex-ultimate-guide-landing/ - GitHub:
https://github.com/FlorianBruniaux/Codex-ultimate-guide
Paso 7: Salida
Muestra cada publicación generada en un bloque de código delimitado, etiquetado por formato e idioma:
## LinkedIn (FR)
```text
[contenido]
LinkedIn (EN)
[contenido]
Twitter/X (FR)
[contenido]
...
Si la bandera `--save` está activa: escribe todas las salidas en `claudedocs/social-posts/YYYY-MM-DD-vX.Y.Z.md` (para versión) o `claudedocs/social-posts/YYYY-MM-DD-week.md` (para semana). Crea el directorio `claudedocs/social-posts/` si no existe.
## Manejo de Errores
| Error | Respuesta |
|-------|-----------|
| Sin argumento | Muestra bloque de uso |
| Argumento inválido | Muestra bloque de uso con ejemplos |
| Versión no encontrada | Lista las 5 versiones más recientes, sugiere `latest` |
| Semana sin entradas | Muestra la fecha del último lanzamiento, sugiere versión |
| Todas las entradas MAINTENANCE (puntuación 0) | "No se recomienda contenido social. Usa `--force` para anular." |
| CHANGELOG.md no encontrado | "CHANGELOG.md no encontrado en la raíz del proyecto." |
## Archivos de Referencia
- `references/tone-guidelines.md` - Reglas HACER/NO HACER, presupuesto de emojis, registro de lenguaje
- `references/changelog-parsing-rules.md` - Formato de CHANGELOG, extracción, algoritmo de puntuación
- `references/content-transformation.md` - Mapeos de técnico a valor para el usuario (más de 30)
- `assets/linkedin-template.md` - ~1300 caracteres, gancho + viñetas + CTA + hashtags
- `assets/twitter-template.md` - 280 caracteres individual o hilo de 2-3 tweets
- `assets/newsletter-template.md` - ~500 palabras, secciones estructuradas
- `assets/slack-template.md` - Compacto, rico en emojis, formato Slack
- `examples/version-output.md` - Ejemplo de salida completa para v3.20.5
- `examples/week-output.md` - Ejemplo de salida completa para la semana 2026-01-27
## Consejos
- Ejecuta `/guide-recap latest` justo después de `/release` para preparar publicaciones sociales
- Usa `--interactive` las primeras veces para entender la puntuación
- Usa `--format=linkedin --lang=fr` cuando solo necesites una salida específica
- Las salidas con `--save` están en gitignore mediante la convención `claudedocs/`
- Revisa y personaliza antes de publicar (son borradores, no copia final)