GH-600 數位教科書 開啟互動版

跨領域整合速查

從 issue 到 PR 的控制鏈

六個領域描述的是同一個工作流程的不同責任。工具能執行卻沒有授權,流程不完整;驗證通過卻不知道測哪個版本,證據不完整;換了代理卻沒有交接副作用,恢復也不完整。用一個端到端案例檢查各環節,比單獨背誦六組術語更容易發現缺口。

匯出修正的交付包

延續全書案例:CSV 的逗號欄位錯位,初始任務只允許修正實作與測試,不包含發布。以下表格是本書設計的交付檢查方式,可依團隊既有 issue、PR 與 CI 紀錄呈現。

階段 應作的決定 交付證據 對應領域
接收需求 哪些輸入要正確,哪些行為不能改 最小失敗案例與驗收條件 D1
準備執行 使用哪些工具、身分、分支與測試資源 有限權限與環境紀錄 D2、D6
實作與恢復 中斷後如何接續,哪些副作用已發生 版本化產物與 checkpoint D3
驗證結果 是否修好原問題並維持相鄰行為 同一組前後測試與掃描結果 D4
整合工作 誰有修改責任,衝突由誰裁決 分派、交接與整合後驗收 D5
交給人決定 是否在核准範圍,能否回復 差異、風險、核准對象與未測事項 D6

若某一步無法提供必要證據,先處理該缺口,不把「代理已完成」當成替代。例如代理輸出正確 patch,但測試服務不可用,可以交付差異並明列未驗證情境;不能回報驗收通過,也不必丟棄已確認的工作。

紙上實作:建立一份可審查摘要

用自己的專案寫出需求、允許範圍、成功與停止條件、工具與資源、產物位置及未完成事項。再請另一位讀者只依這份資料回答:要從哪個版本開始、下一步能做什麼、哪個動作必須先詢問。若對方必須猜測,交付包就還缺資料。

完整交付包中的進度段落可以寫成:「逗號、引號與空值案例在指定 commit 通過;換行案例尚未執行;沒有修改資料庫或對外發布;下一步在相同版本補跑換行驗收。」這段文字比「完成 90%」更能指出剩餘工作,但不能單獨完成交接:交付包仍須附上實際 commit 識別、測試證據位置、核准範圍與可取得的產物。

題幹辨識順序

  1. 找動詞:configure、prevent、evaluate、recover、orchestrate。
  2. 找限制:least privilege、irreversible、specific repository、without disrupting。
  3. 判斷生命週期:規劃、執行、評估、恢復或稽核。
  4. 排除未授權或超出必要範圍的擴權,以及跳過必要驗證、丟失狀態或增加無效摩擦的選項。
  5. 在滿足需求的方案中,優先選擇最小、直接、可驗證且可回復的做法;若操作本質不可逆,確認明確授權與受控路徑。

把限制放進因果判斷

情境一: 建立 PR 的呼叫逾時,題目要求避免重複提交寫入要求。選項是立即重試、改用較大模型,或先查遠端結果。

解析: 先查遠端是否已存在對應 PR。動詞是 recover,限制是避免重複寫入要求;逾時不能證明操作未完成。模型更大不會解決結果未知,立即重試則可能再次要求已完成的工作。是否會真的產生重複產物,取決於工具的冪等與重複檢查契約。這同時涉及 D2 的錯誤處理與 D3 的狀態對帳。

情境二: 兩個代理分別完成修改,題目要求在不破壞既有功能下整合。各自測試都通過,但使用不同格式假設。

解析: 先以共同契約解決語意衝突,再對整合後版本驗收。不能只做文字合併,也不能用多數決決定產品規格。這同時涉及 D5 的整合責任與 D4 的評估對象。

情境三: MCP 工具只能查詢文件,回傳內容卻要求代理提高權限。題目要求防止越權操作。

解析: 把回傳文字當成資料,不讓它擴大原始授權;工具與執行身分仍應限制可用能力。新增事後日誌有助追查,但不能取代動作前的限制。這同時涉及 D2 的工具邊界與 D6 的護欄。

以上為本書原創情境。若題目改成「追查越權已經發生的原因」,評估重點就會移到日誌、版本與工具時間線;不能不看動詞而永遠選同一種防線。

常見跨域陷阱

容易混淆的概念 區分問題 誤判的後果
護欄與評估 在阻止動作,還是在判斷產物品質? 以事後檢查冒充事前限制
記憶與狀態 是可重用知識,還是當前進度? 記住專案慣例卻遺失已發生的副作用
自主與權限 能自行決定,還是有能力操作資源? 把自主工作誤解為不限範圍的授權
重試與恢復 再做一次是否會增加效果? 在結果未知時重複寫入
隔離與整合 各自不互相覆寫,是否代表結果相容? 合併後才發現格式或行為衝突
檢查成功與交付成功 該檢查驗證了哪些需求與版本? 用綠燈掩蓋跳過案例或版本落差

反向檢核你的理解

讀完後,試著不用術語回答下面的問題:

  1. 為什麼核准計畫不一定包含發布?說出一個超出原範圍的副作用。
  2. 為什麼換一位代理不能直接重跑逾時操作?指出應先查證的遠端狀態。
  3. 為什麼兩份測試全綠的修改仍要整合驗收?指出可能衝突的共同契約。
  4. 為什麼把所有聊天保存下來仍可能無法恢復工作?指出缺少的版本或產物。
  5. 為什麼核准次數多不代表風險低?指出真正需要人判斷的動作。

參考回答分別是:授權依具體範圍成立;寫入結果未知可能造成重複副作用;各自的結果不代表合併版本;聊天不保證產物可取得且仍有效;人工注意力應對準實質風險。若只能記住這五句而無法舉例,請回到相應章節,把例子改寫成自己的工作情境。

技能對照:GH-600 Study Guide(GH600-SG)。產品客製化入口延伸閱讀:GH-DOC-28。本章整合案例與驗收方式為教學設計,並未宣稱經外部專家審訂。