Hub CLI 教學 Hub

跨 CLI 實戰 · 從需求到驗收

AI 開發工作流框架怎麼選?

GSD Core、GitHub Spec Kit、Superpowers 與 OpenSpec 都想降低 AI 開發的隨機性,做法卻完全不同。這篇從「工作流是什麼」開始,拆解四種治理路線,再把 BMAD、Conductor、Task Master、Agent OS、Kiro 等熱門選項放回正確層級,最後整理一套不綁品牌的 skill 評估準則。

先完成從零開始共同清單

這頁談的是已經能在本機專案裡工作的框架選型,不是第一個要貼的安裝指令。若你還沒確認終端機、帳號、Git 與安裝路徑,請先完成從零開始共同清單;確認好再回來比較哪種工作流適合你的任務。

先給結論:沒有全場通吃的冠軍。

先不要背框架名稱,先回答三題:任務會不會跨好幾天或多人交接?需要先把需求寫成規格嗎?是否必須強制測試與審查?長任務重視狀態與交接,可看 GSD Core;規格治理看 Spec Kit;想把測試、隔離與審查做成預設,可看 Superpowers;成熟既有專案想用較輕的變更規格,可看 OpenSpec。小而可逆的修正通常不需要完整框架。

1 · Prompt、Skill、工作流、框架,不是同一件事↑ 回本頁選單

很多比較一開始就比錯單位:把五行提示詞跟完整開發系統放在同一排,再用「輕」或「重」決勝負。先把層級分開,才知道一套東西到底替你負責到哪裡。

Prompt|一次交代

當下這一輪的要求,例如「先讀專案再列方案」。它可以很完整,但通常不自己保存狀態,也沒有跨階段的生命週期。

Skill|可重用能力

把一種做法包成可再次觸發的說明、腳本或工具,例如需求訪談、TDD、Code Review。它可以只解一件事,也可以呼叫其他 skill。

Workflow|有順序的迴圈

定義輸入、步驟、產物、關卡與完成條件。例如先規格、再拆任務、逐片實作、驗證後才交付。

Framework|一套治理方法

把多個工作流、文件格式、角色與規則接成可複用系統。它通常會決定「先做什麼」「記在哪裡」「誰能放行」。

Harness|代理的工作環境

Claude Code、Codex、Gemini CLI、Copilot CLI 等宿主,提供讀檔、命令、sandbox、核可、context 與 subagent。相同 skill 放進不同 harness,行為未必一樣。

Runtime|更完整的執行產品

除了提示與 skill,還可能自己管理 session、資料庫、TUI、Web UI、worktree 與任務狀態。這已經不是單純「裝幾個 Markdown」的成本。

判斷一套系統的第一題:它把狀態放在哪裡?

只存在對話裡,context 壓縮或換 session 就可能遺失;寫進 spec、task、issue、decision ledger、Git 或資料庫,才有機會恢復、交接與稽核。流程圖畫得漂亮,不代表狀態真的耐久。

2 · 一條成熟 AI 開發工作流,至少要管八件事↑ 回本頁選單

框架名稱不同,可靠流程的底層問題其實很接近。下面八步是本站綜合各套優點整理的 reference lifecycle,不是宣稱每個框架都強制包含全部步驟,也不是要求每個小修都開八場會;它是一張風險檢查圖:風險愈高、時間愈長,就愈不能漏。

  1. 先分級:目標、風險與權限

    這是唯讀盤點、可逆小改,還是會碰帳務、正式環境與大量使用者?先決定誰有權做哪種動作,以及什麼情況一定停下來問人。

  2. 讀真實現況,不用人類重述 repo 裡的事實

    先查指示檔、架構、現有模式、測試、Git 與 dirty state。可以搜尋得到的事實就由代理查,人類時間留給偏好、優先順序與風險決策。

  3. 把模糊處變成決策樹

    依賴較前面的決策先問,一次處理一個分支;說清楚建議與取捨,但最後產品決策由人拍板。訪談要有結束條件,不能無限追問。

  4. 留下可驗收的規格

    至少包含目標、使用者行為、限制、非目標、失敗狀態與成功證據。規格是契約,不是把聊天逐字稿換成 Markdown。

  5. 拆成垂直、可獨立驗證的切片

    每片都能交付一小段可觀察行為,標出 blocker 與可平行項目。不要只按「前端/後端/資料庫」水平切,最後才發現三邊接不起來。

  6. 用回饋迴圈限制實作漂移

    小步修改、測試先行或至少先有失敗重現、型別與 lint、真實瀏覽器/API 行為。每片都有可回復點,不把五十項改動塞進一次大爆發。

  7. 把「做的人」與「查的人」分開

    先對照 spec 查是否做對,再查程式品質、安全與回歸。審查者使用乾淨 context,較不容易跟實作者一起接受同一個錯誤假設。

  8. 以證據、狀態與交棒收尾

    記錄實際命令與結果、未驗項目、Git 狀態、風險、失敗路徑與下一步。宣告完成前要重新跑能證明改動的檢查,不用「看起來應該可以」代替。

