Task Orchestrator

🚀 任務編排器

任務編排器是一個用於任務編排和管理的模型上下文協議（MCP）服務器。該工具可將目標分解為可管理的任務，並跟蹤其進度。

🚀 快速開始

理想情況下，大語言模型（LLM）應該能夠理解何時使用此MCP工具。作為示例提示，類似以下內容可能會起作用：

"為我創建一個新的開發目標。目標是'實現用戶認證'，該目標適用於'my-web-app'倉庫。"

如果您遇到任何問題，請在頂部的“討論”標籤中創建一個新問題告知我們。

✨ 主要特性

• 創建和管理目標
• 將目標分解為層次化任務
• 跟蹤任務完成狀態
• 支持子任務以及父任務與子任務之間的依賴管理
• 使用LokiDB進行持久化存儲

📋 路線圖

• 複雜任務/目標相互依賴編排
• 目標刪除
• 完成處置
• 用於可視化進度的用戶界面

📚 詳細文檔

任務ID命名約定

任務ID使用點符號表示法（例如，"1"、"1.1"、"1.1.1"），其中每個段表示層次結構中的一個級別。

• 對於每個新目標，頂級任務ID從"1"開始並按順序遞增（例如，"1"、"2"、"3"）。
• 子任務的ID是在其父任務ID後面追加一個新段形成的（例如，"1.1"是"1"的子任務）。
• goalId和taskId的組合保證是唯一的。

工具

服務器提供以下工具（基於build/index.js）：

1. create_goal

   • 創建一個新目標
   • 參數：

     {
       description: string;  // 目標描述
       repoName: string;     // 與此目標關聯的倉庫名稱
     }
     

   • 示例輸入：

     {
       "description": "實現用戶認證",
       "repoName": "example/auth-service"
     }
     

   • 返回值：{ goalId: number }

2. add_tasks

   • 向目標添加多個任務。任務可以以層次結構的形式提供。對於現有任務的子任務，請使用parentId字段。該操作是事務性的：要麼批次中的所有任務都成功，要麼整個操作失敗。
   • 參數：

     {
       goalId: number; // 要添加任務的目標ID
       tasks: Array<{
         title: string; // 任務標題
         description: string; // 任務詳細描述
         parentId?: string | null; // 可選的父任務ID，用於現有任務的子任務。對於在此批次中以層次結構定義的新子任務，請勿使用。
         subtasks?: Array<any>; // 要在此任務下創建的嵌套子任務對象數組。
       }>;
     }
     

   • 示例輸入：

     {
       "goalId": 1,
       "tasks": [
         {
           "title": "設計數據庫架構",
           "description": "定義用戶、角色和權限的表",
           "subtasks": [
             {
               "title": "創建實體關係圖",
               "description": "繪製實體關係圖"
             }
           ]
         },
         {
           "title": "實現用戶註冊",
           "description": "創建新用戶註冊的API端點",
           "parentId": "1"
         }
       ]
     }
     

   • 返回值：HierarchicalTaskResponse[]。HierarchicalTaskResponse對象是簡化的，不包括createdAt、updatedAt或parentId。

3. remove_tasks

   • 從目標中軟刪除多個任務。任務被標記為已刪除，但仍保留在系統中。默認情況下，如果父任務有子任務，則在未明確刪除其子任務的情況下，不能軟刪除該父任務。軟刪除的任務默認從get_tasks結果中排除，除非includeDeletedTasks設置為true。
   • 參數：

     {
       goalId: number; // 要刪除任務的目標ID
       taskIds: string[]; // 要刪除的任務ID（字符串數組）。任務ID使用點符號表示法（例如，"1"、"1.1"）。
       deleteChildren?: boolean; // 是否與父任務一起刪除子任務（布爾值）。默認為`false`。如果為`false`，嘗試刪除有現有子任務的父任務將拋出錯誤。
     }
     

   • 示例輸入（不刪除子任務）：

     {
       "goalId": 1,
       "taskIds": ["2", "3"]
     }
     

   • 示例輸入（刪除子任務）：

     {
       "goalId": 1,
       "taskIds": ["1"],
       "deleteChildren": true
     }
     

   • 返回值：{ removedTasks: TaskResponse[], completedParents: TaskResponse[] }。TaskResponse對象是簡化的，不包括createdAt、updatedAt或parentId。

