Task Master AI

Taskmaster: Система управления задачами для ИИ-управляемой разработки, разработанная для бесшовной работы с любым ИИ-чатом.

| Документация

От @eyaltoledano и @RalphEcom

Система управления задачами для ИИ-управляемой разработки с Claude, разработанная для бесшовной работы с Cursor AI.

Документация

📚 Просмотреть полную документацию

Быстрые ссылки

• Руководство по быстрому старту
• Установка
• API-ключи и провайдеры
• Поддерживаемые редакторы
• Справочник инструментов MCP
• Справочник команд CLI
• Структура задач
• Зависимости задач
• Теги и рабочие потоки
• Команда исследования
• Команда цикла
• Обзор ИИ-провайдеров
• Командная работа
• Лучшие практики
• Часто задаваемые вопросы
• История изменений

Ещё от Hamster

• Hamster Studio
• Методы разработки продукции и инженерии
• Навыки разработки продукции и инженерии
• Тарифы Hamster

Быстрая установка для Cursor 1.0+ (Один клик)

Примечание: После нажатия на ссылку вам всё равно нужно будет добавить свои API-ключи в конфигурацию. Ссылка устанавливает сервер MCP с ключами-заглушками, которые необходимо заменить на ваши реальные API-ключи.

Быстрая установка для Claude Code

Для пользователей Claude Code:

claude mcp add taskmaster-ai -- npx -y task-master-ai

Не забудьте добавить свои API-ключи в конфигурацию: - в корневой файл .env вашего проекта - в разделе "env" конфигурации mcp для taskmaster-ai

Требования

Taskmaster использует ИИ в нескольких командах, и для них требуется отдельный API-ключ. Вы можете использовать различные модели от разных ИИ-провайдеров, при условии добавления ваших API-ключей. Например, если вы хотите использовать Claude 3.7, вам понадобится API-ключ Anthropic.

Вы можете определить 3 типа моделей для использования: основная модель, модель для исследований и резервная модель (на случай, если основная или модель для исследований не сработает). Какую бы модель вы ни использовали, её API-ключ провайдера должен присутствовать в mcp.json или .env.

Требуется хотя бы один (1) из следующих ключей:

• API-ключ Anthropic (API Claude)
• API-ключ OpenAI
• API-ключ Google Gemini
• API-ключ Perplexity (для модели для исследований)
• API-ключ xAI (для модели для исследований или основной модели)
• API-ключ OpenRouter (для модели для исследований или основной модели)
• Claude Code (API-ключ не требуется — требуется CLI Claude Code)
• Codex CLI (OAuth через подписку ChatGPT — требуется CLI Codex)

Использование модели для исследований является необязательным, но настоятельно рекомендуется. Вам понадобится хотя бы один API-ключ (если вы не используете Claude Code или Codex CLI с OAuth). Добавление всех API-ключей позволяет вам беспрепятственно переключаться между провайдерами моделей по желанию.

Быстрый старт

Вариант 1: MCP (Рекомендуется)

MCP (Model Control Protocol) позволяет запускать Task Master прямо из вашего редактора.

1. Добавьте конфигурацию MCP по указанному пути в зависимости от вашего редактора

Ручная настройка

Cursor, Windsurf и Q Developer CLI (mcpServers)

{
  "mcpServers": {
    "task-master-ai": {
      "command": "npx",
      "args": ["-y", "task-master-ai"],
      "env": {
        // "TASK_MASTER_TOOLS": "all", // Options: "all", "standard", "core", or comma-separated list of tools
        "ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY_HERE",
        "PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY_HERE",
        "OPENAI_API_KEY": "YOUR_OPENAI_KEY_HERE",
        "GOOGLE_API_KEY": "YOUR_GOOGLE_KEY_HERE",
        "MISTRAL_API_KEY": "YOUR_MISTRAL_KEY_HERE",
        "GROQ_API_KEY": "YOUR_GROQ_KEY_HERE",
        "OPENROUTER_API_KEY": "YOUR_OPENROUTER_KEY_HERE",
        "XAI_API_KEY": "YOUR_XAI_KEY_HERE",
        "AZURE_OPENAI_API_KEY": "YOUR_AZURE_KEY_HERE",
        "OLLAMA_API_KEY": "YOUR_OLLAMA_API_KEY_HERE"
      }
    }
  }
}

