前言

先拿一套現成的框架跑一輪—Spec Kit 它的價值不在於好用，而在於讓你看見自己缺什麼。

昨天說到

昨天處理完模型與 effort，Claude Code 這邊的設定大致就位了。

但工具準備好，不等於知道要告訴它做什麼。這就是接下來幾天的主題，而我打算從一套現成的框架開始——Spec Kit。

Spec Kit 是什麼

GitHub 開源的 Spec-Driven Development 工具包（github/spec-kit）

主張讓規格變成可執行的東西——不是指導實作，是生成實作。它支援 30 幾種 AI coding agent，Claude Code 是其中之一。

安裝用 uv：

uv tool install specify-cli --from git+https://github.com/github/spec-kit.git@vX.Y.Z

vX.Y.Z 要換成最新的 release tag，前面的 v 要留著。

(Invoke-RestMethod https://api.github.com/repos/github/spec-kit/releases/latest).tag_name

我實測的是 v1.0.4。

初始化：

specify init <專案名> --integration claude

它會建出以下內容：

前三項每個專案都一樣，只有憲法和之後產生的 specs/ 是每個專案獨有的。

指令一覽

主線是以下四個指令，依序跑：

另外六個支線是：implement（把任務做出來）、taskstoissues（轉成 GitHub issue）、converge（拿現有程式碼對照規格補齊），以及選用的 clarify、analyze、checklist。

先寫憲法

/speckit-constitution 產出的是 .specify/memory/constitution.md——專案的開發原則，後面每個階段在產出時都會回頭讀它。

我實際寫的長這樣（節錄，全文 187 行）：

## Core Principles
### I.   API 欄位一律 snake_case
### II.  時間一律 UTC + ISO 8601
### III. 自建認證（NON-NEGOTIABLE）
### IV.  資料庫寫入必須有測試（NON-NEGOTIABLE）
### V.   資料存取只走 ORMㄒ

小結

• Spec Kit 把自己寫成 .claude/skills/ 裡的十個 skill——跟後面要講的 skill 是同一個機制，只是別人先寫好了。
• 憲法要挑跟預設行為相反的條款來寫，不然驗不出規格到底有沒有被讀進去。

明天：明天讓 claude 從一句話長出一份規格。