Task Master

[TOC]

Task Master 是一个基于 Claude 的 AI 驱动开发任务管理系统,可与 Cursor AI、Windsurf、Lovable、Roo 等最新开发环境无缝集成,从而提升开发效率。

概述#

Task Master 是一款能够自动根据项目需求文档(PRD)生成任务,并系统化地管理每个开发阶段的创新工具。该项目在 GitHub 上拥有 14.2k Star 与 1.5k Fork,持续保持活跃开发。

主要特性#

MCP(Model Control Protocol)支持#

  • 可直接从各类编辑器运行 Task Master
  • 支持 Cursor、Windsurf、VS Code
  • 可按项目或全局进行配置

多样化 AI 模型支持#

Task Master 支持以下 AI 提供商,并可自由设定主模型、研究模型及备用模型:

  • Anthropic API(Claude)
  • OpenAI API
  • Google Gemini API
  • Perplexity API(推荐用于研究模型)
  • xAI API
  • OpenRouter API
  • Azure OpenAI
  • Mistral API
  • Ollama API

自动任务生成功能#

  • 解析 PRD,自动生成可实施的任务
  • 自动设置任务优先级与依赖关系
  • 每个任务都附带详细的实现指南

设置方法#

选项 1:MCP 配置(推荐)#

1. 创建 MCP 配置文件#

根据所用编辑器,将配置文件放置到以下路径:

编辑器 作用域 路径(Linux/macOS) 路径(Windows)
Cursor 全局 ~/.cursor/mcp.json %USERPROFILE%\\.cursor\\mcp.json
Windsurf 全局 ~/.codeium/windsurf/mcp_config.json %USERPROFILE%\\.codeium\\windsurf\\mcp_config.json
VS Code 项目 <project_folder>/.vscode/mcp.json <project_folder>\\.vscode\\mcp.json

2. 配置示例(Cursor & Windsurf)#

{
  "mcpServers": {
    "taskmaster-ai": {
      "command": "npx",
      "args": ["-y", "--package=task-master-ai", "task-master-ai"],
      "env": {
        "ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY_HERE",
        "PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY_HERE",
        "OPENAI_API_KEY": "YOUR_OPENAI_KEY_HERE"
      }
    }
  }
}

3. 项目初始化#

在编辑器的 AI 聊天框中运行:

Initialize taskmaster-ai in my project

选项 2:命令行使用#

# 全局安装
npm install -g task-master-ai

# 项目初始化
task-master init

# 解析 PRD 并生成任务
task-master parse-prd your-prd.txt

# 列出所有任务
task-master list

# 显示下一个任务
task-master next

使用方法#

准备 PRD(项目需求文档)#

为最大化 Task Master 效果,需准备详细的 PRD:

  • 新项目:放置于 .taskmaster/docs/prd.txt
  • 已有项目:使用 scripts/prd.txt 或运行 task-master migrate 迁移
  • 示例:模板位于 .taskmaster/templates/example_prd.txt

常用命令#

与 AI 助手的交互示例:

# 解析 PRD
"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 help me expand task 4?"

# 创建独立任务(无需 PRD)
"Can you help me implement [description of what you want to do]?"

项目结构#

Task Master 以如下目录结构管理项目:

.taskmaster/
├── docs/
│   └── prd.txt          # 项目需求文档
├── tasks/
│   ├── task-001.md      # 生成的任务
│   └── task-002.md
└── templates/
    └── example_prd.txt  # PRD 模板

许可证#

Task Master 采用 MIT License with Commons Clause:

允许:

  • 个人、商业、学术用途
  • 修改代码
  • 分发
  • 使用 Task Master 创建并销售产品

禁止:

  • 销售 Task Master 本身
  • 提供 Task Master 的托管服务
  • 基于 Task Master 创建竞争产品

社区与支持#

  • GitHub Stars:14.2k
  • Forks:1.5k
  • Contributors:21 位开发者贡献
  • Discord社区频道
  • NPM:活跃下载量

总结#

Task Master 是一款面向现代 AI 驱动开发的综合任务管理系统,可自动从 PRD 生成任务,并通过与多家 AI 提供商集成显著提升开发效率。支持 MCP 使其可直接在常用开发环境中使用,极具便利性。