Material: Anhang B. Kompatibilität mit Qwen Code

Lektion 1 von 5 im Modul «Anhang B. Kompatibilität mit Qwen Code»

Sie sehen die Lektion ohne Anmeldung an. Anmelden, um Ihren Fortschritt zu speichern und Tests zu absolvieren.

Quelle

Anhang B. Kompatibilität mit Qwen Code

Der zweite Band beschreibt Produktionsprozesse rund um Qwen Code. Ein Teil dieser Prozesse ist in Qwen Code eingebaut, ein anderer Teil muss im Projekt als benutzerdefinierte Befehle, Skills, Hooks, MCP-Server oder gewöhnliche Skripte implementiert werden. Dieser Anhang definiert die Grenze, damit der Leser einen entworfenen Prozess nicht für eine integrierte CLI-Befehl hält.

Kanonische Skala

Im zweiten Band werden drei Reifegrade verwendet. Dies ist keine Bewertung der Ideenqualität, sondern eine Erwartungsgrenze an den Leser.

Reifegrad	Bedeutung	Implementierungsebene
Standard	Kann im gewöhnlichen Qwen Code ohne zusätzliche Plattform wiederholt werden. Dies ist das Basismaterial des Kurses.	Integrierte Funktionen von Qwen Code
Empfehlung	Sinnvoll, im Projekt zu formalisieren, wenn der Prozess wiederholt wird. Erfordert Repository-Dateien: benutzerdefinierte Befehle, Skills, Hooks oder Skripte.	Benutzerdefinierter Befehl, Projektskript
Frontier	Produktionsorchestrierung rund um Qwen Code. Nur für Teams erforderlich, die tatsächlich externe APIs, SRE-Prozesse und Modellbudgetierung anbinden.	Externer Orchestrator, MCP, externe Dienste

Die Verbindung zu den vier Ebenen ist wie folgt: Integrierte Funktionen von Qwen Code gehören zum Standard; benutzerdefinierte Befehle und Projektskripte gehören zur Empfehlung; ein externer Orchestrator gehört zum Frontier. Wenn ein Beispiel Kubernetes, Grafana, PagerDuty oder einen separaten Datei-Schiedsrichter verwendet, handelt es sich um die Frontier-Ebene des Lehrmodells, nicht um eine obligatorische Anforderung für die Durcharbeitung des Bandes.

Integrierte Ebene von Qwen Code

Verwenden Sie diese Funktionen wie sie sind:

/plan — Planungsmodus ohne Bearbeitungen und Shell-Ausführung.
/review — Integrierte Code-Review mit deterministischen Prüfungen und parallelen Review-Agenten.
/skills — Anzeigen und explizites Ausführen von Skills.
/memory, /remember, /forget — Speicherverwaltung und QWEN.md (/dream als expliziter Konsolidierungsbefehl kann in späteren Versionen erscheinen; wenn sie in Ihrem Release nicht vorhanden ist, formalisieren Sie die Konsolidierung als benutzerdefinierten Befehl).
/mcp und qwen mcp add — Anbindung von MCP-Servern.
@path — Hinzufügen einer Datei oder eines Verzeichnisses zum Kontext.
!command — Shell-Befehle innerhalb einer interaktiven Sitzung.
qwen -p "..." — Headless-Ausführung für CI, Batch-Prüfungen und Skripte.

Benutzerdefinierte Befehle

Wenn Sie Befehle wie /specify, /tasks, /validate, /constitution oder ähnliche wünschen, erstellen Sie diese explizit:

.qwen/
  commands/
    sdd/
      specify.md
      tasks.md
      validate.md
      constitution.md

Dann werden die Befehle als /sdd:specify, /sdd:tasks, /sdd:validate, /sdd:constitution aufgerufen. Innerhalb der Markdown-Datei wird ein Prompt mit {{args}}, Verweisen auf @specs/... und Haltebedingungen gespeichert.

Ebenso wird /clarify formalisiert: Im ersten Band wurde dieser Befehl als Schritt zur Anforderungsklärung vor der Planung verwendet, aber er ist nicht in Qwen Code eingebaut. Im zweiten Band legen Sie für dasselbe Szenario einen projektspezifischen benutzerdefinierten Befehl an (z. B. .qwen/commands/sdd/clarify.md), der als /sdd:clarify aufgerufen wird. Verhalten und Haltevertrag definieren Sie im Prompt, damit der Schritt /clarify aus dem ersten Band ohne implizite Annahmen reproduzierbar ist.