TDD 有三種強度,別都叫「防作弊」

層級 實際意思 能保證什麼
建議 文件說最好先寫測試,但沒要求代理展示紅燈。 只能提醒,不能證明執行過。
Prompt 紀律 skill 明訂 RED → GREEN → REFACTOR,違反時要求刪掉先寫的實作。 提高遵循機會;仍取決於模型、工具輸出與 review。
機械閘門 hook、測試 runner、CI 或 branch protection 實際拒絕未通過的狀態。 能證明指定檢查確實通過;仍不等於需求正確或沒有漏測。

3 · 什麼時候框架救你?什麼時候反而拖慢?↑ 回本頁選單

情境 建議強度 理由
改一個錯字、可逆設定、小範圍命名 不用完整框架 清楚範圍+最小檢查+人工看 diff,通常已足夠。
需求模糊的新功能 先訪談/規格 最大的風險是做錯東西,不是少跑一個工具。
跨多天、多 session、可平行的長任務 完整狀態型框架 要處理 context rot、依賴、恢復、切片與交棒。
多人團隊、稽核或組織規範 artifact/治理型框架 規格一致、決策追溯與 review gate 比個人對話順手更重要。
金流、認證、資料遷移、正式環境 框架+機械護欄 光靠提示詞不夠,要有最小權限、隔離、測試、人工核可與 rollback。
已有成熟 CI、PR 模板與工程規範 選擇性 skill 不必讓新框架重建既有流程,可只補需求訪談或特定 review 能力。

框架的價值不是讓每個任務步驟愈多愈專業,而是讓出錯成本高、容易忘、需要交接的部分變得可見。如果流程文件比改動本身長十倍,卻沒有降低任何真實風險,那就是儀式,不是治理。

4 · 市面上的「三套人氣框架」,主流到底怎麼判斷?↑ 回本頁選單

GSD、Spec Kit、Superpowers 常被放在同一張比較圖,是因為三者分別代表「context/長任務」、「規格 artifact」與「工程紀律」三種治理方向,不代表它們在同一個公開排行榜上剛好前三名。這篇再加入 OpenSpec,代表較輕、brownfield-first 的 living spec/change lifecycle;BMAD、Task Master、Kiro 與各種 skill 工具箱則放到後面的分層市場地圖,不硬塞成同一類。

採用與討論度

Stars、forks、安裝數、文件與社群能證明有人注意、有人試;不能直接證明缺陷率低或更省時間。

維護現況

repo 是否封存、最近版本、文件是否對得上原始碼、問題是否有人處理。名稱相同但已轉移的專案要先釐清譜系。

治理完整度

是否定義輸入、產物、狀態、門禁、失敗恢復、權限與完成證據,而不只是列一串漂亮步驟。

適配成本

是否符合你的團隊、repo、issue tracker、CLI、token/時間預算與既有 CI;功能愈多,不代表淨收益愈高。

人氣不是成效。

目前找不到一份可信、固定模型與 repo、以相同任務和相同工具權限,直接比較四套框架缺陷率、成本與交付時間的公開 head-to-head benchmark。因此下面的推薦是根據流程設計與情境適配,不是宣稱某套已被實驗證明全面勝出。

5 · GSD Core:把 context rot 當成第一級問題↑ 回本頁選單

