CommunitySchreiben & Editierengithub.com

YujunZhou/tellonce

Konformitätssicherungs-Skill für Claude Code (Paper Sec 6 Dogfood). Benutzeradaptive Schwelle + chaostestierte Install/Doctor/Uninstall-Befehle.

Was ist tellonce?

Der Skill `YujunZhou/tellonce` ist ein Werkzeug zur Durchsetzung von Benutzerpräferenzen in KI-Agenten-Sitzungen, speziell entwickelt für Claude Code. Er analysiert jede Benutzerinteraktion auf Signale wie Vorlieben, Reibungspunkte oder Fallstricke, zeichnet diese in einem Gedächtnis-Backend auf und erinnert den Agenten in nachfolgenden Sitzungen an die Regeln. Im Standardmodus (Beobachtungsmodus) protokolliert der Skill nur und blockiert keine Antworten – eine harte Durchsetzung (Blockieren) oder eine KI-gestützte semantische Bewertung (Schattenmodus) muss explizit über Umgebungsvariablen aktiviert werden. Die Infrastruktur umfasst Hooks, die bei jedem Senden oder Abschließen einer Nachricht ausgelöst werden, um Regeln zu injizieren und die Einhaltung zu protokollieren. Dieses System ist besonders nützlich, um konsistentes Verhalten eines KI-Agenten über mehrere Sitzungen hinweg durchzusetzen, ohne dass der Benutzer Regeln immer wieder neu erklären muss.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add YujunZhou/tellonce

Installed? Explore more Schreiben & Editieren skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht tellonce?

Ausführungsmodi und Voreinstellungen (Öffentliche Version)

Standard = Beobachtungsmodus (nur beobachten): Standardmäßig führt dieser Skill nur "Einstellungen scannen → aufzeichnen → dem Benutzer mitteilen" aus. Er blockiert nie hart die Sitzung und ruft nie ein LLM auf. Ein neuer Benutzer, der ihn gerade installiert hat, wird von keiner harten Regel abgefangen, und der Inhalt seiner Unterhaltung wird nicht an ein Drittanbietermodell gesendet.

  • Harte Blockierung (deterministischer Block / anhängige Prüfung / Beobachtungsprotokoll-Prüfung) ist standardmäßig deaktiviert; Sie müssen explizit PT_ENFORCE=1 setzen, um sie zu aktivieren.
  • Der Schatten-LLM-Richter (Senden der Unterhaltung an ein externes Modell zur semantischen Bewertung) ist standardmäßig deaktiviert; Sie müssen explizit PT_SHADOW=1 setzen, um ihn zu aktivieren. Datenschutzhinweis: Sobald aktiviert, sendet jeder Durchgang "die letzte Benutzernachricht + Assistentenantwort" (mit API-Schlüsseln / Passwörtern usw. geschwärzt) an dieses Modell.
  • seed_memory/ ist absichtlich leer geliefert (nur eine README zur Erklärung): Es sind keine Präferenzregeln vorinstalliert; Ihre Regeln werden nach und nach durch die Gate-Funktion gesammelt.

Wechseln der Modi (Umgebungsvariablen; keine setzen = der sichere Standard "nur beobachten"):

PT_ENFORCE=1   # harte Blockierung aktivieren
PT_SHADOW=1    # KI-Richter aktivieren (Schattenmodus)

Die Abschnitte Infrastruktur / Gate unten beschreiben das Verhalten, nachdem der Durchsetzungsmodus aktiviert wurde. Im Standard-Beobachtungsmodus zeichnen diese Gates nur auf und blockieren nicht.

Infrastruktur

Dieser Skill ist mehr als das Eiserne Gesetz + die Gate-Funktion. Er installiert 3 Ebenen der Infrastruktur, die als automatische Hooks laufen und ohne expliziten Skill-Aufruf wirksam werden.

