Den KI-Agenten anpassen
Alles auf dieser Seite ist eine lokale Datei. Dateien unter .champrep/ in einem Repository werden über Git mit Ihrem Team geteilt; Dateien unter $CONFIG/ai/
gelten nur für Sie, in jedem Projekt. Wenn ein Projekt und eine Benutzerdefinition denselben Namen haben, hat die Projektdefinition Vorrang.
Projektinhalte in .champrep/ bleibt inaktiv, bis Sie dem Repository vertrauen. Siehe Vertrauenswürdigkeit des Repositorys.
Projektanweisungen: CHAMPREP.md
Abschnitt betitelt „Projektanweisungen: CHAMPREP.md“CHAMPREP.md enthält feststehende Anweisungen für den Agenten: wie das Projekt erstellt und getestet wird, Konventionen und Dinge, die zu vermeiden sind. Der Agent liest zu Beginn jeder Sitzung:
$CONFIG/ai/CHAMPREP.md, Ihre persönlichen Anweisungen für jedes Projekt;CHAMPREP.mdim Projektstammverzeichnis und in jedem Verzeichnis vom Stammverzeichnis abwärts bis zu dem Ort, an dem Sie den Agenten gestartet haben.
Wenn ein Verzeichnis kein CHAMPREP.md, ein AGENTS.md wird stattdessen verwendet.
| Aktion | Wie |
|---|---|
| Erstellen Sie eine | /init durchsucht das Repository und schreibt CHAMPREP.md, wobei nützliche Inhalte aus einer bestehenden Vorlage beibehalten werden AGENTS.md. |
| Notiz hinzufügen | Starten Sie eine Eingabeaufforderung mit #, zum Beispiel # run make lint before committing. |
| Anzeigen oder bearbeiten | /memoryoder /memory edit [user|project|FILE] um sie in Ihrem Editor zu öffnen. |
Ihr CHAMPREP AIKontospeicher, der in Ihren EinstellungenCHAMPREP AI im Web verwaltet wird, gilt auch im Terminal. /memory zeigt ihn schreibgeschützt an.
Benutzerdefinierte Befehle
Abschnitt betitelt „Benutzerdefinierte Befehle“Ein benutzerdefinierter Befehl ist eine Markdown-Prompt-Vorlage, die Sie als ausführen. /<name>.
| Speicherort | Gültigkeitsbereich |
|---|---|
.champrep/commands/NAME.md | Dieses Projekt |
$CONFIG/ai/commands/NAME.md | Sie |
Eine Datei in einem Unterordner, wie beispielsweise commands/git/commit.md, wird zu
/git:commit. Erstellen Sie eine mit /commands new NAME und listen Sie diese mit
/commands.
---description: Explain a failing test and propose a fixargument-hint: <test name>allowed-tools: [local_read_file, local_grep, local_bash]---Find the test named $1, run it, and explain why it fails.Relevant notes: @docs/testing.mdRecent changes:!`git log --oneline -5`$ARGUMENTSist alles, was auf den Befehlsnamen folgt;$1,$2, … sind einzelne Argumente. Verwendet die Vorlage keines von beiden, werden die Argumente angehängt.@pathbezieht eine Arbeitsbereichsdatei ein. Geheime Dateien werden niemals einbezogen.!`command`führt einen Befehl aus, wenn Sie die Vorlage aufrufen. Sie werden einmal pro Vorlage sowie bei jeder Änderung dazu aufgefordert, dies zu genehmigen.allowed-toolsschränkt die Tools für diesen Durchlauf ein, undmodelüberschreibt das Modell.
Fähigkeiten
Abschnitt betitelt „Fähigkeiten“Ein Skill ist ein Ordner mit Anweisungen und optionalen Begleitdateien, den der Agent nur dann lädt, wenn er ihn benötigt. Bis dahin sieht das Modell lediglich den Namen und die Beschreibung des Skills, sodass viele Skills nur sehr wenig Kontext beanspruchen.
| Speicherort | Gültigkeitsbereich |
|---|---|
.champrep/skills/NAME/SKILL.md | Dieses Projekt |
$CONFIG/ai/skills/NAME/SKILL.md | Sie |
---description: Release checklist for this servicewhen_to_use: When the user asks to cut, tag, or publish a release---1. Confirm the changelog has an entry for the new version.2. .../skills listet Skills auf, einschließlich derer aus Ihrem KontoCHAMPREP AI. Führen Sie einen direkt mit /<skill-name>.
Benutzerdefinierte Agenten
Abschnitt betitelt „Benutzerdefinierte Agenten“Ein benutzerdefinierter Agent ist ein Subagent mit eigenen Anweisungen, Tools und einem eigenen Modell.
| Speicherort | Gültigkeitsbereich |
|---|---|
.champrep/agents/NAME.md | Dieses Projekt |
$CONFIG/ai/agents/NAME.md | Sie |
---name: test-writerdescription: Writes and fixes unit tests. Use after a code change.tools: [local_read_file, local_grep, local_glob, local_edit_file, local_bash]permission_mode: accept-editsisolation: worktree---You write focused unit tests that follow this project's existing style.descriptionTeilt dem Hauptagenten mit, wann er Aufgaben an ihn delegieren soll.toolsschränkt die Tools ein; lassen Sie diesen Parameter weg, um die Tools der Sitzung zu übernehmen.permission_modekann den Agenten nur strenger einstellen als Ihre Sitzung.isolation: worktreeführt es in seinem eigenen Git-Arbeitsverzeichnis aus.
Verwalten Sie Agenten mit /agents create|edit|delete NAME. Starten Sie eine Sitzung als Agent mit champrep ai --agent NAMEoder senden Sie ihm eine Eingabeaufforderung mit
@NAME prompt. Siehe Unteragenten.
Hooks sind Shell-Befehle, die der an bestimmten Punkten einer Sitzung ausführtCLI, beispielsweise um Dateien nach einer Bearbeitung zu formatieren oder bestimmte Befehle zu blockieren.
| Ereignis | Wird ausgeführt |
|---|---|
SessionStart | Wenn eine Sitzung beginnt. |
UserPromptSubmit | Bevor eine Abfrage gesendet wird. Kann diese blockieren oder Kontext hinzufügen. |
PreToolUse | Bevor ein lokales Tool ausgeführt wird. Kann die Ausführung blockieren. |
PostToolUse | Nach der Ausführung eines lokalen Tools. Kann dem Ergebnis Feedback hinzufügen. |
PermissionRequest | Wenn eine Berechtigungsabfrage angezeigt wird. |
Notification | Wann der Agent Sie benachrichtigt. |
SubagentStop | Wenn ein Subagent abgeschlossen ist. |
PreCompact | Bevor die Konversation komprimiert wird. |
Stop | Wenn eine Runde endet. |
SessionEnd | Wenn die Sitzung endet. |
Konfigurieren Sie Hooks in einer beliebigen Einstellungsdatei:
{ "hooks": { "PostToolUse": [ { "matcher": "local_edit_file|local_write_file", "command": "npm run format --silent", "timeout": 30 } ], "PreToolUse": [ { "matcher": "local_bash", "command": "./scripts/check-command.sh" } ] }}matcherist ein regulärer Ausdruck für den Tool-Namen; lassen Sie ihn weg, um alle Tools zu erfassen.- Der Hook erhält eine JSON-Beschreibung des Ereignisses über die Standardeingabe.
- Exit-Code
2oder JSON-Ausgabe mit"decision": "block"und einreason, blockiert die Aktion, sofern das Ereignis dies zulässt.additionalContextin JSON Die Ausgabe fügt Text für das Modell hinzu. - Die Standard-Zeitüberschreitung beträgt 60 Sekunden, das Maximum liegt bei 10 Minuten.
- Hooks werden mit Ihrer Umgebung ohne AnmeldedatenCHAMPREP ausgeführt.
Verwalten Sie Hooks mit /hooks, /hooks add EVENT [--matcher M] [--timeout S] [--scope user|project] -- COMMAND, /hooks disable ID, und /hooks enable ID.
Darstellung und Handhabung
Abschnitt betitelt „Darstellung und Handhabung“| Befehl | Optionen |
|---|---|
/color | Eine Akzentfarbe für die Sitzungen dieses Projekts, um parallele Sitzungen voneinander zu unterscheiden: blue, cyan, green, yellow, orange, red, pink, magenta, purple, grayoder reset. |
/theme | auto, dark, light, high-contrastoder colorblind. NO_COLOR und --no-color Farbe deaktivieren. |
/statusline | Wählen Sie Segmente aus profile, model, context, branch, mode, cost, und tasks; verwenden Sie /statusline command CMD um die erste Zeile der Ausgabe Ihres eigenen Befehls anzuzeigen; /statusline reset Stellt die Standardeinstellung wieder her. |
/output-style | default, concise, explanatoryoder learning. |
/vim | Bearbeitung im Vim-Stil in der Eingabeaufforderung. |
/keybindings | Tastenbelegungen anzeigen; /keybindings edit öffnet $CONFIG/ai/keybindings.json. |
/config | All das auf einem Bildschirm. |
Lokale Dateien
Abschnitt betitelt „Lokale Dateien“Die Konversationen des Agenten befinden sich auf Ihrem CHAMPREP AIKonto. Nur der maschinenspezifische Status wird lokal gespeichert. Zeigen Sie alle Speicherorte auf Ihrem Rechner mit folgendem Befehl an:
champrep ai paths| Was | Wo |
|---|---|
| CLI Profile und Umgebungen | $CONFIG/config.toml |
| Ihre Agent-Einstellungen: Regeln, Modus, Design, Statuszeile, Hooks | $CONFIG/ai/settings.json |
| Überschreiben von Tastenbelegungen | $CONFIG/ai/keybindings.json |
| Ihre persönlichen Anweisungen | $CONFIG/ai/CHAMPREP.md |
| Ihre Agenten, Befehle und Skills | $CONFIG/ai/agents/, commands/, skills/ |
| Ihre lokalen MCP-Server | $CONFIG/ai/mcp.json |
| Vertrauenswürdige Projekte | $CONFIG/ai/trusted-projects.json |
| Aktuelle Konversationen pro Verzeichnis und Aufgabenlisten | $STATE/ai/sessions.json |
| Eingabeverlauf (geschwärzt und gekürzt) | $STATE/ai/history.jsonl |
| Debug-Protokolle (geschwärzt, werden 7 Tage lang aufbewahrt) | $STATE/ai/logs/ |
| Datei-Checkpoints | $CACHE/ai/checkpoints/ |
| Projekteinstellungen (committbar) | .champrep/settings.json, mcp.json, agents/, commands/, skills/ |
| Ihre Projektüberschreibungen (von Git ignoriert) | .champrep/settings.local.json |
| Projektanweisungen | CHAMPREP.md |
| Arbeitsverzeichnisse | .champrep/worktrees/ |
Anmeldedaten werden niemals in diesen Dateien gespeichert. Sie verbleiben im Schlüsselbund des Betriebssystems.
| Root | macOS und Linux | Windows |
|---|---|---|
$CONFIG | $XDG_CONFIG_HOME/champrep, andernfalls ~/.config/champrep | %APPDATA%\champrep |
$STATE | $XDG_STATE_HOME/champrep, andernfalls ~/.local/state/champrep | %LOCALAPPDATA%\champrep\state |
$CACHE | $XDG_CACHE_HOME/champrep, andernfalls ~/.cache/champrep | %LOCALAPPDATA%\champrep\cache |
Festlegen CHAMPREP_CONFIG_DIR um alle drei in einem Verzeichnis zu halten, in config/,
state/, und cache/ Unterordner. Dies ist nützlich für portable Installationen und isolierte CI-Läufe.