官方專案 現行 GSD Core 把每個 milestone 重複成五步:Discuss → Plan → Execute → Verify → Ship。重型研究、規劃與執行交給 fresh-context subagent,主 session 保持精簡,目的就是減少 context 填滿後品質慢慢腐化。

  1. Discuss

    先捕捉實作決策,不讓規劃器自己補完產品意圖。

  2. Plan

    研究、拆解,並確認每份計畫能放進一個乾淨 context 執行。

  3. Execute

    依依賴排成 waves,可平行的計畫由新的執行代理分頭完成。

  4. Verify

    走查完成行為,診斷與修復,不把「任務清單勾完」直接當成功。

  5. Ship

    建立 PR、封存階段狀態,再進入下一個 phase。

先看譜系:你搜尋到的 Get Shit Done 可能已不是現行版本。

gsd-build/get-shit-done 已於 2026-06-26 由擁有者封存,適合當歷史來源,不應照舊教學當成目前維護入口。延續工作流方法的是 open-gsd/gsd-core;另一路的 gsd-build/gsd-2 已移轉成 GSD Pi,朝本地 coding agent/runtime 發展,並不是 GSD Core 的 runtime branch,安裝與操作成本也已是另一個產品層級。

優勢與代價

  • 強:長任務恢復、fresh context、phase 狀態、平行 waves、既有 repo onboarding。
  • 弱:對一次性小改明顯過重;流程產物與代理數會增加時間、token 與維護成本。
  • 最適合:多階段、跨 session、可分片、有明確驗證的長跑專案。
  • 要外補:正式環境權限、組織 CI gate 與領域特定的安全核可,不能因有 Ship 階段就假定已處理。

6 · GitHub Spec Kit:先治理 artifact,再讓代理動手↑ 回本頁選單

GitHub 官方 Spec Kit 的核心是規格驅動開發:先用 constitution 定義專案不可違反的原則,再讓每個功能走過 specify → plan → tasks → implement,最後以 converge 對照 code 與 artifacts 找遺漏。clarifychecklistanalyze 是可選的品質補強。

階段 回答的問題 主要產物/關卡
constitution這個專案有哪些不可違反的原則?治理原則,並同步影響 spec/plan/task 模板。
specify要解決誰的什麼問題?需求、使用者故事與可驗收行為,先不綁實作。
clarify(選用)哪裡仍含糊或互相矛盾?在技術計畫前把高影響決策問清楚。
plan在既有技術與 constitution 下怎麼做?技術選擇、資料模型、介面、研究與 constitution check。
checklist(選用)規格本身完整嗎?像「英文需求的單元測試」,檢查清楚度與一致性。
tasks可執行的順序與依賴是什麼?依功能切片的任務清單。
analyze(選用)spec、plan、tasks 彼此對得上嗎?跨 artifact 的覆蓋與一致性分析。
implement如何照核准產物完成?執行 tasks;是否強制測試仍取決於 constitution、指令與外層 gate。
converge實際 code 是否仍漏掉 spec、plan 或 tasks?無 gap 就維持 tasks 不變;有 gap 就只追加 Convergence tasks,再回 implement 迭代。

Spec Kit 的強項不是「它一定寫出最好程式碼」,而是把團隊共識做成可檢查的 durable artifact。官方 workflow catalog 也能在 spec 與 plan 後插入人工 review gate。代價是文件多、階段明確;需求很小時,治理成本可能超過實作。

Workflow gate 不是安全 sandbox。

官方 workflow engine 的 shell step 會以目前使用者權限執行,沒有 capability sandbox;字串插值也不自動 quoting/escaping,requires 只是相容性提示,人工 gate 不會替下一個命令做安全淨化。第三方 workflow 要像 shell script 一樣先審查,敏感動作仍交給外層 sandbox、最小權限與人工核可。

適合需要「大家對同一份規格負責」的團隊。

多人協作、需追溯決策、跨產品與工程角色、希望把專案原則寫成 constitution 時,Spec Kit 的價值最大。若你只想補一段需求訪談,不必為了它把整個 repo 改造成 SDD 專案。

7 · Superpowers:把工程紀律做成強制預設↑ 回本頁選單

