speco-tasker

Speco Tasker

纯净的任务管理系统 | Pure Task Management System

专为 Cursor、Windsurf 等 AI 编辑器内置 Agent 优化的任务管理工具

Task management tool optimized for built-in Agents in AI editors like Cursor and Windsurf

基于 claude-task-master 二次开发，完全移除 AI 功能

✨ 核心功能 | Core Features

• 📋 任务管理 - 完整的任务 CRUD 操作，支持状态跟踪和子任务管理
• 🏷️ 多标签系统 - 按功能、分支、环境组织任务，支持跨标签移动
• 🔗 依赖管理 - 智能的任务依赖关系管理和循环检测
• 🛡️ 安全验证 - 先进的文件系统安全验证和路径保护
• ⚙️ 路径配置 - 动态路径映射和跨平台兼容性
• 📊 进度追踪 - 可视化进度显示和统计报告

📦 安装 | Installation

# 全局安装 CLI 工具
npm install -g speco-tasker

# 或本地安装
npm install speco-tasker

🔧 MCP 配置 | MCP Configuration

添加到 Cursor | Add to Cursor

由于 GitHub 会过滤非标准协议链接，请按以下步骤操作：

• 复制以下链接到浏览器地址栏：

  cursor://anysphere.cursor-deeplink/mcp/install?name=speco-tasker&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyJzcGVjby10YXNrZXIiXX0K
  

• 在浏览器中打开链接，Cursor 会自动处理安装

手动配置 | Manual Configuration

Cursor 用户 | Cursor Users

添加以下配置到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "speco-tasker": {
      "command": "npx",
      "args": ["speco-tasker"]
    }
  }
}

VS Code 用户 | VS Code Users

添加以下配置到 settings.json：

{
  "mcp.servers": {
    "speco-tasker": {
      "command": "npx",
      "args": ["speco-tasker"],
      "type": "stdio"
    }
  }
}

🎯 基础使用 | Basic Usage

# 初始化项目（自动检测配置）
speco-tasker init

# 查看任务列表
speco-tasker list

# 查看下一个任务
speco-tasker next

# 创建新任务
speco-tasker add-task --title "功能名称" --description "功能描述" --details "实现细节" --test-strategy "测试策略" --spec-files "docs/spec.md"

# 更新任务状态
speco-tasker set-status --id=1 --status=done

# 管理标签
speco-tasker add-tag feature-branch
speco-tasker use-tag feature-branch

# 跨标签移动任务
speco-tasker move --from=1 --from-tag=main --to-tag=feature-branch

📚 文档 | Documentation

• 📖 安装指南 - 详细安装和配置说明
• 📋 命令参考 - 完整 CLI 和 MCP 工具参考
• 📚 使用教程 - 开发工作流程教程
• 🔄 跨标签移动 - 跨标签任务移动指南

📄 许可证 | License

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。