workspace-surface-audit

workspace-surface-audit 技能總覽

workspace-surface-audit 的用途

workspace-surface-audit 技能是一個唯讀稽核工具，用來回答一個很實際的問題：這個 workspace 和這台機器現在到底能做什麼？下一步又應該新增或啟用什麼？它會檢查目前的 repo、MCP servers、plugins、connectors、env surfaces，以及 harness 設定，接著推薦最有價值的 ECC-native skills、hooks、agents 和 operator workflows。

適合哪些人使用

如果你正在設定 Claude Code、在加入更多自動化之前先檢視一個 workspace，或是明明 repo 看起來已經「準備好了」，卻還想弄清楚為什麼某個能力還是缺失，workspace-surface-audit 技能就很適合你。特別適合正在評估 skill、hook、agent、MCP server 或外部 connector 之間差異的人。

它的突出之處

和一般的 prompt 不同，workspace-surface-audit 的設計重點是把「已經可用的東西」、「部分設定完成的東西」與「仍需實作的東西」清楚分開。這讓輸出更適合做 Workflow Automation 的決策，尤其是在你想要 ECC-native 覆蓋，而不是零散的 plugin 建議時。

如何使用 workspace-surface-audit 技能

安裝 workspace-surface-audit

先依照 repo 的 skill 安裝流程操作，然後把 skill 指向你想稽核的 workspace。常見的安裝指令如下：

npx skills add affaan-m/everything-claude-code --skill workspace-surface-audit

如果你的環境使用不同的 skill manager，也請保留同一個 slug：workspace-surface-audit install 的重點是把 skill 加入你本機的 skill 系統，而不是改變稽核行為本身。

給 skill 正確的輸入

最好的 workspace-surface-audit usage 不是從模糊請求開始，而是從明確目標開始。好的提示會點出 repo、環境和目的，例如：「稽核這個 workspace 的 Claude Code 準備度，列出目前已設定好的項目，並建議接下來最值得補上的三個 surface。」

更強的輸入通常會包含：

• repo path 或 workspace 名稱
• 你在意的是 MCP、plugins、env vars、hooks 還是 agent routing
• 你要的是唯讀稽核，還是後續實作計畫
• 任何限制，例如不能揭露 secrets、不能使用外部 plugins

先讀這些檔案

進行 workspace-surface-audit guide 工作時，先從 SKILL.md 開始，再查看 README.md、AGENTS.md、metadata.json，以及如果存在的話，rules/、resources/、references/ 或 scripts/ 資料夾。在這個 repository 裡，SKILL.md 是主要來源，所以在要求輸出之前，最有價值的是先讀清楚稽核規則、輸入期待和 workflow 邊界。

能提升結果的工作流程

把這個 skill 分兩輪用：第一輪先請它列出 surface inventory，第二輪再請它提出建議。這樣可以避免稽核太早跳到「再安裝更多東西」，而沒有先確認目前已經有什麼。如果你是把 workspace-surface-audit 用在 Workflow Automation 上，請它把每個發現分類成已可用、部分可用或缺失，然後再依影響力與工作量排序下一步行動。

workspace-surface-audit 技能 FAQ

workspace-surface-audit 只適用於 Claude Code 設定嗎？

不是。它對 Claude Code 和 ECC-native workflows 最有幫助，但邏輯其實更廣：任何能力可能來自 repo 設定、已連接的服務、env 檔案或 automation layers 的 workspace，都可以用它來稽核。

這和一般的 prompt 有什麼不同？

一般 prompt 可以問「我應該用哪些 plugins」，但 workspace-surface-audit 的目的，是去檢查實際的 workspace surface，並提出有邊界的建議。這樣能減少猜測，也能避免過度推薦環境根本無法支援的工具。

對新手友善嗎？

如果你能描述自己的 workspace 和目標，那它就很友善。你不需要很深的基礎架構知識；這個 skill 的目的，就是把模糊的 setup 問題轉成可執行的盤點和下一步計畫。

什麼情況下不該用它？

當你想立刻修改程式碼、想直接暴露 secret 值，或只是想要與 workspace 無關的泛用腦力激盪答案時，就不該用 workspace-surface-audit。它最適合的情境，是在判斷「我們現在有什麼、缺什麼、下一步該啟用什麼」的時候。

如何改進 workspace-surface-audit 技能

先縮小目標範圍

改善 workspace-surface-audit 結果最快的方法，就是縮小稽核 surface 的範圍。比起「稽核我整個環境」，「稽核 repo config、MCP connections 和 env surfaces，判斷 Claude Code readiness」更有用。範圍越具體，建議就越能直接落地。

提供證據，不要只給假設

如果你已經知道某些檔案、服務或 connector 存在，請一開始就說明。這樣 skill 就能去驗證並分類，而不是重新找一次。好的輸入會直接點名實際的 surface，例如 .mcp.json、.env、plugin settings 或已連接的 apps，這會提升 workspace-surface-audit guide 的品質。

請它列出有排序的下一步

workspace-surface-audit 最好的輸出不只是 inventory，而是有優先順序的決策。請它列出最值得補上的 ECC-native skill、hook、agent 或 MCP 加入項目，並說明其重要性，以及如果延後處理會付出的取捨。這樣稽核就會緊扣採用價值，而不是只做覆蓋率盤點。

第一輪之後再迭代

先用第一次稽核找出缺口，然後再針對單一缺口重跑 skill。比如說：「現在只稽核 MCP layer，告訴我這裡應該是 connector、hook 還是 skill。」第二輪往往才是 workspace-surface-audit skill 輸出變得更精準、也更容易實作的關鍵。