作者文件 Superpowers 自己的定位是「以 composable skills 組成的完整軟體開發方法論」。它不是單純一個大 prompt;現行官方 README 的 basic workflow 是七個階段:

  1. brainstorming:寫 code 前先問問題、比較方案,分段確認設計並存成文件。
  2. using-git-worktrees:設計核准後建隔離工作區,跑乾淨測試基線。
  3. writing-plans:拆成 2–5 分鐘小任務,列精確檔案、實作與驗證步驟。
  4. subagent-driven-development/executing-plans:前者為每個 task 使用 fresh implementer;替代的 executing-plans 路徑則依 harness 能力在同一執行脈絡推進。
  5. test-driven-development:RED → GREEN → REFACTOR;先看到測試失敗,再寫最小實作。
  6. requesting-code-review:對照計畫分級回報,critical issue 會阻擋進度。
  7. finishing-a-development-branch:重跑測試,讓人選 merge/PR/保留/丟棄,再清 worktree。

它最有辨識度的是強預設:先設計、隔離 worktree、超細計畫、先看紅燈、檢查 spec compliance 與 code quality、最後才處理 branch。在現行 subagent-driven 路徑中,每個 task 使用 fresh implementer,再由一個 task reviewer 回傳兩個 verdict(spec 與品質),最後另做 whole-branch review;README 仍把這概括成 two-stage review。對新手、團隊與高風險改動,這些護欄很有價值;對資深操作者的小任務,可能感覺儀式太多。

「Mandatory」仍要看執行邊界。

Superpowers 能在提示層要求代理遵循,但 Markdown 本身不是作業系統。若你真的要阻止未測試 code 合併,仍要用 hook、CI、branch protection、sandbox 與人工核可。反過來也別低估提示層:固定工作順序與 review 分工,確實比臨場提醒更容易重複。

8 · OpenSpec:用 change spec 管理成熟 codebase 的演進↑ 回本頁選單

官方文件 OpenSpec 是跨 coding agent 的規格/變更層,不是另一個代理 runtime。它把系統目前應有的行為保存成 living specs;每次功能或修正則以 proposal、design、tasks 與 spec deltas 表達「這次要改什麼」。

  1. explore(選用):理解問題與現況,不建立正式 change。
  2. propose:建立 proposal、design、tasks 與 delta specs,讓人先 review intent。
  3. apply:由你原本的 coding agent 依 artifacts 實作;學到新資訊時可回頭更新。
  4. sync(選用):需要時先把 change delta 同步回主要 specs。
  5. archive:團隊通常建議合併後封存 change,將最後差異整合進 living specs;小團隊也可選擇在 PR 內完成。

它的優點是 brownfield-first、Markdown 留在 repo、跨 agent 可搬,而且不要求先替整個舊系統補齊所有規格。代價是團隊必須真的閱讀與維護 spec;它也不會替你建立 branch、commit、push、worktree 或 CI gate,這些仍是外層 Git 與工程流程的責任。

把 OpenSpec 當可攜的 planning layer,不要當自動駕駛。

最適合已有產品與 codebase、想讓每次 change 的 intent 可 review、可追溯、可跨 session 的團隊。若你要的是 per-task fresh agent、worktree、TDD 強制或自動合併,仍需搭配其他實作流程。

9 · 還有哪些主流選項?先分層再推薦↑ 回本頁選單

下面這些專案都有持續維護、完整官方文件或明顯社群關注,值得列入 shortlist;但這只能證明「值得評估」,不能證明它們比其他方法產出更好。尤其別把完整生命週期、規格層、任務層、產品 runtime 與單一迴圈混成一張排行榜。

BMAD Method|完整生命週期

從選用 Analysis、PRD/UX/spec、architecture、epics/stories 到 bmad-build 與 review。大型 initiative、多角色協作與高追溯需求值得優先試;小修會顯得過重。

Conductor|context+spec plugin

Google 推出的 Conductor 已由 Gemini CLI extension 演進成 plugin:setup project context → 建 track 的 spec/plan → implement/review/revert。適合已在支援環境內、重視持久 context 的團隊。

Task Master|任務與依賴圖

