AI导哈

AI任务管理服务

Task Crusader是一个专为AI编程助手设计的任务和项目管理服务，提供依赖跟踪、验收标准定义、测试策略记录等功能，支持顺序和并行执行。

  • by mcrescenzo
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 mcrescenzo/task-crusader-mcp

使用说明

任务十字军MCP

[！警告] 此项目不再维护。 我最初创建Task Crusader是为了解决跟踪人工智能辅助开发中长时间运行的任务和项目列表的问题。从那时起，大多数主要的人工智能编码代理都添加了强大的内置任务管理，这个项目在实践中不再特别有用。

您的AI编码助手的任务伙伴-通过MCP进行活动和任务管理。

概述

Task Crusader是一个为AI编码助手设计的战役和任务管理系统。它提供了一个模型上下文协议（MCP）服务器，使Claude、Cursor等AI代理能够将工作组织成活动（项目）和任务，包括：

  • 依赖追踪：任务可以依赖于其他任务
  • 验收标准：定义每项任务的完成要求
  • 测试策略：任务的文档验证方法
  • 研究与笔记：收集调查结果和实施细节
  • 进度监控：跟踪活动进度并找到可操作的任务
  • 质量提示：活动设置和执行的上下文感知指导
  • 顺序和并行执行：支持单代理和多代理工作流

安装

pip install task-crusader-mcp

默认情况下，Task Crusader会安装所有功能：

  • MCP服务器：人工智能助理的核心活动/任务管理（63个工具）
  • 命令行界面：命令行界面(crusader 命令）
  • 文本用户界面：终端用户界面(crusader-tui 命令）

需要最少安装的高级用户可以使用 pip install --no-deps task-crusader-mcp 并手动指定依赖关系。

快速开始

1.配置您的AI助手

添加到您的MCP客户端配置中（例如，Claude Desktop claude_desktop_config.json):

{
  "mcpServers": {
    "task-crusade": {
      "command": "crusader-mcp"
    }
  }
}

或光标(.cursor/mcp.json):

{
  "mcpServers": {
    "task-crusade": {
      "command": "crusader-mcp"
    }
  }
}

2.基本工作流程

  1. 创建活动：

    campaign_create(name="My Project")

  2. 添加任务：

    task_create(title="Implement feature", campaign_id="...")

  3. 添加验收标准：

    task_acceptance_criteria_add(task_id="...", content="Unit tests pass")

  4. 添加测试策略：

    task_testing_strategy_add(task_id="...", content="Run pytest with coverage")

  5. 执行任务循环：

    while campaign not complete:
    1. campaign_get_next_actionable_task(campaign_id) -> get next task
    2. task_update(task_id, status="in-progress") -> claim task
    3. [Implement the task]
    4. task_acceptance_criteria_mark_met(criteria_id) -> mark criteria met
    5. task_complete(task_id) -> complete task

3.批量活动创建（推荐）

对于新项目，请使用 campaign_create_with_tasks 以原子方式创建一切：

campaign_create_with_tasks(campaign_json='{
  "campaign": {"name": "Auth System", "priority": "high"},
  "tasks": [
    {"temp_id": "setup", "title": "Setup environment", "acceptance_criteria": ["Dev server runs"]},
    {"temp_id": "impl", "title": "Implement login", "dependencies": ["setup"]},
    {"temp_id": "test", "title": "Integration tests", "dependencies": ["impl"]}
  ]
}')

可用工具（共63个）

活动管理（21个工具）

类别 工具
核心CRUD campaign_create, campaign_list, campaign_show, campaign_update, campaign_delete
进展与行动 campaign_get_progress_summary, campaign_get_next_actionable_task, campaign_get_all_actionable_tasks, campaign_overview, campaign_details
批量和工作流 campaign_create_with_tasks, campaign_validate_readiness, campaign_workflow_guide, campaign_get_state_snapshot, campaign_renumber_tasks
研究 campaign_research_add, campaign_research_list, campaign_research_show, campaign_research_update, campaign_research_delete, campaign_research_reorder

任务管理（42个工具）

类别 工具
核心CRUD task_create, task_list, task_show, task_update, task_delete, task_complete
验收标准 task_acceptance_criteria_add, task_acceptance_criteria_mark_met, task_acceptance_criteria_mark_unmet, task_acceptance_criteria_list, task_acceptance_criteria_show, task_acceptance_criteria_update, task_acceptance_criteria_delete, task_acceptance_criteria_reorder
测试策略 task_testing_strategy_add, task_testing_strategy_list, task_testing_strategy_show, task_testing_strategy_update, task_testing_strategy_delete, task_testing_strategy_mark_passed, task_testing_strategy_mark_failed, task_testing_strategy_mark_skipped, task_testing_strategy_reorder, task_testing_step_add
研究 task_research_add, task_research_list, task_research_show, task_research_update, task_research_delete, task_research_reorder
实现注意事项 task_implementation_notes_add, task_implementation_notes_list, task_implementation_notes_show, task_implementation_notes_update, task_implementation_notes_delete, task_implementation_notes_reorder
搜索和分析 task_search, task_stats, task_get_dependency_info
批量和工作流 task_bulk_update, task_create_from_template, task_complete_with_workflow

命令行用法

# Create a campaign
crusader campaign create "My Project" --description "My awesome project"

# List campaigns
crusader campaign list

# Show campaign details
crusader campaign show <campaign-id>

# Create a task
crusader task create "Implement feature" --campaign <campaign-id>

# Show task details
crusader task show <task-id>

# Update task status
crusader task update <task-id> --status in-progress

TUI使用

crusader-tui

这将打开一个交互式终端界面，用于通过键盘导航、过滤和批量操作浏览活动和任务。

数据库

默认情况下，Task Crusader将数据存储在 ~/.crusader/database.db。您可以通过设置来配置自定义路径 CRUSADER_DB_PATH 环境变量。

建筑

任务十字军遵循干净的六边形架构：

MCP Server → Service Layer → Repository Layer → SQLite Database
                  ↓
            Domain Layer (DTOs, Result Types, Hints)

关键设计决策：

  • 直接服务电话：MCP工具直接调用服务（无CLI子流程开销）
  • 结果模式：所有操作返回 DomainResult 用于显式错误处理
  • 上下文感知提示：操作返回下一步操作的指导提示
  • 内存系统内部：验收标准、研究、笔记和测试步骤使用内部存储系统

贡献

欢迎投稿！在推送之前，请在本地运行CI检查：

./scripts/check_ci.sh

这运行：

  1. 用Linting ruff check src/ tests/
  2. 覆盖范围测试： pytest --cov --cov-fail-under=65
  3. 可选类型检查： mypy src/

看 贡献.md 详细指南。

许可证

MIT许可证-有关详细信息，请参阅许可证文件。

相关 MCP