CRA-Integration: CLAUDE.md Sektion + delegate-remote Skill
- CLAUDE.md: CRA-Sektion mit Architektur, Kommando-Referenz, Wann-vorschlagen-Tabelle - Skills-Referenz um /delegate-remote erweitert - Neuer Skill delegate-remote.md für geführte Remote-Delegation Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
64
CLAUDE.md
64
CLAUDE.md
@@ -655,3 +655,67 @@ Nutze parallele Agenten für umfangreiche Scans und rekursive Entdeckung.
|
||||
| `/troubleshoot-host` | Strukturierter Troubleshooting-Workflow |
|
||||
| `/session-end` | Session beenden, Commits erstellen |
|
||||
| `/new-project` | Neues Projekt anlegen |
|
||||
| `/delegate-remote` | Tasks an Remote-Server delegieren (CRA) |
|
||||
|
||||
---
|
||||
|
||||
## Claude Remote Agent (CRA) - Verteilte Task-Ausführung
|
||||
|
||||
**Repository:** `~/Nextcloud/egonetix/claude-remote-agent`
|
||||
**CLI-Tool:** `cra`
|
||||
**Zweck:** Delegiert Aufgaben an Remote-Server, die Claude Code CLI autonom ausführen - auch wenn der Laptop offline ist.
|
||||
|
||||
### Architektur
|
||||
|
||||
```
|
||||
Laptop (Coordinator) ──SSH + JSON-RPC 2.0──> Server (claude-agent)
|
||||
```
|
||||
|
||||
- **Coordinator:** Verwaltet Server, erstellt Tasks, sammelt Ergebnisse
|
||||
- **Agent:** Empfängt Tasks, führt Claude Code CLI autonom aus, speichert Ergebnisse lokal
|
||||
- **Persistenz:** SQLite auf beiden Seiten, Tasks überleben Verbindungsabbrüche
|
||||
|
||||
### Wann CRA vorschlagen
|
||||
|
||||
**Du SOLLST dem User CRA aktiv vorschlagen, wenn:**
|
||||
|
||||
| Szenario | Beispiel |
|
||||
|----------|---------|
|
||||
| **Lang laufende Tasks** | Codebase-Analyse, Refactorings, Log-Analyse |
|
||||
| **Server-Wartung** | Updates, Cleanup, Security-Audits |
|
||||
| **Multi-Server-Operationen** | Gleiche Aufgabe auf mehreren Servern parallel |
|
||||
| **Offline-Delegation** | User will Laptop zuklappen, Tasks sollen weiterlaufen |
|
||||
| **Unabhängige Teilaufgaben** | Aufgabe lässt sich in parallele Sub-Tasks aufteilen |
|
||||
|
||||
> "Diese Aufgabe eignet sich gut für CRA - soll ich sie an einen Remote-Server delegieren?"
|
||||
|
||||
### Kommando-Referenz
|
||||
|
||||
```bash
|
||||
# Server verwalten
|
||||
cra servers add <name> <host> [--user USER] [--port PORT] [--key PATH] [--tag TAG]
|
||||
cra servers list [--all]
|
||||
cra servers remove <name> [--yes]
|
||||
cra servers status [name]
|
||||
|
||||
# Tasks
|
||||
cra submit <server> "<prompt>" [--priority N] [--model MODEL] [--max-turns N]
|
||||
cra status <server> [task_id]
|
||||
cra cancel <server> <task_id>
|
||||
|
||||
# Ergebnisse
|
||||
cra collect [server] [--task ID] [--since ISO-DATETIME] [--output FILE]
|
||||
|
||||
# Config synchronisieren
|
||||
cra sync-config [server] [--no-claude-md] [--no-settings]
|
||||
```
|
||||
|
||||
### MCP-Server Integration
|
||||
|
||||
Wenn der CRA MCP-Server konfiguriert ist, stehen CRA-Funktionen als native Tools zur Verfügung (`cra_submit`, `cra_status`, `cra_collect`, `cra_servers_list`, `cra_server_status`, `cra_sync_config`). Prüfe ob MCP-Tools verfügbar sind, bevor du auf CLI-Befehle zurückfällst.
|
||||
|
||||
### Wichtige Hinweise
|
||||
|
||||
- **Autonome Ausführung:** Server brauchen `~/.claude/settings.json` mit Tool-Permissions
|
||||
- **Config-Sync:** Nach CLAUDE.md/settings.json Änderungen → `cra sync-config`
|
||||
- **Retry:** Fehlgeschlagene Tasks werden automatisch wiederholt (max 3x)
|
||||
|
||||
Reference in New Issue
Block a user