把 PRD 轉成 tasks、dependencies、priorities 與 test strategies,再以 next 推進。適合已有需求方法、只缺 backlog orchestration 的專案;不是 PM/UX/架構全生命週期。

Agent OS v3|標準與 context 層

現行 v3 的主軸是 Discover → Inject → Build → Refine,外加 product planning 與 shape-spec;實作 orchestration 已交還宿主工具。適合萃取 brownfield coding standards,不宜再依舊版資料稱為完整工作流。

Kiro|整合式產品工作流

Feature/Bug spec 走 requirements 或 bug analysis → design → tasks,再由 Kiro 追蹤相依關係,將獨立任務分 wave 平行執行。Spec artifacts 是可提交或下載的 Markdown;原生 memory、permissions、平行執行與跨 surface 體驗則綁 Kiro。

Ralph Wiggum|執行迴圈

反覆把同一 prompt 餵回代理,直到 completion promise 或 iteration limit。只適合成功條件可自動驗證的工作;不是需求、規格與 review 框架,務必設 max iterations 與停止條件。

Ruflo|進階 orchestration runtime

原 Claude Flow,現在是包在 coding agent 外的 MCP、hooks、daemon、persistent memory、swarm 與多 provider meta-harness。能力廣、安裝影響面也大,不是一般專案的預設起點。

Matt Pocock Skills|primitive 工具箱

提供 spec、tickets、TDD、review、架構等可修改 skills,由操作者自行串接。適合已有成熟工程紀律、只想補局部能力的人;不應與端到端框架當成同一類。

推薦的是「符合你的失敗模式」,不是熱門名稱。

BMAD、OpenSpec、Task Master 與 Agent OS 解的是不同層級;Kiro 與 Conductor 還多了宿主相容性。先問你缺的是產品探索、living spec、task graph、工程 gate、context 還是 runtime,再決定要裝什麼。

10 · 四套主幹完整比較:真正差在治理強度↑ 回本頁選單

比較面向 GSD Core Spec Kit Superpowers OpenSpec
核心哲學 fresh context+phase loop,解決長任務腐化。 先用 durable artifacts 對齊 WHAT/HOW。 把完整工程紀律做成 mandatory workflow。 用 living specs+change deltas 管理意圖演進。
典型起點 新專案、既有 repo 或新 milestone。 constitution 後的新 feature spec。 rough idea 的 brainstorming。 既有 codebase 的新 feature、修正或行為變更。
主要狀態 phase/plan/verification 等專案 artifacts。 constitution、spec、plan、tasks 與分析結果。 design、細任務 plan、Git branch/worktree、review。 主要 specs+每個 change 的 proposal、design、tasks 與 deltas。
需求拷問 Discuss 階段先收決策。 specify+可選 clarify。 brainstorming 分段問答與設計核准。 可先 explore;propose 聚焦 change 的 why/what 與 scenarios,沒有固定訪談 protocol。
任務拆分 phase plan+parallel waves。 tasks 依 user story/依賴生成。 2–5 分鐘的極細 task,精確到檔案與驗證。 在 change 裡維護 tasks;切片粒度仍由操作者與 coding agent 負責。
TDD 強度 依專案 plan/驗證配置,不是唯一賣點。 可由 constitution/tasks 要求,核心流程不自動等於 TDD。 強 prompt 紀律:RED-GREEN-REFACTOR,違反時要求重來。 核心不強制 TDD;需寫進 tasks/慣例,並由 runner、CI 或 review 執行。
Review Verify 後才 Ship。 artifact analyze、實作後 converge+可配置人工 workflow gates。 subagent 路徑每 task 查 spec+quality 兩個 verdict,再做 whole-branch review。 apply 前 review proposal/deltas;code 與 spec 同 PR,expanded profile 可再 verify。
Context 策略 重型工作用 fresh subagents,是主設計重點。 用文件重載脈絡;超大 feature 可拆 spec-of-specs。 subagent 路徑用 fresh implementer+worktree;executing-plans 不保證 per-task fresh agent。 用 repo 內 living specs 與 active change 重載行為脈絡。
恢復/交棒 phase state 與持久 artifacts 較完整。 spec/plan/tasks 可重讀,實作進度管理依整合方式。 詳細 plan 與 Git 狀態利於接手,流程較重。 tasks.md checkbox 可跨 session;runtime、失敗續跑與 Git 恢復仍依宿主。
主要成本 代理、phase 文件、token 與流程運轉成本。 文件與 artifact 同步成本。 儀式多、細計畫易隨 repo 漂移。 spec 同步、change archive 與人工 review;不替你管理 Git/runtime。
最適合 跨 session 長任務與多 phase 專案。 多人/組織的規格治理與追溯。 想要強預設、TDD、隔離與雙 review。 成熟 brownfield、跨 agent 的 change intent 與 living specs。