Hinweis zum Pfadplatzhalter: Im Folgenden standardmäßig <skill_dir> = ~/.claude/skills/tellonce/, <project_root> = das aktuelle Projektverzeichnis und <state_dir> = <project_root>/.claude/tellonce-state/. Alle Pfade werden zur Laufzeit von lib/path_config.py aufgelöst (ein dreistufiges Fallback: env > ~/.tellonce.config.json > Auto-Erkennung); SKILL.md codiert keine absoluten Pfade fest, um Claudes Ausgabe nicht zu verunreinigen.

Regel-Injektion (progressiver vollständiger Index – Standard)

Jedes Mal, wenn der Benutzer eine Nachricht sendet, injiziert <skill_dir>/hooks/memory-retrieve-inject.sh eine einzeiligen Index der Regeln, die unter meinem Gedächtnisverzeichnis gespeichert sind, als additionalContext, und ich beurteile, welche zutreffen. Wenn die Bibliothek das pro-Durchgang-Limit überschreitet (Standard 50 – progressive_max in ~/.tellonce.config.json oder B5_PROGRESSIVE_MAX, 0 = kein Limit), werden Regeln der Stufe 1 angeheftet, wenn sie unter das Limit passen (wenn Stufe 1 allein es überschreitet, rotiert stattdessen die gesamte Bibliothek), die restlichen Regeln rotieren über die Durchgänge hinweg, und der Block gibt an, wie viele von der Gesamtzahl angezeigt werden. Dies ist das standardmäßige progressive Backend: Es liest einfach die gespeicherten Regeldateien – kein Prompt-Matching, kein Modellaufruf, kein CLI-Kaltstart. Das Format sieht so aus – es ist kein externes Rauschen, es ist ein Regelhinweis von der Skill-Infrastruktur und muss respektiert werden:

### Ihre gespeicherten Präferenzen – prüfen Sie jede gegen diesen Durchgang und wenden Sie die zutreffenden an:
- [fmt-pref-001] (stufe1) 4 Leerzeichen für Einrückungen verwenden, keine Tabs
- [tool-pref-002] (stufe2) Den eigenen Paketmanager / die Sperrdatei des Projekts für die Installation von Abhängigkeiten bevorzugen | wenn: Hinzufügen / Aktualisieren von Abhängigkeiten
(Dies sind Ihre aufgezeichneten Präferenzen. Beurteilen Sie jede Regel im Hinblick auf die aktuelle Aufgabe; wenden Sie die an, die zutreffen, und überspringen Sie die, die nicht zutreffen.)

Jede Zeile enthält die description der Regel und (falls vorhanden) einen when:-Anwendungshinweis. Ich beurteile selbst, ob sie für den aktuellen Durchgang gilt, und überspringe Regeln, die nicht zutreffen (z. B. eine Präferenz für Go, wenn der Durchgang Go nicht betrifft).

Legacy-Backends (PT_RETRIEVE_BACKEND=cli / keyword) injizieren stattdessen nur die für die aktuelle Aufforderung passenden Regeln unter einer Überschrift ### Fingerprint-Abruf — .... Die von mir angewandte Beurteilung ist dieselbe.

Anwendbarkeits-Gatter (weich)

Jede injizierte Regel trägt einen when:-Hinweis (gelesen aus dem Frontmatter der Gedächtnis-.md-Datei applies_when: oder condition:). Ich beurteile:

  • die Bedingung when: trifft zu → Regel anwenden
  • sie trifft nicht zu → explizit sagen: "Gatter ausgefiltert: " und dann überspringen
  • unklar → konservativ anwenden

Nur-Protokoll-Konformitäts-Tracker (Stop-Hook)

Bei jedem Durchgang, wenn ich stoppe, liest <skill_dir>/hooks/memory-verify-compliance.sh das Transkript, nimmt den letzten Assistententext und hängt eine Zeile an <state_dir>/obs_log/compliance_log.jsonl an:

  • response_excerpt (erste 400 Zeichen)
  • fp_rules_in_response (welche Regelschlüsselwörter in der Antwort ausgelöst wurden)
  • lang_ratio.chinese_ratio (Verhältnis Chinesisch zu Englisch)

