name: autodoc description: Eigenständige Dokumentsynthese aus RAG-Kontext. Generiert versionierte Markdown-Dokumente (Systemzustand, Grow-Zusammenfassung, Skill-Inventar etc.) via LLM auf Basis lokaler RAG-Retrieval-Ergebnisse. Kein RAG-Rückschreiben – nur Quell-Retrieval.
autodoc
Zweck
Synthesisiert aktuelle Markdown-Dokumente aus RAG-Kontext (retrieve-only) über ein LLM. Eigenständiger Skill – kein Teil des RAG-Skills. Nutzt RAG ausschließlich als Lesequelle.
Schreibt keine Daten zurück in den RAG-Index. Nur explizit promotete Outputs können per manuellem Trigger in den RAG-Index aufgenommen werden.
Trigger
Nutze autodoc wenn:
- ein Systemzustand-Dokument (
SYSTEM-STATE.md) aktualisiert werden soll - eine Growbox-Zusammenfassung generiert werden soll
- Skill-Inventar oder Betriebshistorie synthetisiert werden soll
- ein täglicher/wöchentlicher Dokumentations-Digest läuft (via Heartbeat)
Commands
Einzelnes Dokument synthetisieren:
~/scripts/skills autodoc "system-state" --output /home/steges/agent/SYSTEM-STATE.md
~/scripts/skills autodoc "growbox-summary" --output /home/steges/growbox/GROW-SUMMARY.md
~/scripts/skills autodoc "system-state" --output /home/steges/agent/SYSTEM-STATE.md --provider copilot --model gpt-4.1
~/scripts/skills autodoc "system-state" --output /home/steges/agent/SYSTEM-STATE.md --dry-run
Profil-basierter Lauf:
~/scripts/skills autodoc profile daily
~/scripts/skills autodoc profile weekly
~/scripts/skills autodoc profile post-promote
~/scripts/skills autodoc profile daily --dry-run --provider copilot --model gpt-4.1
Profile
| Profil | Outputs |
|---|---|
daily | agent/SYSTEM-STATE.md, growbox/GROW-SUMMARY.md, agent/TO-DO.md |
post-promote | agent/SKILL-INVENTORY.md |
weekly | agent/SELF-MODEL.md, agent/HISTORY.md |
Provider
| Flag | Verhalten |
|---|---|
--provider auto | Nimmt ersten verfügbaren Key (Anthropic vor Copilot) |
--provider anthropic | Anthropic Claude Haiku |
--provider copilot | Copilot/OpenAI-kompatibler Endpoint |
Dispatch-Struktur
scripts/autodoc-dispatch.sh CLI-Dispatcher (topic / profile)
Abhängigkeiten
- RAG retrieve (
agent/skills/openclaw-rag/scripts/retrieve.py) – nur lesend - RAG reindex (
agent/skills/openclaw-rag/scripts/reindex.sh) – nur nach erfolgreichem Write
Scope-Grenzen
| Erlaubt | Verboten |
|---|---|
| RAG retrieval lesen | RAG-Index direkt beschreiben |
| Output-Dokumente schreiben | Secrets in Outputs |
| Index-Refresh nach eigenem Write | Direkte Skill-Status-Änderungen |
| Dry-Run Preview | Destructive Aktionen |
Lifecycle
- Skill ist eigenständig; kein Canary-Gate für reguläre Nutzung
- Wird vom Heartbeat via
~/scripts/skills autodoc profile daily/weeklyaufgerufen - Doc-Keeper ruft
~/agent/skills/autodoc/scripts/autodoc-dispatch.sh profile <profil>direkt auf