Task Master MCP

📋 任务主控MCP v2.2.1

MCP服务器，用于智能任务和规范管理。状态机、依赖图、人工智能指导和自动导出的规范生成。

📝 基本提示： pastebin.com/EJcJ3fJF

特性

• 规格 --要求→ 设计→ 任务工作流程
• 汽车出口 --在中创建的文件 .gofman3/specs/ 自动地
• 自动同步 — tasks.md 任务/子任务完成情况更新
• 子任务 --将任务分解为步骤（1.1、1.2、1.3），并跟踪完成情况
• 状态机 --严格的任务生命周期和验证
• 依赖图 --任务阻塞，直到deps完成
• AI教练 --WIP限制、过时警告、影响分析
• 检查点 — 🚩 任务流中的验证点
• 可选任务 — ⚡ 存在可选任务时的MVP提示

快速开始

npx @gofman3/task-master-mcp

MCP配置

{
  "mcpServers": {
    "task-master": {
      "command": "npx",
      "args": ["@gofman3/task-master-mcp"]
    }
  }
}

工具

task_spec

规范管理——优于Kiro规范。

行动： create, get, list, update, delete, generate_tasks, progress, export

⚠️ 关键： generate_tasks 需要 workspacePath!

// Create spec with subtasks
task_spec({
  action: 'create',
  name: 'Auth Module',
  requirements: [
    { id: 'REQ-1', userStory: 'As a user, I want to login', criteria: ['Email validation'] }
  ],
  taskTemplates: [
    { content: 'Design API', priority: 1, subtasks: ['Define endpoints', 'Create schemas'] },
    { content: 'Implement login', dependsOn: ['t1'], priority: 2 },
    { content: 'Write tests', dependsOn: ['t2'], optional: true }
  ]
})

// Generate tasks + auto-export to .gofman3/specs/
task_spec({ 
  action: 'generate_tasks', 
  specId: 'spec-xxx',
  workspacePath: 'F:/Projects/my-app'  // REQUIRED! Files created automatically
})

导出创建于 .gofman3/specs/{spec-name}/:

• requirements.md --用户故事+接受标准
• design.md --架构+组件+图表
• tasks.md --进度条+分组任务+子任务（自动同步！）
• context.md — #[[file:]] 自动加载参考

task_manage

任务CRUD和状态转换。

行动： add, update, delete, start, complete, complete_subtask, do, block, reopen, abandon

// Complete a subtask (0-based index)
task_manage({ action: 'complete_subtask', taskId: 'xxx', subtaskIndex: 0 })

// When all subtasks done → task auto-completes!

状态机：

todo → doing, abandoned
doing → todo, blocked, done, abandoned
blocked → todo, doing, abandoned
done → todo (reopen)

task_board

视觉任务板。

意见： kanban, list, priority, mermaid

task_bulk

使用tempId引用创建原子批处理。

task_recommend

人工智能支持下一个任务建议。

自动同步

当你完成一个任务或子任务时， tasks.md 如果满足以下条件，则会自动更新 workspacePath 在 generate_tasks.

# Tasks: Auth Module

## Progress: 1/3 (33%)

### ✅ Completed

- [x] 1. Design API
  - [x] 1.1 Define endpoints
  - [x] 1.2 Create schemas

### 📋 To Do

- [ ] 2. Implement login

许可证

麻省理工学院

______________________________________________________________________

🎯 如何使用（适用于人类）

简单的任务——告诉AI该做什么

You: "Fix bug in auth.ts line 42"
AI: *just does it, no extra steps*

复杂功能——全工作流

示例提示：

Working directory: C:/Projects/my-backend

1. Study folders src/auth/ and src/services/
2. use think_batch — analyze architecture and edge cases
3. use task_spec — create specification with tasks

Goal: "Implement JWT auth system with refresh tokens"

Requirements:
- Access token expires in 15 minutes
- Refresh token expires in 7 days
- Refresh token rotation on use
- Blacklist for revoked tokens

发生了什么：

1. AI研究项目代码
2. think_batch --思考边缘案例（如果代币被盗怎么办？轮换赛条件如何？）
3. task_spec --在中创建规范 .gofman3/specs/jwt-auth/:

   .gofman3/specs/jwt-auth/
   ├── requirements.md   ← what we're building (user stories)
   ├── design.md         ← how we're building (architecture)
   ├── tasks.md          ← progress tracking (auto-updates!)
   └── context.md        ← file references

追踪进度

Show task_board

┌─────────────┬─────────────┬─────────────┐
│    TODO     │   DOING     │   DONE      │
├─────────────┼─────────────┼─────────────┤
│ [P2] Tests  │ [P1] Token  │ [P1] Routes │
│             │   Service   │             │
└─────────────┴─────────────┴─────────────┘

接下来要做什么？

use task_recommend

AI告诉你选择哪个任务（按优先级+依赖关系）。

完成子任务

当处理带有子任务的任务时，它们会自动被勾选， tasks.md 更新：

- [x] 1. Setup routes
  - [x] 1.1 POST /login
  - [x] 1.2 POST /refresh  
  - [ ] 1.3 POST /logout    ← current