Fluxos de trabalho comuns

Saiba mais sobre fluxos de trabalho comuns com o Qwen Code.

Cada tarefa neste documento inclui instruções claras, exemplos de comandos e boas práticas para ajudá-lo a tirar o máximo proveito do Qwen Code.

Entenda novas bases de código

Obtenha uma visão geral rápida da base de código

Suponha que você tenha acabado de ingressar em um novo projeto e precise entender sua estrutura rapidamente.

1. Navegue até o diretório raiz do projeto

cd /caminho/para/o/projeto

2. Inicie o Qwen Code

qwen

3. Peça uma visão geral de alto nível

forneça-me uma visão geral desta base de código

4. Aprofunde-se em componentes específicos

explique os principais padrões de arquitetura utilizados aqui

quais são os principais modelos de dados?

como a autenticação é tratada?

Localizar código relevante

Suppose você precisa localizar código relacionado a uma funcionalidade ou recurso específico.

1. Peça ao Qwen Code para localizar os arquivos relevantes

localize os arquivos que lidam com autenticação de usuários

2. Obtenha contexto sobre como os componentes interagem

como esses arquivos de autenticação funcionam em conjunto?

3. Entenda o fluxo de execução

rastreie o processo de login, desde o front-end até o banco de dados

Corrija bugs de forma eficiente

Suponha que você tenha encontrado uma mensagem de erro e precise localizar e corrigir sua origem.

1. Compartilhe o erro com o Qwen Code

Estou vendo um erro ao executar npm test

2. Peça recomendações de correção

sugira algumas maneiras de corrigir o @ts-ignore em user.ts

3. Aplique a correção

atualize user.ts para adicionar a verificação de nulo que você sugeriu

Refatorar código

Suppose que você precisa atualizar um código antigo para usar padrões e práticas modernos.

1. Identificar o código legado para refatoração

encontrar usos de APIs obsoletas em nossa base de código

2. Obter recomendações de refatoração

sugerir como refatorar o arquivo utils.js para usar recursos modernos do JavaScript

3. Aplicar as alterações com segurança

refatorar o arquivo utils.js para usar recursos do ES 2024, mantendo o mesmo comportamento

4. Verificar a refatoração

executar os testes para o código refatorado

Usar subagentes especializados

Suponha que você deseja usar subagentes de IA especializados para lidar com tarefas específicas de forma mais eficaz.

1. Visualizar os subagentes disponíveis

/agents

Isso mostra todos os subagentes disponíveis e permite criar novos.

2. Usar subagentes automaticamente

O Qwen Code delega automaticamente tarefas apropriadas para subagentes especializados:

revise minhas alterações recentes de código quanto a problemas de segurança

execute todos os testes e corrija quaisquer falhas

3. Solicitar explicitamente subagentes específicos

use o subagente code-reviewer para analisar o módulo de autenticação

peça ao subagente debugger investigar por que os usuários não conseguem fazer login

4. Criar subagentes personalizados para seu fluxo de trabalho

/agents

Em seguida, selecione “criar” e siga as instruções para definir:

• Um identificador exclusivo que descreva a finalidade do subagente (por exemplo, code-reviewer, api-designer).
• Quando o Qwen Code deve usar esse agente.
• Quais ferramentas ele pode acessar.
• Um prompt do sistema que descreva o papel e o comportamento do agente.

Trabalhe com testes

Suponha que você precise adicionar testes para código sem cobertura.

1. Identifique o código não testado

encontre funções em NotificationsService.swift que não são cobertas por testes

2. Gere a estrutura básica dos testes

adicione testes para o serviço de notificações

3. Adicione casos de teste significativos

adicione casos de teste para condições de borda no serviço de notificações

4. Execute e verifique os testes

execute os novos testes e corrija quaisquer falhas

O Qwen Code pode gerar testes que seguem os padrões e convenções já existentes no seu projeto. Ao solicitar testes, seja específico quanto ao comportamento que deseja verificar. O Qwen Code analisa seus arquivos de teste existentes para reproduzir o estilo, as frameworks e os padrões de asserção já utilizados.

Para uma cobertura abrangente, peça ao Qwen Code que identifique casos de borda que você possa ter deixado de considerar. O Qwen Code pode analisar os caminhos do seu código e sugerir testes para condições de erro, valores de fronteira e entradas inesperadas — situações facilmente negligenciadas.

Criar pull requests

Suppose que você precisa criar um pull request bem documentado para suas alterações.

1. Resuma suas alterações

resuma as alterações que fiz no módulo de autenticação

2. Gere um pull request com o Qwen Code

crie um pull request

3. Revise e refine

melhore a descrição do pull request com mais contexto sobre as melhorias de segurança

4. Adicione detalhes de testes

adicione informações sobre como essas alterações foram testadas

Lidar com a documentação

Suponha que você precise adicionar ou atualizar a documentação do seu código.

1. Identificar código sem documentação

encontrar funções sem comentários JSDoc adequados no módulo auth

2. Gerar documentação

adicionar comentários JSDoc às funções sem documentação em auth.js

3. Revisar e aprimorar

melhorar a documentação gerada com mais contexto e exemplos

4. Verificar a documentação

verificar se a documentação segue os padrões do nosso projeto

Arquivos e diretórios de referência

Use @ para incluir rapidamente arquivos ou diretórios sem precisar esperar o Qwen Code ler seu conteúdo.

1. Referenciar um único arquivo

Explique a lógica em @src/utils/auth.js

