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 umgesetzt werden. Dieser Anhang legt die Grenze fest, damit der Leser einen entworfenen Prozess nicht mit einem regulären CLI-Befehl verwechselt.

Kanonsche Skala

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

Grad	Bedeutung	Implementierungsschicht
Standard	Kann in normalem Qwen Code ohne zusätzliche Plattform wiederholt werden. Dies ist das Basismaterial des Kurses.	Integrierte Funktionen von Qwen Code
Empfehlung	Es ist sinnvoll, dies im Projekt zu gestalten, wenn der Prozess wiederkehrt. Erfordert Repository-Dateien: benutzerdefinierte Befehle, Skills, Hooks oder Skripte.	Benutzerdefinierter Befehl, Projektskript
Frontier	Produktions-Orchestrierung rund um Qwen Code. Nur für Teams erforderlich, die tatsächlich externe APIs, SRE-Prozesse und Modellbudgetierung anschließen.	Externer Orchestrator, MCP, externe Dienste

Die Beziehung zu den vier Schichten ist wie folgt: Integrierte Funktionen von Qwen Code gehören zum Standard; benutzerdefinierte Befehle und Projektskripte zur Empfehlung; externer Orchestrator zum Frontier. Wenn ein Beispiel Kubernetes, Grafana, PagerDuty oder einen separaten Datei-Schiedsrichter verwendet, ist dies die Frontier-Schicht des Lehrmodells und keine zwingende Voraussetzung für das Absolvieren des Bandes.

Integrierte Schicht von Qwen Code

Verwenden Sie diese Funktionen wie sie sind:

/plan — Planungsmodus ohne Änderungen und Shell-Ausführung.
/review — integrierte Code-Überprüfung mit deterministischen Prüfungen und parallelen Review-Agenten.
/skills — Anzeigen und explizites Starten von Skills.
/memory, /remember, /forget — Speicherverwaltung und QWEN.md (/dream als expliziter Konsolidierungsbefehl kann in späteren Versionen erscheinen; wenn er in Ihrer Version nicht vorhanden ist, gestalten Sie die Konsolidierung als benutzerdefinierten Befehl).
/mcp und qwen mcp add — Anschließen 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, Stapelprüfungen und Skripte.

Benutzerdefinierte Befehle

Wenn Sie die Befehle /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 Stoppregeln gespeichert.

Auf ähnliche Weise wird auch /clarify gestaltet: 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 projektbasierten benutzerdefinierten Befehl an (z. B. .qwen/commands/sdd/clarify.md), der als /sdd:clarify aufgerufen wird. Legen Sie das Verhalten und den Stoppvertrag im Prompt fest, damit der Schritt /clarify aus dem ersten Band ohne implizite Annahmen reproduzierbar ist.

Projektskripte

Prüfungen, die ohne Modell reproduzierbar sein müssen, gestalten 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üfcode abhängen, nicht von der Überzeugungskraft der Modellantwort.

Hooks

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

MCP und externe APIs

Produktions-APIs sollten nicht zu uneingeschränkten Shell-Befehlen werden. Für Grafana, PagerDuty, Kubernetes, Jira oder interne APIs ist es besser, einen MCP-Server mit einer Allowlist für Tools zu erstellen:

schreibgeschützt für Triage und Prüfung;
separate Schreibwerkzeuge für sichere Aktionen;
explizite Bestätigungs- und Rollback-Bedingungen;
Verbot der Weitergabe von Geheimnissen in Prompts, Spuren und QWEN.md.

Begriffe des zweiten Bandes

Begriff in den Kapiteln	Implementierung im Qwen-Projekt
Verifier — stimmt ab	`/review`, separate Qwen-Sitzung, Unteragent oder Projektskript
Implementor — stimmt ab	Qwen Code im Modus default/auto-edit nach genehmigtem Plan
Safety — stimmt mit Veto bei `critical_risk` ab	separate Qwen-Sitzung mit `safety_review` oder Projektskript, das den Blast Radius und die Rollback-Bedingungen prüft
Koordinator — nicht abstimmender Protokollant	Person, CI-Aufgabe oder externer Orchestrator
Datei-Schiedsverfahren (Tribunal)	kein eingebauter Befehl; Kombination aus `/review`, Skripten, Berichten und Regeln in `validation.md`
Spec-Gateway (Spec CI)	GitHub Actions oder lokale Skripte, die `qwen -p` nur als Hilfsschicht verwenden können
Budgetwächter (Budget Keeper)	externer Dienst oder Skript; Qwen Code selbst verwaltet nicht das tägliche Kontingent der Stufen

Referenzlinks

Das README des angewandten Bandes bleibt eine kurze Übersichtskarte, daher sind externe Quellen hier gesammelt.

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