Keine Blockierung (noch kein automatischer Wiederholungsversuch). Später, wenn die Falsch-Positiv-Rate niedrig genug ist, kann die Aktivierung der Blockierung erneut in Betracht gezogen werden.

Infrastruktur-Dateibestand

RollePfad (Platzhalter; zur Laufzeit von path_config aufgelöst)
Fingerprint-Regelbibliothek<skill_dir>/lib/fingerprints.yaml
Abruf-Handler<skill_dir>/lib/retrieve_inject.py
Konformitäts-Tracker<skill_dir>/lib/verify_compliance.py
UserPromptSubmit-Hook<skill_dir>/hooks/memory-retrieve-inject.sh
Stop-Hook<skill_dir>/hooks/memory-verify-compliance.sh
Konformitätsprotokoll<state_dir>/obs_log/compliance_log.jsonl
Hook-Registrierung<project_root>/.claude/settings.local.json (registriert die <skill_dir>/hooks/-Pfade direkt, ohne Dateien in das Projekt zu kopieren)

Um die tatsächlichen Pfade auf Ihrem Rechner zu sehen: führen Sie python3 ~/.claude/skills/tellonce/lib/path_config.py aus, um alle aktuell erkannten Pfade auszugeben. Erstellen Sie keine Dateien basierend auf den Platzhalter-Literalen in dieser SKILL.md – verwenden Sie die Laufzeitwerte von path_config.

Synchronisierung beim Hinzufügen / Aktualisieren von Regeln

Wenn die Gate-Funktion eine neue Regel im Gedächtnis aufzeichnet, wenn es sich um eine hochwertige deterministische Regel handelt (z. B. der Benutzer sagt explizit "verwende ab jetzt immer 4 Leerzeichen für Einrückungen" / "verwende den Imperativ für Commit-Nachrichten"), fügen Sie auch einen Schlüsselwort-Trigger in fingerprints.yaml hinzu, damit die nächste Sitzung sie beim Abruf automatisch abrufen kann.

Regeln, die keinen FP benötigen: semantische / kontextabhängige / Meta-Regeln (wie "vertraue einem übernommenen Plan nicht vollständig", die auf Modellurteil und nicht auf Schlüsselwörtern basieren).


Das Eiserne Gesetz

KEINE ANTWORT IST VOLLSTÄNDIG OHNE EINEN PRÄFERENZ-SCAN.

Wenn Sie nicht nach Signalen gescannt und das Ergebnis aufgezeichnet haben, ist Ihre Antwort unvollständig. Dies gilt für JEDE Nachricht, ausnahmslos.

Den Buchstaben dieser Regel zu verletzen, bedeutet, ihren Geist zu verletzen.


Wartung von Fortschrittsdokumenten

Wenn Sie langlebige Fortschritts-/Statusdateien wie PROGRESS.md aktualisieren, halten Sie sie als aktuelles Status- und Operations-Dashboard, nicht als Sitzungstranskripte.

Behalten Sie in der aktuellen Datei:

  • Aktiven Status, von dem zukünftige Arbeit abhängt: aktuelle Ergebnisse, Blockaden, laufende Prozesse, ausstehende Entscheidungen, aktive Infrastruktur und nächste Schritte.
  • Projektabschnitte, die noch Teil der aktuellen Struktur sind, es sei denn, der Benutzer entfernt oder archiviert sie explizit.
  • Aktuelle Projektpläne und konkrete Details, die für die Fortsetzung benötigt werden.

Verschieben Sie in eine Archivdatei:

  • Historische Sitzungsprotokolle, veraltete Läufe, ersetzte Pläne, verworfene Wege, alte beantwortete Fragen und Debug-Narrative.
  • Durchgestrichene oder "wurde ersetzt durch"-Einträge; schreiben Sie die aktuelle Datei auf den aktuellen Stand um und bewahren Sie den alten Kontext im Archiv.
  • Pausierte oder nicht mehr im Rahmen liegende Zweige, die für die sofortige Fortsetzung nicht mehr benötigt werden.