🔑 Замените YOUR_…_KEY_HERE на ваши настоящие API-ключи. Вы можете удалить ключи, которыми не пользуетесь.

Примечание: Если вы видите 0 tools enabled в настройках MCP, перезапустите редактор и убедитесь, что API-ключи настроены правильно.

VS Code (servers + type)

{
  "servers": {
    "task-master-ai": {
      "command": "npx",
      "args": ["-y", "task-master-ai"],
      "env": {
        // "TASK_MASTER_TOOLS": "all", // Options: "all", "standard", "core", or comma-separated list of tools
        "ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY_HERE",
        "PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY_HERE",
        "OPENAI_API_KEY": "YOUR_OPENAI_KEY_HERE",
        "GOOGLE_API_KEY": "YOUR_GOOGLE_KEY_HERE",
        "MISTRAL_API_KEY": "YOUR_MISTRAL_KEY_HERE",
        "GROQ_API_KEY": "YOUR_GROQ_KEY_HERE",
        "OPENROUTER_API_KEY": "YOUR_OPENROUTER_KEY_HERE",
        "XAI_API_KEY": "YOUR_XAI_KEY_HERE",
        "AZURE_OPENAI_API_KEY": "YOUR_AZURE_KEY_HERE",
        "OLLAMA_API_KEY": "YOUR_OLLAMA_API_KEY_HERE"
      },
      "type": "stdio"
    }
  }
}

🔑 Замените YOUR_…_KEY_HERE на ваши настоящие API-ключи. Вы можете удалить ключи, которыми не пользуетесь.

2. (Только для Cursor) Включите Taskmaster MCP

Откройте Настройки Cursor (Ctrl+Shift+J) ➡ Нажмите на вкладку MCP слева ➡ Включите task-master-ai с помощью переключателя

3. (Опционально) Настройте модели, которые хотите использовать

В панели ИИ-чата вашего редактора введите:

Change the main, research and fallback models to <model_name>, <model_name> and <model_name> respectively.

Например, чтобы использовать Claude Code (не требуется API-ключ):

Change the main model to claude-code/sonnet

Таблица доступных моделей | Настройка Claude Code

4. Инициализируйте Task Master

В панели ИИ-чата вашего редактора введите:

Initialize taskmaster-ai in my project

5. Убедитесь, что у вас есть PRD (Рекомендуется)

Для новых проектов: создайте ваш PRD в .taskmaster/docs/prd.txt. Для существующих проектов: вы можете использовать scripts/prd.txt или выполнить миграцию с помощью task-master migrate.

Шаблон PRD доступен после инициализации в .taskmaster/templates/example_prd.txt.

[!NOTE] Хотя PRD рекомендуется для сложных проектов, вы всегда можете создавать отдельные задачи, написав в чате «Помоги мне реализовать [описание того, что вы хотите сделать]?».

Всегда начинайте с подробного PRD.

Чем подробнее ваш PRD, тем лучше будут сгенерированные задачи.

6. Основные команды

Используйте вашего ИИ-ассистента для:

• Разбора требований: Can you parse my PRD at scripts/prd.txt?
• Планирования следующего шага: What's the next task I should work on?
• Реализации задачи: Can you help me implement task 3?
• Просмотра нескольких задач: Can you show me tasks 1, 3, and 5?
• Расширения задачи: Can you help me expand task 4?
• Исследования свежей информации: Research the latest best practices for implementing JWT authentication with Node.js
• Исследования с контекстом: Research React Query v5 migration strategies for our current API implementation in src/api.js

Больше примеров использования Task Master в чате

Вариант 2: Использование командной строки

Установка

# Install globally
npm install -g task-master-ai

# OR install locally within your project
npm install task-master-ai

Инициализация нового проекта

# If installed globally
task-master init

# If installed locally
npx task-master init

# Initialize project with specific rules
task-master init --rules cursor,windsurf,vscode

Приложение запросит у вас данные проекта и создаст новый проект с необходимыми файлами и структурой.

Основные команды

# Initialize a new project
task-master init

# Parse a PRD and generate tasks
task-master parse-prd your-prd.txt

# List all tasks
task-master list

# Show the next task to work on
task-master next

