Claude Code 今天就能讀寫你的任務

Claude Code 就活在終端機裡，直接編輯檔案，所以它現在就能開啟你的 Obsidian 儲存庫，並比對出裡面的 Markdown 行。TaskForge 會在儲存庫中加入一份 TaskForge/Settings/agents.md 檔案，寫明你確切的格式，把 Claude Code 指向儲存庫，它從第一行就能寫對，而不是靠猜測比對你的語法。基本用法不需要外掛、不需要 API，也不需要 MCP 伺服器。

下載 Windows

通知我 Linux

在你的儲存庫中開始一個 session

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，你就不必每次重複交代。
```
Read TaskForge/Settings/agents.md, then add every action item
from today's daily note to tasks/this-week.md, due Friday.
```
Claude Code 會開啟指南、比對你的語法，然後寫下那幾行。
04
比起自由編輯，更想用工具？加入 MCP 伺服器

Claude Code 也懂 MCP。註冊 taskforge 伺服器後，它就能取得桌面版 App 使用的同一組具型別 add、query、complete 工具，並附帶結構化錯誤，方便它自我修正。
```
claude mcp add taskforge -- npx -y taskforge-md mcp --stdio
```
如果你在儲存庫資料夾外執行，請設定 TASKFORGE_VAULT。

合約告訴它什麼

TaskForge/Settings/ 資料夾正是 Claude Code 能第一次就寫對你任務的關鍵。它讀取這些檔案的方式，就跟工作目錄裡任何其他原始檔案一樣，所以改名的'due'欄位或自訂的'Waiting'狀態，對它來說是查得到的事實，而不是靠猜的。

TaskForge/Settings/agents.md	白話文指南：你的核取方塊格式、狀態符號、改名後的欄位、日期格式，以及新任務要歸到哪裡。
TaskForge/Settings/dialect.json	同樣的規則以結構化 JSON 呈現，供 Claude Code 在需要剖析而非閱讀文字時使用。
TaskForge/Settings/spaces.json	你儲存的空間及其新增規則，讓「把這個歸到雜事」能準確歸檔到正確的筆記。

從頭到尾的一個 session

這就是實際工作流程，不是示範。Claude Code 直接編輯磁碟上的檔案；App 一讀取儲存庫，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 照著寫，而不是寫出你其他工具讀不懂的通用任務行。

App 關閉時，Claude Code 新增的任務 TaskForge 會發現嗎？

會。TaskForge 開啟時會重新讀取你的儲存庫，執行期間也會持續監看變更。Claude Code 在夜間 session 中寫下的任務，你下次開啟 App 時就看得到。

我能防止它動到不該碰的檔案嗎？

把它指向你在意的任務筆記，並在接受編輯前檢視 diff。既然一切都是你早已建立版本的資料夾裡的純文字，它做的任何事都不會被隱藏，也不會無法還原。

這適用於 iCloud 或 Obsidian Sync 上的儲存庫嗎？

適用。Claude Code 編輯的是儲存庫的本機副本；你原本使用的同步方式，都會把變更帶到你的手機和其他機器，就跟它搬運你在 Obsidian 裡所做的編輯一樣。

你的終端機、你的儲存庫、你的任務。

純 Markdown，Claude Code 能讀能寫。TaskForge 可在 iPhone、iPad、Mac、Android 和 Windows 上免費下載。