Spec Kit 寫文件。DotMD 是你審閱的地方。

GitHub Spec Kit 是什麼

Spec Kit 是 GitHub 的開源工具組，用於規格驅動開發。它不取代你的代理，而是加入一個設定專案的命令列工具 specify，以及一組在代理聊天中執行的指令。寫作由代理負責；Spec Kit 給它步驟與結構。

它支援許多代理，包括 Claude Code、Codex CLI 和 Cursor。完整清單請見 Spec Kit 的 integrations 頁面。

安裝與初始化

你需要 Python 3.11 或更新版本，以及 uv。然後：

uv tool install specify-cli
specify init my-project --integration claude

--integration 旗標接受你所用代理的代號：Claude Code 是 claude，Codex CLI 是 codex，Cursor 是 cursor-agent。其他代理的代號請見 Spec Kit 自己的頁面。

指令的順序

這些要輸入在代理的聊天中，而不是終端機：

1. /speckit-constitution
2. /speckit-specify：寫出 spec.md。
3. /speckit-plan：寫出 plan.md。
4. /speckit-tasks：寫出 tasks.md。
5. /speckit-implement：依任務建置。
6. /speckit-converge

指令的寫法因代理而異：有的用 /speckit.specify，有的用連字號或 $。Spec Kit 在 command invocation 的說明中解釋了各代理的形式。

在 DotMD 審閱每一步

Spec Kit 會請你在繼續之前審閱每個結果。DotMD 讓這成為一次正式的審閱，而不是在終端機裡草草瀏覽。

1. 開啟專案

   按 ⌘O，選擇專案資料夾。Spec Kit 寫出的檔案在建立時就會出現在側邊欄，標題、清單與表格都會渲染出來。

2. 在確切的行上加註解

   閱讀 spec.md，選取有錯或含糊的需求，按 ⌥⌘M。寫下要改什麼。註解由 DotMD 保存，不放在檔案中。

3. 讓代理修正

   告訴代理：「處理我在 DotMD 裡的註解。」它會透過 MCP 讀取註解並編輯檔案。每項修正都顯示在它的註解旁，舊文字為紅色、新文字為綠色。逐項接受或重新開啟。

4. 之後才執行下一個指令

   規格正確了，再執行 /speckit-plan，計畫與任務也照樣重複。在規格階段抓到的錯誤，只需一則註解；到了程式碼才發現，就得重做。

檢查 tasks.md

任務清單是 Markdown 的核取清單，DotMD 會以核取方塊呈現待辦清單，所以哪些做完、哪些還沒，一眼就能看出。在執行 /speckit-implement 之前，用代理讀它的方式來讀這些任務：依序、每項都夠小、沒有遺漏。如果你執行了 Spec Kit 的分析步驟，也以同樣的方式處理它的發現：在 DotMD 開啟，並對你不同意的項目加註解。

把代理連接到 DotMD 只要一行；Claude Code、Codex 與 Cursor 的指南都有說明。

為什麼要審閱每個檔案

Spec Kit 動作很快：一個指令，就冒出一整份文件。這個速度就是風險。如果規格裡有一條錯的需求，你沒讀就執行下一個指令，計畫與任務會建立在它之上，程式碼也是。仔細讀一次 spec.md，是整個流程中成本最低的檢查。

關於 Spec Kit 的問題

更多問題