Unblocked Code Review

什麼是 Unblocked Code Review？

Unblocked Code Review 是一款由 AI 驅動的程式碼審查助理，設計目標是貼近你團隊實際的工作方式。它不只是依賴一般性的最佳實務或表面上的程式風格檢查，而是從你組織在真實世界中的決策、慣例以及系統架構中學習，為每一個 Pull Request 提供高品質、具情境感知的回饋。

透過連結你的程式碼庫、溝通紀錄、文件與規劃工具，Unblocked 會建立一個「活的知識圖譜」，描述你的系統如何運作，以及為何要這樣設計。接著，它會利用這份理解，提出有意義的審查評論、對 CI 失敗給出修復建議，並以豐富情境來摘要變更內容。最終帶來的效果是：更少吹毛求疵，更高訊號品質，以及更快速、更有信心的程式碼審查流程。

主要功能

• 團隊記憶與情境感知審查
  Unblocked 會記住你團隊隨時間累積下來的各種決策。它會引用實際的 Slack 討論、過去的 PR，以及已紀錄的架構或產品決策，讓回饋方式與團隊偏好的工作模式保持一致，而不是套用抽象、千篇一律的規則。

• 具系統意識的架構理解
  這套工具能理解你系統的模式與限制。它不會去標記對你技術棧不適用的理論問題，而是根據實際的系統架構、設計模式與營運情況提出真正相關的顧慮。

• CI 失敗分析與可執行修復建議
  當 CI 壞掉時，Unblocked 不只是把日誌丟給你看，而是會分析 CI 輸出，並在 Pull Request 中直接張貼具體、可執行的修復建議，將失敗轉化成清楚明確的待辦事項。

• 高品質的 PR 行內評論
  Unblocked 會在 PR 中留下行內評論，標示出邏輯錯誤、競態條件、安全風險與不安全模式等問題。重點放在正確性、穩健性與可維護性，而不是表面上的程式風格瑣事。

• 用於互動式審查的 PR Chat（@unblocked）
  開發者可以在 PR 討論串中提及 @unblocked，來追問細節、請求更深入的解釋、索取範例或測試，或就特定程式碼區段進行反覆調整。你也可以請它產生圖表，將資料流或系統變更以視覺方式呈現。

• 具情境的豐富 PR 摘要
  Unblocked 會產生更高層次的 PR 摘要，將相關工作、歷史團隊討論與關聯工作單一併納入考量。這有助於審查者快速理解變更的意圖與影響，而不只是閱讀 diff。

• 由既有工具驅動的知識圖譜
  透過匯入程式碼庫、Slack、文件及規劃系統（如 Jira）中的資料，Unblocked 會建立一張描述你程式碼與協作方式的知識圖譜。它會在 Issue、PR、聊天與文件之間建立連結，依據新近程度與權威性為資訊排序，並在不同來源意見不一致時進行整合。

• 持續同步與隨時最新的情境
  Unblocked 會持續與你的程式碼庫及已連結工具同步，掌握最新的變更、決策與架構演進，確保回饋能反映系統「現在」的實際狀態。

• 安全與合規（SOC 2 Type II）
  此平台通過 SOC 2 Type II 稽核與認證，在安全性、可用性與機密性方面符合要求。它採用企業級權限管理與細緻的存取控制，確保你的資料安全無虞。

• 具權限感知的存取控制
  Unblocked 會尊重你現有資料來源的權限與安全邊界。它能在公開與私有版本庫中無縫運作，且不會逾越使用者原本擁有的權限範圍。

• 企業就緒功能
  支援 SSO、稽核日誌與角色為本的存取控制（RBAC），讓 Unblocked 適用於各種規模的團隊與組織，包括管控嚴格的企業環境。

• 快速上線與免費試用
  你可以先使用 21 天免費試用（無需信用卡）。多數團隊在 10 分鐘內即可完成設定，只需快速安裝與極少量配置。

如何使用 Unblocked Code Review

1. 註冊並啟用免費試用
   前往 Unblocked Code Review 官方網站，啟用 21 天免費試用。無需信用卡，非常適合在團隊內快速測試與評估。

2. 連結程式碼版本庫
   使用安全的 OAuth 整合，將 Unblocked 連結到你的 Git 託管平台（如 GitHub、GitLab 或類似服務）。Unblocked 會遵守版本庫現有的權限設定，並同時支援公開與私有 repository。

3. 匯入對話、文件與規劃工具資料
   連結 Slack、文件系統，以及 Jira 等 Issue 追蹤工具。這能讓 Unblocked 學習你們實際的決策歷史、架構討論與專案情境。

4. 讓 Unblocked 建立知識圖譜
   完成連結後，Unblocked 會持續同步資料，並建立一張知識圖譜，用來關聯：

   • 將 Jira Issue 對應到相關的 PR
   • 將 Slack 討論串對應到程式碼決策
   • 將文件對應到特定元件與模組
     它會依新近程度與權威性為來源排序，並調和彼此衝突的資訊。

5. 像平常一樣建立 Pull Request
   開發者可以維持原有的 Git 工作流程。當 PR 被建立或更新時，Unblocked 會在蒐集到的情境知識基礎上分析 diff。

