Coding Agent
審閱 Andy 的工作成果
檢視、接受或修改 Andy 開立的 pull request。
Coding Agent 完成後,你會有兩個審閱介面:變更說明(PR 開立前)與 pull request 或 merge request(PR 開立後)。本頁說明在每一步要看什麼、怎麼迭代。
PR 之前:變更說明
實作完成後,Andy 會發布變更說明:在 PR 還沒開之前先把變更摘要給你看。打開網頁應用中的任務,或 Slack 中的「實作完成」訊息,可以看到:
- 變更摘要:Coding Agent 做了什麼,用直白的語言說明
- 變動檔案:路徑與每個檔案的簡短 diff
- 測試結果:若測試有跑,會包含測試輸出
- 注意事項:Andy 想請你留意的東西,例如延後的後續工作或它做出的某些假設
- 分支連結:實際分支在 GitHub 或 GitLab 上的位置,方便你直接檢視
這是修正方向最便宜的時機。如果有不對勁,點選 Make changes 描述希望怎麼調整。Coding Agent 會從停下的地方接手,把後續 commit 推到同一個分支。
如果變更說明看起來沒問題,點選 Create pull request 開立 PR。
PR 開立之後
Andy 會以機器人帳號(@meetandyai,或你 GitHub App 安裝對應的等價帳號)開立 PR/MR,並在 Slack 討論串中貼上連結。任務移到 PR open。
PR 描述包含:
- 變更內容的摘要
- 主要修改的條列清單
- 連回 MeetAndy 任務頁的連結
- Andy 想讓你知道的注意事項
接下來就是一般的程式碼審閱:
- 看 diff:在 GitHub 或 GitLab 上像審閱任何同事的 PR 一樣審閱。
- 跑 CI/預覽部署:Andy 會等這些完成才把任務視為完成。
- 留下評論:如果想修改的話。
PR 開立後請求修改
PR 開立後仍有兩種方式請求修改:
- 在 GitHub 或 GitLab 留 PR 評論:行內或一般評論都可以。Andy 會讀並以後續 commit 推回同一個 PR。
- 在 Slack 討論串回覆:描述你希望的差異。Andy 會把這當作 request-changes 訊號並推送新 commit。
如果你已經想自己接手,也可以直接 push 到分支,PR 會接續你的 commit。
核准與合併
合併是 手動 的。Andy 不會合併自己的 PR,那永遠是你的決定。請走你平常的 GitHub/GitLab 合併流程:
- 走你平常的審閱流程核准 PR
- CI 綠燈、審閱者也都認可後再合併
PR 合併後,Andy 會自動接到合併事件,把任務移到 Done。如果你有用 Jira,Andy 還可以更新對應的工單,請見 讀取與更新工單。
不想合併、想丟掉時
如果結果不如預期、不打算合併:
- 在 GitHub/GitLab 上關閉 PR:Andy 會察覺並把任務移到 PR rejected
- 在 Slack 討論串或網頁應用點選 Discard and exit:Andy 會關閉 PR(若已開立)並把任務移到 Abandoned
無論哪種,分支都會留在你的 Git host 上,直到你手動刪除為止。Andy 不會自動清理分支。