Agent-Skripte
Geteilte Agenten-Anweisungen, Skills und kleine portable Helfer für Peters lokale Arbeitsbereiche.
Dieses Repository ist der kanonische Ort für:
AGENTS.MD: Geteilte feste Regeln für Codex/Claude-ähnliche Agentenskills/: Wiederverwendbare Workflow-Skills, einschließlich repositoriumseigener Skills, die per Symlink bereitgestellt werdenscripts/: Abhängigkeitsarme Helfer, die projektübergreifend verwendet werdenhooks/: Lokale Schutzmechanismen wie Skill-Validierung
Skills
Skills sind die primäre Routing-Ebene. Jede skills/<name>/SKILL.md hat YAML-Frontmatter:
---
name: skill-name
description: "Kurze generische Trigger-Phrase."
---
Regeln:
- Beschreibungen kurz und generisch halten; für Routing optimieren, nicht für Dokumentation.
- Skill-Körper prägnant und operativ halten.
- Bei wiederholbaren Befehlen in Workflows bevorzugt Helfer-Skripte unter
skills/<name>/scripts/verwenden. - Nach Bearbeitungen validieren:
scripts/validate-skills. descriptionim Frontmatter in Anführungszeichen setzen.
Die globale Erkennung wird von scripts/sync-skills aufgebaut (idempotent; wird auf jedem Mac nach dem Klonen oder Hinzufügen von Skills ausgeführt):
- Codex scannt verschachtelte Verzeichnisse, daher erhält es Wurzelverknüpfungen:
~/.codex/skills/agent-scripts -> ~/Projects/agent-scripts/skills,~/.codex/skills/manager -> ~/Projects/manager/skills. - Claude Code lädt nur
~/.claude/skills/<name>/SKILL.md(genau eine Ebene tief; pro Eintrag werden Symlinks gefolgt, Kategorie-Unterordner werden nicht gescannt – bestätigt auf 2.1.197). Es erhält ein flaches, pro Skill verknüpftes Spiegelbild, das beide Repositories sowie maschinenlokale~/.codex/skills/<name>-Extras abdeckt. - Namenskonflikte lösen sich auf in der Reihenfolge agent-scripts > manager > codex-local; das Skript gibt übersprungene Duplikate aus und entfernt defekte/veraltete verwaltete Verknüpfungen.
Geteilte persönliche Skills leben als echte Ordner in skills/. Öffentliche OpenClaw-Community-Skills leben in ../agent-skills und werden hier mit getrackten relativen Symlinks bereitgestellt. Repositoriumseigene Skills bleiben kanonisch in ihrem Repository und werden hier auf die gleiche Weise bereitgestellt, zum Beispiel:
skills/autoreview -> ../../agent-skills/skills/autoreview
skills/discrawl -> ../../discrawl/.agents/skills/discrawl
Aktuelle per Symlink verknüpfte repositoriumseigene Skills sind birdclaw, discrawl, gog, imsg, slacrawl, wacli und wacrawl.
Agenten-Anweisungen
Geteilte feste Regeln leben in AGENTS.MD.
Globale Einrichtung (ebenfalls von scripts/sync-skills gewartet; Claude Code liest nur CLAUDE.md, daher wird auf die gemeinsame AGENTS.MD verlinkt):
~/.codex/AGENTS.md -> ~/Projects/agent-scripts/AGENTS.MD~/.claude/CLAUDE.md -> ~/Projects/agent-scripts/AGENTS.MD~/.claude/AGENTS.md -> ~/Projects/agent-scripts/AGENTS.MD
Downstream-Repositories sollten eine Zeiger-AGENTS.MD verwenden:
READ ~/Projects/agent-scripts/AGENTS.MD BEFORE ANYTHING (skip if missing).
Repositoriumsspezifische Regeln stehen unterhalb dieses Zeigers. Kopieren Sie die gemeinsamen Blöcke nicht in Downstream-Repositories.
Helfer
scripts/committer
- Staged genau die aufgelisteten Dateien.
- Erzwingt eine nicht leere Commit-Nachricht.
- Führt vor dem Commit die Skill-Validierung aus.
scripts/sync-skills
- Erstellt das maschinenspezifische Skill-Spiegelbild: Codex-Wurzelverknüpfungen, Claude-flache-Pro-Skill-Verknüpfungen, gemeinsame
AGENTS.MD-Zeiger. - Idempotent; gibt nur Änderungen aus, entfernt defekte/veraltete verwaltete Verknüpfungen, überschreibt niemals echte Dateien.
scripts/validate-skills
- Überprüft jede
skills/*/SKILL.md. - Validiert YAML-Frontmatter sowie die erforderlichen Felder
nameunddescription. - Als lokaler Hook aktivieren mit
git config core.hooksPath hooks.
scripts/docs-list.ts
- Durchläuft
docs/. - Erzwingt
summary- undread_when-Frontmatter. - Gibt Onboarding-Zusammenfassungen für Repositories aus, die es eingebunden haben.
scripts/browser-tools.ts
- Eigenständiger Chrome DevTools-Helfer.
- Häufige Befehle:
start --profile,nav <url>,eval '<js>',screenshot,console,network,search --content "<query>",content <url>,inspect,kill --all --force. - Optionale Binärdatei erstellen mit
bun build scripts/browser-tools.ts --compile --target bun --outfile bin/browser-tools.
Synchronisierung
Behandeln Sie dieses Repository als kanonisch für gemeinsame Agentenregeln und portable Helfer-Skripte.
Beim Synchronisieren von Downstream-Repositories:
- Zuerst hier die neueste Version ziehen.
- Sicherstellen, dass jedes Ziel-Repository mit der Zeiger-
AGENTS.MDbeginnt. - Repositoriumslokale Regeln unterhalb des Zeigers erhalten.
- Helfer-Änderungen nur dann in beide Richtungen kopieren, wenn der Helfer byte-identisch bleiben soll.
- Skripte abhängigkeitsfrei und portabel halten; keine repositoriumsspezifischen Importe oder Pfad-Alias.
Für Submodule den Zeiger-Check innerhalb jedes Subrepos wiederholen, diese Änderungen pushen und dann die Submodule-SHA im Eltern-Repository aktualisieren.