Learning From Mistakes

Skriver en løst fejl op som en enkeltfils lektion under docs/learning-from-mistakes/

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

Testet · Virker ★ 8.0/10

Learning From Mistakes — Skriver en løst fejl op som en enkeltfils lektion under docs/learning-from-mistakes/

Hvad det gør

Omdanner en netop løst fejl til en kort lektionsfil på docs/learning-from-mistakes/<slug>.md med fire faste sektioner: Symptom, Root cause, Resolution, Lesson. Udløses, når en fejlfindingsjagt ender i en ikke-indlysende årsag, når brugeren måtte pege på svaret, eller når der anmodes om at skrive en fejl op, so it is not relearned. Instruerer også agenten i at scanne mappen, før en svær fejl erklæres uløselig.

Testrapport

Klonede til en midlertidig HOME og kopierede mappen til ~/.claude/skills — SKILL.md landede på den forventede sti; frontmatter parsed via yaml.safe_load til præcis {name, description}; de to stier, kroppen refererer til (docs/learning-from-mistakes/.gitkeep, NOTES.md), returnerer begge HTTP 200; grep efter curl|sh, base64 -d, api keys og injektionsfraser fandt intet. Outputtest: samme scenarie begge gange — en to-timers jagt, hvor `new Date("2026-03-10")` parsed som UTC midnat og flyttede fakturadatoer en dag tilbage for amerikanske brugere, med brugeren pegende på Date-konstruktøren. Baseline (262 ord, overskrifter "What happened / Investigation / Fix / Prevention", 2 kodeblokke, ad-hoc filnavn) navngav dokumentet efter symptomet og sluttede med fix-specifikke TODOs (add a lint rule, add a TZ test); færdighedsartefaktet (203 ord, faste Symptom/Root cause/Resolution/Lesson, `docs/learning-from-mistakes/date-only-string-parses-as-utc-midnight.md`) navngav det efter den overførbare årsag, tilføjede en `**Date**: … · **Area**: …` linje, krediterede brugerens vejledning (0 vs 1 omtaler), og dens Lesson-sektion angiver en genkendelsesheuristik, baselinen aldrig producerede: "A timezone bug that only appears for some users is a parsing bug, not a transport bug." Reel omkostning: færdighedens korthedsregel fjernede begge kodeuddrag, baselinen inkluderede.

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

Installation

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.

Kommandoer og eksempelprompter

  • /learning-from-mistakesSkriver en løst fejl op som en enkeltfils lektion under docs/learning-from-mistakes/

Skills udløses af almindelige forespørgsler — ingen kommandoer at huske. Efter installationen aktiverer prompter som disse skillen (på engelsk):

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