gstack /retro 是什麼、怎麼安裝使用：從 git 提交記錄生成每週工程復盤

本文根據 garrytan/gstack 倉庫裏該技能的 SKILL.md 與倉庫 README 整理，資料核對於 2026-10-11。所在倉庫 garrytan/gstack 在 GitHub 約 13.6 萬 Star（同日數據）。技能內容會隨倉庫更新，以倉庫為準。

這個 Skill 做什麼

週會上被問到「這週做了什麼」，多數人靠回憶。/retro 讓智能體直接去讀 git 歷史。description：每週工程復盤；分析提交歷史、工作模式和代碼質素指標，帶持久化的歷史與趨勢跟蹤；能識別團隊，按人拆分貢獻，給出表揚和成長空間。README 把它對應的角色叫作工程經理。

SKILL.md 列出了它的調用方式：

• /retro：預設最近 7 天；/retro 24h、/retro 14d、/retro 30d 指定窗口；
• /retro compare：和緊挨着的上一個同長度窗口對比；
• /retro global：跨項目復盤，彙總本機各個 AI 編程工具下的項目，不要求當前目錄是 git 倉庫。

一次復盤的步驟很細：先拉取遠端，用一條命令採集指標；然後計算提交的時間分佈、推斷工作時段、按類型拆分提交、找出改動熱點文件、統計 PR 大小分佈，評出專注度和「本週最佳交付」；逐個成員分析；窗口不少於 14 天時做周環比；統計連續交付的天數；還有一份「捷徑債務」台帳，掃描代碼裏留下的臨時方案。最後讀入以前的復盤做比較，存一份 JSON 快照，再寫成敘述性的總結。

幾條規則值得知道：分析的是遠端預設分支而不是本地可能過期的 main；時間按你的本地時區顯示；合併提交被當作 PR 的邊界；這段時間沒有提交會直說，並建議換個窗口。

怎麼安裝

/retro 不單獨發佈，隨 gstack 整套安裝。README 的要求是先裝好 Claude Code、Git 和 Bun（Windows 另需 Node.js），然後：

bash
git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.claude/skills/gstack && cd ~/.claude/skills/gstack && ./setup

./setup 預設只給 Claude Code 裝；其他智能體用 ./setup --host codex（或 --host auto），README 把這些標為實驗性支持，技能名會帶 gstack- 前綴。注意整套安裝還會編譯工具、下載一份 Chromium 供它的瀏覽器類技能使用，這部分和 /retro 無關，但會佔磁盤。

倉庫整體介紹和其他安裝方式，詳見本站《gstack 是什麼、怎麼安裝和使用：YC 總裁 Garry Tan 的 Claude Code Skills 工作流》。

怎麼用

在項目倉庫裏：

• 「/retro」——出最近一週的復盤。
• 「/retro compare 14d」——最近兩週和之前兩週比。
• 「/retro global」——看自己這一週在所有項目上的投入和切換情況。

適合誰 / 侷限

適合小團隊的技術負責人做週報和迭代回顧的底稿，也適合獨立開發者回看自己的節奏。侷限很明確：它只能看到進了 git 的東西，評審、討論、排查問題這些不產生提交的工作不會被統計；按人拆分貢獻和「每小時代碼行數」這類指標容易被誤讀，適合做回顧的引子，不適合當績效依據；提交資訊寫得隨意，分類也會跟着不準。

注意事項

• 許可：MIT。
• 會執行命令：運行 git fetch 和倉庫自帶的指標腳本；復盤快照存在項目的 .context/retros/，全局模式存在 ~/.gstack/retros/。
• 涉及同事的數據：報告裏有按人的統計，往外發之前想清楚是否合適。
• 遙測：預設關閉，README 說明即使開啟也不上載代碼、路徑和倉庫名。