Copilot 能像編輯任何其他檔案一樣編輯你的任務

## setup

開啟儲存庫，再選擇一種模式

Copilot 的 agent 模式會直接編輯工作區檔案，這樣就已經足夠。如果你想讓代理呼叫 add 和 complete 工具，而不是手動寫行，MCP 伺服器也在那裡等你使用。

1. 01

   產生儲存庫合約

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

2. 02

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

   選擇「檔案 > 開啟資料夾」，選擇你的儲存庫。Copilot 現在會把每一則筆記，包括 TaskForge/Settings/ 合約，都視為工作區的一部分。

3. 03

   使用 agent 模式，並指向合約

   在 Copilot Chat 面板中切換到 agent 模式，讓它能編輯檔案。請它在新增或修改任務前先讀取 TaskForge/Settings/agents.md。把同樣的指示加進 .github/copilot-instructions.md，就能套用到每個 session。

   # .github/copilot-instructions.md
   This folder is an Obsidian vault. Before adding or editing
   tasks, read TaskForge/Settings/agents.md and follow its exact syntax.

4. 04

   或加入 taskforge MCP 伺服器

   VS Code 支援 MCP 伺服器。加入 taskforge，Copilot 的代理就能取得桌面版客戶端使用的同一組具型別工具：add_task、query_tasks、complete_task 等等。

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

## prompts that work today

有效的提示

在 agent 模式下開啟儲存庫，於聊天面板中詢問 Copilot。它會讀取合約、編輯 Markdown，並把變更顯示為一份你可核准的 diff。

## privacy

編輯留在你的工作區裡

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

## faq

常見問題