Copilot 能像编辑其他文件一样编辑你的任务

## setup

打开仓库，然后选择一种模式

Copilot 的智能体模式会直接编辑工作区文件，单靠这一点就已经够用。如果你希望智能体调用 add 和 complete 这样的工具，而不是手动写行，还可以用 MCP 服务器。

1. 01

   生成仓库契约文件

   用 TaskForge 3.0 或更高版本打开你的仓库，进入“设置” > “AI 与智能体”，保持“生成智能体文件”开关为开启状态。TaskForge 会写入一个描述你任务格式的 TaskForge/Settings/ 文件夹，让 Copilot 用你的写法写任务。

2. 02

   在 VS Code 中把仓库当文件夹打开

   依次选择“文件” > “打开文件夹”，选中你的仓库。现在 Copilot 会把每一篇笔记，包括 TaskForge/Settings/ 契约文件，都视为工作区的一部分。

3. 03

   使用智能体模式，并让它指向契约文件

   在 Copilot Chat 面板中切换到智能体模式，让它能够编辑文件。让它在添加或修改任务之前先读取 TaskForge/Settings/agents.md。把同样的指令加进 .github/copilot-instructions.md，它就会应用于每一次会话。

   # .github/copilot-instructions.md
   这个文件夹是一个 Obsidian 仓库。在添加或编辑
   任务之前，请先读取 TaskForge/Settings/agents.md，并遵循其精确的语法。

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

行之有效的提示词

在智能体模式下打开仓库，在聊天面板里直接问 Copilot。它会读取契约文件，编辑 markdown，并把改动以 diff 的形式呈现给你审批。

## privacy

编辑始终留在你的工作区里

Copilot 的智能体编辑的是你打开的文件夹里的文件，如果你加入 taskforge MCP 服务器，它也在本地运行。没有 TaskForge 账号，你的任务也不会有云端副本。你已有的同步方式，无论是 iCloud、Dropbox 还是 Obsidian Sync，都会把改动带到你的其他设备。

## faq

大家常问的问题