TaskFlow - Управление задачами с интеграцией AI

TaskFlow - это мощное расширение для Visual Studio Code, которое позволяет разработчикам эффективно управлять задачами прямо в IDE.

� Дополнительная документация

🎯 Для пользователей

• �🚀 Быстрый старт тестирования v2.0.1
• 📋 Чеклист тестирования v2.0.1
• 📝 Резюме изменений v2.0.1

🔧 Для разработчиков

• 🤖 Анализ VS Code Chat API - 630+ строк исследования
• 💾 Гибридная архитектура хранения - Map + JSON + Markdown
• 📝 Что нового в v2.0.x
• 📋 История изменений

📚 Полная документация

• 📖 Навигация по документацииерсия 2.0.1**: Улучшенный UX с persistent notification! Теперь уведомления не блокируют работу в VS Code. Что нового?

💾 Хранение данных

Гибридный подход для лучшей производительности:

• JSON файл (.github/.task_flow/.task_flow_state.json) - источник правды для расширения
• Markdown файл (.github/.task_flow/tasks.md) - автоматически генерируемое человекочитаемое представление
• Map в памяти - мгновенный O(1) доступ к задачам по ID

📚 Подробнее о новой архитектуре

🌟 Ключевые возможности

📝 Управление задачами

• Надежное хранение: JSON файл как источник правды, Markdown для чтения
• Быстрый доступ: O(1) поиск задач по ID благодаря Map структуре
• Версионирование: Полная совместимость с Git и другими системами контроля версий
• Автогенерация: Markdown файл создается автоматически из JSON

🎯 Удобный интерфейс

• Боковая панель TreeView: Визуальная организация задач с иерархической структурой
• Категоризация: Группировка задач по категориям, проектам или модулям
• Приоритеты: Отметка задач как высокий/средний/низкий приоритет
• Сроки выполнения: Установка дедлайнов с автоматическим выделением просроченных задач
• Подзадачи: Декомпозиция сложных задач на более мелкие этапы

📊 Отслеживание прогресса

• Визуальные индикаторы: Цветные иконки для разных статусов и приоритетов
• Шкалы прогресса: Автоматический расчет выполнения по подзадачам
• Статистика: Общий прогресс по всем задачам в проекте

📋 Очередь задач с AI

• 🖱️ Drag & Drop: Перетаскивайте задачи мышью из панели "ЗАДАЧИ" в "Очередь задач"
  • Быстрое добавление: Просто перетащите задачу в очередь одним движением
  • Множественный выбор: Перетаскивайте несколько задач одновременно (Ctrl+Click)
  • Интуитивно: Работает как в привычных файловых менеджерах
• 🎯 Автоматическая сортировка по приоритету: Задачи автоматически упорядочиваются при добавлении
  • Умная приоритизация: Высокий → Средний → Низкий
  • Срочные задачи впереди: Критические задачи всегда в начале очереди
  • Стабильная сортировка: При одинаковом приоритете сохраняется порядок добавления
• ⚡ Автоматический режим выполнения: Полная автоматизация workflow разработки
  • Два режима: Ручной (manual) и Автоматический (automatic)
  • Таймер обратного отсчета: Периодические уведомления каждые 30 секунд
  • Настраиваемое время: От 1 до 480 минут (8 часов) на задачу
  • ⏱️ Индивидуальное время задач: Каждая задача может иметь собственное время выполнения
    • Приоритет: Время задачи > Глобальная настройка
    • Гибкость: Быстрые задачи (5-15 мин), стандартные (30-60 мин), сложные (90-240 мин)
  • Досрочное завершение: Кнопка "Завершить сейчас" в любой момент
  • Автоматический переход: К следующей задаче после завершения таймера
  • Идеально для flow: Фокусируйтесь на коде, а не на управлении очередью
