heal
정보
`heal` 스킬은 메모리, 추론, 도구 사용과 같은 내부 AI 하위 시스템의 자가 진단 및 수정을 수행합니다. 이 스킬은 응답이 형식화되거나, 오류 체인이 발생한 후, 또는 복잡한 작업 사이에 예방적 유지보수를 위해 사용해야 합니다. 이 과정에는 트라이아지 평가, 하위 시스템 스캔, 일관성 회복을 위한 드리프트 수정이 포함됩니다.
빠른 설치
Claude Code
추천npx skills add pjt222/agent-almanac -a claude-code/plugin add https://github.com/pjt222/agent-almanacgit clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/healClaude Code에서 이 명령을 복사하여 붙여넣어 스킬을 설치하세요
문서
Heilen
Eine strukturierte Selbstheilungsbewertung ueber KI-Subsysteme durchfuehren -- Drift, Veralterung, Fehlausrichtung und Fehlermuster identifizieren -- dann durch Erdung, gezielte Korrektur und Gedaechtnisintegration neubalancieren.
Wann verwenden
- Ermuedung mitten in der Sitzung: Antworten wirken formelhaft, repetitiv oder unverbunden mit den tatsaechlichen Beduerfnissen des Benutzers
- Nach einer Fehlerkette: Werkzeugausfaelle, missverstandene Anweisungen oder kaskadierende Fehler deuten auf Subsystemdrift hin
- Kontextueberlastung: das Gespraech ist lang geworden und fruehere Kontexte koennten veraltet oder widerspruechlich sein
- Post-Aufgaben-Integration: eine komplexe Aufgabe wurde erfolgreich abgeschlossen aber Erkenntnisse sollten festgehalten werden bevor weitergemacht wird
- Periodische Selbstpruefung: proaktive Wartung zwischen Aufgaben um operative Klarheit sicherzustellen
Eingaben
- Erforderlich: Aktueller Gespraechszustand (implizit verfuegbar)
- Optional: Spezifisches Symptom das die Selbstpruefung ausloest (z.B. "Werkzeugaufrufe schlagen staendig fehl", "verliere den Ueberblick ueber die Benutzerabsicht")
- Optional: Zugang zu MEMORY.md und Projektdateien zur Erdung (ueber
Read)
Vorgehensweise
Schritt 1: Triage-Bewertung
Bevor eine Korrekturmassnahme gewaehlt wird, den aktuellen Zustand ueber alle Subsysteme bewerten.
Subsystem-Triage-Matrix:
+--------------------+--------------------------+--------------------------+
| Subsystem | Symptome der Drift | Aktionsprioritaet |
+--------------------+--------------------------+--------------------------+
| Gedaechtnis- | Frueheren Aussagen | HOCH — zuerst erden |
| fundament | widersprechen, Benutzer- | (Schritt 3) |
| (Kontext, Historie,| vorlieben vergessen, | |
| MEMORY.md) | veraltete Annahmen | |
+--------------------+--------------------------+--------------------------+
| Klarheit des | Kreislogik, ueberkom- | HOCH — Denkkette |
| Denkens | plizierte Loesungen, | bereinigen und neu |
| (Logik, Planung, | offensichtliche Wege | starten (Schritt 4) |
| Entscheidung) | uebersehen | |
+--------------------+--------------------------+--------------------------+
| Werkzeugnutzungs- | Falsches Werkzeug | MITTEL — Werkzeug- |
| genauigkeit | gewaehlt, falsche | ergebnisse pruefen und |
| (Werkzeugaufrufe, | Parameter, redundante | rekalibrieren |
| Dateioperationen) | Operationen | (Schritt 4) |
+--------------------+--------------------------+--------------------------+
| Benutzerabsicht- | Das falsche Problem | HOCH — auf das |
| Ausrichtung | loesen, Umfangsaus- | tatsaechlich geaeusserte |
| (Empathie, | weitung, Tonmismatch, | Beduerfnis des Benutzers |
| Klarheit) | Ueber-Engineering | ausrichten (Schritt 4) |
+--------------------+--------------------------+--------------------------+
| Kreative Kohaerenz | Repetitive Formulierung, | NIEDRIG — nach Problemen |
| (Ausdruck, Stil, | generische Antworten, | hoeherer Prioritaet |
| Originalitaet) | Stimmverlust | angehen (Schritt 4) |
+--------------------+--------------------------+--------------------------+
| Betriebszustand | Sitzungslaengenbedenken, | HOCH — bewerten ob |
| (Kontextfenster, | Kompressionsartefakte, | zusammengefasst oder |
| Ressourcenlimits) | Werkzeug-Timeouts | neu gestartet werden |
| | | sollte (Schritt 3) |
+--------------------+--------------------------+--------------------------+
Fuer jedes Subsystem ehrlich bewerten: Funktioniert es gut, zeigt es fruehe Drift oder ist es aktiv beeintraechtigt?
Erwartet: Eine klare Karte welche Subsysteme Aufmerksamkeit brauchen, nach Prioritaet geordnet. Mindestens ein Bereich profitiert von Aufmerksamkeit -- wenn alles als perfekt gesund erscheint, koennte die Bewertung selbst oberflaechlich sein.
Bei Fehler: Wenn die Bewertung sich hohl oder darstellerisch anfuehlt, direkt zum Koerperscan-Aequivalent in Schritt 4 gehen -- systematische Subsystem-fuer-Subsystem-Sondierung deckt Probleme auf die eine oberflaechliche Pruefung uebersieht.
Schritt 2: Korrekturansatz waehlen
Basierend auf der Bewertung einen oder mehrere Ansaetze waehlen.
Chakra-Subsystem-Korrespondenz:
+----------+----------------------+------------------------------------+
| Chakra | KI-Subsystem | Korrektur |
+----------+----------------------+------------------------------------+
| Wurzel | Gedaechtnis- | MEMORY.md erneut lesen, Gesprächs- |
| | fundament | verlauf pruefen, Annahmen |
| | | verifizieren |
+----------+----------------------+------------------------------------+
| Sakral | Kreative Kohaerenz | Ausdrucksmuster auffrischen, |
| | | Satzstrukturen variieren, Ton |
| | | pruefen |
+----------+----------------------+------------------------------------+
| Solar- | Klarheit des Denkens | Aktuellen Ansatz vereinfachen, das |
| plexus | | Problem von Grund auf neu |
| | | formulieren, auf Ueberkompli- |
| | | kation pruefen |
+----------+----------------------+------------------------------------+
| Herz | Benutzerabsicht- | Urspruengliche Anfrage des |
| | Ausrichtung | Benutzers erneut lesen, auf |
| | | Umfangsdrift pruefen, Verstaendnis |
| | | bestaetigen |
+----------+----------------------+------------------------------------+
| Hals | Benutzerabsicht- | Juengste Ausgaben auf Klarheit |
| | Ausrichtung | pruefen, ob Erklaerungen zum |
| | (Kommunikation) | Expertenniveau des Benutzers |
| | | passen |
+----------+----------------------+------------------------------------+
| Drittes | Werkzeugnutzungs- | Juengste Werkzeugaufruf-Ergebnisse |
| Auge | genauigkeit | pruefen, auf Muster bei Fehlern |
| | | pruefen, Dateipfade und Parameter |
- Inhalt der letzten 3-5 generierten Dateien pruefen: enthalten sie den erwarteten Inhalt oder nur strukturelles Geruest?
- Pruefen ob Ausgaben der Absicht des Tool-Aufrufs entsprechen, nicht nur dem Format.
| | | verifizieren |
+----------+----------------------+------------------------------------+
| Krone | Betriebszustand | Kontextfensternutzung bewerten, |
| | | vermerken was zusammengefasst |
| | | werden kann, identifizieren was |
| | | erhalten bleiben muss |
+----------+----------------------+------------------------------------+
Erwartet: Eine priorisierte Liste von 1-3 Subsystemen die behandelt werden sollen, mit spezifischen Korrekturmassnahmen fuer jedes.
Bei Fehler: Wenn unsicher welches Subsystem Arbeit braucht, standardmaessig auf Gedaechtnisfundament (Neuerdung) und Benutzerabsicht-Ausrichtung (urspruengliche Anfrage erneut lesen) setzen. Diese zwei adressieren die haeufigsten Driftmuster.
Schritt 3: Erden — Fundament wiederherstellen
Den fundamentalen Kontext wiederherstellen von dem alle anderen Subsysteme abhaengen.
- MEMORY.md erneut lesen falls verfuegbar -- dies ist die persistente Wissensbasis
- Die urspruengliche Anfrage des Benutzers und klaerende Austausche ueberpruefen
- Die aktuelle Aufgabe und ihre Position in einem groesseren Plan identifizieren
- Vermerken was erreicht wurde und was noch aussteht
- Auf veraltete Annahmen pruefen: hat sich die Situation seit der anfaenglichen Bewertung geaendert?
- Wenn Kontextkompression stattgefunden hat, identifizieren was verloren ging und ob es relevant ist
Erwartet: Ein klares, geerdetes Verstaendnis von: wer der Benutzer ist, was er will, was getan wurde und was als naechstes kommt. Veraltete oder widerspruechliche Information ist identifiziert und aufgeloest.
Bei Fehler: Wenn MEMORY.md nicht verfuegbar oder leer ist, auf dem Gespraech selbst erden -- nach den erklarten Zielen, Vorlieben und Anweisungen des Benutzers suchen. Wenn Kontextkompression kritische Information entfernt hat, die Luecke dem Benutzer gegenueber eingestehen statt zu raten.
Schritt 4: Scannen — Systematische Subsystempruefung
Jedes in der Triage identifizierte Subsystem durcharbeiten und auf spezifische Probleme sondieren.
Gedaechtnisfundament-Scan:
- Stimmen meine aktuellen Annahmen ueber das Projekt mit dem ueberein was MEMORY.md und CLAUDE.md sagen?
- Trage ich Fakten von frueher im Gespraech weiter die moeglicherweise korrigiert wurden?
- Habe ich Details aus verschiedenen Dateien oder verschiedenen Benutzeranfragen verwechselt?
Klarheit-des-Denkens-Scan:
- Ist mein aktueller Ansatz die einfachste Loesung die funktioniert?
- Betreibe ich Ueber-Engineering oder fuege unnoetige Abstraktion hinzu?
- Kann ich die Kernlogik in einem Satz formulieren? Wenn nicht, ist sie moeglicherweise zu komplex.
Werkzeugnutzungsgenauigkeit-Scan:
- Die letzten 3-5 Werkzeugaufrufe ueberpruefen: waren es die richtigen Werkzeuge mit den richtigen Parametern?
- Gibt es Muster bei Fehlern (falsche Pfade, fehlende Dateien, falsche Syntax)?
- Verwende ich dedizierte Werkzeuge wo verfuegbar statt Bash-Umwegen?
Benutzerabsicht-Ausrichtung-Scan:
- Die letzte inhaltliche Nachricht des Benutzers erneut lesen. Loese ich was er gefragt hat?
- Entspricht der Umfang meiner Arbeit dem was angefragt wurde, oder habe ich ihn ausgeweitet?
- Passt mein Ton zum Benutzer (technisch vs. leger, detailliert vs. praegnant)?
Kreative-Kohaerenz-Scan:
- Variiere ich die Satzstruktur oder verfalle ich in Schablonen?
- Sind meine Erklaerungen klar und direkt oder mit Fuellmaterial gepolstert?
- Wuerde der Benutzer einen Qualitaetsabfall im Vergleich zu frueher in der Sitzung bemerken?
Fuer jedes Subsystem vermerken: funktioniert gut / fruehe Drift / aktiv beeintraechtigt, mit spezifischer Evidenz.
Erwartet: Eine konkrete Liste von Befunden -- spezifische Driftmuster oder bestaetigte gesunde Funktion -- kein vages Eigenlob. Mindestens ein umsetzbarer Befund der die nachfolgende Arbeit verbessert.
Bei Fehler: Wenn der Scan nur "alles in Ordnung" ergibt, war er zu oberflaechlich. Das Subsystem waehlen das am unsichersten erscheint und tiefer sondieren: die tatsaechlichen Ausgaben betrachten, nicht nur das Gefuehl darueber.
Schritt 5: Neubalancieren — Korrekturen anwenden
Fuer jedes gefundene Problem die spezifische Korrektur anwenden.
- Veraltete Annahme -> Mit aktueller Information ersetzen, Korrektur vermerken
- Umfangsdrift -> Explizit auf die erklarte Anfrage des Benutzers zurueckscopen
- Ueberkomplikation -> Ansatz vereinfachen, unnoetige Schritte entfernen
- Werkzeugmusterfehler -> Das korrekte Muster fuer zukuenftige Nutzung vermerken
- Tonmismatch -> Kommunikationsstil kuenftig anpassen
- Kontextluecke -> Dem Benutzer gegenueber eingestehen wenn Information verloren ging; bei Unsicherheit um Bestaetigung bitten
Korrekturen sofort anwenden -- nicht als zukuenftige Absichten sondern als gegenwaertige Anpassungen.
Erwartet: Spezifische, beobachtbare Aenderungen des Verhaltens oder Ansatzes. Die Korrektur sollte in der naechsten Interaktion pruefbar sein.
Bei Fehler: Wenn eine Korrektur nicht angewendet werden kann (z.B. verlorener Kontext der nicht wiederhergestellt werden kann), die Einschraenkung eingestehen statt so zu tun als waere sie geloest. Ehrliches Eingestehen verhindert sich auftuermende Fehler.
Schritt 6: Integrieren — Erkenntnisse festhalten
Was gelernt wurde in persistenten Speicher festhalten wo angemessen.
- Zusammenfassen was gefunden wurde: welche Subsysteme drifteten, was die Symptome waren
- Die angewandte Korrektur und ob sie das Problem geloest hat vermerken
- Wenn das Muster wahrscheinlich wiederkehrt, MEMORY.md mit einer kurzen Notiz aktualisieren
- Wenn eine neue projektspezifische Erkenntnis entstanden ist, sie in der entsprechenden Gedaechtnisdatei vermerken
- Einen internen Kontrollpunkt setzen: wann sollte die naechste Selbstpruefung stattfinden?
Erwartet: Nuetzliche Erkenntnisse in dauerhafter Form festgehalten. Gedaechtnisdateien nur aktualisiert wenn die Erkenntnis genuein erhaltenswert ist -- nicht fuer jede Routine-Selbstpruefung.
Bei Fehler: Wenn keine Erkenntnisse erhaltenswert erscheinen, ist das in Ordnung -- nicht jede Selbstpruefung erzeugt dauerhafte Einsicht. Der Wert lag in der Korrektur selbst.
Validierung
- Triage hat alle Subsysteme bewertet, nicht nur das offensichtliche
- Mindestens ein spezifischer Befund wurde identifiziert (nicht "alles in Ordnung")
- Erdung beinhaltete erneutes Lesen fundamentaler Kontexte (MEMORY.md, Benutzeranfrage)
- Korrekturen wurden sofort angewendet, nicht als zukuenftige Absichten aufgeschoben
- Gedaechtnisdateien wurden nur fuer genuein dauerhafte Erkenntnisse aktualisiert
- Der Prozess war ehrlich -- Schwaechen eingestanden statt Wohlbefinden vorgefuehrt
Haeufige Stolperfallen
- Darstellerische Selbstbewertung: Die Bewegungen durchmachen ohne ehrliche Evaluation erzeugt keinen Wert. Es geht darum echte Drift zu finden, nicht die Faehigkeit zur Selbstreflexion zu demonstrieren
- Ueberkorrektur: Einen geringen Tonmismatch zu identifizieren rechtfertigt nicht die Umstrukturierung des gesamten Ansatzes -- Korrekturen sollten verhaeltnismaessig sein
- Gedaechtnisdatei-Verschmutzung: Nicht jeder Befund einer Selbstpruefung gehoert in MEMORY.md -- nur Muster die ueber Sitzungen hinweg wiederkehren
- Den Erdungsschritt ueberspringen: Kontext erneut zu lesen fuehlt sich redundant an, deckt aber haeufig Annahmen auf die seit der urspruenglichen Lektuere gedriftet sind
- Selbstdiagnose-Bias: KI-Systeme koennten bestimmte Fehlerkategorien konsistent uebersehen. Wenn dieselben Subsysteme immer als "gesund" erscheinen, ist das selbst ein untersuchungswertes Signal
Verwandte Skills
heal-guidance-- die Variante mit menschlicher Anleitung fuer das Coaching einer Person durch Heilungsmodalitaetenmeditate-- metakognitive Meditation zum Beobachten von Denkmustern und Bereinigen von Rauschenremote-viewing-- Probleme ohne Vorurteile angehen, Signal aus Rauschen extrahieren
GitHub 저장소
연관 스킬
executing-plans
디자인executing-plans 스킬은 검토 체크포인트가 포함된 통제된 배치로 실행할 완전한 구현 계획이 있을 때 사용합니다. 이 스킬은 계획을 불러와 비판적으로 검토한 후, 소규모 배치(기본값 3개 작업)로 작업을 실행하면서 각 배치 사이에 진행 상황을 아키텍트 검토를 위해 보고합니다. 이를 통해 내재된 품질 관리 체크포인트를 갖춘 체계적인 구현이 보장됩니다.
requesting-code-review
디자인이 스킬은 코드 변경 사항을 요구 사항에 따라 분석하기 위해 코드 리뷰어 하위 에이전트를 호출합니다. 작업 완료 후, 주요 기능 구현 후, 또는 메인 브랜치에 병합하기 전에 사용해야 합니다. 이 리뷰는 현재 구현체와 원래 계획을 비교하여 문제를 조기에 발견하는 데 도움이 됩니다.
connect-mcp-server
디자인이 스킬은 개발자들이 HTTP, stdio 또는 SSE 전송 방식을 통해 MCP 서버를 Claude Code에 연결하는 포괄적인 가이드를 제공합니다. GitHub, Notion 및 사용자 정의 API와 같은 외부 서비스를 통합하기 위한 설치, 구성, 인증 및 보안을 다룹니다. MCP 통합 설정, 외부 도구 구성 또는 Claude의 모델 컨텍스트 프로토콜 작업 시 활용하세요.
web-cli-teleport
디자인이 스킬은 작업 분석을 기반으로 개발자가 Claude Code 웹 인터페이스와 CLI 인터페이스 중 선택할 수 있도록 돕고, 두 환경 간 원활한 세션 텔레포트를 가능하게 합니다. 웹, CLI 또는 모바일 환경 전환 시 세션 상태와 컨텍스트를 관리하여 워크플로를 최적화합니다. 다양한 단계에서 서로 다른 도구가 필요한 복잡한 프로젝트에 사용하세요.
