Der Copilot-CLI-Harness

Titel: Der Copilot-CLI-Harness – Instructions, Permissions, MCP und Workflows in der Praxis

Praxisbuch (Deutsch) über GitHub Copilot CLI (copilot): ein allgemeiner Coding-Agent im Terminal – und der Harness, mit dem du ihn steuerst (Tools, Permissions, Custom Instructions, Sessions, GitHub-Workflows). Stand der Fakten: Mitte/Ende 2026.

Stil: klar, unaufgeregt, praxisnah. Kein Marketing, keine leeren Versprechen. Konzepte → Beispiele → nachbaubare Configs. Eigenständig und ohne Feature-Vergleichskapitel zu anderen Coding-Agents (kurze, faire Einordnung in Kap. 7.9).

---

Für wen

Stufe	Kapitel	Fokus
Tag-1-Einstieg	01	Installation, Trusted Directory, erste Session, Sicherheit
Einsteiger	02, 03	Instructions, Permissions, Explore–Plan–Code–Verify–Commit
Fortgeschrittene	04, 05	Settings-Hierarchie, MCP, Skills, Hooks, Agents, Fleet, Plugins
Experten & Teams	06, 07	CI, Enterprise, Context/Sessions, Troubleshooting, kritische Einordnung
Nachschlagewerk	08, 09	Cheatsheets, Glossar; stabile Kernvorlagen (Anhang A)

Einstieg für alle: 00-einleitung.md. Kapitel 1–3 reichen für den produktiven Alltag; 4–6 bei konkretem Schmerz.

---

Lesepfad (empfohlen)

Zielgruppe: Entwickler mit Terminal-Basics (cd, Dateien lesen; für Übungen Python-venv). Kein reines Non-Coder-Buch.

1. Einleitung – Modell vs. Harness, Agent-Schleife, Lesevertrag oder zuerst Kap. 1

2. Tag-1 – installieren, todo-cli, Permissions, Diff

3. Grundlagen – Instructions (weich) und Permissions (hart)

4. Alltag – Plan Mode, GitHub-Flow, Modelle – hier darfst du wochenlang bleiben

5. Fortgeschritten – Settings-Hierarchie, Sandbox, multi-repo

6. Erweiterungen – MCP / Skills / Hooks / Agents / Plugins / Fleet

7. Teams & CI – Baseline, programmatic mode, Cloud Agent, Compliance-Orientierung

8. Best Practices – Context, Sessions, Symptom→Fix, kritische Einordnung

9. Anhang – Cheatsheets (Kap. 8) und stabile Kernvorlagen (Anhang A / Kap. 9)

---

Kapitel (Einzeiler)

Datei	Inhalt
00-einleitung.md	Allgemeiner Coding-Agent; Modell vs. Harness; Agent-Schleife; Lesepfade
01-laien-einstieg.md	Install, Auth, Trusted Directory, erste Übungen am todo-cli
02-grundlagen-und-konfiguration.md	Custom Instructions und Permissions (weich vs. hart)
03-alltag-und-workflows.md	Plan, Autopilot, Diff, GitHub-Alltag, /delegate
04-fortgeschrittene-konfiguration.md	Settings-Hierarchie, URLs, Sandbox, Session-State
05-mcp-skills-hooks-agents-plugins.md	Erweiterbarkeit und Härtegrade; Fleet
06-teams-enterprise-ci.md	Team-Baseline, CI, Cloud Agent, Credits, Compliance
07-best-practices-troubleshooting.md	Context, Sessions, BYOK, Symptom→Fix, Doku-Drift, Grenzen & Trade-offs
08-anhang-cheatsheets.md	Flags, Pfade, Patterns, Vorlagen-Index, Glossar
09-anhang-a-kernvorlagen.md	Stabile Kernvorlagen im PDF (Hybrid: Buch-Minima + Online-ZIPs)

---

Verzeichnisstruktur

