Workflows courants

Découvrez les workflows courants avec Qwen Code.

Chaque tâche de ce document comprend des instructions claires, des exemples de commandes et des bonnes pratiques pour vous aider à tirer le meilleur parti de Qwen Code.

Comprendre de nouvelles bases de code

Obtenir un aperçu rapide de la base de code

Supposons que vous veniez de rejoindre un nouveau projet et que vous deviez en comprendre rapidement la structure.

1. Accédez au répertoire racine du projet

cd /path/to/project

2. Démarrez Qwen Code

qwen

3. Demandez un aperçu de haut niveau

give me an overview of this codebase

4. Approfondissez des composants spécifiques

explain the main architecture patterns used here

what are the key data models?

how is authentication handled?

Trouver le code pertinent

Supposons que vous deviez localiser du code lié à une fonctionnalité ou une fonction spécifique.

1. Demandez à Qwen Code de trouver les fichiers pertinents

find the files that handle user authentication

2. Obtenez le contexte sur l’interaction des composants

how do these authentication files work together?

3. Comprenez le flux d’exécution

trace the login process from front-end to database

Corriger les bugs efficacement

Supposons que vous ayez rencontré un message d’erreur et que vous deviez en trouver et corriger la source.

1. Partagez l’erreur avec Qwen Code

I'm seeing an error when I run npm test

2. Demandez des recommandations de correction

suggest a few ways to fix the @ts-ignore in user.ts

3. Appliquez la correction

update user.tsto add the null check you suggested

Refactoriser du code

Supposons que vous deviez mettre à jour d’ancien code pour utiliser des modèles et pratiques modernes.

1. Identifiez le code legacy à refactoriser

find deprecated API usage in our codebase

2. Obtenez des recommandations de refactoring

suggest how to refactor utils.js to use modern JavaScript features

3. Appliquez les modifications en toute sécurité

refactor utils.js to use ES 2024 features while maintaining the same behavior

4. Vérifiez le refactoring

run tests for the refactored code

Utiliser des sous-agents spécialisés

Supposons que vous souhaitiez utiliser des sous-agents IA spécialisés pour traiter des tâches spécifiques plus efficacement.

1. Affichez les sous-agents disponibles

/agents

Cela affiche tous les sous-agents disponibles et vous permet d’en créer de nouveaux.

2. Utilisez les sous-agents automatiquement

Qwen Code délègue automatiquement les tâches appropriées aux sous-agents spécialisés :

review my recent code changes for security issues

run all tests and fix any failures

3. Demandez explicitement des sous-agents spécifiques

use the code-reviewer subagent to check the auth module

have the debugger subagent investigate why users can't log in

4. Créez des sous-agents personnalisés pour votre workflow

/agents

Sélectionnez ensuite “create” et suivez les invites pour définir :

• Un identifiant unique décrivant l’objectif du sous-agent (par exemple, code-reviewer, api-designer).
• Quand Qwen Code doit utiliser cet agent
• Les outils auxquels il peut accéder
• Un system prompt décrivant le rôle et le comportement de l’agent

Travailler avec les tests

Supposons que vous deviez ajouter des tests pour du code non couvert.

1. Identifiez le code non testé

find functions in NotificationsService.swift that are not covered by tests

2. Générez le squelette de test

add tests for the notification service

3. Ajoutez des cas de test pertinents

add test cases for edge conditions in the notification service

4. Exécutez et vérifiez les tests

run the new tests and fix any failures

Qwen Code peut générer des tests qui suivent les modèles et conventions existants de votre projet. Lorsque vous demandez des tests, soyez précis sur le comportement que vous souhaitez vérifier. Qwen Code examine vos fichiers de test existants pour correspondre au style, aux frameworks et aux modèles d’assertion déjà utilisés.

Pour une couverture complète, demandez à Qwen Code d’identifier les cas limites que vous auriez pu manquer. Qwen Code peut analyser vos chemins de code et suggérer des tests pour les conditions d’erreur, les valeurs limites et les entrées inattendues faciles à négliger.

Créer des pull requests

Supposons que vous deviez créer une pull request bien documentée pour vos modifications.

1. Résumez vos modifications

summarize the changes I've made to the authentication module

2. Générez une pull request avec Qwen Code

create a pr

3. Révisez et affinez

enhance the PR description with more context about the security improvements

4. Ajoutez des détails sur les tests

add information about how these changes were tested

Gérer la documentation

Supposons que vous deviez ajouter ou mettre à jour la documentation de votre code.

1. Identifiez le code non documenté

find functions without proper JSDoc comments in the auth module

2. Générez la documentation

add JSDoc comments to the undocumented functions in auth.js

3. Révisez et améliorez

improve the generated documentation with more context and examples

4. Vérifiez la documentation

check if the documentation follows our project standards

Référencer des fichiers et répertoires

Utilisez @ pour inclure rapidement des fichiers ou répertoires sans attendre que Qwen Code les lise.

1. Référencez un fichier unique

