實戰手冊 · Field Manual 2026 夏季號
github.com/garrytan/gstack · 108k ★
g
開源工程 · Claude Code 設定檔 / 全指令手冊

gstack 全指令
速查表與
Prompt 範例。

gstack 是 Y Combinator 執行長 Garry Tan 公開的 Claude Code 設定檔:一套放在 ~/.claude/skills/gstack/ 的 Markdown 技能,把 Think → Plan → Build → Review → Test → Ship → Reflect 七階段工作流寫進斜線指令。這份手冊涵蓋安裝、七階段流程,以及 40+ 個指令的完整速查表——每個指令都附一則 Prompt 範例。

108k
GitHub Stars
40+
斜線指令
7
階段工作流
MIT
開源授權
01
這是什麼

一套把工程流程
寫進斜線指令的設定檔。

Garry Tan 是 Y Combinator 現任執行長,曾是 Palantir 早期工程師、Posterous 共同創辦人(被 Twitter 收購)。他公開承認:過去 60 天他出貨了 3 個正式產品、40+ 功能,而這只是他經營 YC 的「兼職」。他自己統計過,以邏輯程式碼變動量(非單純行數)計算,2026 年的產出速度是他 2013 年寫 Bookface 時的 810 倍。

gstack 本質上是一堆 Markdown 寫的 SKILL.md 檔案,放在 ~/.claude/skills/gstack/。每個檔案對應一個角色或動作:CEO、工程經理、設計師、QA 主管、資安長、發布工程師。官方把它定位成「23 個有觀點的專家角色 + 40 多個斜線指令」。當你輸入 /office-hours 或 /review,Claude Code 會載入對應 SKILL,切換成那個角色的思考方式。授權 MIT,目前 GitHub 108k 星。

重點是把流程固定下來。Garry 把 Sprint 的節奏寫進 Markdown:Think → Plan → Build → Review → Test → Ship → Reflect。每一階段都有專屬指令,指令會把工作成果寫到專案資料夾,下一個指令自動讀取,形成「上下文交班」。本手冊第 03 節是全部指令的速查表,每個指令附一則 Prompt 範例;第 04 節說明哪個階段該用哪個指令。

gstack Sprint · 完整生命週期
Think→ Plan→ Build→ Review→ Test→ Ship→ Reflect
「I don't think I've typed like a line of code probably since December.」
過去四個月,我幾乎沒手打過半行程式。
— Andrej Karpathy(OpenAI 共同創辦人)2026 年 3 月 No Priors Podcast
02
30 秒安裝

把指令貼進你的 Claude Code,
剩下交給它。

先確認你的環境有這四個東西:Claude Code、Git、Bun v1.0+、Node.js(只有 Windows 需要)。然後在 Claude Code 對話框直接貼以下指令,讓 Claude 自己幫你完成 git clone、執行 setup、修改 CLAUDE.md。

# 貼這段給 Claude Code,它會自己安裝 Install gstack: run git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.claude/skills/gstack && cd ~/.claude/skills/gstack && ./setup then add a "gstack" section to CLAUDE.md that says to use the /browse skill from gstack for all web browsing, never use mcp__claude-in-chrome__* tools, and lists the available skills: /office-hours, /autoplan, /plan-ceo-review, /plan-eng-review, /plan-design-review, /plan-devex-review, /design-consultation, /design-shotgun, /design-html, /review, /investigate, /design-review, /codex, /cso, /qa, /qa-only, /devex-review, /browse, /benchmark, /ship, /land-and-deploy, /canary, /document-release, /document-generate, /retro, /learn, /spec, /careful, /freeze, /guard, /unfreeze.

團隊模式:讓整個 repo 同步使用同一版本

如果你想讓專案隊友自動拿到相同的 gstack 設定(每個 Claude Code session 啟動時都會做一次節流的自動更新檢查),從你 repo 根目錄貼這段:

