GitWhy

GitWhy 是什麼？

GitWhy 是 Git 的「脈絡層」，用來保存並分享 AI 生成程式的推理脈絡，直接連結到產生該程式的提交（commit）。目的是讓提示詞、決策和取捨能與程式碼變更一同審查，而不是只留在聊天視窗中。

它會擷取結構化脈絡（例如原始提示詞、推理、決策、被捨棄的替代方案），並將這些脈絡連結到提交。產品會在拉取請求（PR）中呈現這些保存的推理，讓審查者能了解變更原因，而不僅僅是 diff。

主要功能

• 結構化「推理」脈絡：儲存固定格式，包括提示詞、推理、決策、被捨棄的替代方案、檔案和提交，以確保各次執行輸出一致。
• 連結到提交（git 原生出處追蹤）：每個保存的脈絡都綁定到產生它的確切提交，讓文件始終錨定在程式碼歷史中。
• 透過 gitwhy-bot 在 PR 中呈現：將完整推理推送到拉取請求作為 PR 留言，讓審查脈絡在程式碼審查時可用。
• 雲端同步與分享：將保存的脈絡同步到雲端，讓團隊能在組織內分享。
• 跨脈絡搜尋：讓使用者依關鍵字、領域或主題搜尋保存的推理，快速找到先前的決策。
• 適用於 MCP 相容代理：設計用於任何 MCP 相容代理（本頁明確提及 Claude Code、Cursor、Windsurf 和 Cline）。
• 終端機 UI 管理：提供互動式終端介面，用來瀏覽、搜尋和管理脈絡，無需瀏覽器。

如何使用 GitWhy

1. 使用 MCP 相容代理產生程式碼，並確保代理產生您想擷取的推理。
2. 保存推理脈絡，GitWhy 會記錄結構化項目（提示詞、推理、決策、被捨棄的替代方案、檔案和提交），並連結到相關提交。
3. 同步到雲端（用於團隊分享），然後開啟拉取請求。
4. 在 PR 中審查：GitWhy 的 bot 會將保存的推理貼到拉取請求，讓審查者能閱讀底層決策和取捨。

使用情境

• AI 輔助變更的 PR 審查：當 AI 產生程式碼時，審查者可在 PR 留言中閱讀儲存的推理和決策，而非從 diff 推斷意圖。
• 團隊知識擷取，重複設計選擇：認證、資料庫和 API 設計決策可儲存在依領域/主題組織的脈絡樹中，幫助團隊重用過去的理由。
• 審計特定提交背後的「為何」：由於每個脈絡都連結到產生它的提交，開發者能追溯決策起源至確切的程式碼變更。
• 新工作中更快擷取：從終端機、代理或團隊儀表板依關鍵字、領域或主題搜尋保存脈絡，快速找到相關理由。
• 多代理工作流程：使用不同 MCP 相容代理的團隊，能在單一地方擷取和管理推理，而無需依賴單一聊天介面。

常見問題

• GitWhy 為每個脈絡儲存哪些資訊？ 頁面描述一個結構化格式，包括提示詞、推理、決策、被捨棄的替代方案、檔案和提交。

• GitWhy 如何將推理連結到程式碼？ 它將每個保存的脈絡連結到產生它的確切提交。

• 審查者在哪裡看到推理？ GitWhy 的 bot 會將完整推理作為 PR 留言貼到拉取請求。

• 可以不使用瀏覽器嗎？ 可以。產品包含互動式終端 UI，用來瀏覽、搜尋和管理脈絡。

• 支援哪些代理？ 網站表示適用於任何 MCP 相容代理，並明確提及 Claude Code、Cursor、Windsurf 和 Cline。

替代方案

• 純 PR 描述或留言：團隊可以手動將推理貼到 PR 文字中，但這無法自動保存結構化的、連結到 commit 的變更原因歷史。
• 外部文件系統（wiki/知識庫）：團隊可以單獨維護決策文件，但這些文件不會本質上連結到 commit，也不會自動顯示在 PR 中。
• 本機日誌/聊天記錄檢視：閱讀先前的聊天記錄可提供脈絡，但搜尋性較差，且通常未連結到儲存庫歷史中的 commit。
• 通用程式碼審查工具與註解：註解 diff 的工具可解釋變更，但本處原始文字強調結構化的、連結到 commit 的推理，以及透過 gitwhy-bot 發佈到 PR，這可能未被通用審查工具涵蓋。