Projektskripte

Prüfungen, die ohne Modell reproduzierbar sein müssen, formalisieren Sie als gewöhnliche Skripte:

scripts/
  spec_ci/
    check_coverage.py
    validate_schema.py
  stress_mutator/
    mutate_specs.py
    fake_validator.py
    immunity_score.py
  tribunal/
    run_duel.py
    check_invariants.py

write_judgment.py
  budget/
    compile.py
    simulate.py
    inspect.py

Qwen Code kann beim Schreiben und Ausführen solcher Skripte helfen, aber der grüne Status muss vom Prüfungscode abhängen, nicht von der Überzeugungskraft der Modellantwort.

Hooks

Für Absicherungen (Guardrails) verwenden Sie die offiziellen Qwen Code-Ereignisse: PreToolUse, PostToolUse, UserPromptSubmit, SessionStart, Stop, SubagentStop, Notification, PreCompact und andere. Verwenden Sie im Text des zweiten Bands genau diese Namen, nicht freie Varianten wie pretooluse. Die genaue Liste der Ereignisse und das Konfigurationsformat prüfen Sie mit der aktuellen Qwen Code-Dokumentation (siehe Links am Ende des Anhangs).

MCP und externe APIs

Produktions-APIs dürfen nicht zu unbegrenzten Shell-Befehlen werden. Für Grafana, PagerDuty, Kubernetes, Jira oder interne APIs ist ein MCP-Server mit einer Positivliste (Allowlist) von Werkzeugen besser:

Nur-Lesen für Triage und Prüfung;
separate schreibende Werkzeuge für sichere Aktionen;
explizite Bestätigungs- und Rollback-Bedingungen;
Verbot der Weitergabe von Geheimnissen in Prompts, Traces und QWEN.md.

Begriffe des zweiten Bands

Begriff in den Kapiteln	Implementierung im Qwen-Projekt

| Verifizierer (Verifier) — stimmt ab | /review, separate Qwen-Sitzung, Sub-Agent oder Projektskript | | Implementierer (Implementor) — stimmt ab | Qwen Code im Standardmodus/auto-edit nach genehmigtem Plan | | Safety — stimmt mit Veto bei critical_risk ab | separate Qwen-Sitzung mit safety_review oder Projektskript, das Blast Radius und Rollback-Bedingungen prüft | | Koordinator (Coordinator) — nicht abstimmender Protokollant | Mensch, CI-Aufgabe oder externer Orchestrator | | Datei-Schiedsrichter (tribunal) | keine integrierte Befehl; Kombination aus /review, Skripten, Berichten und Regeln in validation.md | | Spezifikations-Gateway (Spec CI) | GitHub Actions oder lokale Skripte, die qwen -p nur als Hilfsebene verwenden dürfen | | Budgetverwalter (budget keeper) | externer Dienst oder Skript; Qwen Code verwaltet selbst keine tägliche Stufen-Quote |

Referenzlinks

Die README des Anwendungsbands ist als kurze Routenkarte gehalten, daher sind externe Quellen hier zusammengestellt.

Qwen Code commands: https://qwenlm.github.io/qwen-code-docs/en/users/features/commands/
Qwen Code headless mode: https://qwenlm.github.io/qwen-code-docs/en/users/features/headless/

Qwen Code hooks: https://qwenlm.github.io/qwen-code-docs/en/users/features/hooks/
Qwen Code skills: https://qwenlm.github.io/qwen-code-docs/en/users/features/skills/
Qwen Code memory: https://qwenlm.github.io/qwen-code-docs/en/users/features/memory/
Qwen Code MCP: https://qwenlm.github.io/qwen-code-docs/en/users/features/mcp/
Qwen Code approval mode: https://qwenlm.github.io/qwen-code-docs/en/users/features/approval-mode/
Qwen Code code review: https://qwenlm.github.io/qwen-code-docs/en/users/features/code-review/
GitHub Spec Kit: https://github.com/github/spec-kit
AWS Kiro documentation overview: https://aws.amazon.com/documentation-overview/kiro/
OWASP Top 10 for LLM Applications: https://owasp.org/www-project-top-10-for-large-language-model-applications/
Google SRE book: https://sre.google/sre-book/
Goodhart's law: https://en.wikipedia.org/wiki/Goodhart%27s_law