# Show specific task(s) - supports comma-separated IDs
task-master show 1,3,5

# Research fresh information with project context
task-master research "What are the latest best practices for JWT authentication?"

# Move tasks between tags (cross-tag movement)
task-master move --from=5 --from-tag=backlog --to-tag=in-progress
task-master move --from=5,6,7 --from-tag=backlog --to-tag=done --with-dependencies
task-master move --from=5 --from-tag=backlog --to-tag=in-progress --ignore-dependencies

# Add rules after initialization
task-master rules add windsurf,roo,vscode

Конфигурация загрузки инструментов

Оптимизация загрузки MCP-инструментов

MCP-сервер Task Master поддерживает выборочную загрузку инструментов для уменьшения использования окна контекста. По умолчанию загружаются все 36 инструментов (~21 000 токенов) для обеспечения обратной совместимости с существующими установками.

Вы можете оптимизировать производительность, настроив переменную окружения TASK_MASTER_TOOLS:

Доступные режимы

Методы конфигурации

Метод 1: Переменная окружения в конфигурации MCP

Добавьте TASK_MASTER_TOOLS в раздел env вашего конфигурационного файла MCP:

{
  "mcpServers": {  // or "servers" for VS Code
    "task-master-ai": {
      "command": "npx",
      "args": ["-y", "task-master-ai"],
      "env": {
        "TASK_MASTER_TOOLS": "standard",  // Options: "all", "standard", "core", "lean", or comma-separated list
        "ANTHROPIC_API_KEY": "your-key-here",
        // ... other API keys
      }
    }
  }
}

Метод 2: Claude Code CLI (настройка на один раз)

Для пользователей Claude Code вы можете задать режим при установке:

# Core mode example (~70% token reduction)
claude mcp add task-master-ai --scope user \
  --env TASK_MASTER_TOOLS="core" \
  -- npx -y task-master-ai@latest

# Custom tools example
claude mcp add task-master-ai --scope user \
  --env TASK_MASTER_TOOLS="get_tasks,next_task,set_task_status" \
  -- npx -y task-master-ai@latest

Подробности наборов инструментов

Основные инструменты (7): get_tasks, next_task, get_task, set_task_status, update_subtask, parse_prd, expand_task

Стандартные инструменты (15): Все основные инструменты плюс initialize_project, analyze_project_complexity, expand_all, add_subtask, remove_task, generate, add_task, complexity_report

Все инструменты (36): Полный набор, включая настройку проекта, управление задачами, анализ, зависимости, теги, исследования и многое другое

Рекомендации

• Новые пользователи: Начните со стандартного режима для хорошего баланса возможностей.
• Крупные проекты: Используйте базовый режим для минимизации использования токенов.
• Сложные рабочие процессы: Используйте полный режим или настраиваемый выбор.
• Обратная совместимость: Если режим не указан, по умолчанию используется полный режим.

Поддержка Claude Code

Task Master теперь поддерживает модели Claude через CLI Claude Code, который не требует API-ключа:

• Модели: claude-code/opus и claude-code/sonnet
• Требования: Установленный Claude Code CLI
• Преимущества: Не нужен API-ключ, используется ваша локальная инстанция Claude.

Подробнее о настройке Claude Code

Устранение неполадок

Если команда task-master init не отвечает

Попробуйте запустить её напрямую через Node:

node node_modules/claude-task-master/scripts/init.js

Или клонируйте репозиторий и запустите:

git clone https://github.com/eyaltoledano/claude-task-master.git
cd claude-task-master
node scripts/init.js

Присоединяйтесь к нашей команде

Участники проекта

История звёзд

Лицензирование

Task Master распространяется под лицензией MIT с Commons Clause. Это означает, что вы можете:

✅ Разрешено:

• Использовать Task Master в любых целях (личные, коммерческие, академические).
• Изменять код.
• Распространять копии.
• Создавать и продавать продукты, построенные с использованием Task Master.

❌ Запрещено:

• Продавать сам Task Master.
• Предлагать Task Master в качестве хостинговой услуги.
• Создавать конкурирующие продукты на основе Task Master.

Смотрите файл ЛИЦЕНЗИЯ для полного текста лицензии и информацию о деталях лицензирования для дополнительной информации.