Gängige Workflows
Erfahren Sie mehr über gängige Workflows mit Qwen Code.
Jede Aufgabe in diesem Dokument enthält klare Anweisungen, Beispielbefehle und Best Practices, um Ihnen zu helfen, das Beste aus Qwen Code herauszuholen.
Neue Codebasen verstehen
Schneller Überblick über die Codebasis erhalten
Angenommen, Sie sind einem neuen Projekt beigetreten und müssen sich schnell mit dessen Struktur vertraut machen.
1. Navigieren Sie zum Stammverzeichnis des Projekts
cd /path/to/project2. Starten Sie Qwen Code
qwen3. Fragen Sie nach einer Übersicht auf hoher Ebene
give me an overview of this codebase4. Tauchen Sie tiefer in spezifische Komponenten ein
explain the main architecture patterns used herewhat are the key data models?how is authentication handled?- Beginnen Sie mit allgemeinen Fragen und grenzen Sie diese dann auf spezifische Bereiche ein
- Fragen Sie nach den im Projekt verwendeten Codierungsrichtlinien und Mustern
- Fordern Sie ein Glossar projekt-spezifischer Begriffe an
Relevanten Code finden
Angenommen, du musst Code zu einer bestimmten Funktion oder Funktionalität lokalisieren.
1. Frage Qwen Code, relevante Dateien zu finden
finde die Dateien, die die Benutzerauthentifizierung behandeln2. Kontext darüber erhalten, wie Komponenten zusammenarbeiten
wie arbeiten diese Authentifizierungsdateien zusammen?3. Den Ausführungsfluss verstehen
verfolge den Anmeldevorgang vom Frontend bis zur Datenbank- Sei spezifisch, was du suchst
- Verwende die Domänensprache des Projekts
Fehler effizient beheben
Angenommen, Sie sind auf eine Fehlermeldung gestoßen und müssen deren Ursache finden und beheben.
1. Teilen Sie den Fehler mit Qwen Code
Ich erhalte einen Fehler, wenn ich npm test ausführe2. Bitten Sie um Vorschläge zur Behebung
schlage ein paar Möglichkeiten vor, das @ts-ignore in user.ts zu beheben3. Wenden Sie die Korrektur an
aktualisiere user.ts, um die von dir vorgeschlagene Null-Prüfung hinzuzufügen- Teilen Sie Qwen Code den Befehl mit, um das Problem zu reproduzieren und eine Stack-Trace zu erhalten
- Erwähnen Sie alle Schritte zur Reproduktion des Fehlers
- Informieren Sie Qwen Code, ob der Fehler sporadisch oder konstant auftritt
Code refaktorieren
Angenommen, du musst alten Code aktualisieren, um moderne Muster und Praktiken zu verwenden.
1. Legacy-Code für die Refaktorisierung identifizieren
veraltete API-Nutzung in unserer Codebasis finden2. Empfehlungen zur Refaktorisierung erhalten
vorschlagen, wie utils.js refaktoriert werden kann, um moderne JavaScript-Funktionen zu nutzen3. Die Änderungen sicher anwenden
utils.js refaktorisieren, um ES-2024-Funktionen zu nutzen, während das gleiche Verhalten beibehalten wird4. Die Refaktorisierung verifizieren
Tests für den refaktorierten Code ausführen- Qwen Code bitten, die Vorteile des modernen Ansatzes zu erklären
- Anfragen, dass Änderungen bei Bedarf die Abwärtskompatibilität beibehalten
- Refaktorisierung in kleinen, testbaren Schritten durchführen
Spezialisierte Sub-Agenten verwenden
Angenommen, Sie möchten spezialisierte KI-Sub-Agenten nutzen, um bestimmte Aufgaben effektiver zu bearbeiten.
1. Verfügbare Sub-Agenten anzeigen
/agentsDies zeigt alle verfügbaren Sub-Agenten an und ermöglicht das Erstellen neuer.
2. Sub-Agenten automatisch verwenden
Qwen Code delegiert automatisch geeignete Aufgaben an spezialisierte Sub-Agenten:
review my recent code changes for security issuesrun all tests and fix any failures3. Explizit bestimmte Sub-Agenten anfordern
use the code-reviewer subagent to check the auth modulehave the debugger subagent investigate why users can't log in4. Benutzerdefinierte Sub-Agenten für Ihren Workflow erstellen
/agentsWählen Sie dann „create“ und folgen Sie den Anweisungen, um Folgendes festzulegen:
- Eine eindeutige Kennung, die den Zweck des Sub-Agenten beschreibt (z. B.
code-reviewer,api-designer). - Wann Qwen Code diesen Agenten verwenden soll
- Welche Tools er aufrufen darf
- Ein System-Prompt, der die Rolle und das Verhalten des Agenten beschreibt
- Erstellen Sie projektspezifische Sub-Agenten in
.qwen/agents/für die gemeinsame Nutzung im Team - Verwenden Sie aussagekräftige
description-Felder, um die automatische Delegation zu aktivieren - Beschränken Sie den Tool-Zugriff auf das, was jeder Sub-Agent tatsächlich benötigt
- Erfahren Sie mehr über Sub-Agenten
- Erfahren Sie mehr über den Genehmigungsmodus
Mit Tests arbeiten
Angenommen, du musst Tests für nicht abgedeckten Code hinzufügen.
1. Nicht getesteten Code identifizieren
finde Funktionen in NotificationsService.swift, die nicht durch Tests abgedeckt sind2. Testgerüst generieren
füge Tests für den Benachrichtigungsdienst hinzu3. Aussagekräftige Testfälle hinzufügen
füge Testfälle für Randbedingungen im Benachrichtigungsdienst hinzu4. Tests ausführen und überprüfen
führe die neuen Tests aus und behebe alle FehlerQwen Code kann Tests generieren, die den bestehenden Mustern und Konventionen deines Projekts folgen. Sei beim Anfordern von Tests konkret darüber, welches Verhalten du überprüfen möchtest. Qwen Code untersucht deine vorhandenen Testdateien, um den Stil, die Frameworks und die Assertion-Muster zu erkennen, die bereits verwendet werden.
Für eine umfassende Abdeckung kannst du Qwen Code bitten, Randfälle zu identifizieren, die dir möglicherweise entgangen sind. Qwen Code kann deine Codepfade analysieren und Vorschläge für Tests bei Fehlerzuständen, Grenzwerten und unerwarteten Eingaben machen, die leicht übersehen werden können.
Pull Requests erstellen
Angenommen, du musst einen gut dokumentierten Pull Request für deine Änderungen erstellen.
1. Änderungen zusammenfassen
fasse die Änderungen zusammen, die ich am Authentifizierungsmodul vorgenommen habe2. Einen Pull Request mit Qwen Code generieren
erstelle einen PR3. Überprüfen und verfeinern
verbessere die PR-Beschreibung mit weiterem Kontext zu den Sicherheitsverbesserungen4. Testdetails hinzufügen
füge Informationen darüber hinzu, wie diese Änderungen getestet wurden- Fordere Qwen Code direkt auf, einen PR für dich zu erstellen
- Überprüfe den von Qwen Code generierten PR vor dem Einreichen
- Bitte Qwen Code, potenzielle Risiken oder Überlegungen hervorzuheben
Dokumentation bearbeiten
Angenommen, du musst Dokumentation für deinen Code hinzufügen oder aktualisieren.
1. Nicht dokumentierten Code identifizieren
finde Funktionen ohne ordnungsgemäße JSDoc-Kommentare im Auth-Modul2. Dokumentation generieren
füge JSDoc-Kommentare zu den nicht dokumentierten Funktionen in auth.js hinzu3. Überprüfen und verbessern
verbessere die generierte Dokumentation mit mehr Kontext und Beispielen4. Dokumentation verifizieren
prüfe, ob die Dokumentation unseren Projektstandards entspricht- Gib den gewünschten Dokumentationsstil an (JSDoc, docstrings usw.)
- Bitte um Beispiele in der Dokumentation
- Fordere Dokumentation für öffentliche APIs, Schnittstellen und komplexe Logik an
Referenzdateien und -verzeichnisse
Verwenden Sie @, um schnell Dateien oder Verzeichnisse einzubinden, ohne auf das Lesen durch Qwen Code warten zu müssen.
1. Eine einzelne Datei referenzieren
Erkläre die Logik in @src/utils/auth.jsDies fügt den vollständigen Inhalt der Datei in die Konversation ein.
2. Ein Verzeichnis referenzieren
Wie sieht die Struktur von @src/components aus?Dies liefert eine Verzeichnisliste mit Dateiinformationen.
3. MCP-Ressourcen referenzieren
Zeige mir die Daten von @github: repos/owner/repo/issuesDies ruft Daten von verbundenen MCP-Servern im Format @server: Ressource ab. Weitere Informationen finden Sie unter MCP.
- Dateipfade können relativ oder absolut sein
- @-Dateireferenzen fügen
QWEN.mdim Verzeichnis der Datei und den übergeordneten Verzeichnissen zum Kontext hinzu - Verzeichnisreferenzen zeigen Dateilisten, nicht deren Inhalte
- Sie können mehrere Dateien in einer einzigen Nachricht referenzieren (z. B. “
@file 1.jsund@file 2.js”)
Vorherige Gespräche fortsetzen
Angenommen, du hast bereits an einer Aufgabe mit Qwen Code gearbeitet und möchtest zu einem späteren Zeitpunkt dort weitermachen, wo du aufgehört hast.
Qwen Code bietet zwei Optionen, um vorherige Gespräche fortzusetzen:
--continue, um automatisch das neueste Gespräch fortzusetzen--resume, um eine Auswahl der Gespräche anzuzeigen
1. Das neueste Gespräch fortsetzen
qwen --continueDies setzt unmittelbar dein zuletzt geführtes Gespräch ohne weitere Eingaben fort.
2. Im nicht-interaktiven Modus fortfahren
qwen --continue --p "Continue with my task"Verwende --print zusammen mit --continue, um das neueste Gespräch im nicht-interaktiven Modus fortzusetzen – ideal für Skripte oder Automatisierung.
3. Gesprächsauswahl anzeigen
qwen --resumeDies zeigt eine interaktive Liste der bisherigen Gespräche an, darunter:
- Eine Zusammenfassung der Sitzung (oder die ursprüngliche Eingabe)
- Metadaten: verstrichene Zeit, Anzahl der Nachrichten und Git-Branch
Navigiere mit den Pfeiltasten und drücke Enter, um ein Gespräch auszuwählen. Drücke Esc zum Beenden.
- Der Gesprächsverlauf wird lokal auf deinem Gerät gespeichert
- Verwende
--continuefür schnellen Zugriff auf das letzte Gespräch - Verwende
--resume, wenn du ein bestimmtes früheres Gespräch auswählen willst - Beim Fortsetzen siehst du den vollständigen Gesprächsverlauf, bevor es weitergeht
- Das fortgesetzte Gespräch beginnt mit demselben Modell und derselben Konfiguration wie das ursprüngliche
So funktioniert es:
- Speicherung der Gespräche: Alle Gespräche werden automatisch lokal mit vollständigem Nachrichtenverlauf gespeichert
- Wiederherstellung der Nachrichten: Beim Fortsetzen wird der gesamte Verlauf wiederhergestellt, um den Kontext zu bewahren
- Zustand der Werkzeuge: Die Nutzung und Ergebnisse von Werkzeugen aus dem vorherigen Gespräch bleiben erhalten
- Wiederherstellung des Kontexts: Das Gespräch wird mit allen vorherigen Informationen fortgesetzt
Beispiele:
# Letztes Gespräch fortsetzen
qwen --continue
# Letztes Gespräch mit einer bestimmten Eingabe fortsetzen
qwen --continue --p "Show me our progress"
# Gesprächsauswahl anzeigen
qwen --resume
# Letztes Gespräch im nicht-interaktiven Modus fortsetzen
qwen --continue --p "Run the tests again"Parallele Qwen Code-Sitzungen mit Git-Worktrees ausführen
Angenommen, Sie müssen gleichzeitig an mehreren Aufgaben arbeiten und dabei eine vollständige Code-Isolation zwischen den Qwen Code-Instanzen gewährleisten.
1. Verstehen Sie Git-Worktrees
Git-Worktrees ermöglichen es Ihnen, mehrere Branches aus demselben Repository in separaten Verzeichnissen auszuchecken. Jeder Worktree verfügt über ein eigenes Arbeitsverzeichnis mit isolierten Dateien, teilt sich jedoch dieselbe Git-Historie. Erfahren Sie mehr in der offiziellen Git-Worktree-Dokumentation .
2. Erstellen Sie einen neuen Worktree
# Erstellen Sie einen neuen Worktree mit einem neuen Branch
git worktree add ../project-feature-a -b feature-a
# Oder erstellen Sie einen Worktree mit einem bestehenden Branch
git worktree add ../project-bugfix bugfix-123Dadurch wird ein neues Verzeichnis mit einer separaten Arbeitskopie Ihres Repositorys erstellt.
3. Führen Sie Qwen Code in jedem Worktree aus
# Navigieren Sie zu Ihrem Worktree
cd ../project-feature-a
# Qwen Code in dieser isolierten Umgebung ausführen
qwen4. Qwen Code in einem anderen Worktree ausführen
cd ../project-bugfix
qwen5. Ihre Worktrees verwalten
# Alle Worktrees auflisten
git worktree list
# Entferne einen Worktree nach Abschluss der Arbeit
```bash
git worktree remove ../project-feature-a- Jeder Worktree hat seinen eigenen unabhängigen Dateizustand, was ihn perfekt für parallele Qwen Code-Sitzungen macht
- Änderungen in einem Worktree beeinflussen andere nicht, wodurch Qwen Code-Instanzen sich nicht gegenseitig stören
- Alle Worktrees teilen sich denselben Git-Verlauf und dieselben Remote-Verbindungen
- Für lang laufende Aufgaben kannst du Qwen Code in einem Worktree arbeiten lassen, während du die Entwicklung in einem anderen fortsetzt
- Verwende beschreibende Verzeichnisnamen, um leicht zu erkennen, wofür jeder Worktree gedacht ist
- Denke daran, deine Entwicklungsumgebung in jedem neuen Worktree entsprechend dem Setup deines Projekts zu initialisieren. Abhängig von deinem Stack kann dies Folgendes beinhalten:
- JavaScript-Projekte: Ausführen der Abhängigkeitsinstallation (
npm install,yarn) - Python-Projekte: Einrichten von virtuellen Umgebungen oder Installation mit Paketmanagern
- Andere Sprachen: Befolgen des Standard-Setup-Prozesses deines Projekts
- JavaScript-Projekte: Ausführen der Abhängigkeitsinstallation (
Qwen Code als Unix-ähnliches Dienstprogramm verwenden
Qwen Code zu Ihrem Verifizierungsprozess hinzufügen
Angenommen, Sie möchten Qwen Code als Linter oder Code-Reviewer verwenden.
Fügen Sie Qwen Code Ihrem Build-Skript hinzu:
// package.json
{
...
"scripts": {
...
"lint:Qwen Code": "qwen -p 'you are a linter. please look at the changes vs. main and report any issues related to typos. report the filename and line number on one line, and a description of the issue on the second line. do not return any other text.'"
}
}- Verwenden Sie Qwen Code für automatisierte Code-Reviews in Ihrer CI/CD-Pipeline
- Passen Sie den Prompt an, um auf projektspezifische Probleme zu prüfen
- Erwägen Sie die Erstellung mehrerer Skripte für verschiedene Arten der Verifizierung
Pipe rein, Pipe raus
Angenommen, Sie möchten Daten in Qwen Code einlesen und strukturierte Daten zurück erhalten.
Daten durch Qwen Code leiten:
cat build-error.txt | qwen -p 'erkläre knapp die Hauptursache dieses Build-Fehlers' > output.txt- Verwenden Sie Pipes, um Qwen-Code in bestehende Shell-Skripte zu integrieren
- Kombinieren Sie es mit anderen Unix-Tools für leistungsstarke Workflows
- Erwägen Sie die Verwendung von —output-format für strukturierte Ausgaben
Ausgabeformat steuern
Angenommen, du benötigst die Ausgabe von Qwen Code in einem bestimmten Format, insbesondere wenn du Qwen Code in Skripte oder andere Tools integrierst.
1. Textformat verwenden (Standard)
cat data.txt | qwen -p 'summarize this data' --output-format text > summary.txtDies gibt nur die Klartext-Antwort von Qwen Code aus (Standardverhalten).
2. JSON-Format verwenden
cat code.py | qwen -p 'analyze this code for bugs' --output-format json > analysis.jsonDies gibt ein JSON-Array mit Nachrichten und Metadaten wie Kosten und Dauer aus.
3. Streaming-JSON-Format verwenden
cat log.txt | qwen -p 'parse this log file for errors' --output-format stream-jsonDies gibt eine Reihe von JSON-Objekten in Echtzeit aus, während Qwen Code die Anfrage verarbeitet. Jede Nachricht ist ein gültiges JSON-Objekt, aber die gesamte Ausgabe ist nicht gültig, wenn sie verkettet wird.
- Verwende
--output-format textfür einfache Integrationen, bei denen du nur die Antwort von Qwen Code benötigst - Verwende
--output-format json, wenn du das vollständige Konversationsprotokoll benötigst - Verwende
--output-format stream-jsonfür die Echtzeitausgabe jeder Konversationseinheit
Qwen Code nach seinen Fähigkeiten fragen
Qwen Code hat integrierten Zugriff auf seine Dokumentation und kann Fragen zu seinen eigenen Funktionen und Einschränkungen beantworten.
Beispiel-Fragen
kann Qwen Code Pull Requests erstellen?wie geht Qwen Code mit Berechtigungen um?welche Slash-Befehle sind verfügbar?wie verwende ich MCP mit Qwen Code?wie konfiguriere ich Qwen Code für Amazon Bedrock?was sind die Einschränkungen von Qwen Code?Qwen Code liefert dokumentationsbasierte Antworten auf diese Fragen. Für ausführbare Beispiele und praktische Demonstrationen siehe die spezifischen Workflow-Abschnitte oben.
- Qwen Code hat immer Zugriff auf die neueste Qwen Code-Dokumentation, unabhängig von der Version, die du verwendest
- Stelle spezifische Fragen, um detaillierte Antworten zu erhalten
- Qwen Code kann komplexe Funktionen wie MCP-Integration, Unternehmenskonfigurationen und erweiterte Workflows erklären