项目简介

Task Master 是一个专为AI驱动的软件开发工作流设计的任务管理命令行工具。它帮助开发者和AI（如Claude通过Cursor AI）共同管理开发任务，将高层次的需求文档（PRD）转化为结构化的、可执行的任务列表，并支持任务的分解、状态跟踪、依赖管理和复杂性分析。通过MCP协议，Task Master 能与兼容的LLM客户端（如Cursor AI）深度集成，允许AI直接访问和操作任务数据，从而实现更智能、上下文感知的协助。

主要功能点

• 从产品需求文档（PRD）自动生成结构化的任务列表。
• 列出、显示和管理任务及其子任务。
• 根据依赖关系和优先级推荐下一个待办任务。
• 更新任务内容和状态，标记任务完成。
• 将复杂任务分解为更小的子任务，支持AI辅助分解。
• 分析任务复杂性并生成报告。
• 管理任务间的依赖关系。
• 支持AI根据指令修改或重新规划后续任务。
• 生成单独的任务文件以便于参考。

安装步骤

通过 npm 包管理器安装 Task Master：

# 全局安装，可在任何目录使用 task-master 命令
npm install -g task-master-ai

# 或者在项目本地安装
npm install task-master-ai

安装后，在项目根目录运行初始化命令：

# 如果是全局安装
task-master init

# 如果是本地安装
npx task-master-init

这将引导您设置项目并创建必要的配置文件（如 'tasks.json'）。

服务器配置（面向MCP客户端）

Task Master 作为 MCP 服务器运行时，通常由 MCP 客户端 (如 Cursor AI) 通过命令行启动。您需要在您的 MCP 客户端配置中添加一个新的 MCP 服务器，类型选择 "Command"，并指定启动 Task Master MCP 服务器的命令。

在您的 MCP 客户端（例如 Cursor AI 的 MCP 设置界面）中，配置一个新的服务器连接，填写以下信息：

• Name (名称): Task Master
• Type (类型): Command (表示客户端将通过执行命令行程序来与服务器通信)
• Command (命令): 'npx' (这是 Node.js 包执行器，用于运行本地或远程安装的 npm 包中的命令)
• Args (参数): '-y task-master-mcp' (这是一组参数，告诉 'npx' 运行 'task-master-mcp' 这个命令，'-y' 参数表示自动确认安装。'task-master-mcp' 是 Task Master 包中专门用于 MCP 模式的命令)

完成配置后，您的 MCP 客户端就能通过执行 'npx -y task-master-mcp' 命令来启动 Task Master 的 MCP 服务器实例，并与其建立通信。

基本使用方法

初始化项目后，您可以将产品需求文档（PRD，通常为'.txt'文件）放在项目目录中，然后使用以下命令解析它以生成初始任务列表：

task-master parse-prd path/to/your/prd.txt

生成任务后，您可以使用以下命令查看任务列表或找到下一个待办任务：

task-master list
task-master next

通过 MCP 客户端集成，您可以直接在 LLM 助手中通过自然语言指示 Task Master 执行这些命令，例如："Please use the task-master parse-prd command to generate tasks from my PRD file." AI 助手会通过 MCP 协议调用 Task Master 的相应功能。