terminal-ops

Terminal Ops

當使用者需要實際的儲存庫執行時使用此技能：執行指令、檢查 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 相關的工作需指明儲存庫路徑與分支
• 任何推送聲明需包含目標分支與確切結果