• Последовательное выполнение: Организуйте задачи в очередь для планомерной работы
• 🤖 Автоматическая генерация кода: При запуске каждой задачи из очереди автоматически вызывается GitHub Copilot
• Умный запуск: Начинайте следующую задачу одной командой с автоматической генерацией кода
• Автоматизация всей очереди: Запустите выполнение всей очереди - Copilot будет генерировать код для каждой задачи последовательно
• ✅ Интерактивное завершение: Persistent notification с кнопками "Завершить" и "Пропустить" - не блокирует работу!
• ⏱️ Гибкое ожидание: Уведомление появляется снова через 2 секунды, если закрыть без выбора
• 🎨 Удобный UI: Работайте в VS Code, пока Copilot генерирует код
• Управление порядком: Легко меняйте приоритеты и последовательность
• Отдельное представление: Специальная панель для просмотра очереди задач
• Бесшовная интеграция: Завершайте текущую задачу и автоматически начинайте следующую с генерацией кода

📊 Представление выполненных задач

• Отдельный раздел: Специальная панель для просмотра всех завершенных задач
• Группировка по категориям: Автоматическая организация как в основном представлении
• Подсчет статистики: Количество выполненных задач в каждой категории
• История прогресса: Визуальное подтверждение проделанной работы
• Интеграция с очередью: Задачи из очереди автоматически попадают сюда после завершения

🤖 Интеграция с GitHub Copilot

• 🆕 AI-генерация описания задач: Используйте /ai при создании задачи для автоматической генерации детального описания
  • Автоматический режим: Language Model API генерирует описание за 2-3 секунды
  • Интерактивный режим: Copilot Chat помогает детализировать задачу
  • Редактирование результата: Возможность скорректировать сгенерированное описание
• Автоматическая генерация при запуске задачи: Copilot автоматически запускается для каждой задачи в очереди
• Генерация кода: Отправка описания задачи в Copilot для автоматической генерации кода
• Контекстные запросы: Создание структурированных промптов на основе метаданных задачи
• Декомпозиция задач: Анализ и разбиение сложных задач на подзадачи с помощью AI
• Множественные запросы: Генерация кода для нескольких связанных задач
• Workflow автоматизация: Последовательная обработка всей очереди задач через Copilot

🚀 Начало работы

Установка

1. Откройте VS Code
2. Перейдите в раздел расширений (Ctrl+Shift+X)
3. Найдите "TaskFlow"
4. Нажмите "Установить"

Первые шаги

1. Инициализация: Откройте палитру команд (Ctrl+Shift+P) и выполните команду TaskFlow: Инициализировать задачи
2. Создание задачи: Используйте команду TaskFlow: Добавить новую задачу или кнопку "+" в боковой панели
   • 🤖 Новое! Используйте /ai для генерации описания через AI: /ai создать REST API
3. Просмотр задач: Откройте панель TaskFlow в Activity Bar (иконка списка задач)
4. Работа с задачами: Кликните правой кнопкой мыши на задаче для доступа к действиям
   • ✨ Новое! Кликните на задачу для открытия WebView редактора

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

Формат задач в Markdown

# Задачи

## Бэкенд

- [ ] Реализовать API авторизации [Высокий] Срок: 2025-12-31 @john
      Создать REST API для входа и регистрации пользователей

  - [ ] Создать модели данных
  - [ ] Реализовать endpoints
  - [ ] Добавить валидацию
  - [ ] Написать тесты

- [x] Настроить базу данных [Средний]
      Завершенная задача

## Фронтенд

- [ ] Создать форму входа [Высокий]
      Разработать UI компонент для аутентификации

Команды

Горячие клавиши

Вы можете настроить собственные горячие клавиши для команд TaskFlow в настройках VS Code.

⚙️ Настройки

Откройте настройки VS Code и найдите секцию "TaskFlow":

{
  "taskflow.tasksFile": ".github/.task_flow/tasks.md",
  "taskflow.autoSave": true,
  "taskflow.showCompletedTasks": true,
  "taskflow.defaultPriority": "Средний",
  "taskflow.copilotIntegration": true
}

Параметры конфигурации

• tasksFile: Имя файла для хранения задач (по умолчанию: tasks.md)
• autoSave: Автоматическое сохранение изменений (по умолчанию: true)
• showCompletedTasks: Показывать завершенные задачи в списке (по умолчанию: true)
• defaultPriority: Приоритет по умолчанию для новых задач (по умолчанию: Средний)
• copilotIntegration: Включить интеграцию с GitHub Copilot (по умолчанию: true)

🤖 Работа с GitHub Copilot

Генерация кода для задачи

