Exit Plan Mode Tool (exit_plan_mode)

Этот документ описывает инструмент exit_plan_mode для Qwen Code.

Описание

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

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

Аргументы

exit_plan_mode принимает один аргумент:

• plan (строка, обязательный): План реализации, который вы хотите представить пользователю на утверждение. Это должна быть краткая, отформатированная в Markdown, последовательность шагов реализации.

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

Инструмент Exit Plan Mode является частью рабочего процесса планирования Qwen Code. Когда вы находитесь в режиме планирования (обычно после изучения кодовой базы и разработки подхода к реализации), вы используете этот инструмент для:

1. Представления плана реализации пользователю
2. Запроса одобрения для перехода к реализации
3. Переключения из режима планирования в режим реализации на основе ответа пользователя

Инструмент покажет пользователю ваш план и предложит варианты:

• Выполнить один раз: Одобрить план только для этого сеанса
• Выполнять всегда: Одобрить план и включить автоматическое подтверждение для будущих операций редактирования
• Отмена: Отклонить план и остаться в режиме планирования

Использование:

exit_plan_mode(plan="Ваш подробный план реализации здесь...")

Когда использовать этот инструмент

Используйте exit_plan_mode, когда:

1. Задачи реализации: Вы планируете шаги реализации для задачи по кодированию
2. План завершён: Вы закончили изучение и разработку подхода к реализации
3. Требуется одобрение пользователя: Вам нужно подтверждение пользователя перед внесением изменений в код
4. Задачи по написанию кода: Задача включает написание, изменение или рефакторинг кода

Примеры подходящего использования:

• «Помоги мне реализовать аутентификацию пользователей» → Использовать после планирования системы аутентификации
• «Добавь новый API endpoint для управления пользователями» → Использовать после проектирования структуры endpoint
• «Выполни рефакторинг уровня базы данных на TypeORM» → Использовать после планирования подхода к рефакторингу

Когда НЕ использовать этот инструмент

НЕ используйте exit_plan_mode для:

1. Исследовательских задач: Задачи, направленные на понимание или изучение существующего кода
2. Сбора информации: Когда вы ищете, читаете или анализируете без реализации
3. Задач по документации: Когда создаёте документацию без изменений кода
4. Аналитических задач: Когда предоставляете объяснения или ревью без реализации

Примеры неподходящего использования:

• «Найди и пойми реализацию vim mode в кодовой базе» → Не использовать (исследовательская задача)
• «Объясни, как работает система аутентификации» → Не использовать (аналитическая задача)
• «Найди все TODO-комментарии в проекте» → Не использовать (сбор информации)

Примеры exit_plan_mode

Пример планирования реализации

exit_plan_mode(plan="## Implementation Plan for User Dashboard

### 1. Create Dashboard Components
- Create `UserDashboard.tsx` with main dashboard layout
- Add `DashboardStats.tsx` for displaying user statistics
- Implement `ActivityFeed.tsx` for recent user activities

### 2. Add API Integration
- Create `dashboardApi.ts` for dashboard data fetching
- Add endpoints for user stats and activity data
- Implement error handling and loading states

### 3. Update Routing
- Add dashboard route in `App.tsx`
- Update navigation component with dashboard link
- Add route protection for authenticated users

### 4. Testing and Documentation
- Write unit tests for dashboard components
- Add integration tests for API calls
- Update user documentation with dashboard features

This implementation will take approximately 4-6 hours and requires changes to 8-10 files.")

Пример плана рефакторинга

exit_plan_mode(plan="## Database Layer Refactoring Plan

### Phase 1: Setup and Configuration
- Install and configure TypeORM dependencies
- Create database connection configuration
- Set up entity definitions for existing models

### Phase 2: Migration
- Create migration scripts for existing data
- Implement new repository pattern using TypeORM
- Replace raw SQL queries with TypeORM query builder

### Phase 3: Testing and Validation
- Update all database tests to use TypeORM
- Validate data integrity after migration
- Performance testing to ensure no regressions

This refactoring will modernize our database layer while maintaining backward compatibility.")

Обработка ответа пользователя

После вызова exit_plan_mode пользователь может ответить одним из способов:

• Выполнить один раз: План одобрен для немедленной реализации с настройками подтверждения по умолчанию
• Выполнять всегда: План одобрен, и для последующих операций редактирования включается автоматическое подтверждение
• Отмена: План отклонён, система остаётся в режиме планирования для дальнейшего планирования

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

Важные замечания

• Только режим планирования: Этот инструмент следует использовать только когда вы находитесь в режиме планирования
• Ориентация на реализацию: Используйте только для задач, связанных с написанием или изменением кода
• Краткие планы: Составляйте планы лаконичными и сфокусированными — стремитесь к ясности, а не к излишней детализации
• Поддержка Markdown: Планы поддерживают форматирование Markdown для лучшей читаемости
• Однократное использование: Инструмент следует использовать один раз за сеанс планирования, когда вы готовы к переходу
• Контроль пользователя: Окончательное решение о продолжении всегда остаётся за пользователем

Интеграция с рабочим процессом планирования

Инструмент Exit Plan Mode является частью более крупного рабочего процесса планирования:

1. Вход в режим планирования: Пользователь запрашивает или система определяет необходимость планирования
2. Фаза исследования: Анализ кодовой базы, понимание требований, изучение вариантов
3. Разработка плана: Создание стратегии реализации на основе исследования
4. Представление плана: Использование exit_plan_mode для представления плана пользователю
5. Фаза реализации: После одобрения — выполнение запланированной реализации

Такой рабочий процесс обеспечивает продуманные подходы к реализации и даёт пользователю контроль над существенными изменениями кода.