Task Researcher

🚀 任務研究

本項目聚焦於任務研究相關內容，涵蓋了配置文件說明、任務結構定義以及不同命令參數的區別，為任務的開展和管理提供了清晰的指引。

🚀 快速開始

若要開啟任務研究，需先完成.env文件的配置，並瞭解任務結構，同時清楚--research與--research-hint的區別，以下將詳細介紹。

📦 安裝指南

.env配置文件示例

請參考.env.example文件。關鍵設置包括：

• LLM_MODEL：用於任務、分析和生成子任務（非STORM）的主要模型。
• ANTHROPIC_API_KEY, GOOGLE_API_KEY等：主要LLM的API密鑰。
• STORM_RETRIEVER：用於STORM檢索器的選擇（如bing, you, tavily等）。
• BING_SEARCH_API_KEY, YDC_API_KEY, TAVILY_API_KEY等：所選STORM檢索器的API密鑰。
• BIG_STORM_MODEL：（可選）用於STORM內部處理的大模型。
• SMALL_STORM_MODEL：（可選）用於STORM內部處理的小模型。
• STORM_SEARCH_TOP_K, STORM_MAX_TOKENS_*：控制STORM的深度。
• 文件路徑（如TASKS_FILE_PATH等）。

📚 詳細文檔

任務結構 (tasks/tasks.json)

任務結構遵循在task_master_py/models.py中定義的Pydantic模型，包括Task、Subtask和TasksData。

{
  "meta": {
    "projectName": "任務大師項目",
    "projectVersion": "0.1.2",
    "sourceFiles": ["scripts/plan.md", "..."],
    "generatedAt": "...",
    "totalTasks": 15
  },
  "tasks": [
    {
      "id": 1,
      "title": "設置項目環境",
      "phase": 1,
      "description": "初始化項目結構，安裝依賴項，配置代碼檢查工具。",
      "details": "...",
      "status": "pending",
      "dependencies": [],
      "priority": "high",
      "testStrategy": "通過運行基本命令驗證環境設置。",
      "subtasks": []
    },
    {
      "id": 2,
      "title": "實現核心數據模型",
      "phase": 1,
      "description": "定義Pydantic模型用於任務和報告。",
      "details": "...",
      "status": "pending",
      "dependencies": [1], // 依賴於任務1
      "priority": "high",
      "testStrategy": "為模型驗證編寫單元測試。",
      "subtasks": [
        {
            "id": 1, // 子任務ID相對於父任務
            "title": "定義任務模型",
            "description": "...",
            "details": "...",
            "status": "pending",
            "dependencies": [], // 子任務之間的依賴關係（整數）
            "acceptanceCriteria": "Pydantic模型通過驗證...",
        },
        {
            "id": 2,
            "title": "定義報告模型",
            "description": "...", 
            "details": "...",
            "status": "pending",
            "dependencies": [1], // 依賴於子任務1
            "acceptanceCriteria": "Pydantic模型通過驗證...",
        }
      ]
    },
    // ... 更多任務
  ]
}

--research與--research-hint的區別

• expand --research：觸發完整的基於STORM的工作流：AI生成問題 -> AI分組問題 -> knowledge-storm執行網絡搜索併合成報告 -> AI利用合成的報告作為上下文生成子任務。需要knowledge-storm和配置好的檢索器API密鑰。
• analyze-complexity --research-hint：修改主要LLM的提示，使其更像研究助理一樣使用其內部知識庫進行分析。不使用knowledge-storm或執行即時網絡搜索。
• update --research-hint：與analyze-complexity類似，提示主要LLM在處理更新提示時使用其內部知識。