Обычные рабочие процессы

Узнайте об обычных рабочих процессах с Qwen Code.

Каждая задача в этом документе содержит четкие инструкции, примеры команд и лучшие практики, которые помогут вам максимально эффективно использовать Qwen Code.

Понимание новых кодовых баз

Быстрый обзор кодовой базы

Предположим, вы только что присоединились к новому проекту и хотите быстро понять его структуру.

1. Перейдите в корневой каталог проекта

cd /path/to/project

2. Запустите Qwen Code

qwen

3. Запросите обзор высокого уровня

give me an overview of this codebase

4. Углубитесь в конкретные компоненты

explain the main architecture patterns used here

what are the key data models?

how is authentication handled?

Поиск соответствующего кода

Предположим, вам нужно найти код, относящийся к определенной функции или функциональности.

1. Попросите Qwen Code найти соответствующие файлы

find the files that handle user authentication

2. Получите контекст о том, как компоненты взаимодействуют

how do these authentication files work together?

3. Поймите поток выполнения

trace the login process from front-end to database

Эффективное исправление ошибок

Предположим, вы столкнулись с сообщением об ошибке и хотите найти и устранить ее источник.

1. Поделитесь ошибкой с Qwen Code

I'm seeing an error when I run npm test

2. Попросите рекомендации по исправлению

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

3. Примените исправление

update user.ts to add the null check you suggested

Рефакторинг кода

Предположим, вам нужно обновить старый код, чтобы использовать современные шаблоны и практики.

1. Определите устаревший код для рефакторинга

find deprecated API usage in our codebase

2. Получите рекомендации по рефакторингу

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

3. Примените изменения безопасно

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

4. Проверьте рефакторинг

run tests for the refactored code

Использование специализированных субагентов

Предположим, вы хотите использовать специализированные ИИ-субагенты для более эффективного выполнения конкретных задач.

1. Просмотр доступных субагентов

/agents

Это покажет все доступные субагенты и позволит создать новые.

2. Автоматическое использование субагентов

Qwen Code автоматически делегирует подходящие задачи специализированным субагентам:

review my recent code changes for security issues

run all tests and fix any failures

3. Явный запрос конкретных субагентов

use the code-reviewer subagent to check the auth module

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

4. Создание пользовательских субагентов для вашего рабочего процесса

/agents

Затем выберите “create” и следуйте подсказкам, чтобы определить:

• Уникальный идентификатор, описывающий назначение субагента (например, code-reviewer, api-designer).
• Когда Qwen Code должен использовать этого агента
• Какие инструменты он может использовать
• Системный промпт, описывающий роль и поведение агента

Работа с тестами

Предположим, вам нужно добавить тесты для непокрытого кода.

1. Определите непротестированный код

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

2. Сгенерируйте каркас тестов

add tests for the notification service

3. Добавьте осмысленные тестовые случаи

add test cases for edge conditions in the notification service

4. Запустите и проверьте тесты

run the new tests and fix any failures

Qwen Code может генерировать тесты, соответствующие существующим шаблонам и соглашениям вашего проекта. При запросе тестов будьте конкретны в том, какое поведение вы хотите проверить. Qwen Code изучает ваши существующие тестовые файлы, чтобы соответствовать стилю, фреймворкам и шаблонам утверждений, уже используемым в проекте.

Для всестороннего покрытия попросите Qwen Code определить граничные случаи, которые вы могли упустить. Qwen Code может проанализировать ваши пути кода и предложить тесты для состояний ошибок, граничных значений и неожиданных входных данных, которые легко пропустить.

Создание pull request’ов

Предположим, вам нужно создать хорошо документированный pull request для ваших изменений.

1. Суммируйте ваши изменения

summarize the changes I've made to the authentication module

2. Создайте pull request с помощью Qwen Code

create a pr

3. Просмотрите и доработайте

enhance the PR description with more context about the security improvements

4. Добавьте информацию о тестировании

add information about how these changes were tested

Работа с документацией

Предположим, вам нужно добавить или обновить документацию для вашего кода.

1. Найдите недокументированный код

find functions without proper JSDoc comments in the auth module

2. Сгенерируйте документацию

add JSDoc comments to the undocumented functions in auth.js

3. Просмотрите и улучшите

improve the generated documentation with more context and examples

4. Проверьте документацию

check if the documentation follows our project standards