(cd ~/.claude/skills/gstack && ./setup --team) && \ ~/.claude/skills/gstack/bin/gstack-team-init required && \ git add .claude/ CLAUDE.md && \ git commit -m "require gstack for AI-assisted work"
不只 Claude Code。gstack 支援多種 AI coding agent host(如 OpenAI Codex CLI、OpenCode、OpenClaw)。執行 ./setup --host codex(或其他 host 名稱)就會安裝到對應位置;要新增自家 host 看 docs/ADDING_A_HOST.md。也就是說你切換 agent 時,工作流程不會斷掉。需求環境:Claude Code、Git、Bun v1.0+,Windows 另需 Node.js。
03
全指令速查表

40+ 指令,
每個附 Prompt 範例。

下面把全部斜線指令依七階段分組。每一列是:指令、用途、以及一則可以直接改著用的 Prompt 範例。你不用全背——記住 /office-hours、/autoplan、/review、/qa、/ship 五個核心就能跑完一輪;其他在需要時查表即可。Prompt 範例只是起點,實際用你自己的專案內容替換即可。

① 規劃與審查 · Think / Plan

指令用途Prompt 範例
/office-hours起點。六個逼問,把模糊想法重新框成真正的產品問題/office-hours 我想做一個追蹤小團隊訂閱開銷的工具
/autoplan一條指令跑完 CEO + 設計 + 工程審查,產出完整 plan/autoplan 規劃讓使用者把資料匯出成 CSV 的功能
/plan-ceo-review重新思考問題本身,四種範圍模式(擴張/選擇性擴張/守住/減法)/plan-ceo-review 這個 onboarding 該擴張還是砍掉一半步驟?
/plan-eng-review鎖架構、資料流、ASCII 圖、邊界案例與測試矩陣/plan-eng-review 審這份即時通知計畫,標出 race condition
/plan-design-review各設計維度 0–10 評分,說明 10 分長怎樣再改 plan/plan-design-review 評我的定價頁,指出哪裡像 AI slop
/plan-devex-review互動式開發者體驗審查,三種模式/plan-devex-review 我的 SDK 從安裝到第一次成功呼叫要幾步?
/design-consultation從零建立完整設計系統/design-consultation 幫 B2B 儀表板建一套設計系統,參考 Linear
/spec把模糊意圖轉成精確、可執行的 spec/spec 把「使用者要能排程貼文」寫成可執行規格

② 實作與設計 · Build

指令用途Prompt 範例
/design-shotgun生成 4–6 個 mockup,瀏覽器開比較板讓你選/design-shotgun 給我六個 landing hero 版本,客群是工程師
/design-html把選定 mockup 轉成可上線、會 reflow 的 HTML/design-html 把第 3 個 mockup 轉成零依賴 HTML
/review抓 CI 過得了但上線會炸的 bug,明顯的自動修/review 審這個 PR,只回信心 8/10 以上的問題
/investigate系統性根因除錯,鐵律是沒查清楚不准修/investigate 為什麼登入後第一次 API 偶爾回 401
/design-review設計師審查並真的進去修,原子提交、前後截圖/design-review 進去修 settings 頁的間距與層級

③ 測試與品質 · Test / QA

指令用途Prompt 範例
/qa真開瀏覽器點按鈕、找 bug、修掉、生 regression test、再驗/qa https://staging.myapp.com 把結帳流程點一遍
/qa-only同 /qa 方法但只回報告、不動 code/qa-only 測註冊流程,列出所有 bug 但先別改
/devex-review真實 onboarding 測試的開發者體驗審查/devex-review 假裝第一次用我的 CLI,記錄每個卡關點
/browse真 Chromium、真點擊、真截圖,每個動作約 100ms/browse 打開 competitor.com 定價頁,截圖並列出級距
/benchmarkpage load、Core Web Vitals、資源大小基線/benchmark 比較這個 PR 前後的首頁 LCP

