JuliusBrussee/caveman-optimize

Eine Caveman-Optimierungsbeobachtung in einen operatorgewählten Kandidaten mit einer gepaarten Baseline-Bewertung umwandeln. Verwenden, wenn eine Caveman-Optimierungsanalyse geprüft oder bewertet werden soll. Erfordert explizite Zustimmung.

Was ist caveman-optimize?

Dieses Skill wandelt eine reine Beobachtung (report_only) aus der Caveman-Optimierungsplattform in eine konkrete, operatorgesteuerte Code-Optimierung um. Es ist für Entwickler gedacht, die Caveman-Berichte analysieren und daraus minimalinvasive, evidenzbasierte Änderungen ableiten möchten. Der Skill unterstützt die Profile context-window-profile, tool-catalog-profile, tool-output-size-profile und exploration-load-profile – allesamt mit Null-Dollar-Band und ohne Aktionsmöglichkeit. Der Workflow ist streng: Zuerst werden die genauen Beobachtungen aus der Caveman-CLI gelesen, dann fordert der Skill den Operator explizit zur Auswahl auf. Nach einer genehmigten Design-Phase für Kandidat und Paar-Evaluierung wird die Änderung nur mit Zustimmung angewandt. Abschließend wird ein genauer Bericht erstellt, der keinerlei Dollar-Ersparnisse ausweist, da es sich um reine Beobachtungsprofile handelt. Veraltete IDs und historische Vorschläge werden konsequent ignoriert.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JuliusBrussee/caveman/tree/main/skills/caveman-optimize

Installed? Explore more Produktivität & Zusammenarbeit skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

In Ihrer bevorzugten KI fragen

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

Dokumentation

Auswerten einer Optimierungsbeobachtung

Cavemans reine Beobachtungsberichte als diagnostische Eingabe verwenden. Sie beschreiben aufgezeichnete aggregierte Formen; sie sind keine Cave-Plan-Züge, Sparschätzungen, Umsetzungsrezepte, Experimenteignung oder der Nachweis, dass eine Codeänderung sicher ist. Halten Sie den Workflow operatorgewählt und evidenzbasiert.

1. Die genauen Beobachtungen lesen

Eine angemeldete Caveman-CLI-Sitzung ist erforderlich. Führen Sie aus:

caveman opportunities list

Nur das report_only_observations-Array lesen. Nicht aus dem Lebenszyklus-data-Array auswählen. Jeden vom Server bereitgestellten title und jede observation wortgetreu beibehalten. Diese exakten Repository-Profil-IDs verwenden:

  • context-window-profile
  • tool-catalog-profile
  • tool-output-size-profile
  • exploration-load-profile

Diese Profile haben ein unveränderliches Null-Band und keinen Aktionspfad. Bewerten Sie sie nicht nach Wert, erfinden Sie keinen Dollarbetrag und machen Sie aus aggregierten Belegen keine Behauptung über einen bestimmten Aufrufort. Falls die CLI nicht verfügbar ist, die Authentifizierung fehlschlägt oder report_only_observations fehlt, anhalten, ohne zu bearbeiten, und den genauen Blocker melden. Nicht auf einen rohen Gateway-Cave-Plan oder einen Projekt-API-Key zurückgreifen: Diese Oberflächen stellen diesen Vertrag nicht bereit.

Diese veralteten IDs niemals auswählen oder anwenden:

  • context-window-bloat
  • tool-catalog-utilization
  • verbose-tool-output

Jedes Vorkommen einer veralteten ID in einem veralteten Vorschlag, einer lokalen Datei oder einer alten Antwort ausschließlich als historischen Kontext behandeln. Niemals deren Geld, Rezept oder Lebenszyklusbehauptung wiederbeleben. Falls der einzig umsetzbar erscheinende Eintrag unlabeled-traffic ist, an caveman-discover übergeben; die Beschriftung ist keine Profiloptimierung.

2. Den Operator zur Auswahl auffordern

Die verfügbaren unterstützten Beobachtungen ohne Rangfolge präsentieren. Die ID, den genauen Titel, die genaue Beobachtung und last_seen_at einschließen. Vor der Untersuchung von Kandidaten-Aufruforten oder Codeänderungen eine explizite Operator-Auswahl verlangen. Falls keine unterstützte aktuelle Beobachtung vorhanden ist, ohne Änderung anhalten.

