Learning From Mistakes
Schreibt einen behobenen Fehler als Ein-Datei-Lektion unter docs/learning-from-mistakes/ auf
Getestet · Funktioniert
Was es kann
Wandelt einen gerade behobenen Fehler in eine kurze Lektionsdatei unter docs/learning-from-mistakes/<slug>.md mit vier festen Abschnitten um: Symptom, Root cause, Resolution, Lesson. Wird ausgelöst, wenn eine Debugging-Suche in einer nicht offensichtlichen Ursache endet, wenn der Benutzer die Antwort aufzeigen musste oder wenn er gebeten wird, einen Fehler aufzuschreiben, damit er nicht neu gelernt werden muss. Weist den Agenten auch an, den Ordner zu scannen, bevor ein schwerwiegender Fehler als unlösbar erklärt wird.
Testbericht
In ein temporäres HOME geklont und das Verzeichnis nach ~/.claude/skills kopiert – SKILL.md landete am erwarteten Pfad; Frontmatter wurde über yaml.safe_load exakt zu {name, description}; die beiden vom Body referenzierten Pfade (docs/learning-from-mistakes/.gitkeep, NOTES.md) gaben beide HTTP 200 zurück; grep nach curl|sh, base64 -d, api keys und Injektionsphrasen fand nichts. Ausgabe-Test: dasselbe Szenario beide Male – eine zweistündige Suche, bei der `new Date("2026-03-10")` als UTC-Mitternacht geparst wurde und Rechnungsdaten für US-Benutzer einen Tag zurück verschob, wobei der Benutzer auf den Date-Konstruktor zeigte. Baseline (262 Wörter, Überschriften "What happened / Investigation / Fix / Prevention", 2 Codeblöcke, Ad-hoc-Dateiname) betitelte das Dokument nach dem Symptom und endete mit fix-spezifischen TODOs (Lint-Regel hinzufügen, TZ-Test hinzufügen); das Skill-Artefakt (203 Wörter, feste Symptom/Root cause/Resolution/Lesson, `docs/learning-from-mistakes/date-only-string-parses-as-utc-midnight.md`) betitelte es nach der übertragbaren Ursache, fügte eine Zeile `**Date**: … · **Area**: …` hinzu, würdigte die Anleitung des Benutzers (0 vs. 1 Erwähnungen), und sein Lesson-Abschnitt nennt eine Erkennungsheuristik, die die Baseline nie produzierte: "A timezone bug that only appears for some users is a parsing bug, not a transport bug." Echte Kosten: Die Kürze-Regel des Skills ließ beide Code-Snippets weg, die die Baseline enthielt.
Getestet am: 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. Befehle & Beispiel-Prompts
/learning-from-mistakesSchreibt einen behobenen Fehler als Ein-Datei-Lektion unter docs/learning-from-mistakes/ auf
Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):
Record what we learned from this bugSave this debugging lesson for next timeDocument the root cause of today's mistake