ki-copilot/
├── README.md
├── AGENTS.md                 # Regeln für Agents am Buch (Autoren-Harness)
├── .grok/                    # Grok: rules, skills, slash-commands
├── 00-einleitung.md … 09-anhang-a-kernvorlagen.md
├── abbildungen.md            # Bildkatalog (Konzept + SCREEN)
├── assets/illustrations/     # Konzept-Figuren für PDF
├── assets/screenshots/       # Terminal-Screendumps (SD-01…08)
├── scripts/screenshots/      # Capture-Pipeline (copilot -p / rekonstruiert)
├── vorlagen/                 # kopierfertig für Leser
├── beispiele/
│   ├── todo-cli/             # Mitmach-Mini-Projekt
│   └── configs/              # Settings-Hints + CI-Gerüst
├── prompts/                  # Autoren-Prompts (nicht Manuskript)
├── research/                 # Autoren-Research (nicht Manuskript)
├── justfile                  # optional: assemble / pdf / qa
├── scripts/
└── pdf/

---

Vorlagen und Beispiele

Hybrid: Im PDF liefert Anhang A die stabilen Kernvorlagen. Vollständige und laufend aktualisierte Materialien liegen im Begleit-Service (versionierte ZIPs).

Begleit-Service: https://books.maatini.space/projects/copilot-cli-harness/ — Stand & Drift, Errata, Material (ZIPs mit MANIFEST/SHA256 für beispiele/ und vorlagen/), Schnelle Hilfe, Feedback.

Pfad	Inhalt
vorlagen/copilot-instructions.minimal.md	Minimale Repo-Instructions → .github/copilot-instructions.md
vorlagen/copilot-instructions.team.md	Team-Baseline
vorlagen/path-instructions.example.md	path-scoped mit applyTo
vorlagen/settings.permissions-hints.md	Allow/Deny-Flags + permissions-config.json
vorlagen/hooks/	Guard- und Format-Hook-Beispiele
vorlagen/skills/verify/SKILL.md	Verify-Skill
vorlagen/agents/security-reviewer.agent.md	Custom Agent (Security-Review)
vorlagen/PLAN.md.skeleton.md	Feature-Plan-Skeleton
vorlagen/mcp-config.beispiel.json	MCP-Server-Beispiel (Platzhalter)
beispiele/todo-cli/	Mini-Python-CLI inkl. Instructions, Skill, Hook
beispiele/configs/	Repo-Settings-Beispiel + GitHub-Actions-Gerüst

---

Konventionen im Text

• Jetzt selbst machen: Übungen im Terminal
• Kern in einem Satz / Kern: Abschnittsthese
• Achtung: echte Risiken (Trust, Secrets, YOLO, CI-Rechte) – sparsam
• Was du jetzt kannst / Nächste Schritte: Abschluss größerer Abschnitte
• Platzhalter: YOUR_TOKEN, your-org/your-repo – nie echte Secrets

---

Build (optional)

Voraussetzungen: just, pandoc, TeX Live (LuaLaTeX, KOMA scrbook), Fonts je nach Template.

just assemble   # Kapitel → build/book.md
just pdf        # → dist/copilot-cli-harness.pdf
just qa         # Keyword-/Struktur-Checks
just clean

---

Quellen

Primär: GitHub Copilot CLI Docs
Produkt: github.com/features/copilot/cli

Bei Abweichung zwischen Buch und Doku: Konzept behalten, Syntax der Doku (Lesevertrag in Kapitel 00 und Drift-Vorgehen in Kapitel 07).

---

Autoren-Material (nicht im PDF-Manuskript)

• prompts/buch-erstellung-copilot-cli.md – Erstellungsauftrag
• research/copilot-cli-achsen.md – interne Achsen (nicht als Kapitel übernehmen)
• AGENTS.md – Regeln für Agents, die am Buch arbeiten
• .grok/ – Grok Build: rules, skills (pdf-bauen, lektorat, kapitel-review, humanizer), commands

Typischer Mitautor-Workflow: Kapitel editieren → bei Bedarf just pdf && just qa → Lektorat/Review über Skills bzw. Grok-Commands (/pdf, /lektorat, /review, /status).