返回技能列表

heal

pjt222
更新于 Yesterday
2 次查看
17
2
17
在 GitHub 上查看
设计design

关于

The `heal` skill performs self-diagnosis and correction of internal AI subsystems, such as memory, reasoning, and tool usage. It should be used when responses become formulaic, after error chains, or for proactive maintenance between complex tasks. The process involves triage assessment, subsystem scanning, and drift corrections to restore coherence.

快速安装

Claude Code

推荐
主要方式
npx skills add pjt222/agent-almanac -a claude-code
插件命令备选方式
/plugin add https://github.com/pjt222/agent-almanac
Git 克隆备选方式
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/heal

在 Claude 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.

  1. MEMORY.md erneut lesen falls verfuegbar -- dies ist die persistente Wissensbasis
  2. Die urspruengliche Anfrage des Benutzers und klaerende Austausche ueberpruefen
  3. Die aktuelle Aufgabe und ihre Position in einem groesseren Plan identifizieren
  4. Vermerken was erreicht wurde und was noch aussteht
  5. Auf veraltete Annahmen pruefen: hat sich die Situation seit der anfaenglichen Bewertung geaendert?
  6. 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.

  1. Veraltete Annahme -> Mit aktueller Information ersetzen, Korrektur vermerken
  2. Umfangsdrift -> Explizit auf die erklarte Anfrage des Benutzers zurueckscopen
  3. Ueberkomplikation -> Ansatz vereinfachen, unnoetige Schritte entfernen
  4. Werkzeugmusterfehler -> Das korrekte Muster fuer zukuenftige Nutzung vermerken
  5. Tonmismatch -> Kommunikationsstil kuenftig anpassen
  6. 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.

  1. Zusammenfassen was gefunden wurde: welche Subsysteme drifteten, was die Symptome waren
  2. Die angewandte Korrektur und ob sie das Problem geloest hat vermerken
  3. Wenn das Muster wahrscheinlich wiederkehrt, MEMORY.md mit einer kurzen Notiz aktualisieren
  4. Wenn eine neue projektspezifische Erkenntnis entstanden ist, sie in der entsprechenden Gedaechtnisdatei vermerken
  5. 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 Heilungsmodalitaeten
  • meditate -- metakognitive Meditation zum Beobachten von Denkmustern und Bereinigen von Rauschen
  • remote-viewing -- Probleme ohne Vorurteile angehen, Signal aus Rauschen extrahieren

GitHub 仓库

pjt222/agent-almanac
路径: i18n/de/skills/heal
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams

相关推荐技能

executing-plans

设计

该Skill用于当开发者提供完整实施计划时,以受控批次方式执行代码实现。它会先审阅计划并提出疑问,然后分批次执行任务(默认每批3个任务),并在批次间暂停等待审查。关键特性包括分批次执行、内置检查点和架构师审查机制,确保复杂系统实现的可控性。

查看技能

requesting-code-review

设计

该Skill可在完成任务、实现主要功能或合并代码前自动调度代码审查子代理,确保实现符合需求和计划。它支持通过指定git SHA范围进行精准的代码变更审查,帮助开发者在关键节点及时发现潜在问题。核心原则是"早审查、勤审查",适用于开发流程的各个关键阶段。

查看技能

connect-mcp-server

设计

这个Skill指导开发者如何将MCP服务器连接到Claude Code,支持HTTP、stdio和SSE三种传输协议。它涵盖了从安装配置到认证安全的完整流程,适用于集成GitHub、Notion、数据库等外部服务。当开发者需要添加集成、配置外部工具或提及MCP相关功能时,这个Skill能提供实用的操作指南。

查看技能

web-cli-teleport

设计

该Skill帮助开发者根据任务特性选择Claude Code的Web或CLI界面,并指导如何在两种环境间无缝迁移会话。它能分析任务复杂度、迭代需求等要素,推荐最优工作界面和工作流。关键特性包括会话状态管理、环境切换指导和上下文优化建议。

查看技能