Workflows courants

Découvrez les workflows courants avec Qwen Code.

Chaque tâche de ce document inclut 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 d’une base de code

Supposons que vous venez de rejoindre un nouveau projet et que vous devez comprendre rapidement sa structure.

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

cd /path/to/project

2. Lancez Qwen Code

qwen

3. Demandez un aperçu de haut niveau

donne-moi un aperçu de cette base de code

4. Approfondissez des composants spécifiques

explique les principaux motifs architecturaux utilisés ici

quels sont les modèles de données clés ?

comment l'authentification est-elle gérée ?

Trouver le code pertinent

Supposons que vous ayez besoin de localiser le code lié à une fonctionnalité spécifique.

1. Demandez à Qwen Code de trouver les fichiers pertinents

trouve les fichiers qui gèrent l'authentification utilisateur

2. Obtenez du contexte sur l’interaction des composants

comment ces fichiers d'authentification fonctionnent-ils ensemble ?

3. Comprenez le flux d’exécution

trace le processus de connexion du front-end à la base de données

Corriger les bugs efficacement

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

1. Partagez l’erreur avec Qwen Code

Je vois une erreur quand j'exécute npm test

2. Demandez des recommandations de correctifs

suggère quelques façons de corriger le @ts-ignore dans user.ts

3. Appliquez le correctif

mets à jour user.ts pour ajouter la vérification null que tu as suggérée

Refactoriser du code

Supposons que vous deviez mettre à jour du code ancien pour utiliser des pratiques et des motifs modernes.

1. Identifiez le code legacy à refactoriser

trouve les usages d'API dépréciées dans notre base de code

2. Obtenez des recommandations de refactorisation

suggère comment refactoriser utils.js pour utiliser les fonctionnalités modernes de JavaScript

3. Appliquez les changements en toute sécurité

refactorise utils.js pour utiliser les fonctionnalités ES 2024 tout en gardant le même comportement

4. Vérifiez la refactorisation

exécute les tests pour le code refactorisé

Utiliser des sous-agents spécialisés

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

1. Affichez les sous-agents disponibles

/agents

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

2. Utilisez automatiquement les sous-agents

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

vérifie mes récentes modifications de code pour des problèmes de sécurité

exécute tous les tests et corrige les échecs

3. Demandez explicitement des sous-agents spécifiques

utilise le sous-agent code-reviewer pour vérifier le module d'authentification

demande au sous-agent debugger d'enquêter sur l'impossibilité pour les utilisateurs de se connecter

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

/agents

Sélectionnez ensuite « créer » et suivez les instructions 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
• Quels outils il peut accéder
• Un prompt système 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é

trouve les fonctions dans NotificationsService.swift qui ne sont pas couvertes par les tests

2. Générez une structure de test

ajoute des tests pour le service de notification

3. Ajoutez des cas de test significatifs

ajoute des cas de test pour les conditions limites dans le service de notification

4. Exécutez et vérifiez les tests

exécute les nouveaux tests et corrige les échecs

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

Pour une couverture complète, demandez à Qwen Code d’identifier les cas limites que vous pourriez avoir oubliés. 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 qui sont 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

résume les modifications que j'ai apportées au module d'authentification

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

crée une pr

3. Révisez et affinez

améliore la description de la PR avec plus de contexte sur les améliorations de sécurité

4. Ajoutez des détails sur les tests

ajoute des informations sur la façon dont ces modifications ont été testées

Gérer la documentation

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

1. Identifiez le code non documenté

trouve les fonctions sans commentaires JSDoc appropriés dans le module d'authentification

2. Générez de la documentation

ajoute des commentaires JSDoc aux fonctions non documentées dans auth.js

3. Révisez et améliorez

améliore la documentation générée avec plus de contexte et d'exemples

4. Vérifiez la documentation

vérifie si la documentation suit nos standards de projet

Référencer fichiers et répertoires

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

