工作流
Claude Task Master
可放入 Cursor 等编码工具的 AI 任务管理系统,许可证未明确。
eyaltoledano/claude-task-master 是一套给编码工具用的 AI 任务管理,仓库提到可以放进 Cursor、Lovable、Windsurf、Roo 等环境。GitHub 没有给出明确的 SPDX 许可证。
先用一个小功能看它如何拆任务、如何回写进度,再用于真实迭代。任务文件会进入仓库的,注意不要把内部排期或客户名原样提交。许可证未明确时,商用要自行判断。
推荐来源:
- @beamnxw 在 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 是一套给编码工具用的 AI 任务管理,npm 包名是 task-master-ai,文档现在放在 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 为准。npm 包要求 Node.js 20 或更新。密钥只放在项目根目录 .env 或 MCP 配置的 env 里,不要写进对话或提交。
Claude Code
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。官方示例的形状如下,请删除你不用的密钥项,并换成真实值:
{
"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,官方建议重启编辑器并检查密钥。
命令行
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 如何拆任务。请在你有权修改的实验目录里做。本次没有实跑,因此不编造任务列表或模型输出。
- 确认 Node.js 为 20 或更新,并用上一节的 MCP 或
npm install -g task-master-ai完成安装。 - 在实验仓库运行
task-master init(或在编辑器里说Initialize taskmaster-ai in my project),按提示生成目录结构。 - 把一段短需求写进
.taskmaster/docs/prd.txt,只描述一个小功能,例如「给 README 增加一节安装说明,不要改其他文件」。不要写入客户名或内部排期。 - 在对话里发送:
Parse the PRD at .taskmaster/docs/prd.txt, then show me the first task only. Do not implement it yet. - 预期效果:项目里出现任务文件,助手能指出第一项任务和依赖,而不是直接改业务代码。请你自己打开任务文件核对拆分是否合理,再决定是否让它实现某一项。若命令无响应,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 和仓库里的 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 在本站记为 unspecified。LICENSE 文本为 MIT 加上 Commons Clause,以仓库文件为准。本文依据 2026-11-16 查阅的 README、LICENSE、安装文档 和 npm 页面,用自己的话写成,供 CQBase 上下文库使用。若命令有变,以官方文档为准;仓库已数月无推送,请自行验证。