KI-Buch-Archive

Projekte · copilot-cli-harness · Hilfe

Letzte Prüfung: 2026-07-30 · companion-0.1.1

Schnelle Hilfe bei typischen Drift-Problemen

Symptom → 2–3 Sätze Lösung → Buchkapitel und offizielle Doku. Kein Ersatz für ? / copilot help und die Docs – sondern der schnelle Einstieg.

Immer zuerst: copilot --version notieren, dann in der Session ? bzw. copilot help. UI-Labels und Flags können abweichen – Buch-Konzept bleibt gültig, Syntax der aktuellen Doku folgen.

H-01 Produkt-Drift (UI)

Permission-Dialog sieht anders aus

Sofort: freigeben / ablehnen / Session-Allow als Idee bleibt. Den Dialog lesen; bei Unsicherheit ablehnen und in den Docs nachsehen – nicht YOLO oder Session-Allow aus Gewohnheit.

Buch-Konzept bleibt gültig. Permissions sind Policy, nicht Memory.

Buch: Kap. 1 (Trusted Directory), Kap. 2 (Permissions) · Extern: docs.github.com/en/copilot · copilot help permissions

H-02 Produkt-Drift (UI)

Slash-Command heißt anders oder fehlt in ? / /help

Sofort: ? in deiner Version ist maßgeblich. Die Phase (Plan, Compact, …) zählt – nicht der exakte String im Buch-Screenshot.

Buch-Konzept bleibt gültig. Harness-Steuerung vs. „Modell umstimmen“.

Buch: Kap. 3, Kap. 7.8 · Extern: Docs + ? / /help

H-03 Produkt-Drift / Setup

Instructions oder Settings greifen nicht

Sofort: Pfade und Scopes prüfen (Repo .github/copilot-instructions.md, path-scoped, User unter ~/.copilot/, Local vs. Repo-Settings). In der Session /instructions bzw. geladene Quellen ansehen – oft liegt die Datei im falschen Scope oder wird nie geladen.

Buch-Konzept bleibt gültig. Hierarchie und Discovery sind die Landkarte.

Buch: Kap. 2, Kap. 4 · Extern: Docs (Custom instructions, Config directory)

H-04 Setup (kein Copilot-Bug)

ZIP entpackt, aber pytest / Import scheitert

Sofort: Im Ordner beispiele/todo-cli venv anlegen, pip install -e ".[dev]", dann pytest -q. Ohne Install greifen weder CLI noch Tests – unabhängig von Copilot CLI.

Buch-Konzept bleibt gültig. Verify gehört vor „fertig“.

Buch: Kap. 1 · Material: Vorlagen & Beispiele

H-05 Produkt-Drift / Config

Hooks feuern nicht

Sofort: Script-Pfad und Exec-Bit prüfen, Event-Name in den Hook-Configs mit der aktuellen Doku abgleichen, Session neu starten. Geladene Settings-Quellen und Hook-Pfade ansehen.

Buch-Konzept bleibt gültig. Hooks erzwingen Schritte; Permissions sind die Tür.

Buch: Kap. 5 · Extern: Docs (Hooks)

H-06 Produkt-Drift / MCP

MCP-Server „verbunden“, Tool greift nicht

Sofort: Server-Status und Tool-Namen prüfen, Permissions für MCP-Tools, Env/Token außerhalb des Chats. Verbindung ≠ erlaubte Ausführung.

Buch-Konzept bleibt gültig. MCP erweitert Tools; Policy begrenzt sie.

Buch: Kap. 5 · Extern: Docs (MCP)

H-07 Produkt-Drift (Syntax)

JSON-Feld oder Flag aus dem Buch wird abgelehnt

Sofort: Version notieren, Feldnamen in der aktuellen Doku suchen, Konzept (z. B. Deny vor YOLO / --allow-all) behalten und Syntax anpassen. Nicht das ganze Buch verwerfen.

Buch-Konzept bleibt gültig. Siehe Lesevertrag und Kap. 7.8.

Buch: Kap. 0, Kap. 7.8 · Stand: Drift-Liste

H-08 Produkt-Drift (CI)

CI-Action-Input oder programmatic-Beispiel weicht ab

Sofort: Offizielle CLI-/Actions-Doku und aktuelle Flag-Namen prüfen (copilot -p, Token-Env). Prinzip bleibt: begrenzte Rechte, Review, Merge bleibt menschlich.

Buch-Konzept bleibt gültig. Policy in CI ist enger als lokal.

Buch: Kap. 6 · Material: beispiele/configs/github-actions-copilot.yml

Mehr nicht gelöst?

Troubleshooting-Raster im Buch (Kap. 7), dann Feedback mit copilot --version und kurzer Symptom-Beschreibung.