# Claude Task Master

Canonical: https://cqbase.net/zh/entry/claude-task-master
Chinese: https://cqbase.net/zh/entry/claude-task-master
English: https://cqbase.net/en/entry/claude-task-master

> 可放入 Cursor 等编码工具的 AI 任务管理系统，许可证未明确。

eyaltoledano/claude-task-master 是一套给编码工具用的 AI 任务管理，仓库提到可以放进 Cursor、Lovable、Windsurf、Roo 等环境。GitHub 没有给出明确的 SPDX 许可证。

先用一个小功能看它如何拆任务、如何回写进度，再用于真实迭代。任务文件会进入仓库的，注意不要把内部排期或客户名原样提交。许可证未明确时，商用要自行判断。

推荐来源：

- [@beamnxw](https://x.com/beamnxw/status/2099797510080360913) 在 2026 年 9 月 15 日 的帖子里提到了这个项目（数字采集于 2026 年 11 月 15 日：633 次喜欢，105 次转发）。

注意（核验日期 2026-11-15）：仓库未归档。README 未见项目级废弃声明（文中出现的 migrate 是任务迁移命令）。最近推送停在 2026-04-28 21:27 Asia/Shanghai，约 6.5 个月。本次未能确认它是否仍兼容当前的 Claude Code。

## 解决什么问题

[eyaltoledano/claude-task-master](https://github.com/eyaltoledano/claude-task-master) 是一套给编码工具用的 AI 任务管理，npm 包名是 `task-master-ai`，文档现在放在 [tryhamster.com/docs/taskmaster](https://tryhamster.com/docs/taskmaster)。它把需求拆成任务、记录依赖和进度，并可以通过 MCP 或 CLI 放进 Cursor、Claude Code、Windsurf、VS Code 等环境。仓库介绍里还提到 Lovable、Roo 等工具。

它管理的是任务文件和工作流，并不替代编码模型本身。拆任务、扩写子任务、查询下一步都会调用你配置的模型，因此通常需要对应供应商的 API 密钥。官方也提供通过已安装的 Claude Code CLI、以 `claude-code/sonnet` 这类名称调用的路径，不必再单独准备 Anthropic API 密钥。

## 适合谁

适合已经在用 Cursor 或 Claude Code，希望把较大功能拆成可跟踪任务，而不是只在对话里口头排期的人。CLI 适合喜欢在终端里初始化项目、查看任务列表的人；MCP 适合希望直接在编辑器对话里说「解析我的 PRD」或「实现任务 3」的人。

请先用一个小功能看它如何拆任务、如何把进度写回文件，再用于真实迭代。任务文件会进入仓库，不要把内部排期或客户名原样提交。本站将许可证记为 unspecified，因为 GitHub 没有明确的 SPDX 标识；LICENSE 实际是 MIT 加上 Commons Clause，商用或再分发前请自己阅读，见文末「来源与许可」。

核验当天先看维护状况：仓库未归档，README 未见项目级废弃声明（`migrate` 是任务迁移命令）。最近推送停在 2026-04-28 21:27（Asia/Shanghai），约 6.5 个月；npm 上 0.43.1 发布于 2026-03-31。本次未能确认它是否仍兼容当前的 Claude Code 或 Cursor。文档站点当天仍可打开。

## 怎么装

核验日期为 2026-11-16（Asia/Shanghai）。命令以仓库 README 和官方 [Installation](https://tryhamster.com/docs/taskmaster/getting-started/quick-start/installation) 为准。npm 包要求 Node.js 20 或更新。密钥只放在项目根目录 `.env` 或 MCP 配置的 `env` 里，不要写进对话或提交。

**Claude Code**

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

加上密钥后，在对话里初始化，例如：`Initialize taskmaster-ai in my project`。若走 Claude Code 且不再单独配置 Anthropic API 密钥，官方示例是把主模型改成 `claude-code/sonnet`。

**Cursor**

把 MCP 配置写进 `~/.cursor/mcp.json` 或项目内 `.cursor/mcp.json`。官方示例的形状如下，请删除你不用的密钥项，并换成真实值：

```json
{
  "mcpServers": {
    "taskmaster-ai": {
      "command": "npx",
      "args": ["-y", "task-master-ai"],
      "env": {
        "ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY_HERE"
      }
    }
  }
}
```

README 还提供 Cursor 1.0+ 的一键安装链接，装完后仍要把占位密钥换成自己的。若 MCP 设置里显示 `0 tools enabled`，官方建议重启编辑器并检查密钥。

**命令行**

```bash
npm install -g task-master-ai
task-master init
```

只在当前项目安装时，用 `npm install task-master-ai`，再执行 `npx task-master init`。官方还支持 `task-master init --rules cursor,windsurf,vscode` 来写入对应规则文件。

初始化后，复杂项目建议先准备 PRD。新项目用 `.taskmaster/docs/prd.txt`；已有项目可用 `scripts/prd.txt`，或按文档执行 `task-master migrate`。示例模板在 `.taskmaster/templates/example_prd.txt`。

## 一个实际例子

下面用一份很短的、你自己写的 PRD，看 Task Master 如何拆任务。请在你有权修改的实验目录里做。本次没有实跑，因此不编造任务列表或模型输出。

1. 确认 Node.js 为 20 或更新，并用上一节的 MCP 或 `npm install -g task-master-ai` 完成安装。
2. 在实验仓库运行 `task-master init`（或在编辑器里说 `Initialize taskmaster-ai in my project`），按提示生成目录结构。
3. 把一段短需求写进 `.taskmaster/docs/prd.txt`，只描述一个小功能，例如「给 README 增加一节安装说明，不要改其他文件」。不要写入客户名或内部排期。
4. 在对话里发送：`Parse the PRD at .taskmaster/docs/prd.txt, then show me the first task only. Do not implement it yet.`
5. 预期效果：项目里出现任务文件，助手能指出第一项任务和依赖，而不是直接改业务代码。请你自己打开任务文件核对拆分是否合理，再决定是否让它实现某一项。若命令无响应，README 的故障排除是改用 `node node_modules/claude-task-master/scripts/init.js`，或以仓库里的 `node scripts/init.js` 初始化。

## 常见坑

- 未先核对维护窗口就接到日常仓库。最近推送停在 2026-04-28，README 例子仍出现 Claude 3.7，不能证明与当前客户端完全兼容。
- 把许可证当成标准 MIT。LICENSE 在 MIT 文本之后附加了 Commons Clause，限制出售该软件本身或把它作为托管服务提供。GitHub 将其显示为 Other / NOASSERTION，本站记为 unspecified。
- 把 API 密钥写进一键安装后的配置并提交。占位符必须换成环境中的真实密钥，且不要入库。
- 把 `task-master migrate` 理解成项目废弃声明。它是任务文件的迁移命令。
- 让任务文件带上真实客户名、未公开排期或其他内部信息后再提交。
- 在对话里直接要求「实现全部任务」，却不先查看拆分结果和依赖。官方建议先有较详细的 PRD，再逐项实现。

## FAQ

### 这个项目还在维护吗？

仓库未归档，也没有项目级停更声明，但到 2026-11-16 为止，最近推送已过去约 6.5 个月，npm 的 0.43.1 发布于 2026-03-31。文档站点当天仍可访问。本文不能证明它与当前 Claude Code 或 Cursor 完全兼容，接入前请先在小项目里验证。

### 可以商用吗？

本站把许可证记为 unspecified。LICENSE 的实际文本是 MIT 加上 Commons Clause：官方 README 写明可以在个人或商业项目中使用，但不能出售 Task Master 本身，也不能把它作为托管服务或基于它的竞品来提供。请阅读 [LICENSE](https://github.com/eyaltoledano/claude-task-master/blob/main/LICENSE) 和仓库里的 licensing 说明后自行判断。

### 没有 Anthropic API 密钥也能用吗？

如果已经安装 Claude Code CLI，官方写明可以用 `claude-code/opus` 或 `claude-code/sonnet`，不必再单独准备 Anthropic API 密钥。使用其他供应商时，仍要把对应密钥放在 `.env` 或 MCP 的 `env` 里。本次没有验证这条 Claude Code 路径在当前版本上是否仍然有效。

### MCP 和 CLI 必须一起装吗？

不是。官方把 MCP 列为推荐路径，CLI 是另一选项。你可以只用其中一种。初始化方式不同，但任务文件都在项目目录里。

### `migrate` 是不是说明项目已经停止？

不是。条目和 README 里的 `migrate` 指任务迁移命令，例如把旧路径上的 PRD 迁到新的目录结构。它不是停用声明。

## 来源与许可

仓库 [eyaltoledano/claude-task-master](https://github.com/eyaltoledano/claude-task-master) 在本站记为 unspecified。LICENSE 文本为 MIT 加上 Commons Clause，以仓库文件为准。本文依据 2026-11-16 查阅的 README、LICENSE、[安装文档](https://tryhamster.com/docs/taskmaster/getting-started/quick-start/installation) 和 npm 页面，用自己的话写成，供 CQBase 上下文库使用。若命令有变，以官方文档为准；仓库已数月无推送，请自行验证。

## 收录信息

- 作者: eyaltoledano
- 许可证: 未明确
- 来源: https://github.com/eyaltoledano/claude-task-master
- 收录: 2026-11-15
- GitHub 星标: 28360（采集 2026-11-15）

