Claude Code 现在就能读写你的任务

Claude Code 运行在终端里，靠编辑文件干活，所以它现在就能打开你的 Obsidian 仓库，照着找到的 markdown 行来写。TaskForge 会在仓库里加入 TaskForge/Settings/agents.md 文件，写清楚你的确切格式；把 Claude Code 指向仓库，它从第一行起就能写对，而不用靠模式匹配去猜你的语法。基本用法不需要插件、API 或 MCP 服务器。

下载 Windows

上线通知： Linux

在你的仓库里开始一次会话

Claude Code 在一个工作目录中工作。把这个目录设成你的仓库，它需要的一切就已经在磁盘上了。

先生成一次契约文件

用 TaskForge 3.0 或更高版本打开仓库，进入“设置 → AI 与智能体”，保持“生成智能体文件”开启。这样就会把 TaskForge/Settings/agents.md 和 TaskForge/Settings/dialect.json 写入仓库。之后如果你改了状态符号或日期格式，TaskForge 会重写它们，确保两者永远不会脱节。
02
在仓库里启动 Claude Code

在终端里切换到你的仓库文件夹，然后在那里启动 Claude Code。仓库现在就是它的工作目录，因此每个文件，包括 TaskForge/Settings/ 契约文件，都触手可及。
```
cd ~/Documents/MyVault
claude
```
任何仓库文件夹都可以，不管它是通过 iCloud、Dropbox 还是 Obsidian Sync 同步的。
03
让它先读契约文件

一行指令就能让它写的每个任务都符合你的格式：让它在添加或编辑任务之前先读取 TaskForge/Settings/agents.md。把同一行放进仓库根目录的 CLAUDE.md 里，你就再也不用重复这句话了。
```
先读取 TaskForge/Settings/agents.md，然后把今天日记里的所有行动项
添加到 tasks/this-week.md，截止日期设为周五。
```
Claude Code 会打开这份指南，匹配你的写法，然后写下这些行。
04
更喜欢用工具而不是自由格式编辑？加入 MCP 服务器

Claude Code 也支持 MCP。注册 taskforge 服务器之后，它就能获得与桌面应用相同的类型化 add、query 和 complete 工具，以及可供它自我纠正的结构化错误信息。
```
claude mcp add taskforge -- npx -y taskforge-md mcp --stdio
```
如果你在仓库文件夹之外运行它，请设置 TASKFORGE_VAULT。

契约文件告诉它什么

Claude Code 能一次就把你的任务写对，靠的就是 TaskForge/Settings/ 文件夹。它会像读取工作树里其他源文件一样读取这些文件，所以改了名的“due”字段、自定义的“Waiting”状态，对它来说都是查得到的事实，而不是靠猜。

TaskForge/Settings/agents.md	大白话指南：你的复选框写法、状态符号、改名的字段、日期格式，以及新任务的去向。
TaskForge/Settings/dialect.json	同样的规则以结构化 JSON 呈现，方便 Claude Code 在想解析数据而不是读文字说明时使用。
TaskForge/Settings/spaces.json	你保存的空间及其添加规则，这样“把这个归到‘外出办事’里”就能落在正确的笔记里。

一次完整的会话

这就是实际工作流程，不是演示。Claude Code 编辑磁盘上的文件，应用一读取仓库，TaskForge 就会显示结果，手机上则在下次同步后更新。

你输入

“读取 inbox.md，把每个尚未回复的问题都转成 tasks/this-week.md 里的一条任务，每条都在周五截止。”

Claude Code 写下的内容

- [ ] 回复 Priya 关于导出格式的问题 📅 2026-07-10

- [ ] 与 Sam 确认场地人数 📅 2026-07-10

它读取笔记，用你仓库的语法写下两行，并告诉你添加了什么。不用复制粘贴，也不用猜格式。

你输入

“tasks/ 里有没有标了 #blocked 且超过一周的任务？把它调到高优先级。”

Claude Code 写下的内容

- [ ] 等待法务签字 ⏫ #blocked 📅 2026-07-02

Claude Code 对你的任务文件做 grep 搜索，找出搁置太久的任务，原地改写优先级标记。改动就是一份普通 diff，提交前你可以先检查。

本地文件，可审查的编辑

Claude Code 运行在你自己的电脑上，只接触它工作目录里的文件。由于你的任务是纯文本，它做的每一次改动都是你能读懂的 diff，而你仓库现有的版本历史，无论是 git、iCloud 还是 Obsidian Sync，都意味着一次糟糕的编辑只需一次回退就能挽回。没有 TaskForge 账号，没有云端。

大家常问的问题

Claude Code 管理任务需要 MCP 服务器吗？

不需要。基本用法它只是编辑文件。把仓库设为工作目录，让它读取 TaskForge/Settings/agents.md，它就会按你的格式写任务。如果你更希望它使用类型化的工具而不是自由格式的文件编辑，MCP 服务器是一个可选项。

Claude Code 怎么知道我的任务语法？

它会读取 TaskForge/Settings/agents.md，也就是 TaskForge 在你仓库中生成的契约文件。这份文件描述了你确切的任务写法、改名的字段、状态符号和日期格式，因此 Claude Code 能与之匹配，而不是写出一行你其他工具读不懂的通用任务。

应用关闭时 Claude Code 添加的任务，TaskForge 能发现吗？

能。TaskForge 打开时会重新读取你的仓库，运行期间也会持续监听变化。Claude Code 在夜间会话中写下的任务，你下次打开应用时就在那里。

我能防止它碰到不该碰的文件吗？

把它指向你在意的那些任务笔记，并在接受一次编辑之前先审查 diff。既然一切都是纯文本，存放在你已经做版本管理的文件夹里，它做的任何改动都看得见，也都能撤回。

这适用于放在 iCloud 或 Obsidian Sync 上的仓库吗？

适用。Claude Code 编辑的是仓库的本地副本，你已经在用的同步方式会把改动带到你的手机和其他设备，和同步你在 Obsidian 里的编辑一样。

你的终端，你的仓库，你的任务。

纯 markdown，Claude Code 读得懂也写得了。TaskForge 可在 iPhone、iPad、Mac、安卓和 Windows 上免费下载。