Learning From Mistakes

Escribe un error resuelto como una lección de un solo archivo bajo docs/learning-from-mistakes/

Por syahiidkamil · syahiidkamil/Software-Engineer-AI-Agent-Atlas

Probado · Funciona ★ 8.0/10

Learning From Mistakes — Escribe un error resuelto como una lección de un solo archivo bajo docs/learning-from-mistakes/

Qué hace

Convierte un error recién resuelto en un archivo de lección corto en docs/learning-from-mistakes/<slug>.md con cuatro secciones fijas: Symptom, Root cause, Resolution, Lesson. Se activa cuando una búsqueda de depuración termina en una causa no obvia, cuando el usuario tuvo que señalar la respuesta, o cuando se le pide que documente un error para que no se vuelva a aprender. También instruye al agente a escanear la carpeta antes de declarar un error difícil como irresoluble.

Informe de la prueba

Clonado en un HOME temporal y copiado el directorio a ~/.claude/skills — SKILL.md aterrizó en la ruta esperada; el frontmatter se analizó a través de yaml.safe_load a exactamente {name, description}; las dos rutas que el cuerpo referencia (docs/learning-from-mistakes/.gitkeep, NOTES.md) devolvieron HTTP 200; grep para curl|sh, base64 -d, api keys y frases de inyección no encontró nada. Prueba de salida: el mismo escenario en ambos casos — una búsqueda de dos horas donde `new Date("2026-03-10")` se analizó como medianoche UTC y desplazó las fechas de las facturas un día hacia atrás para los usuarios de EE. UU., con el usuario señalando el constructor Date. La línea base (262 palabras, encabezados "What happened / Investigation / Fix / Prevention", 2 bloques de código, nombre de archivo ad-hoc) tituló el documento por el síntoma y terminó en TODOs específicos de la solución (agregar una regla de lint, agregar una prueba de TZ); el artefacto de la habilidad (203 palabras, Symptom/Root cause/Resolution/Lesson fijos, `docs/learning-from-mistakes/date-only-string-parses-as-utc-midnight.md`) lo tituló por la causa transferible, añadió una línea `**Date**: … · **Area**: …`, acreditó la guía del usuario (0 vs 1 menciones), y su sección Lesson establece una heurística de reconocimiento que la línea base nunca produjo: "A timezone bug that only appears for some users is a parsing bug, not a transport bug." Costo real: la regla de brevedad de la habilidad eliminó ambos fragmentos de código que la línea base incluía.

Probado el: 2026-07-31 · Claude Code 2.x (agent harness)

Instalación

git clone --depth 1 https://github.com/syahiidkamil/Software-Engineer-AI-Agent-Atlas.git /tmp/learning-from-mistakes-src
mkdir -p ~/.claude/skills
cp -R /tmp/learning-from-mistakes-src/.claude/skills/learning-from-mistakes ~/.claude/skills/learning-from-mistakes
# Single 1.9 KB SKILL.md, no scripts, no dependencies, no API keys.
# Part of the multi-skill ATLAS agent repo; the clone pulls the whole repo, only this dir is copied.
# The skill writes lessons to docs/learning-from-mistakes/<slug>.md relative to your project root.
# Its prose is written in the repo's persona ("ATLAS", "Boss" = the user) and cross-references
# that repo's NOTES.md entropy rule; harmless elsewhere, but expect those two words in output.

Comandos y prompts de ejemplo

  • /learning-from-mistakesEscribe un error resuelto como una lección de un solo archivo bajo docs/learning-from-mistakes/

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

  • Record what we learned from this bug
  • Save this debugging lesson for next time
  • Document the root cause of today's mistake