④ 部署與監控 · Ship

指令用途Prompt 範例
/ship同步 main、跑測試、稽核覆蓋率、push、開 PR/ship 跑完測試把這個分支開成 PR
/land-and-deploy合 PR、等 CI、部署、驗證生產健康/land-and-deploy 合併 #128,部署後確認 /healthz 回 200
/canary部署後監控迴圈:console error、效能退化、頁面失敗/canary 盯 production 10 分鐘,有錯就回報
/setup-deploy一次性設定,讓 /land-and-deploy 能用/setup-deploy 幫我接上部署設定

⑤ 文件、安全與第二意見

指令用途Prompt 範例
/document-release比對 diff,更新所有過期文件/document-release 依這次 diff 更新 README 與 ARCHITECTURE
/document-generate用 Diataxis 框架補缺的文件/document-generate 幫 webhook 模組寫一篇 how-to
/csoOWASP Top 10 + STRIDE 威脅模型,每個 finding 附攻擊情境/cso 對檔案上傳端點做威脅模型
/codex呼叫 OpenAI Codex CLI 做跨模型第二意見(審查/對抗/諮詢)/codex 用對抗模式審我剛改的權限檢查

⑥ 瀏覽器與自動化

指令用途Prompt 範例
/open-gstack-browser開啟有側欄、反偵測 stealth 的 GStack 瀏覽器/open-gstack-browser 開一個 stealth 視窗準備爬資料
/pair-agent把你的瀏覽器分享給另一個 AI agent/pair-agent 讓 Codex 共用這個已登入的瀏覽器
/setup-browser-cookies從真實瀏覽器匯入 cookie 到 headless session/setup-browser-cookies 匯入我 Chrome 的 GitHub 登入

⑦ 反思、記憶與維護 · Reflect

指令用途Prompt 範例
/retro團隊感知的週度回顧,個人拆解與測試健康趨勢/retro 給我這週的出貨回顧與測試健康趨勢
/learn管理 gstack 跨 session 學到的東西(review/search/prune/export)/learn 看看 gstack 學到我哪些 codebase 慣例
/skillify把你重複的工作流程封裝成新的 Claude Skill/skillify 把我這套發版檢查流程包成一個 skill
/context-save把當前上下文存成 checkpoint,供之後接回/context-save 存一個 checkpoint 叫 payments-wip
/context-restore還原先前的上下文(崩潰或 context 爆掉後接回)/context-restore payments-wip 接回剛剛的進度
/setup-gbrain5 分鐘內把 gbrain 持久記憶跑起來/setup-gbrain 用本機 PGLite 建立專案記憶
/sync-gbrain讓記憶與 code index 保持同步/sync-gbrain 重新索引這個 repo 的最新變動
/gstack-upgrade升級 gstack 到最新版/gstack-upgrade 更新到最新版本

⑧ 安全控制 · Safety

指令用途Prompt 範例
/careful在 rm -rf、DROP TABLE、force-push 等破壞性指令前先攔下問你/careful 接下來接近 production,危險操作前先問我
/freeze把檔案編輯限制在單一目錄內/freeze src/payments 只准改這個資料夾
/guard/careful + /freeze 合一/guard src/auth 鎖目錄又攔危險指令
/unfreeze解除 /freeze 邊界/unfreeze 解除目錄限制

⑨ iOS 測試(v1.43.0.0+)

指令用途Prompt 範例
/ios-qa透過 USB CoreDevice 驅動真實 iPhone 測試/ios-qa 在我的 iPhone 上把登入流程點一遍
/ios-fixiOS bug 修復迴圈/ios-fix 修剛剛 ios-qa 找到的鍵盤遮擋問題
/ios-design-review設計師視角的 HIG(人機介面指南)審查/ios-design-review 用 HIG 審我的設定頁
/ios-cleandebug bridge 清理/ios-clean 清掉殘留的除錯橋接
/ios-syncaccessor 重新同步/ios-sync 重新同步 accessor 設定
指令數量會隨版本變動。以上以官方 README 與 repo 目錄為準(本手冊對應 gstack v1.57.6.0)。完整、最新的清單見 docs/skills.md 與各指令資料夾下的 SKILL.md。每個 SKILL.md 都是純 Markdown,可打開閱讀或自行修改。