1. Выберите задачу в боковой панели
2. Кликните правой кнопкой мыши
3. Выберите "Сгенерировать код с Copilot"
4. Промпт будет автоматически сформирован и отправлен в Copilot Chat

Структура промпта

TaskFlow автоматически создает структурированный промпт, включающий:

• Название и описание задачи
• Метаданные (приоритет, категория, срок)
• Список подзадач
• Инструкции для Copilot

Пример сгенерированного промпта:

# Задача: Реализовать API авторизации

## Описание
Создать REST API для входа и регистрации пользователей

## Метаданные
- Приоритет: Высокий
- Статус: ожидает
- Категория: Бэкенд
- Срок выполнения: 31.12.2025

## Подзадачи
- [ ] Создать модели данных
- [ ] Реализовать endpoints
- [ ] Добавить валидацию
- [ ] Написать тесты

## Инструкции
Пожалуйста, помоги мне реализовать эту задачу. Сгенерируй код с учетом контекста проекта, добавь комментарии и следуй лучшим практикам. Обрати внимание на подзадачи - они описывают шаги реализации.

👥 Командная работа

Работа с Git

1. Коммиты: Файл tasks.md можно коммитить в репозиторий
2. Синхронизация: Изменения автоматически синхронизируются между файлом и UI
3. Конфликты: TaskFlow обнаруживает изменения и обновляет интерфейс

Назначение задач

Используйте упоминания для назначения задач членам команды:

- [ ] Реализовать feature X @username

📈 Лучшие практики

Организация задач

1. Используйте категории: Группируйте задачи по модулям или функциональности
2. Устанавливайте приоритеты: Помечайте срочные задачи как "Высокий"
3. Добавляйте описания: Подробно описывайте требования
4. Создавайте подзадачи: Разбивайте сложные задачи на этапы
5. Указывайте сроки: Устанавливайте дедлайны для важных задач

Работа с Copilot

1. Четкие описания: Чем подробнее описание, тем лучше результат от Copilot
2. Контекст проекта: Упоминайте используемые технологии и фреймворки
3. Проверка кода: Всегда проверяйте код, сгенерированный AI
4. Итеративный подход: Используйте подзадачи для пошаговой генерации

🔧 Разработка

Требования

• Node.js >= 14.x
• VS Code >= 1.80.0
• TypeScript >= 5.1.6

Сборка из исходников

# Клонирование репозитория
git clone https://github.com/yourusername/taskflow.git
cd taskflow

# Установка зависимостей
npm install

# Компиляция
npm run compile

# Запуск в режиме разработки
npm run watch

Тестирование

npm run test

🐛 Известные проблемы

• Прямая отправка промптов в Copilot Chat может не работать в некоторых версиях VS Code (используется буфер обмена как fallback)
• Перетаскивание задач между категориями пока не реализовано

🗺️ Планы развития

• [ ] Поддержка множественных файлов tasks.md
• [ ] Drag & drop для переупорядочивания задач
• [ ] Интеграция с внешними трекерами задач (Jira, Trello)
• [ ] Аналитика и отчеты по задачам
• [ ] Поддержка тегов и меток
• [ ] Экспорт задач в различные форматы
• [ ] Напоминания и уведомления
• [ ] Поддержка Model Context Protocol (MCP)

🤝 Вклад в проект

Мы приветствуем вклад сообщества! Если вы хотите помочь:

1. Fork проекта
2. Создайте ветку для вашей функции (git checkout -b feature/AmazingFeature)
3. Закоммитьте изменения (git commit -m 'Add some AmazingFeature')
4. Push в ветку (git push origin feature/AmazingFeature)
5. Откройте Pull Request

📄 Лицензия

Этот проект распространяется под лицензией MIT. См. файл LICENSE для деталей.

� Дополнительная документация

• 📋 Руководство по работе с очередью задач
• 🚀 Быстрый старт
• 📖 Подробная документация
• 🏗️ Архитектура проекта

�💬 Поддержка

• 📧 Email: support@taskflow.dev
• 🐛 Баг-репорты: GitHub Issues
• 💡 Предложения: GitHub Discussions

🙏 Благодарности

• GitHub Copilot за вдохновение
• Сообщество VS Code за отличную экосистему расширений
• Всем контрибьюторам проекта

Сделано с ❤️ для разработчиков, использующих VS Code и GitHub Copilot