Was macht ai-native-cli-spec?
Spec-Suite + Copy-Paste-Seed zum Bauen KI-nativer CLI-Tools: Agentensicherer Output-Vertrag, Skills, Sicherheits- und Repo-Baselines. Ziehe das .agent/-Seed und lasse deine KI bauen.
Übersicht
Dieses Repository stellt eine umfassende Vorlage (Seed) für die Erstellung von KI-nativen CLI-Tools bereit. Es definiert einen agentensicheren Output-Vertrag, der die Kommunikation zwischen KI-Agenten und CLI-Tools standardisiert, sowie Skills, Sicherheitsrichtlinien und Repo-Baselines.
Hauptkomponenten
.agent/-Seed: Das Kernverzeichnis mit allen Konfigurationen und Skill-Definitionen. Kopiere dieses Verzeichnis in dein Projekt, um die KI-Integration zu starten.- Output-Vertrag: Ein klar definiertes Format (JSON/Structured Output), das sicherstellt, dass die KI-Ausgabe von Tools wie
claude,cursorodercodexkorrekt interpretiert wird. - Skills: Vordefinierte Aktionen und Workflows, die der KI-Agent ausführen kann (z. B. Code-Generierung, Testausführung, Deployment).
- Sicherheit: Sicherheitsrichtlinien für die Ausführung von KI-generierten Befehlen, einschließlich Sandboxing und Prüfung von Berechtigungen.
- Repo-Baselines: Mindestanforderungen an die Repository-Struktur, um die Kompatibilität mit KI-Agenten zu gewährleisten.
Verwendung
-
Seed kopieren: Führe folgenden Befehl in deinem Projektverzeichnis aus:
cp -r /path/to/ai-native-cli-spec/.agent/ ./ -
KI initialisieren: Öffne dein Projekt mit einem kompatiblen KI-Agenten (Claude Code, Cursor, Codex). Der Agent erkennt automatisch die
.agent/-Konfiguration und beginnt mit der Arbeit. -
Skills nutzen: Verwende die vordefinierten Skills, um Aufgaben zu automatisieren. Beispiel:
claude run "Generiere neue API-Endpunkte gemäß Output-Vertrag"
Output-Vertrag (Auszug)
Der Output-Vertrag definiert ein JSON-Schema, das alle KI-generierten Ausgaben erfüllen müssen. Beispiel:
{
"type": "command",
"action": "generate",
"target": "api/v1/users",
"parameters": {
"method": "POST",
"role": "admin"
}
}
Skills (Beispiele)
| Skill | Beschreibung |
|---|---|
generate | Erstellt Code oder Konfigurationen basierend auf natürlicher Sprache |
test | Führt Tests aus und meldet Ergebnisse im Output-Vertrag-Format |
deploy | Führt Deployment-Workflows mit vordefinierten Sicherheitsprüfungen durch |
Sicherheit
- Jeder Befehl wird vor Ausführung auf Vertrauenswürdigkeit geprüft.
- Unterstützt Sandboxing (z. B. Docker, Firecracker).
- Ausführliche Logs aller KI-Aktionen.
Repo-Baselines
.agent/-Verzeichnis muss vorhanden sein.package.json(oder Äquivalent) mit definierten Skripten.- CI/CD-Konfiguration, die Output-Vertrag-Validierung einschließt.
Lizenz
MIT
Mitwirken
Pull Requests, Issues und Verbesserungsvorschläge sind willkommen. Bitte beachte den Output-Vertrag bei der Kommunikation mit KI-Agenten.