加映:該用哪一個 review?

同一件事在「寫 code 前」與「寫完後」用不同指令。下表幫你選對。

你在做什麼 計畫階段(寫 code 前) 上線審查(寫完 code 後)
給終端用戶用的 UI、Web app、行動 app /plan-design-review /design-review
給開發者用的 API、CLI、SDK、文件 /plan-devex-review /devex-review
架構、效能、資料流、測試 /plan-eng-review /review
三種都涉及(全部都跑) /autoplan 會自動判斷哪些適用
04
七階段工作流

哪個階段,
用哪些指令。

gstack 把一次開發拆成七個階段,每階段把成果交棒給下一階段。下面是一輪完整 sprint 的指令地圖。小任務(改 typo、調 CSS)直接用 Claude Code 即可,不必走完整流程;跨日、多功能、上線壓力大的專案才需要整套跑。

THINK

釐清問題

把模糊想法先丟 /office-hours,讓六個逼問把它框成真正的產品問題;需要精確規格時用 /spec 寫成可執行的 spec。產出餵給下游所有階段。

核心 · /office-hours · /spec
PLAN

規劃與審查

多數情況一條 /autoplan 跑完 CEO + 設計 + 工程審查就夠。要單獨深入時用 /plan-ceo-review、/plan-eng-review、/plan-design-review、/plan-devex-review。

核心 · /autoplan
BUILD

實作與設計

設計用 /design-shotgun 出 4–6 個選項、/design-consultation 建設計系統、/design-html 把 mockup 落地成可上線 HTML;邏輯實作交給 Claude Code 本體。

核心 · /design-shotgun · /design-html
REVIEW

審查

/review 抓上線會炸的 bug;/cso 做 OWASP + STRIDE 威脅模型;/codex 拿跨模型第二意見;卡住的 bug 用 /investigate 追根因。

核心 · /review · /cso · /codex
TEST

測試與品質

/qa 真開瀏覽器點到 bug 並修掉、生 regression test;只要報告用 /qa-only;手動探查用 /browse;量效能用 /benchmark;測 DX 用 /devex-review。

核心 · /qa · /benchmark
SHIP

出貨與部署

/ship 跑測試並開 PR;/land-and-deploy 合併、等 CI、部署、驗證生產;/canary 部署後監控;/document-release 同步更新文件。

核心 · /ship · /land-and-deploy
REFLECT

回顧與沉澱

/retro 做週度回顧;/learn 管理 gstack 跨 session 學到的慣例;把重複的流程用 /skillify 封裝成新的 Claude Skill,讓下次更快。

核心 · /retro · /learn · /skillify
SAFETY

全程護欄

接近 production 時開 /careful,它會在 rm -rf、DROP TABLE、force-push 前先攔下問你;要把改動鎖在單一目錄用 /freeze;兩者合一是 /guard,解除用 /unfreeze。

核心 · /guard
05
Prompt 設計實例

看 /office-hours 怎麼
把模糊想法逼成產品。

以下是一段真實情境改寫:你想做一個「給小孩用的 AI 學習助手」,但沒講清楚誰用、解決什麼痛點。看 gstack 怎麼透過 /office-hours 把你拉回到第一性原理,接著用 /autoplan 跑完三輪審查、/qa 真的開瀏覽器測試、/ship 開 PR。