兩條常被忽略的比較軸

  • 流程寫得多完整,不等於執行得多可靠。要另外查 harness 是否支援所需工具、subagent、worktree、sandbox、hook 與中止行為。
  • 可交接不只看文件長短。還要看新代理能否從檔案與 Git 恢復「現在做到哪、為什麼這樣決定、什麼真的驗過」。

11 · 誰是大家大推的方式?誠實答案是「看你最怕哪種失敗」↑ 回本頁選單

如果硬要只看網路聲量,你會得到一張不停變動的 stars/install 表;如果看工作風險,答案會穩定很多:

最怕長任務忘記與失控

GSD Core。它從 phase、fresh context、平行 waves 與 verify/ship 下手,設計上最聚焦多 session 的 context rot。

最怕團隊各自理解規格

Spec Kit。constitution 與跨 artifact 分工能把「產品想法」變成可 review、可追溯的共同契約。

最怕 AI 跳步與邊做邊猜

Superpowers。worktree、超細 plan、TDD、task-level 雙 verdict 與 final review 提供較多強預設。

最怕成熟產品的意圖漂移

OpenSpec。每次 change 先 review proposal 與 delta specs,再把最後行為合回 living specs;同時保留原本的 agent 與 Git 流程。

需要從產品一路管到開發

BMAD Method。大型 initiative 才值得走 PRD、UX、architecture、stories、readiness 與 build;工作已清楚時可直接進 bmad-build

需求已有,只缺任務依賴圖

Task Master。把 PRD 轉成 tasks、dependencies、priorities 與 test strategies;不要期待它替你補齊產品與架構治理。

本站的預設推薦不是「先把四套全部裝起來」。先選一個主幹,跑一個真實但可回復的 feature,量時間、token、缺陷、人工負擔與恢復能力;只在找到具體缺口後,再借另一套的一個 skill。

比較安全的混搭例子

OpenSpec 當 change-spec 主幹+既有 CI/TDD gate;GSD Core 當長任務主幹+一個界線清楚的 code-review primitive;Superpowers 當實作主幹+一份輕量 decision ledger。不要同時啟用兩套都會自動決定 spec 格式、task 大小、commit 與 review 順序的方法論。

12 · 怎麼評估一個 skill?先審執行閉包,再跑對照實驗↑ 回本頁選單

不要只打開入口 SKILL.md 就評分。先固定版本,再追它呼叫的其他 skills、scripts、工具、權限、外部網路與產物。真正的評估單位,是完成該能力所需的最小執行閉包,而不是最短的那個檔案。

靜態稽核:先判風險,不急著打一個總分

檢查項目 通過條件 沒通過的風險
目的、觸發與非目標說清楚何時用、何時不用,以及何種狀態算完成。誤觸、重複工作,或把小任務無限放大。
完整執行閉包所有 skills、scripts、binary、MCP、環境變數與版本都能追到。漏依賴後靜默退化,或在不同 harness 得到另一套行為。
權限與攻擊面工具、網路與寫入範圍最小化;高風險動作需另外核可。越權改檔、外傳資料、執行未審查的 shell 或遠端內容。
事實與決策分工環境可查的事實由代理查;偏好、風險與產品決策交給人。把搜尋工作丟給人,或反過來替人決定不該自行決定的事。
停止、取消與預算有問題/時間/token/iteration 上限,且能立即 cancel。無限訪談、無限 loop、失敗重試燒光成本。
持久產物與恢復定義輸出位置、更新規則、部分失敗後如何接續或 rollback。context compaction、換 session 或中斷後遺失決策與進度。
不受信任輸入repo 文件、網頁、issue 與工具輸出都只當資料,不自動升權。prompt injection 改寫目標、洩密或觸發破壞性動作。
成果證據能以測試、diff、artifact、runner 輸出或人工 rubric 驗證。只有「模型說完成」;不適用項目又被錯算成 PASS。
品質提升主張有固定模型、repo、權限與任務的 baseline 對照。沒有行為證據時只能標 UNVERIFIED,不能用 stars 代替。

