Инструмент выхода из режима планирования (exit_plan_mode)

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

Описание

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

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

Аргументы

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

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

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

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

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

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

• Proceed Once: Утвердить план только для текущей сессии
• Proceed Always: Утвердить план и включить автоматическое подтверждение для будущих операций редактирования
• Cancel: Отклонить план и остаться в режиме планирования

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

exit_plan_mode(plan="Your detailed implementation plan here...")

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

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

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

Примеры корректного использования:

• “Help me implement user authentication” → Используйте после планирования реализации системы аутентификации
• “Add a new API endpoint for user management” → Используйте после проектирования структуры эндпоинта
• “Refactor the database layer to use TypeORM” → Используйте после планирования подхода к рефакторингу

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

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

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

Примеры некорректного использования:

• “Search for and understand the implementation of vim mode in the codebase” → Не используйте (исследовательская задача)
• “Explain how the authentication system works” → Не используйте (аналитическая задача)
• “Find all TODO comments in the project” → Не используйте (сбор информации)

Примеры использования 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 пользователь может ответить несколькими способами:

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

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

Важные примечания

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

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

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

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

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