1. Référencez un seul fichier

Explique la logique dans @src/utils/auth.js

Cela inclut le contenu complet du fichier dans la conversation.

2. Référencez un répertoire

Quelle est la structure de @src/components ?

Cela fournit un listing du répertoire avec des informations sur les fichiers.

3. Référencez des ressources MCP

Montre-moi les données de @github: repos/owner/repo/issues

Cela récupère les données des serveurs MCP connectés en utilisant le format @serveur: ressource. Voir MCP pour les 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é dans une session ultérieure.

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

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

1. Reprendre la conversation la plus récente

qwen --continue

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

2. Reprendre en mode non interactif

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

Utilisez -p (ou --prompt) avec --continue pour reprendre la conversation la plus récente en mode non interactif, parfait pour les scripts ou l’automatisation.

3. Afficher le sélecteur de conversation

qwen --resume

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

• Le résumé de la session (ou le prompt initial)
• Métadonnées : temps écoulé, nombre de messages et branche git

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

# Reprendre la conversation la plus récente
qwen --continue
 
# Reprendre la conversation la plus récente avec un prompt spécifique
qwen --continue -p "Montre-moi notre progression"
 
# Afficher le sélecteur de conversation
qwen --resume
 
# Reprendre la conversation la plus récente en mode non interactif
qwen --continue -p "Relance les tests"

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

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

1. Comprendre les Git worktrees

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

2. Créer un nouveau worktree

# Créer un nouveau worktree avec une nouvelle branche
git worktree add ../project-feature-a -b feature-a
 
# Ou créer un worktree avec une branche existante
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écuter Qwen Code dans chaque worktree

# Accédez à votre worktree
cd ../project-feature-a
 
# Exécutez Qwen Code dans cet environnement isolé
qwen

4. Exécuter Qwen Code dans un autre worktree

cd ../project-bugfix
qwen

5. Gérer vos worktrees

# Lister tous les worktrees
git worktree list
 
# Supprimer un worktree une fois terminé
git worktree remove ../project-feature-a

Utiliser Qwen Code comme un utilitaire de type Unix

Ajouter Qwen Code à votre processus de vérification

Supposons que vous souhaitiez utiliser Qwen Code comme un linter ou un réviseur de code.

Ajoutez Qwen Code à votre script de build :

// package.json
{
    ...
    "scripts": {
        ...
        "lint:Qwen Code": "qwen -p 'tu es un linter. regarde les modifications par rapport à main et signale tout problème lié à des fautes de frappe. signale le nom du fichier et le numéro de ligne sur une ligne, et une description du problème sur la deuxième ligne. ne renvoie aucun autre texte.'"
    }
}

Pipe in, pipe out

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

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

cat build-error.txt | qwen -p 'explique de manière concise la cause première de cette erreur de build' > output.txt

Contrôler le format de sortie

Supposons que vous ayez besoin de la sortie de Qwen Code dans un format spécifique, surtout 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 'résume ces données' --output-format text > summary.txt

Cela produit uniquement la réponse texte brute de Qwen Code (comportement par défaut).

2. Utilisez le format JSON

cat code.py | qwen -p 'analyse ce code pour détecter des bugs' --output-format json > analysis.json

Cela produit 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 'analyse ce fichier journal pour les erreurs' --output-format stream-json

Cela produit 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 l’ensemble de la sortie n’est pas un JSON valide si concaténé.

Interroger Qwen Code sur ses capacités

Qwen Code a un accès intégré à sa documentation et peut répondre à des questions sur ses propres fonctionnalités et limitations.

Exemples de questions

est-ce que Qwen Code peut créer des pull requests ?

comment Qwen Code gère-t-il les permissions ?

quelles commandes slash sont disponibles ?

comment utiliser MCP avec Qwen Code ?

comment configurer Qwen Code pour Amazon Bedrock ?

quelles sont les limitations de Qwen Code ?