不用离开 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
   添加或编辑任务时，先读取本仓库中的 TaskForge/Settings/agents.md，并严格遵循其精确的语法和日期格式。

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

大家常问的问题