GitHub

GitHub 設定有兩個階段：Corvo GitHub App 決定可存取的儲存庫範圍；Agent environment 決定要為 Agent 執行預先準備哪些儲存庫。

​

安裝 Corvo GitHub App

1. 開啟 Integrations → GitHub。
2. 選擇 Install the Corvo GitHub App。
3. 選擇要授權的 GitHub 帳號與儲存庫。組織可能要求管理員核准。
4. 回到 Corvo，確認狀態為 CONNECTED。

日後可用 Add or configure repositories 修改 App 的安裝範圍。即使 App 能存取所有儲存庫，也不代表所有儲存庫都會加入 Agent environment。

​

準備 Agent environment

1. 在 Agent environment 選擇 Add repo，加入 GitHub App 可存取、且 Corvo 需要使用的儲存庫。
2. 為每個儲存庫輸入設定指令。Corvo 會在僅預先安裝 Node、Git 和 gh 的乾淨環境中，從儲存庫根目錄執行。請自行安裝專案需要的套件管理器與依賴。例如 pnpm 專案可使用：
   npm install -g pnpm
   pnpm install --frozen-lockfile
   
3. 選擇 Save & build。Corvo 會執行每個設定指令並準備環境快照。
4. 等待狀態顯示 READY。Agent 執行時會從快照啟動，再取得最新程式碼。

設定失敗時，先查看該儲存庫的執行日誌，修正指令後重新選擇 Save & build。修改儲存庫或指令後，也要重新建立環境，後續執行才會使用新設定。

​

審查修正 PR

調查完成後可能只有分析結果，不一定會修改程式碼。若 Agent 建立 PR，請到 GitHub 審查變更與測試結果。Permissions 會另外控制 Git 與 GitHub 操作，與 App 安裝範圍分開設定。