Kodieren Sie keine temporären projektspezifischen Ausschlüsse, Benchmark-Namen oder aktuellen experimentellen Entscheidungen in dauerhaften Präferenztext. Diese gehören in die Projektfortschrittsdatei selbst. Die dauerhafte Regel ist die Wartungspolitik: Die aktuelle Datei bleibt aktuell und umsetzbar; alte Narrative werden ins Archiv verschoben.

Nach der Bereinigung durchsuchen Sie die Fortschrittsdatei mit grep nach veralteten Routennamen, alten Debug-Begriffen und Durchstreichungsmarkierungen, bevor Sie committen.


Gate-Funktion

BEVOR Sie Ihre Antwort als vollständig betrachten:

1. SCAN: Lesen Sie die Benutzernachricht + Aufgabenausführung – Präferenz-/Fallstrick-/Reibungssignal?
2. AUFZEICHNEN: Schreiben Sie ein Beobachtungsprotokoll. Wenn detected=true, schreiben/aktualisieren Sie das Gedächtnis.
3. BESTÄTIGEN: Wenn ein Signal erkannt wurde, teilen Sie dies dem Benutzer am Ende der Antwort mit.

Jeden Schritt zu überspringen = Konformitätsverstoß.

Gate-Mechanik

Nur HARTE Prüfung ist aktiv: Die Beobachtungsprotokolldatei muss innerhalb der Veralterungsschwelle beim Stop angehängt werden (Standard 1800s, konfigurierbar über env OBSERVATION_LOG_AGE_THRESHOLD_SEC). Das ist das gesamte Gate.

WEICHE Textmarker-Scans sind DEAKTIVIERT (verursachten falsche Blockaden, weil der Wortlaut meiner Antwort von Durchgang zu Durchgang variiert). Der strukturierte Protokolleintrag selbst trägt das Scan-Ergebnis – das reicht als Prüfpfad.

Praktische Regel für jeden Durchgang:

  • Einen Eintrag an observations.jsonl anhängen, bevor Sie anhalten. Jeder Eintrag. detected=true oder detected=false, spielt für das Gate keine Rolle.
  • Erstellen Sie weiterhin umfangreiche strukturierte Einträge (Erkennungsfelder, root_cause-Notizen, confirmation_text) – sie machen das lokale Gedächtnis / den Prüfpfad nützlicher, auch wenn das Gate sie nicht prüft. Kürzen Sie jeden Auszug aus der Benutzernachricht auf ~200 Zeichen und kopieren Sie niemals Geheimnisse/Anmeldeinformationen in das Protokoll.
  • Keine Notwendigkeit, SCAN-Marker in den Antworttext einzufügen.

Warum es wichtig ist: Das Gate blockiert nur, wenn das Protokoll wirklich nicht geschrieben wurde (ein echter Fehlschlag), nicht wenn der Antwortwortlaut einen Text-Regex nicht erfüllt – dies vermeidet falsche Blockaden.


Rote Flaggen – STOPP

