speco-tasker
v1.2.4
Published
Pure Task Management System optimized for built-in Agents in AI editors like Cursor and Windsurf
Readme
✨ 核心功能 | 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
📄 许可证 | License
本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。
