終端操作 是做什麼的?
當使用者想要在真實儲存庫中執行操作時使用此技能:執行指令、檢查 Git 狀態、除錯 CI 或建置、進行狹義修正,並精確回報哪些內容已變更及經過驗證。
此技能特意比一般程式碼輔導更為狹義。它是一種用於證據優先終端執行的操作員工作流程。
技能組合
在相關時,將這些 ECC 原生技能拉入工作流程:
verification-loop用於在變更後進行精確的證明步驟tdd-workflow當正確的修正需要回歸測試覆蓋率時security-review當涉及機密、驗證或外部輸入時github-ops當任務依賴於 CI 執行、PR 狀態或發佈狀態時knowledge-ops當需要將驗證結果擷取到持久的專案背景中時
使用時機
- 使用者說「修正」、「除錯」、「執行此項」、「檢查儲存庫」或「推送它」
- 任務依賴於指令輸出、Git 狀態、測試結果或經過驗證的本機修正
- 答案必須區分「本機變更」、「本機驗證」、「已提交」和「已推送」
護欄
- 編輯前先檢查
- 如果使用者僅要求稽核/審查,則保持唯讀模式
- 優先使用儲存庫本機的腳本和輔助工具,而非臨時自製的包裝腳本
- 在重新執行證明指令之前,不要聲稱修正完成
- 除非分支實際上已推送到上游,否則不要聲稱推送完成
工作流程
1. 解析工作介面
確定:
- 確切的儲存庫路徑
- 分支
- 本機差異狀態
- 請求的模式:
- 檢查
- 修正
- 驗證
- 推送
2. 先讀取失敗介面
在變更任何內容之前:
- 檢查錯誤
- 檢查檔案或測試
- 檢查 Git 狀態
- 先使用任何已提供的日誌或背景,再盲目地重新讀取
3. 保持修正範圍狹窄
一次解決一個主要失敗:
- 首先使用最小的有用證明指令
- 只有在解決本機失敗之後,才升級到更大的建置/測試通過
- 如果某個指令持續以相同的特徵失敗,則停止廣泛的重試並縮小範圍
4. 回報精確的執行狀態
使用精確的狀態詞彙:
- 已檢查
- 已在本機變更
- 已在本機驗證
- 已提交
- 已推送
- 已封鎖
輸出格式
SURFACE
- 儲存庫
- 分支
- 請求的模式
EVIDENCE
- 失敗的指令 / 差異 / 測試
ACTION
- 變更了什麼
STATUS
- 已檢查 / 已在本機變更 / 已在本機驗證 / 已提交 / 已推送 / 已封鎖
陷阱
- 當可以讀取即時儲存庫狀態時,不要根據過時的記憶進行操作
- 不要將狹義的修正擴大為儲存庫範圍的翻新
- 不要使用破壞性的 Git 指令
- 不要忽略無關的本機工作
驗證
- 回應中需命名證明指令或測試
- 與 Git 相關的工作需命名儲存庫路徑和分支
- 任何推送聲明都需包含目標分支和確切結果