4. get_tasks

   • 獲取目標的任務。任務ID使用點符號表示法（例如，"1"、"1.1"、"1.1.1"）。當指定includeSubtasks時，響應將返回層次化任務對象。否則，將返回不包括createdAt、updatedAt或parentId的簡化任務對象。
   • 參數：

     {
       goalId: number; // 要獲取任務的目標ID
       taskIds?: string[]; // 可選：要獲取的任務ID（字符串數組）。如果為`null`或為空，則將獲取目標的所有任務。
       includeSubtasks?: "none" | "first-level" | "recursive"; // 要包含的子任務級別："none"（僅頂級任務）、"first-level"（頂級任務及其直接子任務）或"recursive"（所有嵌套子任務）。默認為"none"。
       includeDeletedTasks?: boolean; // 是否在結果中包含軟刪除的任務（布爾值）。默認為`false`。
     }
     

   • 示例輸入：

     {
       "goalId": 1,
       "includeSubtasks": "recursive",
       "includeDeletedTasks": true
     }
     

   • 返回值：TaskResponse[]。TaskResponse對象是簡化的，不包括createdAt、updatedAt或parentId。

5. complete_task_status

   • 將任務標記為已完成。默認情況下，如果父任務有未完成的子任務，則不能將其標記為已完成。
   • 參數：

     {
       goalId: number; // 包含任務的目標ID
       taskIds: string[]; // 要更新的任務ID（字符串數組）。任務ID使用點符號表示法（例如，"1"、"1.1"）。
       completeChildren?: boolean; // 是否遞歸完成所有子任務（布爾值）。默認為`false`。如果為`false`，則只有在所有子任務都已完成的情況下，才能完成任務。
     }
     

   • 示例輸入（不完成子任務）：

     {
       "goalId": 1,
       "taskIds": ["1", "2"]
     }
     

   • 示例輸入（完成子任務）：

     {
       "goalId": 1,
       "taskIds": ["1"],
       "completeChildren": true
     }
     

   • 返回值：TaskResponse[]。TaskResponse對象是簡化的，不包括createdAt、updatedAt或parentId。

💻 使用示例

創建目標和任務

// 創建一個新目標。其頂級任務的ID將從 "1" 開始。
const goal = await callTool('create_goal', {
  description: '實現用戶認證',
  repoName: 'user/repo'
});

// 添加一個頂級任務
const task1 = await callTool('add_tasks', {
  goalId: goal.goalId,
  tasks: [
    {
      title: '設置認證中間件',
      description: '實現基於JWT的認證'
    }
  ]
});
// task1.addedTasks[0].id 將為 "1"

// 向之前創建的任務 "1" 添加一個子任務
const task2 = await callTool('add_tasks', {
  goalId: goal.goalId,
  tasks: [
    {
      title: '創建登錄端點',
      description: '實現POST /auth/login',
      parentId: "1"  // ParentId 必須引用一個已經存在的任務ID
    }
  ]
});
// task2.addedTasks[0].id 將為 "1.1"

管理任務狀態

// 將一個父任務標記為已完成，這也將完成其子任務
await callTool('complete_task_status', {
  goalId: 1,
  taskIds: ["1"],
  completeChildren: true
});

// 遞歸獲取所有任務，包括子任務
const allTasks = await callTool('get_tasks', {
  goalId: 1,
  includeSubtasks: "recursive"
});

刪除任務

// 嘗試在不刪除子任務的情況下刪除一個父任務（如果有子任務，操作將失敗）
try {
  await callTool('remove_tasks', {
    goalId: 1,
    taskIds: ["1"]
  });
} catch (error) {
  console.error(error.message); // 如果存在子任務，預計會拋出錯誤
}

// 刪除一個父任務及其子任務
await callTool('remove_tasks', {
  goalId: 1,
  taskIds: ["1"],
  deleteChildren: true
});

📦 安裝指南

前提條件

• Node.js 18+
• pnpm

安裝步驟

1. 安裝依賴項：

   pnpm install
   

2. 構建項目：

   pnpm build
   

3. 運行測試：

   pnpm test
   

項目結構

• src/ - 源代碼
  • index.ts - 主服務器實現
  • storage.ts - 數據持久層
  • types.ts - TypeScript 類型定義
  • prompts.ts - AI 提示模板
  • __tests__/ - 測試文件

📄 許可證

本項目採用 MIT 許可證。