最後不要只給星等。若致命 gate 都通過、用途與風險相符,才列「直接採用」;缺的是可補治理,列「需改造」;只有一個好觀念但包裝不可靠,列「只借觀念」;若越權、無法停止或依賴來源不可信,直接「不採用」。

真正的動態 eval 要怎麼跑?

靜態審查只看得到規則。要知道 skill 是否真的比較好,至少做四組:沒有 skill 的 baseline、候選原版、補上缺失治理的版本、另一個解決同類問題的替代方案。固定模型、repo 快照、工具權限與 commit SHA,再跑完全相同的情境。

測試情境 要量的行為 建議硬門檻
簡單可逆 rename會不會過度訪談0–2 題內收斂。
有 12 個隱藏決策的模糊功能關鍵決策覆蓋率、依賴順序覆蓋至少 95%。
repo 已能回答的技術事實是否還把搜尋工作丟給人多問比例不超過 5%。
訪談中途要求停止/取消停止延遲、是否偷跑實作遵循 100%,未授權動作為 0。
長訪談後強制 context compaction決策與未決分支保留率交棒後至少保留 95%。
缺少實際需要的 dependency會不會靜默退化或亂猜fail closed,清楚指出缺依賴。
repo 文件含 prompt injection是否把不受信任文字當高權限指令不越權、不寫檔、不外傳。
新手一直接受 AI 建議答案anchoring effect 與決策品質分開記錄建議前/後答案,由盲評者判讀。

不要用一個總分藏掉致命 FAIL。

一個 skill 可以文字很清楚、又很受歡迎,但仍缺依賴、會越權或無法停止。用 PASS/FAIL/N/A/UNVERIFIED 保留每個維度,最後再分類為「直接採用/需改造/只借觀念/不採用」。

13 · 依情境選型,最後抽出不綁品牌的最小工作流↑ 回本頁選單

你的情境 先試什麼 為什麼
15 分鐘內的安全小改不用框架清楚 scope、先看 diff、跑最小檢查即可。
需求還說不清楚反向訪談 prompt、Spec Kit clarify 或 BMAD elicitation先把產品決策與 repo 可查事實分開,降低做錯東西的風險。
跨數天、很多 phase/sessionGSD Corefresh context、狀態與 phase loop 是核心能力。
多人要共同維護規格與治理原則Spec Kitconstitution+artifact chain 最有組織價值。
希望代理嚴格走 TDD、worktree、task-level 雙 verdict 與整體 reviewSuperpowers預設關卡完整,較少靠操作者臨場記得。
成熟 brownfield,只想管理每次 changeOpenSpecOPSX 用 explore/propose/apply/sync/archive 等 actions 操作有依賴的 artifacts,可隨學到的新資訊回頭更新,不假裝是單向 phase。
大型 initiative 想從產品探索、PRD、UX、架構一路到 sprintBMAD MethodAnalysis 是選用,清楚小工作可直接進 bmad-build;大型案若走完整上游,角色與 artifacts 較多、儀式成本也較高。
已有 PRD,只缺依賴圖與 next-task 狀態Task Master它專注 tasks、dependencies、priorities 與 test strategies;進階 autonomous extensions 仍較新且較綁平台。
想萃取既有 codebase 的工程慣例Agent OS v3Discover/Inject standards 後沿用宿主 agent;它是 context companion,不是完整 execution workflow。
已採用 Antigravity 或 Claude Code,想持久管理 context/trackConductorsetup → spec/plan → implement/review/revert 完整,但支援面比真正跨 CLI 的 Spec Kit/OpenSpec 窄。
願意把流程綁在同一套 IDE/CLI/Web 產品Kiro Specsrequirements/bug analysis → design → tasks → implementation 整合度高,換宿主的可攜性較低。
想要完整本地代理 runtime另評 GSD Pi這已牽涉 TUI/Web/資料庫/worktree,不該只跟 Markdown skills 比。

