不必離開 Cursor 就能管理任務

## setup

兩種接法

規則檔是最快的路徑，不需要安裝任何東西。如果你想讓代理呼叫 add 和 complete，而不是手動編輯行，MCP 伺服器則能加上具型別的工具。選一種，或兩種都用。

1. 01

   產生儲存庫合約

   用 TaskForge 3.0 以上版本開啟你的儲存庫，然後到 設定 > AI 與代理程式，並保持「產生代理程式檔案」開啟。TaskForge 會寫入一個描述你任務格式的 TaskForge/Settings/ 資料夾，以下兩種設定都會用到它。

2. 02

   在 Cursor 中把儲存庫開啟為資料夾

   選擇「檔案 > 開啟資料夾」，選擇你的儲存庫。Cursor 現在能看到每一則筆記，包括 TaskForge/Settings/ 合約，都在它的工作區裡。

3. 03

   讓規則指向合約

   Cursor 目前還不會自動探索儲存庫內的指南，所以要告訴它你的指南在哪裡。加入一份引用 TaskForge/Settings/agents.md 的專案規則，Cursor 就會在寫任何任務之前先讀取它。

   # .cursor/rules/taskforge.md
   When adding or editing tasks, first read TaskForge/Settings/agents.md
   in this vault and follow its exact syntax and date format.

4. 04

   或加入 MCP 伺服器以取得具型別的工具

   比較想讓代理呼叫工具？把 taskforge 加進 Cursor 的 MCP 設定。npx 會在第一次執行時抓取它，Cursor 就能取得 add_task、query_tasks、complete_task 等工具。

   {
     "mcpServers": {
       "taskforge": {
         "command": "npx",
         "args": ["-y", "taskforge-md", "mcp", "--stdio"],
         "env": {
           "TASKFORGE_VAULT": "/path/to/your/vault"
         }
       }
     }
   }

## prompts that work today

有效的提示

在開啟儲存庫的狀態下，於聊天面板中詢問 Cursor。它會讀取合約、編輯 Markdown，變更則會以一份你能在接受前檢視的 diff 呈現。

## privacy

沒有任何內容離開你的機器

Cursor 編輯的是你開啟的資料夾中的本機檔案，如果你有使用 taskforge MCP 伺服器，它同樣在本機執行。不需要 TaskForge 帳號，也不上雲端。你原本的同步方式，無論是 iCloud、Dropbox 還是 Obsidian Sync，都會把編輯搬到你的其他裝置。

## faq

常見問題