6. 檢視行內評論與建議
   當偵測到邏輯問題、潛在競態條件、安全疑慮或不安全模式時，Unblocked 會在 PR 中留下行內評論。你可以像閱讀資深工程師的回饋一樣，檢視這些評論並選擇接受、調整或展開討論。

7. 利用可執行建議處理 CI 失敗
   當 CI 失敗時，Unblocked 會解析日誌，並在 PR 內貼出清楚且具體的修復建議。開發者無需一再翻閱冗長日誌，就能快速找到根本原因並完成修正。

8. 使用 PR Chat 進行深入討論
   在 PR 討論中提及 @unblocked，可以：

   • 要求針對某個問題提供更詳細的說明
   • 索取實作範例或測試案例
   • 釐清某項變更對系統其他部分的影響
   • 產生圖表來視覺化資料流或架構變動

9. 善用 PR 摘要，加速審查流程
   利用 Unblocked 產生的高情境 PR 摘要，讓審查者快速上手。摘要會凸顯關鍵變更、關聯工單與歷史背景，有助於縮短審查週期並提升理解深度。

10. 自訂審查規則與回饋程度
    你可以透過設定來微調 Unblocked 的行為，例如指定要審查的範圍、排除特定模式或檔案，以及調整回饋的詳盡程度與語氣，讓它更符合你團隊的文化與需求。

使用情境

1. 需要擴充程式碼審查產能的工程團隊
   團隊成長後，PR 量往往暴增，容易造成審查瓶頸與草率的 Review。Unblocked 可作為一位高訊號、具情境感知的虛擬審查者，在早期就捕捉關鍵問題，讓人工審查者得以專注於更深入的設計與產品討論，而不是重複性檢查。

2. 分散式或遠端優先的組織
   對於遠端或全球分散的團隊，上下文資訊通常散落在各個時區與不同工具中。Unblocked 會把來自 Slack、文件與工單的知識整合進審查流程，減少來回詢問，即使團隊成員不在同一時間線上，也能保持高品質的程式碼審查。

3. 架構複雜且約束眾多的系統
   使用微服務、事件驅動架構或嚴格領域邊界的系統，需要更細緻的審查。由於 Unblocked 能理解系統，並以實際架構與既有決策為依據，因此可以標記那些違反既定模式、引入高風險依賴或與既有設計選擇相衝突的變更。

4. 對安全與合規高度敏感的程式碼庫
   處理敏感資料或受監管規範約束的團隊，需要嚴謹且一致的程式碼審查。Unblocked 能偵測安全風險、不安全模式與政策違規，再加上 SOC 2 Type II 合規與權限感知的存取控制，非常適合這類環境。

5. 新工程師加入大型程式碼庫
   新成員往往不了解各種模式、決策或技術債背後的歷史脈絡。將 Unblocked 嵌入 PR 工作流程後，新工程師收到的解說與建議會反映資深團隊成員的經驗，從而加速熟悉程式碼庫並降低導入成本。

常見問題（FAQ）

1. Unblocked 如何存取我的程式碼？
Unblocked 透過安全的 OAuth 連線整合到你既有的工具中。它會遵守你在 Git 託管平台及其他資料來源中設定的權限。除了執行分析所必需的部分外，你的程式碼不會被長期儲存，所有存取行為都受你組織的安全政策管控。

2. 它能支援私有 repository 嗎？
可以。Unblocked 同時支援公開與私有 repository，並完全遵循你組織的存取控制與權限設定，確保只有經授權的使用者與服務可以存取敏感程式碼。

3. 我可以自訂 Unblocked 要審查的範圍與評論方式嗎？
可以。你可以依照團隊標準設定審查規則，排除特定模式或檔案（例如自動產生程式碼或既有遺留模組），並調整回饋的詳細程度，從非常細緻到較為精簡皆可。這讓你可以將 Unblocked 的行為調整到最符合自身工作流程與偏好。

4. Unblocked 與其他 AI 程式碼審查工具有何不同？
多數 AI 程式碼審查工具只看 diff 或單一檔案，然後套用通用的最佳實務。Unblocked 則會透過整個程式碼庫、討論紀錄、文件與歷史決策建立知識圖譜。藉由這些豐富的情境，它能產生真正有幫助且具情境意識的評論，並理解你的具體系統，而不是假設一個通用架構。

5. Unblocked 支援哪些程式語言？
Unblocked 支援所有主流程式語言，包括但不限於 JavaScript、TypeScript、Python、Go、Java、Ruby、PHP、C++ 和 C#。這樣的廣泛支援，非常適合多語言程式碼庫與現代全端團隊。

6. 建置需要多久時間？需要哪些前置作業？
多數團隊在 10 分鐘內就能完成導入。你只要啟用免費試用，透過 OAuth 連結 repository 與常用協作工具，Unblocked 便會立刻開始學習你的程式碼庫與決策歷史。無需複雜設定，就能快速獲得初始價值。

7. Unblocked 是否安全且適用於企業？
是的。Unblocked 通過 SOC 2 Type II 稽核與認證，在安全性、可用性與機密性方面達到企業級標準。它提供 SSO、稽核日誌與角色為本的存取控制等企業功能，並且會尊重所有已連結資料來源的既有權限設定。