Isso inclui todo o conteúdo do arquivo na conversa.

2. Referenciar um diretório

Qual é a estrutura de @src/components?

Isso fornece uma listagem do diretório com informações sobre os arquivos.

3. Referenciar recursos MCP

Mostre-me os dados de @github: repos/owner/repo/issues

Isso busca dados dos servidores MCP conectados usando o formato @servidor: recurso. Consulte MCP para obter mais detalhes.

Retomar conversas anteriores

Suponha que você tenha estado trabalhando em uma tarefa com o Qwen Code e precise retomá-la mais tarde, na mesma sessão ou em outra.

O Qwen Code oferece duas opções para retomar conversas anteriores:

• --continue para retomar automaticamente a conversa mais recente
• --resume para exibir um seletor de conversas

1. Retomar a conversa mais recente

qwen --continue

Isso retoma imediatamente sua conversa mais recente, sem nenhuma solicitação adicional.

2. Retomar em modo não interativo

qwen --continue --p "Continue com minha tarefa"

Use --print junto com --continue para retomar a conversa mais recente em modo não interativo — ideal para scripts ou automações.

3. Exibir o seletor de conversas

qwen --resume

Isso exibe um seletor interativo de conversas com uma lista limpa mostrando:

• Resumo da sessão (ou o prompt inicial)
• Metadados: tempo decorrido, contagem de mensagens e branch do Git

Use as setas para navegar e pressione Enter para selecionar uma conversa. Pressione Esc para sair.

# Retomar a conversa mais recente
qwen --continue
 
# Retomar a conversa mais recente com um prompt específico
qwen --continue --p "Mostre-me nosso progresso"
 
# Exibir o seletor de conversas
qwen --resume
 
# Retomar a conversa mais recente em modo não interativo
qwen --continue --p "Execute os testes novamente"

Execute sessões paralelas do Qwen Code com worktrees do Git

Suponha que você precise trabalhar em várias tarefas simultaneamente, com isolamento completo de código entre instâncias do Qwen Code.

1. Entenda as worktrees do Git

As worktrees do Git permitem fazer checkout de múltiplas branches do mesmo repositório em diretórios separados. Cada worktree possui seu próprio diretório de trabalho com arquivos isolados, enquanto compartilha o mesmo histórico do Git. Saiba mais na documentação oficial do git worktree.

2. Crie uma nova worktree

 
# Crie uma nova worktree com uma nova branch
git worktree add ../project-feature-a -b feature-a
 
# Ou crie uma worktree com uma branch existente
git worktree add ../project-bugfix bugfix-123

Isso cria um novo diretório com uma cópia de trabalho separada do seu repositório.

3. Execute o Qwen Code em cada worktree

 
# Navegue até sua worktree
cd ../project-feature-a
 
# Executar o Qwen Code neste ambiente isolado  
qwen  

4. Executar o Qwen Code em outra worktree

cd ../project-bugfix
qwen

5. Gerenciar suas worktrees

 
# Listar todas as worktrees
git worktree list
 
# Remover uma worktree ao finalizar
git worktree remove ../project-feature-a

Usar o Qwen Code como um utilitário no estilo Unix

Adicionar o Qwen Code ao seu processo de verificação

Suponha que você deseja usar o Qwen Code como um linter ou revisor de código.

Adicione o Qwen Code ao seu script de build:

// package.json
{
    ...
    "scripts": {
        ...
        "lint:Qwen Code": "qwen -p 'você é um linter. Analise as alterações em comparação com a branch main e relate quaisquer problemas relacionados a erros de digitação. Informe o nome do arquivo e o número da linha em uma única linha, e uma descrição do problema na linha seguinte. Não retorne nenhum outro texto.'"
    }
}

Entrada por pipe, saída por pipe

Suponha que você deseja enviar dados para o Qwen Code por meio de um pipe e obter de volta dados em um formato estruturado.

Enviar dados por pipe ao Qwen Code:

cat build-error.txt | qwen -p 'explique de forma concisa a causa raiz deste erro de compilação' > output.txt

Controlar o formato de saída

Suponha que você precise da saída do Qwen Code em um formato específico, especialmente ao integrar o Qwen Code em scripts ou outras ferramentas.

1. Usar o formato de texto (padrão)

cat data.txt | qwen -p 'resuma esses dados' --output-format text > summary.txt

Isso gera apenas a resposta em texto simples do Qwen Code (comportamento padrão).

2. Usar o formato JSON

cat code.py | qwen -p 'analise este código em busca de bugs' --output-format json > analysis.json

Isso gera um array JSON de mensagens com metadados, incluindo custo e duração.

3. Usar o formato JSON em streaming

cat log.txt | qwen -p 'analise este arquivo de log em busca de erros' --output-format stream-json

Isso gera uma série de objetos JSON em tempo real, à medida que o Qwen Code processa a solicitação. Cada mensagem é um objeto JSON válido, mas a saída completa não é um JSON válido se concatenada.

Pergunte ao Qwen Code sobre suas capacidades

O Qwen Code tem acesso embutido à sua própria documentação e pode responder perguntas sobre seus recursos e limitações.

Exemplos de perguntas

O Qwen Code pode criar pull requests?

Como o Qwen Code lida com permissões?

Quais comandos com barra estão disponíveis?

Como usar o MCP com o Qwen Code?

Como configurar o Qwen Code para o Amazon Bedrock?

Quais são as limitações do Qwen Code?