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

Ознакомьтесь с типичными рабочими процессами при использовании Qwen Code.

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

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

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

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

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

cd /path/to/project

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

qwen

3. Запросите общее описание кодовой базы

дайте мне общее описание этой кодовой базы

4. Исследуйте конкретные компоненты подробнее

объясните основные архитектурные паттерны, используемые здесь

какие ключевые модели данных?

как реализована аутентификация?

Поиск релевантного кода

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

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

найди файлы, отвечающие за аутентификацию пользователей

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

как эти файлы аутентификации работают совместно?

3. Поймите последовательность выполнения

проследи процесс входа пользователя от фронтенда до базы данных

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

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

1. Передайте ошибку Qwen Code

Я вижу ошибку при выполнении команды npm test

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

предложите несколько способов исправить @ts-ignore в файле user.ts

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

обновите файл user.ts, добавив проверку на null, которую вы предложили

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

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

1. Выявите устаревший код, подлежащий рефакторингу

найдите использование устаревших API в нашей кодовой базе

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

предложите, как рефакторить utils.js для использования современных возможностей JavaScript

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

выполните рефакторинг utils.js с использованием возможностей ES 2024, сохранив прежнее поведение

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

запустите тесты для рефакторенного кода

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

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

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

/agents

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

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

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

проанализируй мои недавние изменения в коде на наличие проблем безопасности

запусти все тесты и устрани любые сбои

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

используй подагента code-reviewer для проверки модуля аутентификации

поручи подагенту debugger выяснить причину невозможности входа пользователей в систему

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

/agents

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

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

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

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

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

найдите функции в NotificationsService.swift, которые не покрыты тестами

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

добавьте тесты для сервиса уведомлений

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

добавьте тестовые случаи для граничных условий в сервисе уведомлений

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

запустите новые тесты и исправьте все ошибки

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

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

Создание pull request

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

1. Краткое описание изменений

кратко опиши изменения, внесённые мной в модуль аутентификации

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

создай pull request

3. Проверка и уточнение

дополни описание pull request дополнительным контекстом об улучшениях безопасности

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

добавь информацию о том, как были протестированы эти изменения

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

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

1. Найдите код без документации

найти функции в модуле auth, для которых отсутствуют корректные комментарии JSDoc

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

добавить комментарии JSDoc к функциям без документации в файле auth.js

3. Проверьте и улучшите

улучшить сгенерированную документацию, добавив больше контекста и примеров

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

проверить, соответствует ли документация стандартам нашего проекта

Справочные файлы и каталоги

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

1. Ссылка на отдельный файл

Объясните логику в @src/utils/auth.js

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

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

Какова структура каталога @src/components?

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

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

Покажите мне данные из @github: repos/owner/repo/issues

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

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

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

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

• --continue — автоматически возобновляет самый последний диалог;
• --resume — отображает интерактивный выбор диалогов.

1. Возобновление самого последнего диалога

qwen --continue

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

2. Возобновление в неинтерактивном режиме

qwen --continue --p "Продолжи выполнение моей задачи"

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

3. Отображение выбора диалогов

qwen --resume

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

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

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

# Возобновить самый последний диалог
qwen --continue
 
# Возобновить самый последний диалог с конкретным запросом
qwen --continue --p "Покажи наш прогресс"
 
# Открыть выбор диалогов
qwen --resume
 
# Возобновить самый последний диалог в неинтерактивном режиме
qwen --continue --p "Запусти тесты ещё раз"

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

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

1. Ознакомьтесь с Git worktrees

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

2. Создайте новую worktree

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

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

3. Запустите Qwen Code в каждой worktree

 
# Перейдите в свою worktree
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 'вы — линтер. Проверьте изменения по сравнению с веткой main и сообщите о любых проблемах, связанных с опечатками. Укажите имя файла и номер строки в одной строке, а описание проблемы — во второй строке. Не выводите никакого другого текста.'"
    }
}

Передача данных через конвейер

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

Передача данных через конвейер в Qwen Code:

cat build-error.txt | qwen -p 'кратко объяснить основную причину этой ошибки сборки' > output.txt

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

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

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

cat data.txt | qwen -p 'сделай краткое содержание этих данных' --output-format text > summary.txt

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

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

cat code.py | qwen -p 'проанализируй этот код на наличие ошибок' --output-format json > analysis.json

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

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

cat log.txt | qwen -p 'проанализируй этот лог-файл на наличие ошибок' --output-format stream-json

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

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

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

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

Может ли Qwen Code создавать pull-запросы?

Как Qwen Code обрабатывает разрешения?

Какие слэш-команды доступны?

Как использовать MCP с Qwen Code?

Как настроить Qwen Code для Amazon Bedrock?

Каковы ограничения Qwen Code?