我用 spec-kit + Copilot 實作個人品牌首頁：誠實報告

你有沒有過這樣的經驗？看到一個新工具，文件寫得漂漂亮亮，GitHub stars 破萬，你心想「這個我可以！」然後實際跑一次，發現處處碰壁。

spec-kit 就是這樣的東西。

但這次，我是有備而來的。

spec-kit 是 GitHub 出的「規格文件驅動開發」工具包。核心理念：先寫規格，再實作，讓 AI agent 跟著規格走，而不是跟著感覺走。

6-phase 流程看起來很嚴謹：Constitution → Spec → Clarify → Plan → Tasks → Implementation。

文件寫得很好，GitHub stars 也在漲。我心想：這次應該可以讓 Copilot 乖乖跟著我的規格走，不會再脫韁了。

真的嗎？

我的實測環境

我的目標很簡單：做一個「個人品牌首頁」，就是那種一打開瀏覽器就能看的簡單 HTML。

需求列出來就四行： - 姓名、標語、三個技能展示區塊 - 聯絡按鈕 - 響應式設計（手機和桌面都能看） - 單一 HTML 檔，無需伺服器

就這樣。沒了。

規劃階段：出乎意料的完整

我必須說，spec-kit 的規劃階段做得非常好。

執行 /speckit.specify 後，Copilot 幫我生出完整規格文件： - 3 個使用者故事（US1、US2、US3） - 7 個功能需求（FR-001 到 FR-007） - 5 個成功準則（SC-001 到 SC-005） - 4 個澄清記錄（聯絡方式、資料來源、技能呈現、色彩方案）

顏色都幫你選好了： - 背景：#f5f5f5（淺灰） - 技能卡片：#003d82（深藍）、#1b5e20（深綠）、#4a148c（深紫）

繼續跑 /speckit.plan，又生出： - 完整的設計系統文件 - 技術架構決策 - 甚至包含 30 分鐘快速開始指南

最後 /speckit.tasks，44 個任務拆解出來了，6 個階段，預估 2-3 天完成。

看到這裡，你會覺得「哇，這工具很靠譜」。

實作階段：期望落差

然後我跑了 /speckit.implement。

你猜怎麼？

生出來的東西，跟你自己叫 Copilot 寫「幫我做一個個人首頁」差不多。44 個任務規劃得落落長，實際產出就是一塊簡單的 HTML。顏色是對的，響應式也有，但就是一個「能用但不驚艷」的結果。

問題不在 spec-kit 的流程，問題在於：

規格寫得太詳細，AI agent 反而不知道從哪裡下手。

你給它 44 個任務、6 個階段、2-3 天的工作量，結果它做出的東西跟你給它 5 分鐘 prompt 差不多。這就是期望落差。

spec-kit 適合什麼場景

經過這次體驗，我的結論是：

適合： - 大型專案（多人協作、需要長期維護） - 複雜系統（電商平台、CRM、ERP 等企業級應用） - 需要強制規格紀律的團隊（強迫團隊先想清楚再做）

不適合： - 小型原型（個人專案、快速 MVP） - 簡單需求（這次就是） - 創意探索階段（你還不知道做出來會長怎樣）

一個更實際的工作流

如果你想用 spec-kit，我建議這樣：

手動快速實作 → spec-kit 分析優化 → 迭代 不要一開始就用 spec-kit 規劃。先自己做一個 MVP出來，感受一下實際問題，再讓 spec-kit 幫你系統化。

結語

spec-kit 是一個有價值的工具，但它的價值不在「讓 AI 做出好東西」，而在「強迫團隊先想清楚規格」。

如果你是一個人做小型專案，spec-kit 有點殺雞用牛刀。但如果你是團隊Leader，要帶人做複雜專案，spec-kit 的規格驅動流程可以幫你減少「做到一半才發現規格有問題」的風險。

需要架構顧問服務？歡迎來信： - Email：[email protected]