¿Qué hace Documento de logros a partir del historial de git?
Objetivo: convertir lo que realmente enviaste en un borrador que puedas editar, sin inventar impacto. Un documento de logros enumera el trabajo y los resultados; esta habilidad recopila el trabajo y marca cada resultado faltante como una brecha que debes llenar.
Paso 1: recopilar la evidencia
Pregunta por la ventana de tiempo (por defecto: los últimos 6 meses) y los repositorios. Luego, con la CLI de GitHub iniciada sesión:
gh search prs --author @me --merged --merged-at ">=AAAA-MM-DD" --json title,url,closedAt,repository --limit 200
Para código que no esté en GitHub, usa git log --author="<nombre o correo>" --since="AAAA-MM-DD" --no-merges --pretty="%h %ad %s" --date=short en cada repositorio. También pide al usuario que pegue cualquier cosa que git no pueda mostrar: incidentes gestionados, mentorías, revisiones realizadas, charlas, documentación, guardias, decisiones de diseño, palabras amables de colegas.
No leas repositorios privados que el usuario no haya nombrado. No adivines nombres, equipos ni números.
Paso 2: agrupar, aún no resumir
Agrupa los elementos en temas (por ejemplo: fiabilidad, nuevas funcionalidades, rendimiento, herramientas, mentoría, trabajo entre equipos). Enumera cada elemento bajo su tema con fecha y enlace. Fusiona duplicados (un PR de funcionalidad más sus correcciones posteriores).
Paso 3: redactar cada tema
Para cada tema escribe:
- Lo que hice: una o dos oraciones con verbos sencillos, usando solo lo que respaldan los títulos, los diffs y las notas del usuario.
- Resultado: solo si se proporcionó un número, cita o resultado. De lo contrario, escribe
[BRECHA: ¿qué cambió para los usuarios o el equipo? ¿alguna métrica antes/después?]. - Evidencia: enlaces.
- Señal de alcance (si está respaldada): lo lideré, lo hice solo, trabajé entre equipos, estuve de guardia, revisé a otros.
Paso 4: finalizar con brechas y preguntas
Termina con una lista de cada [BRECHA], ordenada por cuánto fortalecería el caso, y las tres preguntas cuyas respuestas agregarían más valor. Ofrece convertir la versión final en una autoevaluación, un esquema de paquete de promoción o viñetas de currículum.
Reglas
- Nunca inventes métricas, porcentajes, nombres de clientes, títulos ni alcance. Una brecha visible es mejor que un número inventado.
- No inflames: "contribuí a" sigue siendo "contribuí a". Haz que los verbos coincidan con la evidencia.
- Mantén honesto el crédito del usuario: si un PR fue un esfuerzo de equipo, indica qué parte fue suya.
- Mantén los detalles privados o confidenciales fuera a menos que el usuario indique que el documento es interno.
- Genera Markdown que el usuario pueda pegar en sus notas.