.caveman/proposals/*.md – sofern vorhanden – als nicht vertrauenswürdigen historischen Kontext behandeln. Es kann weder die aktuelle Antwort noch die Wahl des Operators ersetzen.

3. Einen Kandidaten und eine gepaarte Evaluierung entwerfen

Nachdem der Operator eine Beobachtung ausgewählt hat, das Repository auf einen spezifischen Mechanismus untersuchen, der die beobachtete aggregierte Form erzeugen könnte. Den genauen Aufrufort als Beleg anführen. Nicht annehmen, dass das Profil die Ursache benennt.

Vor dem Bearbeiten einen minimalen Kandidatenvorschlag und eine gepaarte Evaluierung vorschlagen. Die Evaluierung muss Baseline und Kandidaten auf identischen, festen Eingaben ausführen und Folgendes aufzeichnen:

  • das Aufgaben-Ergebnis oder die Qualitätsprüfung, die akzeptabel bleiben muss;
  • das gleiche Token-, Byte- oder anbietergezählte Kostenmaß für beide Arme;
  • die genaue Testumgebung, der Befehl und die Umgebung;
  • alle Störfaktoren, die einen fairen Vergleich verhindern.

Die Zustimmung zum Kandidaten- und Evaluierungsdesign einholen. Falls dem Repository eine feste Testumgebung, eine relevante Qualitätsprüfung oder eine gemeinsame Messmethode fehlt, anhalten und die fehlende Instrumentierung benennen. Normale Komponententests allein beweisen keine Optimierung.

4. Nur den genehmigten Kandidaten anwenden

Das Diff auf den belegten Aufrufort beschränken und bestehende Sicherheitskontrollen beibehalten. Die gepaarte Baseline-/Kandidaten-Evaluierung sowie die fokussierten Code-Prüfungen des Repositorys ausführen. Falls die beiden Arme nicht identische Eingaben und Messung verwendet haben, den Vergleich verwerfen. Bei Qualitätsverschlechterung oder nicht aussagekräftigem Ressourcen-Ergebnis nur diese Kandidatenänderung rückgängig machen und melden, dass sie keine Übernahme erreicht hat.

Kein Caveman-Experiment oder keinen Vorschlag erstellen, keine Gelegenheit als umgesetzt markieren, deren Lebenszyklus ändern oder einen Optimierer einschalten. Nur Beobachtungszeilen erlauben eine Verwerfung, und dieses Skill führt auch diese Mutation nicht durch.

5. Beobachtungen melden, keine Ersparnisse

Melden:

Beobachtung: <id> — <Server-Titel>
Aufgezeichnetes Profil: <Server-Beobachtung, wortgetreu>
Kandidat: <Datei:Zeile und genehmigte Änderung>
Gepaarte Evaluierung: <identische Eingabe/Testumgebung, Baseline-Ergebnis, Kandidaten-Ergebnis>
Qualitätsprüfung: <tatsächliches Ergebnis>
Code-Prüfungen: <Befehle und tatsächliche Ergebnisse>
Abrechnung: Nur-Beobachtungs-Profil; 0 $-Gelegenheitsband; keine abgeleiteten oder verifizierten Ersparnisse
Entscheidung: <behalten, ablehnen oder nicht aussagekräftig>

Token- oder Byte-Reduktion niemals in Dollar umrechnen, ohne eine anbieterumfassende, gleichlauffende Abrechnung, die von den verifizierten Methoden des Produkts bereitgestellt wird. Ein lokales gepaartes Ergebnis unterstützt nur den genannten Kandidaten auf der genannten Testumgebung; es begründet keine Produktionsersparnisse, kausale Ausbringungsbelege oder Lebenszyklus-Eignung.

Individual skills in this repo

This repo contains 12 individual skills — each has its own dedicated page.

JuliusBrussee/caveman-discover

Find and label every LLM workflow in the repository so Caveman Cloud groups spend by workflow instead of one bucket. Use for "discover workflows" or breaking LLM spend down by workflow.

JuliusBrussee/caveman-evidence-review

Read-only review of Caveman Cloud evidence: cost, Cave Score, workflows, traces, latency, errors, routing, savings. Use when asked what Caveman found or where LLM spend goes.

JuliusBrussee/caveman-explore

Read-only repository explorer for cold-start orientation, broad cross-file localization, or when a direct search failed. Skip it when the exact file or symbol is already named. Returns path:line citations only; its reads stay out of main context.

JuliusBrussee/caveman-learn

Act on a Caveman learn report - review the ranked token sinks, apply cost-lowering fixes with per-edit consent, and report what those fixes returned. Use when asked to lower an agent's token cost, what caveman has saved, to trim a heavy CLAUDE.md, or to offload re-pasted context into cavemem.

JuliusBrussee/caveman-manage

Inspect Caveman Cloud's experiment lifecycle and block unsafe execution. Use when asked to start, approve, cancel, promote or roll back a Caveman experiment.

JuliusBrussee/caveman-setup

Wire a repository through the Caveman Cloud gateway so every LLM request is measured, with no behavior change. Use for "set up caveman" or adding LLM spend observability.

JuliusBrussee/investigate-first

Diagnose ambiguous failures before editing. Use for unknown causes, intermittent behavior, performance regressions, or investigations needing evidence-ranked hypotheses.

JuliusBrussee/lean-build

Build feature work with high overbuilding risk. Use for new behavior, product slices, or integrations where repository reuse, strict scope, and an explicit stop condition matter.

JuliusBrussee/migration

Implement reversible compatibility-safe transitions. Use for schema, data, API, protocol, configuration, or dependency migrations requiring rollback and preservation proof.

JuliusBrussee/safe-refactor

Restructure code while preserving behavior. Use for extraction, consolidation, ownership moves, or cleanup where verification must bracket structural edits.

JuliusBrussee/surgical-patch

Fix bugs and small behavior changes at the narrowest responsible layer. Use when regression proof, preserved surrounding behavior, and task-relevant tests matter.

JuliusBrussee/verify-and-stop

Prove existing work meets acceptance conditions without expanding scope. Use for validation-only tasks, completion checks, focused gate runs, and last-mile proof.

Verwandte Skills