Explain the logic in @src/utils/auth.js

Cela inclut le contenu complet du fichier dans la conversation.

2. Référencez un répertoire

What's the structure of @src/components?

Cela fournit une liste du répertoire avec les informations des fichiers.

3. Référencez des ressources MCP

Show me the data from @github: repos/owner/repo/issues

Cela récupère les données des serveurs MCP connectés en utilisant le format @server: resource. Consultez MCP pour plus de détails.

Reprendre des conversations précédentes

Supposons que vous ayez travaillé sur une tâche avec Qwen Code et que vous deviez reprendre là où vous vous êtes arrêté lors d’une session ultérieure.

Qwen Code propose deux options pour reprendre des conversations précédentes :

• --continue pour continuer automatiquement la conversation la plus récente
• --resume pour afficher un sélecteur de conversation

1. Continuez la conversation la plus récente

qwen --continue

Cela reprend immédiatement votre conversation la plus récente sans aucune invite.

2. Continuez en mode non interactif

qwen --continue --p "Continue with my task"

Utilisez --print avec --continue pour reprendre la conversation la plus récente en mode non interactif, idéal pour les scripts ou l’automatisation.

3. Affichez le sélecteur de conversation

qwen --resume

Cela affiche un sélecteur de conversation interactif avec une vue en liste claire montrant :

• Résumé de la session (ou invite initiale)
• Métadonnées : temps écoulé, nombre de messages et branche git

Utilisez les flèches pour naviguer et appuyez sur Entrée pour sélectionner une conversation. Appuyez sur Échap pour quitter.

# Continue most recent conversation
qwen --continue
 
# Continue most recent conversation with a specific prompt
qwen --continue --p "Show me our progress"
 
# Show conversation picker
qwen --resume
 
# Continue most recent conversation in non-interactive mode
qwen --continue --p "Run the tests again"

Exécuter des sessions Qwen Code parallèles avec des Git worktrees

Supposons que vous deviez travailler sur plusieurs tâches simultanément avec une isolation complète du code entre les instances Qwen Code.

1. Comprendre les Git worktrees

Les Git worktrees vous permettent de checker plusieurs branches du même dépôt dans des répertoires distincts. Chaque worktree possède son propre répertoire de travail avec des fichiers isolés, tout en partageant le même historique Git. Pour en savoir plus, consultez la documentation officielle des Git worktrees .

2. Créez un nouveau worktree

# Create a new worktree with a new branch
git worktree add ../project-feature-a -b feature-a
 
# Or create a worktree with an existing branch
git worktree add ../project-bugfix bugfix-123

Cela crée un nouveau répertoire avec une copie de travail séparée de votre dépôt.

3. Exécutez Qwen Code dans chaque worktree

# Navigate to your worktree
cd ../project-feature-a
 
# Run Qwen Code in this isolated environment
qwen

4. Exécutez Qwen Code dans un autre worktree

cd ../project-bugfix
qwen

5. Gérez vos worktrees

# List all worktrees
git worktree list
 
# Remove a worktree when done
git worktree remove ../project-feature-a

Utiliser Qwen Code comme utilitaire de type Unix

Ajouter Qwen Code à votre processus de vérification

Supposons que vous souhaitiez utiliser Qwen Code comme linter ou relecteur de code.

Ajoutez Qwen Code à votre script de build :

// 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.'"
    }
}

Entrée et sortie via pipe

Supposons que vous souhaitiez envoyer des données à Qwen Code via un pipe, et récupérer des données dans un format structuré.

Transmettez des données via un pipe à Qwen Code :

cat build-error.txt | qwen -p 'concisely explain the root cause of this build error' > output.txt

Contrôler le format de sortie

Supposons que vous ayez besoin de la sortie de Qwen Code dans un format spécifique, notamment lors de l’intégration de Qwen Code dans des scripts ou d’autres outils.

1. Utilisez le format texte (par défaut)

cat data.txt | qwen -p 'summarize this data' --output-format text > summary.txt

Cela génère uniquement la réponse en texte brut de Qwen Code (comportement par défaut).

2. Utilisez le format JSON

cat code.py | qwen -p 'analyze this code for bugs' --output-format json > analysis.json

Cela génère un tableau JSON de messages avec des métadonnées incluant le coût et la durée.

3. Utilisez le format JSON en streaming

cat log.txt | qwen -p 'parse this log file for errors' --output-format stream-json

Cela génère une série d’objets JSON en temps réel pendant que Qwen Code traite la requête. Chaque message est un objet JSON valide, mais la sortie complète n’est pas un JSON valide si elle est concaténée.

Interroger Qwen Code sur ses capacités

Qwen Code dispose d’un accès intégré à sa documentation et peut répondre aux questions sur ses propres fonctionnalités et limites.

Exemples de questions

can Qwen Code create pull requests?

how does Qwen Code handle permissions?

what slash commands are available?

how do I use MCP with Qwen Code?

how do I configure Qwen Code for Amazon Bedrock?

what are the limitations of Qwen Code?