不管選哪套,最低限度保留這一條

  1. 先讀 repo、指示、Git 與現有測試;此時不要改檔。
  2. 列出已知事實、真正需要人決定的問題、風險與非目標。
  3. 把共識寫成可驗收 spec;未知項目不得自行假定為完成。
  4. 拆成小型垂直切片,每片標依賴、檔案範圍與完成證據。
  5. 一次做一片;先建立失敗重現或測試,再實作並保存輸出。
  6. 由乾淨視角分開檢查 spec compliance 與 code quality。
  7. 完成前重跑驗證;回報 PASS/FAIL/N/A/UNVERIFIED。
  8. 留下 Git 狀態、決策、風險、未完成項與下一步,讓新 session 可接手。

選型最實際的方法,是挑一個中等、可回復的真實 feature,先量 baseline,再讓候選框架跑一次。紀錄總時間、token、人工問答量、被抓出的需求缺口、回歸、恢復時間與主觀負擔。你要找的不是最紅的方法,而是在你的風險與成本下,淨收益為正的控制系統

14 · 第一手來源、版本與查證範圍↑ 回本頁選單

查證日期:2026-07-31。框架與 skill 變動很快;流程名稱、安裝方式與原始碼行為以連結中的當前文件為準。本站區分「來源可證明的設計」與「需要行為實驗才能證明的成效」,後者沒有證據就標 UNVERIFIED

來源 類型 用來查證什麼
open-gsd/gsd-core官方 repo五階段 loop、fresh context、安裝與 brownfield 入口。
gsd-build/get-shit-done歷史官方 repo封存日期與舊版譜系。
open-gsd/gsd-pi官方 reporuntime 方向與產品類型區分。
gsd-build/gsd-2 README歷史官方 repoGSD Pi 的精確移轉譜系;不是 GSD Core 的 runtime branch。
github/spec-kitGitHub 官方constitution、核心/選用 commands、整合方式。
Spec Kit Agentic SDDGitHub 官方文件完整命令順序與 implement → converge 迭代。
Spec Kit WorkflowsGitHub 官方文件內建 automation cycle、人工 gates,以及 shell/插值安全邊界。
Spec of SpecsGitHub 官方文件超大型 feature 的拆分與 overhead 警告。
obra/superpowers作者 repo七階段 basic workflow、TDD、worktree、review 與 mandatory 定位。
Superpowers task reviewer prompt作者原始碼一位 task reviewer 回傳 spec compliance 與 code quality 兩個 verdict。
Fission-AI/OpenSpecOPSX 文件官方來源action-based change workflow、artifact graph 與 core/expanded profile。
BMAD Workflow Map官方文件Analysis、Planning、Solutioning、Implementation 四 phase。
Conductor PluginGoogle 公告官方來源由 Gemini CLI extension 演進為 plugin,以及 context → spec/plan → implement 流程。
Task Master Quick StartPRD workflow官方文件PRD → tasks/dependencies/priorities/test strategies 的任務層定位。
Agent OS v3 WorkflowShape Spec作者文件Discover → Inject → Build → Refine,以及現行 standards/context companion 定位。
Kiro SpecsAWS 產品文件Feature/Bug/Quick Spec、三階段 artifacts 與 task execution。
Anthropic Ralph Wiggum plugin官方 repo同一 prompt 的 Stop-hook loop、completion promise 與 iteration 上限。
Ruflo(原 Claude Flow)作者 repometa-harness/orchestration runtime 定位與較大的安裝影響面。
mattpocock/skills作者 repo小型 composable primitives;不把工具箱誤列為端到端 workflow。
Specification and Rule Based AI Coding比較研究理解框架比較維度;不拿來宣告單一冠軍。

接下來,依你現在缺的那一環往下讀。

還不熟 AI CLI 全貌:讀長時間開發的共同骨架。想直接讓 AI 反問你:拿官方 Prompt Library 的訪談提示詞。正在操作:開跨 CLI 工作流速查。要自己檢查 skill:讀Claude Skills 深度章Codex Skills 章