Learning From Mistakes
Scrive un bug risolto come lezione in un singolo file sotto docs/learning-from-mistakes/
Promosso
Cosa fa
Trasforma un bug appena risolto in un breve file di lezione in docs/learning-from-mistakes/<slug>.md con quattro sezioni fisse: Symptom, Root cause, Resolution, Lesson. Si attiva quando una caccia al debug termina con una causa non ovvia, quando l'utente ha dovuto indicare la risposta, o quando viene chiesto di documentare un bug in modo che non venga riappreso. Istruisce anche l'agente a scansionare la cartella prima di dichiarare un bug difficile irrisolvibile.
Rapporto di test
Clonato in una HOME temporanea e copiata la directory in ~/.claude/skills — SKILL.md è stato posizionato nel percorso previsto; il frontmatter è stato analizzato tramite yaml.safe_load esattamente in {name, description}; i due percorsi a cui il corpo fa riferimento (docs/learning-from-mistakes/.gitkeep, NOTES.md) restituiscono entrambi HTTP 200; grep per curl|sh, base64 -d, chiavi API e frasi di injection non ha trovato nulla. Test di output: stesso scenario entrambe le volte — una caccia di due ore in cui `new Date("2026-03-10")` è stato analizzato come mezzanotte UTC e ha spostato le date delle fatture di un giorno indietro per gli utenti statunitensi, con l'utente che ha indicato il costruttore Date. La baseline (262 parole, intestazioni "What happened / Investigation / Fix / Prevention", 2 blocchi di codice, nome file ad-hoc) ha intitolato il documento in base al sintomo e si è conclusa con TODO specifici per la correzione (aggiungere una regola lint, aggiungere un test TZ); l'artefatto della skill (203 parole, Symptom/Root cause/Resolution/Lesson fissi, `docs/learning-from-mistakes/date-only-string-parses-as-utc-midnight.md`) lo ha intitolato in base alla causa trasferibile, ha aggiunto una riga `**Date**: … · **Area**: …`, ha accreditato la guida dell'utente (0 vs 1 menzioni), e la sua sezione Lesson afferma un'euristica di riconoscimento che la baseline non ha mai prodotto: "A timezone bug that only appears for some users is a parsing bug, not a transport bug." Costo reale: la regola di brevità della skill ha eliminato entrambi i snippet di codice inclusi nella baseline.
Testato il: 2026-07-31 · Claude Code 2.x (agent harness)
Installazione
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. Comandi e prompt di esempio
/learning-from-mistakesScrive un bug risolto come lezione in un singolo file sotto docs/learning-from-mistakes/
Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):
Record what we learned from this bugSave this debugging lesson for next timeDocument the root cause of today's mistake