~/projects/ai-tutor · claude code · gstack v1.57
You › 我想做一個 AI 學習助手給我兒子用,他國中,英文跟數學需要陪讀。
You › /office-hours
[loaded ~/.claude/skills/gstack/office-hours/SKILL.md] [entered Founder Mode · Brian Chesky framing]
Claude(YC Office Hours)› 在你開始 coding 之前,我要先逼問你六個問題—— 不是因為我懷疑你的點子,而是因為「AI 學習助手」這個 框架,八成不是你兒子真正需要的東西。
Q1 / 上週他學習時,最讓他卡住的具體 30 分鐘是什麼? (請給我一個真實場景,不是「英文不好」這種抽象描述)
You › 上週四晚上他在寫英文閱讀測驗,看到一個句子有三個生字, 他不想查字典就直接寫錯了,結果整題都錯。他不是不會,是懶。
Claude › 好。我要 push back 一下你的框架—— 你說的是「AI 學習助手」,但你描述的痛點是: · 查字典摩擦太大 → 他選擇猜 · 沒人盯著 → 他不會回頭檢查 · 出錯後沒有後果 → 學不到教訓
這不是學習助手問題,是「無痛輔助查詢 + 自動回饋迴圈」。
[extracts 5 capabilities you didn't realize you were describing] 1. 圈詞即時翻譯(零摩擦) 2. 寫完自動標出他可能誤解的句子 3. 錯題的微反饋(不是答案,是線索) 4. 跨日累積:同一個字第二次又錯 → 提示 5. 給你(爸爸)每週簡報,看他哪邊真的卡住
[challenges 4 premises — you agree / disagree / adjust] ✗ 假設:他需要「對話式 AI」→ 反而會分心。 ✗ 假設:他想要「正確答案」→ 他想要「不被罵」。 ✓ 假設:他用平板 → 圈詞比敲鍵盤摩擦低 10 倍。 ✗ 假設:你想跟他 collaborate → 你其實想「不用每晚陪寫」。
RECOMMENDATION: 先做最窄的楔子 → 一個 iPad 圈詞翻譯小工具, 搭配每週爸爸簡報。明天就能上線。 完整願景是三個月專案——先驗證楔子。
[wrote ~/.gstack/projects/ai-tutor/design-doc.md] [7 sections, 1,847 words, ready for downstream skills]
You › /autoplan
[reads design-doc.md] [Phase 1/4 · CEO review · scope decision: HOLD SCOPE] [Phase 2/4 · Design review · 8/10 — 修了文案層級] [Phase 3/4 · Eng review · 鎖架構 + 4 個 edge cases] [Phase 4/4 · DX review · TTHW = 90s,通過]
Claude › 三個 taste 決定要你拍板,其他我都先決定了: A. 圈詞翻譯時要不要播發音? B. 每週簡報用 email 還是 LINE? C. 錯題提示要直白還是蘇格拉底式?
You › A 要,B LINE,C 蘇格拉底式。Exit plan mode.
[implementing... 2,400 lines across 11 files · ~8 min]
You › /review
[AUTO-FIXED] 2 issues · 拼字、unused import [ASK] race condition in word-cache writer → approve fix? y
You › /qa https://staging.tutor.app
[opens chromium · clicks through flows · takes screenshots] I SEE THE ISSUE — 圈詞翻譯在小於 768px 時 popup 蓋到下一行。 [fix committed · regression test generated · re-verified ✓]
You › /ship
Tests: 42 → 51 (+9 new) PR: github.com/you/ai-tutor/pull/14 · ready for review
你說「AI 學習助手」,但你描述的痛點是
查字典摩擦太大,他選擇猜。
這不是學習助手問題。
— /office-hours 的逼問,把模糊需求逼回真正的問題

這段對話為什麼值得拆解

你說「學習助手」,agent 說「你在做幕僚」——這不是 LLM 的魔法,是 /office-hours 的 SKILL.md 在指令裡寫死了「不要照字面接 ticket、要找隱藏的真問題」。換句話說,效果來自那份 Markdown,而不是運氣。你也可以打開它,改成你自己的提問框架。

八個指令,從模糊想法走到 PR——這就是 23 人團隊的意義:你不是少了一個工程師,而是少了一個會在你寫 code 之前先逼你想清楚的產品總監。

06
先看清楚這些

上路前,
先知道這些邊界。

  • 對小任務反而拖累。修個 typo、改個 CSS,直接用 Claude Code 比走 sprint 快 10 倍。gstack 是給跨日、多功能、上線壓力大的專案用的。
  • 需要先有判斷力。/office-hours 會反問你,但如果你連自己想做什麼都說不清楚,六個問題只會讓你更焦慮。先寫一份 200 字的「我為什麼要做這個」,再進來。
  • Token 消耗會明顯增加。每個技能都會載入很長的 SKILL.md(常常 400–800 行),加上 plan / review 多階段對話,跑完一輪 /autoplan + /review + /qa + /ship 容易吃掉 50–200k token。建議搭配 Claude Code 的 context 監控。
  • Browser 模式會吃資源。/qa 跟 /browse 是真的開 Chromium,記憶體佔用明顯。在低記憶體的機器上同時開多個瀏覽器 session 容易卡頓,一次跑一個比較穩。
  • 會載入長 prompt,留意上下文用量。每個技能會載入完整的 SKILL.md,多階段的 plan / review / qa 對話會快速累積 token。長 sprint 時搭配 Claude Code 的 context 監控,必要時用 /context-save 存檔再接回。
  • Windows 需要額外裝 Node.js。官方需求列明 Windows 除了 Bun 還要 Node.js;macOS / Linux 只需 Bun v1.0+。環境不齊全時 setup 會失敗。
  • 把 /careful、/freeze、/guard 當真。接近 production 時用 /careful,它會在 rm -rf、DROP TABLE、force-push 之前先攔下來問你;/guard 再加上目錄鎖定。別等出事才想到。
  • 評分不等於品味。/plan-design-review 給 0–10 評分時要批判性看;9 分與 10 分的差距常是品味判斷,模型不會替你定案,你自己得有看法。
07
進階路徑

把 gstack 編輯成你自己的。

最 underrated 的事實:每個 SKILL.md 都是純 Markdown。你可以打開來改、加章節、加你自己的審查規則,完全不需要寫 code。Garry 也鼓勵你 fork。

進階玩法地圖

1. 客製化你的 /review。打開 ~/.claude/skills/gstack/review/SKILL.md,在「Critical Findings」段落加你公司的 lint 規則、命名慣例。下次 /review 就會抓。

2. 用 /skillify 封裝你的 workflow。repo 內建的 skillify/ 會把你重複的 Claude Code 操作打包成新 skill,放進 ~/.claude/skills/your-name/。你的 prompt 工程也能變成資產。

3. 接 GBrain 做持久記憶。跑 /setup-gbrain 把專案知識存到 Postgres(本機 PGLite 或 Supabase),Claude Code 重啟也記得你的 codebase 模式跟過去決策。

4. 接 OpenClaw 做多 agent。OpenClaw 可以同時跑多個 Claude session,搭配 gstack 變成你的「個人工程部」,讓多個任務並行推進。詳見 docs/OPENCLAW.md。

5. 加你自己的 host。如果你用的 AI agent 不在預設 host 清單裡,看 docs/ADDING_A_HOST.md——只需要寫一個 TypeScript config 檔,不用改任何 code。

最該讀的三份延伸閱讀

① docs/skills.md——每個技能的哲學、實例、工作流程深度解析。
② ETHOS.md——Garry 的建造哲學:Boil the Lake、Search Before Building、三層知識結構。
③ USING_GBRAIN_WITH_GSTACK.md——把記憶層接起來的完整步驟。

Fork it. Improve it. Make it yours.
And if you want to hate on free open source software—
you're welcome to, but I'd rather you just try it first.
— Garry Tan,gstack README