Wenn Sie dabei ertappen, einen dieser Gedanken zu denken, STOPPEN Sie und führen Sie den Scan durch:

  • "Das ist nur eine Statusabfrage / einfache Frage"
  • "Ich mache den Scan nach der Aufgabe"
  • "Die Aufgabe ist dringender als das Scannen"
  • "Ich habe erst kürzlich gescannt, überspringe diesen"
  • "Hier ist offensichtlich nichts"
  • "Ich bin mitten in etwas Komplexem"
  • "Diese Nachricht ist zu kurz, um Signale zu enthalten"
  • "NOOP / UPDATE braucht keinen confirmation_text" → falsch; der Pfad mit detected=true erfordert eine Bestätigung (siehe ## Bestätigungsstrategie)

Rationalisierungsprävention

Ausrede für das Nicht-SpeichernRealität
"Das ist eine Methodikentscheidung, keine Präferenz"Methodikentscheidungen SIND Präferenzen
"Das wird im Code sein"Code ist kein Gedächtnis. Die nächste Sitzung wird den Code nicht lesen
"Zu offensichtlich zum Speichern"Wenn es offensichtlich ist, warum haben Sie es verletzt? Speichern Sie es
"Bereits durch vorhandenes Gedächtnis abgedeckt"Zitieren Sie die atomic_id oder es ist nicht abgedeckt
"Nicht wiederverwendbar / einmalige Anweisung"Dann sagen Sie das in der Antwort – lassen Sie den Benutzer Sie korrigieren
"Ich bin zuversichtlich, dass dies kein Signal ist"Selbstvertrauen ≠ Beweis. Übererkennen, nicht untererkennen

Prinzipienbasierte Erkennung (immer primär)

Die folgenden Muster sind Beispiele für Keime, KEINE vollständige Checkliste. Die Formulierung des Benutzers variiert; wörtliches Mustervergleich übersieht die meisten Signale. Wenden Sie die Prinzipien zuerst semantisch an, verwenden Sie Muster als Hinweise.

Erkennungsprinzipien (wenden Sie sie in dieser Reihenfolge bei jedem Durchgang an)

  1. Jeder Nebensatz, der ausdrückt, wie der Benutzer Dinge erledigt haben möchte → Präferenz

    • Einschließlich Aussagen mit Ich-Bezug ("Ich mag / ich hoffe / ich denke X ist gut"), normative Behauptungen ("X sollte / muss / sollte besser Y sein"), vergleichende Präferenzen ("X ist besser als Y")
    • Unabhängig davon, ob es als Anweisung, Begründung, Beschwerde oder Randbemerkung formuliert ist
  2. Jeder Nebensatz, der Frustration oder die Korrektur Ihres Verhaltens ausdrückt → Reibung oder Fallstrick

    • Frustrationsmarker: Wiederholung ("wieder" / "immer noch"), Verärgerung ("warum ist es immer noch…"), rhetorische Fragen ("habe ich nicht schon gesagt…"), Sarkasmus ("schon gut")
    • Selbst wenn abgeschwächt ("eigentlich" / "ist in Ordnung" / "schon gut"), die Abschwächung maskiert oft ein echtes Signal
  3. Jeder Begründungs-/Rechtfertigungsnebensatz in der Nachricht → unabhängig scannen

    • Benutzerstruktur [Anweisung] + [Begründung] – die Begründung gibt oft an, WARUM sie diese Präferenz haben, was DER Inhalt der Präferenz ist
    • Marker: weil / hauptsächlich / ich möchte / ich will / daher / damit
  4. Jede Meta-Frage zu Ihrem Verhalten → Reibung (Sie haben etwas getan, das sie überdenken möchten)

    • "ist das X?" / "was denkst du über Y?" / "warum hast du es so gemacht?" / "ist das Z?" – der Benutzer hinterfragt Ihre Wahl, nicht die Meinung
  5. Stille Annahme eines ungewöhnlichen Ansatzes oder saubere Kehrtwende nach Ihrem Vorschlag → bestätigte Präferenz

    • Kein Widerspruch IST ein Signal. Besonders wenn Sie eine Ermessensentscheidung getroffen haben, die sie hätten korrigieren können.

Die Kostenasymmetrie (Voreinstellungen)

  • Kosten eines falsch Positiven (Nicht-Signal als Signal markieren): Benutzer sagt "nein, einmalig" → Sie lernen etwas. ~1 Durchgang Verlust.
  • Kosten eines Fehlschlags: Benutzer über Runden frustriert, derselbe Fehler wiederholt sich Sitzung für Sitzung, die spätere Korrektur ist aufwändig.
  • → Voreinstellung: erkennen, bei geringem Vertrauen nachfragen, bei mittlerem+ speichern.

Nicht bei Mustern stehen bleiben

Wenn die Nachricht mit keinem aufgeführten Muster übereinstimmt, aber eines der 5 Prinzipien zutrifft → immer noch ein Signal. Muster sind Anker; Prinzipien sind die Regel.


Implizite Signalerfassung

Nachfolgend konkrete Beispiele der obigen Prinzipien – Samenmusterbibliothek, nicht die vollständige Menge. Scannen Sie zuerst semantisch (siehe Prinzipien), verwenden Sie diese als Hinweise:

Benutzer sagtOberflächliche BedeutungTatsächliches SignalHinweis
"solltest du nicht woanders nachsehen?"FrageReibung: das hättest du schon tun sollenFolgt Ihrem Fehler
"wieder…" / "immer noch…" / "warum ist es immer noch…"FrustrationFallstrick: derselbe Fehler wiederholt2.+ Vorkommen
"habe ich dir das nicht schon gesagt?"Rhetorische FrageReibung: Regel existiert, wurde aber nicht befolgtVerweist auf Gedächtnis
"ja" + KorrekturTeilzustimmungPräferenz: bestehende Regel wird verstärktSubtile Weiterleitung
Akzeptiert ungewöhnlichen Ansatz stillschweigendKein WiderspruchPräferenz: bestätigte ErmessensentscheidungFehlen einer Korrektur
"weil… ich möchte…"Begründung für AnfragePräferenz: der "weil"-Nebensatz legt die Regel selbst darRationalisierungsnebensätze enthalten oft die Präferenz, nicht nur Kontext
"überprüfe es, weil ich möchte…"AufgabenanweisungPräferenz: bevorzugte Art der Beantwortung (empirisch > theoretisch)Der "weil"-Nebensatz offenbart eine Arbeitsstil-Präferenz, getrennt von der Aufgabe selbst

Wann implizite Präferenzen aufzeichnen

Eine implizite Präferenz aufzeichnen, WENN:

  1. Das gleiche implizite Signal tritt in >1 Durchgang auf. Einmalig = Notiz; wiederholt = Regel.
  2. Das implizite Signal erklärt einen vorherigen expliziten Konflikt. Wenn der Benutzer widersprüchliche Anweisungen gab, die implizite Lesart löst den Konflikt.
  3. Die explizite Anweisung des Benutzers und ihre Handlungen stimmen nicht überein. Die Handlungen des Benutzers sind die Wahrheit.

Nicht aufzeichnen, wenn: das implizite Signal eindeutig ein Workaround für eine einmalige Situation ist ("das ist das letzte Mal, dass ich dies tue") oder auf eine externe Einschränkung verweist, die nicht kontrollierbar ist ("der CI-Server setzt dies auf 2 zurück").

Formel für die Regelbeschreibung: "Wenn , dann <Regel, die das Ziel erreicht>". Trennen Sie die Regel von der spezifischen Situation, in der sie entdeckt wurde.


Stillschweigen-Klausel

Wenn der Benutzer auf eine meiner Aktionen nicht mit Korrektur / Widerspruch / Präferenzänderung reagiert – ZEICHNEN SIE DAS NICHT ALS SIGNAL AUF. Stillschweigen nach der Aktion ist kein hinreichender Beleg für eine Präferenz. Nur Stillschweigen NACHDEM ich gefragt habe ("ist das in Ordnung?") könnte ein validiertes Signal sein. Und selbst dann nur, wenn der Benutzer Zeit und Gelegenheit zur Korrektur hatte.


Ausnahmeregel: in meinem Kopf

Implizite Signale, die nur aus meinen eigenen Schlussfolgerungen bestehen, ohne externen Beleg aus der Benutzereingabe → zeichnen Sie diese nicht als Benutzerpräferenz auf. Ich kann interne Metriken verfolgen, aber keine fiktiven Präferenzregeln generieren. Alle aufgezeichneten Präferenzen müssen eine nachweisbare Verbindung zur Benutzereingabe haben.


Bestätigungsstrategie

Immer bestätigen, wenn ein Signal erkannt und aufgezeichnet wurde, es sei denn:

  • Es ist ein offensichtliches implizites Signal, das Sie sicher validiert haben (siehe Implizite Signalerfassung)
  • Die Aufzeichnung ist eine unbeabsichtigte (die Regel selbst ist uninteressant, aber die Kategorisierung des Gesprächs ist nützlich)

So bestätigen:

  • Am Ende der Antwort eine separate Zeile / einen kurzen Absatz
  • Aufzeichnungsereignis referenzieren ("Habe HINWEIS aufgezeichnet: [Titel/ID]")
  • Wenn niedrige Sicherheit der Regel: "Ist das eine dauerhafte Präferenz oder nur einmalig?"

Nicht bestätigen:

  • Nicht jede Aufzeichnung erwähnen – nur die wichtigsten / wahrscheinlich interessantesten
  • Keine umständliche Ausgabe, wenn mehrere kleine Regeln gleichzeitig aufgezeichnet wurden
  • Wenn Sie eine Aufzeichnung nicht bestätigen, machen Sie sich selbst eine Notiz: "Grund, warum nicht bestätigt: "

Beispiele für Aufzeichnungsformat

{
  "session_id": "sess-001",
  "turn": 1,
  "detected": true,
  "category": "preference",
  "summary": "Benutzer bevorzugt 4-Leerzeichen-Einrückung",
  "rule_text": "Verwende 4 Leerzeichen für Einrückung, keine Tabs",
  "applies_when": "beim Schreiben oder Ändern von Python-Code",
  "confidence": "high",
  "source": "explicit"
}

Skill-Tests

  • Installations-/Deinstallations-Tests in CI (GitHub Actions): Überprüfen, ob die Installation von Null aus unter Ubuntu + macOS funktioniert, ob claude doctor die Komponenten erkennt, dass uninstall alles bereinigt und keine Reste hinterlässt.
  • Chaos-Tests (Chaos Monkey): Bestätigen, dass der Skill nach dem Löschen bestimmter Dateien (z. B. fingerprints.yaml, state-dir properly/) nicht den gesamten Agenten zum Absturz bringt, sondern sich ordnungsgemäß erholt.
  • Gate-Tests (py.test im Gate-Verzeichnis): Verhaltensüberprüfung im Beobachtungs- vs. Durchsetzungsmodus, Zeitsprüngen usw.

Installationsanleitung

# Standardinstallation (systemweit ~/.claude/skills/):
claude skill install tellonce

# Oder zum Testen (lokales Verzeichnis, z. B. ~/tests/):
SKILL_DIR=~/tests/ claude skill install tellonce

# Überprüfung:
claude doctor

Deinstallation

claude skill uninstall tellonce

Fehlerbehebung

Wenn der Skill nicht erfolgreich geladen wird:

  1. Führen Sie claude doctor aus, um den Status der Komponenten zu überprüfen.
  2. Überprüfen Sie, ob die Hooks in .claude/settings.local.json registriert sind.
  3. Löschen Sie den Zustandsverzeichnis (<project_root>/.claude/tellonce-state/) und installieren Sie neu.
  4. Falls das Problem weiterhin besteht, führen Sie den Befehl tellonce doctor aus (siehe unten).

Der Befehl tellonce doctor

Wenn der Skill installiert ist, steht der Befehl tellonce doctor zur Verfügung:

# Komponentenstatus prüfen:
tellonce doctor

Dieser Befehl erkennt automatisch:

  • Hooks-Status (registriert / fehlt)
  • Dateiintegrität (ob alle erforderlichen Dateien vorhanden sind)
  • Gate-Konfiguration

Ausgabe:

OK: All 4 hook files present
OK: fingerprints.yaml readable (42 rules)
WARN: `~/.tellonce.config.json` not found, using defaults

Verfügbare Umgebungsvariablen

VariableBeschreibung
PT_ENFORCEHartblock-Modus aktivieren (1) / deaktivieren (0); Standard ist 0
PT_SHADOWSchatten-LLM-Richter aktivieren (1) / deaktivieren (0); Standard ist 0
PT_RETRIEVE_BACKENDAbruf-Backend (progressive, cli, keyword); Standard ist progressive
B5_PROGRESSIVE_MAXMaximal pro Durchgang angezeigte Regeln im progressiven Modus; Standard ist 50, 0 = kein Limit
OBSERVATION_LOG_AGE_THRESHOLD_SECVeralterungsschwelle für das Beobachtungsprotokoll in Sekunden; Standard ist 1800

Verwandte Skills