使用手冊

開源工程 · Claude Code 設定檔 / 全指令手冊

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

garrytan/gstack 完整使用手冊:安裝、七階段工作流、40+ 斜線指令速查表,每個指令附 Prompt 範例。涵蓋規劃、設計、審查、QA、部署、文件、安全與 iOS 測試。

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

garrytan/gstack
星標
105K
分支
15.7K
授權
—
資料截至
閱讀時間
14 分
更新日期
開啟原始報告
GitHub Stars
108k
斜線指令
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 節說明哪個階段該用哪個指令。

  1. Think

  2. Plan

  3. Build

  4. Review

  5. Test

  6. Ship

  7. Reflect

「I don't think I've typed like a line of code probably since December.」 過去四個月,我幾乎沒手打過半行程式。

— Andrej Karpathy(OpenAI 共同創辦人)2026 年 3 月 No Priors Podcast

0230 秒安裝

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

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

bash
# 貼這段給 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 根目錄貼這段:

bash
(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"

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 設定

加映:該用哪一個 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

05Prompt 設計實例

看 /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: Claude(YC Office Hours)›
  在你開始 coding 之前,我要先逼問你六個問題——
  不是因為我懷疑你的點子,而是因為「AI 學習助手」這個
  框架,八成不是你兒子真正需要的東西。


  hl: Q1 / 上週他學習時,最讓他卡住的具體 30 分鐘是什麼?
      hl: (請給我一個真實場景,不是「英文不好」這種抽象描述)


$ You ›
  上週四晚上他在寫英文閱讀測驗,看到一個句子有三個生字,
  他不想查字典就直接寫錯了,結果整題都錯。他不是不會,是懶。


claude: Claude ›
  好。我要 push back 一下你的框架——
  你說的是「AI 學習助手」,但你描述的痛點是:
    · 查字典摩擦太大 → 他選擇猜
    · 沒人盯著 → 他不會回頭檢查
    · 出錯後沒有後果 → 學不到教訓


  hl: 這不是學習助手問題,是「無痛輔助查詢 + 自動回饋迴圈」。


  [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 → 你其實想「不用每晚陪寫」。


  ok: RECOMMENDATION:
    ok: 先做最窄的楔子 → 一個 iPad 圈詞翻譯小工具,
    ok: 搭配每週爸爸簡報。明天就能上線。
    ok: 完整願景是三個月專案——先驗證楔子。


# [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: Claude ›
  三個 taste 決定要你拍板,其他我都先決定了:
    hl: A. 圈詞翻譯時要不要播發音?
    hl: B. 每週簡報用 email 還是 LINE?
    hl: 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]
claude: I SEE THE ISSUE — 圈詞翻譯在小於 768px 時 popup 蓋到下一行。
# [fix committed · regression test generated · re-verified ✓]


$ You › /ship


ok: Tests: 42 → 51 (+9 new)
ok: 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先看清楚這些

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

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