Ссылки на файлы и каталоги

Используйте @ для быстрого включения файлов или каталогов, не дожидаясь, пока Qwen Code их прочитает.

1. Ссылка на один файл

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

Это включает полное содержимое файла в диалог.

2. Ссылка на каталог

What's the structure of @src/components?

Это выводит список файлов каталога с информацией о них.

3. Ссылка на ресурсы MCP

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

Это получает данные с подключённых MCP-серверов, используя формат @сервер: ресурс. Подробнее см. MCP.

Возобновление предыдущих бесед

Предположим, вы работали над задачей с помощью Qwen Code и хотите продолжить с того же места в следующем сеансе.

Qwen Code предлагает два варианта возобновления предыдущих бесед:

• --continue — автоматически продолжить последнюю беседу
• --resume — показать выбор беседы

1. Продолжить последнюю беседу

qwen --continue

Эта команда сразу возобновляет последнюю беседу без каких-либо подсказок.

2. Продолжить в неинтерактивном режиме

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

Используйте -p (или --prompt) вместе с --continue, чтобы возобновить последнюю беседу в неинтерактивном режиме — идеально для скриптов или автоматизации.

3. Показать выбор беседы

qwen --resume

Отображается интерактивный выбор беседы с чистым списком, показывающим:

• Краткое описание сеанса (или начальный запрос)
• Метаданные: прошедшее время, количество сообщений и ветка Git

Используйте клавиши со стрелками для навигации и нажмите Enter, чтобы выбрать беседу. Нажмите Esc для выхода.

# Продолжить последнюю беседу
qwen --continue
 
# Продолжить последнюю беседу с конкретным запросом
qwen --continue -p "Show me our progress"
 
# Показать выбор беседы
qwen --resume
 
# Продолжить последнюю беседу в неинтерактивном режиме
qwen --continue -p "Run the tests again"

Запуск параллельных сеансов Qwen Code с помощью Git worktrees

Предположим, вам нужно одновременно работать над несколькими задачами с полной изоляцией кода между экземплярами Qwen Code.

1. Разберитесь с Git worktrees

Git worktrees позволяет извлечь несколько веток из одного репозитория в отдельные каталоги. Каждый worktree имеет свою рабочую директорию с изолированными файлами, но общую историю Git. Подробнее читайте в официальной документации Git worktree . 2. Создание нового рабочего дерева

# Создать новое рабочее дерево с новой веткой
git worktree add ../project-feature-a -b feature-a
 
# Или создать рабочее дерево с существующей веткой
git worktree add ../project-bugfix bugfix-123

Эта команда создаёт новый каталог с отдельной рабочей копией вашего репозитория.

3. Запуск Qwen Code в каждом рабочем дереве

# Перейдите в ваше рабочее дерево
cd ../project-feature-a
 
# Запустите Qwen Code в этой изолированной среде
qwen

4. Запуск Qwen Code в другом рабочем дереве

cd ../project-bugfix
qwen

5. Управление рабочими деревьями

# Вывести список всех рабочих деревьев
git worktree list
 
# Удалить рабочее дерево после завершения работы
git worktree remove ../project-feature-a

Использование Qwen Code как утилиты Unix

Добавление Qwen Code в процесс верификации

Предположим, вы хотите использовать Qwen Code как линтер или ревьюер кода.

Добавьте Qwen Code в скрипт сборки:

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

Передача через конвейер (pipe)

Предположим, вы хотите передать данные в Qwen Code через конвейер и получить структурированные данные на выходе.

Передача данных через Qwen Code:

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

Управление форматом вывода

Предположим, вам нужен вывод Qwen Code в определённом формате, особенно при интеграции Qwen Code в скрипты или другие инструменты.

1. Использование текстового формата (по умолчанию)

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

Это выводит только текстовый ответ Qwen Code (поведение по умолчанию).

2. Использование JSON-формата

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

Это выводит массив JSON с сообщениями и метаданными, включая стоимость и длительность.

3. Использование потокового JSON-формата

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

Это выводит серию JSON-объектов в реальном времени по мере обработки запроса Qwen Code. Каждый объект является корректным JSON, но при конкатенации весь вывод не является корректным JSON.

Спросите Qwen Code о его возможностях

Qwen Code имеет встроенный доступ к своей документации и может отвечать на вопросы о собственных функциях и ограничениях.

Примеры вопросов

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?