terminal-ops

terminal-ops 技能概觀

terminal-ops 是一個以證據為先的 terminal 執行技能，專門用於 repo 工作，不是通用的 coding copilot。它最適合需要實際執行命令、檢查 repository、追查 CI 或 build 失敗，或做出範圍很小的修正，並且要有明確證據說明改了什麼、驗證了什麼的使用者。

terminal-ops 用來做什麼

當工作需要真實的 terminal 輸出時，就該使用 terminal-ops 技能：像是檢查 git 狀態、執行 tests、重現 bug、驗證修正，或確認變更是只在本機、已 commit，還是已 push。terminal-ops 技能的設計目標，是降低猜測空間，並讓執行軌跡清楚可追蹤。

terminal-ops 為什麼特別

terminal-ops 的主要差異化在於驗證迴圈。它會推著你先檢查再修改、優先使用 repo 內的 helper，並在宣稱成功前重新執行可證明結果的命令。當正確性比速度更重要時，這會比一般提示詞更有優勢。

terminal-ops 的最佳適用者與情境

這份 terminal-ops 指南適合在活躍中的 codebase 內工作的 agents 和開發者，特別是 repo 裡有 CI、scripts 或 release 限制的情況。它不太適合高層次的腦力激盪、只談架構的工作，或根本不需要 terminal 動作的任務。

如何使用 terminal-ops 技能

安裝並找到 terminal-ops 技能

先從 repository 的 skills 目錄使用 terminal-ops 的安裝路徑，然後先打開 SKILL.md。一個實用的安裝指令是：npx skills add affaan-m/everything-claude-code --skill terminal-ops。之後，請把這個技能當成 terminal 操作的工作流程層，而不是取代 repository 約定的替代品。

提供能啟動工作流程的輸入

要把 terminal-ops 用好，起點是清楚的操作目標與限制。好的需求會說明要檢查什麼、什麼算成功，以及任務是只讀、偏修復，還是偏 release。

較強的輸入範例如下：

• “在 packages/api 重現失敗的 test，找出最小修正，並在摘要前重新執行相關 test。”
• “檢查 repo 狀態、看 build logs，並告訴我這是 code 問題還是環境問題。”
• “針對這個 CI failure 做最小修正，接著在本機驗證，並精確記錄改了什麼。”

先讀對的檔案

如果是用 terminal-ops 做 Code Editing，先從 SKILL.md 開始，再檢查會影響執行的 repository 指引，例如 README.md、AGENTS.md、metadata.json，以及像 rules/、resources/、references/ 或 scripts/ 這類資料夾（如果存在）。repo preview 只會顯示 SKILL.md，所以在實際安裝時，你可以預期支援檔案會少一些，並且更依賴技能文字本身。

依照 evidence-first 迴圈操作

terminal-ops 的使用模式是：先檢查、再重現、精準修改、重新執行證明命令，最後清楚回報驗證了什麼。第一次操作時，重點應放在最小且相關的 command 或 test，尤其當失敗可能來自 script、環境不一致，或 git 狀態問題，而不一定是 code 本身。

terminal-ops 技能 FAQ

terminal-ops 是一般 prompt 的替代品嗎？

不是。一般 prompt 可以請求 code 協助，但 terminal-ops 更適合必須在 terminal 中實際執行並證明的工作。它是一種操作流程，不只是回應風格。

什麼情況下不該用 terminal-ops？

如果你只想要概念性的解釋、設計建議，或不需要執行的摘要，就不要用它。當你無法執行命令、檢查 repo，或在事後驗證結果時，它也不是很好的選擇。

terminal-ops 對初學者友善嗎？

可以，只要你能描述具體任務，並接受分步驟的工作流程。這個技能能幫助初學者避免跳過驗證，但前提是你能提供 repository、預期行為，以及任何失敗命令的輸出。

terminal-ops 和更廣泛的 coding 技能相比如何？

terminal-ops 比一般 coding 指引更聚焦。當 terminal 輸出、git 狀態與執行證明比廣泛的實作討論更重要時，就用它。這種窄範圍正是 terminal-ops 技能對 Code Editing 與 repo 操作特別有用的原因。

如何改進 terminal-ops 技能

先從你真正需要的證明開始

最好的 terminal-ops 結果，來自你明確說出必須證明什麼：像是失敗的 test 已重現、lint 檢查已通過、build 已完成，或分支已推到 upstream。如果你只說「修好它」，工作流程仍然有幫助，但輸出可能不會像預期那麼精準。

在第一則提示裡降低歧義

請包含 repo path、失敗的 command、相關錯誤文字，以及任何限制，例如「不要改變行為」、「只做 read-only audit」或「用最小可行修正」。更強的輸入會提升 terminal-ops 的使用效果，因為它能更快選對檢查與驗證步驟。

圍繞驗證迭代，不只是圍繞 code

如果第一次修正不對，請改成要求更窄的 repro、不同的 test slice，或與先前 git 狀態做比較。對 terminal-ops 來說，最有用的後續要求通常是更好的證明目標，而不是更長的解釋。