Learning From Mistakes

Skriver upp en löst bugg som en en-fils lektion under docs/learning-from-mistakes/

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

Testad · Fungerar ★ 8.0/10

Learning From Mistakes — Skriver upp en löst bugg som en en-fils lektion under docs/learning-from-mistakes/

Vad den gör

Omvandlar en nyligen löst bugg till en kort lektionsfil på docs/learning-from-mistakes/<slug>.md med fyra fasta sektioner: Symptom, Root cause, Resolution, Lesson. Utlöses när en felsökningsjakt slutar i en icke-uppenbar orsak, när användaren var tvungen att peka ut svaret, eller när man ombeds att skriva upp en bugg så att den inte återlärs. Instruerar också agenten att skanna mappen innan den förklarar en svår bugg olösbar.

Testrapport

Klonade till en tillfällig HOME och kopierade katalogen till ~/.claude/skills — SKILL.md hamnade på den förväntade sökvägen; frontmatter tolkades via yaml.safe_load till exakt {name, description}; de två sökvägar som kroppen refererar till (docs/learning-from-mistakes/.gitkeep, NOTES.md) returnerar båda HTTP 200; grep efter curl|sh, base64 -d, api-nycklar och injektionsfraser hittade inget. Utdata-test: samma scenario båda gångerna — en tvåtimmars jakt där `new Date("2026-03-10")` tolkades som UTC midnatt och flyttade fakturadatum en dag tillbaka för amerikanska användare, med användaren som pekade på Date-konstruktorn. Baseline (262 ord, rubriker "What happened / Investigation / Fix / Prevention", 2 kodblock, ad-hoc filnamn) titulerade dokumentet efter symptomet och slutade i fix-specifika TODOs (lägg till en lint-regel, lägg till ett TZ-test); färdighetsartefakten (203 ord, fasta Symptom/Root cause/Resolution/Lesson, `docs/learning-from-mistakes/date-only-string-parses-as-utc-midnight.md`) titulerade den efter den överförbara orsaken, lade till en `**Date**: … · **Area**: …`-rad, krediterade användarens vägledning (0 vs 1 omnämnanden), och dess Lesson-sektion anger en igenkänningsheuristik som baseline aldrig producerade: "A timezone bug that only appears for some users is a parsing bug, not a transport bug." Verklig kostnad: färdighetens korthetsregel tog bort båda kodutdragen som baseline inkluderade.

Testad: 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.

Kommandon och exempelprompter

  • /learning-from-mistakesSkriver upp en löst bugg som en en-fils lektion under docs/learning-from-mistakes/

Skills triggas av vanliga förfrågningar — inga kommandon att memorera. Efter installationen aktiverar prompter som dessa skillen (på engelska):

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