workspace-surface-audit

workspace-surface-audit 技能概览

workspace-surface-audit 的作用

workspace-surface-audit 技能是一个只读审计工具，用来回答一个很实用的问题：这个 workspace 和这台机器现在到底能做什么，下一步应该补什么、启用什么？它会检查当前仓库、MCP servers、plugins、connectors、env surfaces 以及 harness 设置，然后给出最值得优先采用的 ECC-native skills、hooks、agents 和 operator workflows。

适合谁使用

如果你正在搭建 Claude Code、在给 workspace 增加更多自动化之前先做评估，或者明明仓库看起来已经“准备好了”，却还是搞不清为什么某项能力缺失，那么就该用 workspace-surface-audit 技能。对于在 skill、hook、agent、MCP server 和 external connector 之间做选择的人，它尤其有用。

它为什么更突出

不同于普通 prompt，workspace-surface-audit 的设计目标是把“已经可用的”“部分配置好的”和“还需要实现的”严格区分开来。这样一来，输出就更适合直接做 Workflow Automation 决策，尤其是在你想要 ECC-native 覆盖，而不是零散的插件建议时。

如何使用 workspace-surface-audit 技能

安装 workspace-surface-audit

先走仓库里的 skill 安装流程，然后把要审计的 workspace 指给这个技能。一个典型的安装命令是：

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

如果你的环境使用的是别的 skill manager，也保持同样的 slug：workspace-surface-audit install 的重点是把这个技能加入你的本地 skill 系统，而不是改变审计行为本身。

给技能正确的输入

最好的 workspace-surface-audit usage 不是从笼统问题开始，而是先给出明确目标。好的提示词会直接说明 repo、环境和目标，例如：“审计这个 workspace 的 Claude Code 准备情况，列出已经配置好的内容，并推荐接下来最该补的三个 surface。”

更强的输入通常会包含：

• repo 路径或 workspace 名称
• 你更关心 MCP、plugins、env vars、hooks 还是 agent routing
• 你是只想做只读审计，还是需要后续实施计划
• 任何约束，比如不能泄露密钥、不能使用外部插件

先读这些文件

做 workspace-surface-audit guide 相关工作时，先看 SKILL.md，再检查 README.md、AGENTS.md、metadata.json，以及仓库里如果存在的话 rules/、resources/、references/、scripts/ 目录。在这个仓库里，SKILL.md 是主要来源，所以在你要求输出之前，最有价值的是先读清楚审计规则、输入预期和工作边界。

能提升结果的工作流

把技能分两轮用：第一轮先让它做 surface inventory，第二轮再让它给 recommendations。这样可以避免审计还没确认现状，就过早跳到“再装点东西”上。如果你是在 workspace-surface-audit for Workflow Automation 场景下使用它，就要求它把每个发现都标成 already available、partially available 或 missing，然后再按影响和工作量排序下一步动作。

workspace-surface-audit 技能 FAQ

workspace-surface-audit 只适用于 Claude Code 吗？

不是。它最适合 Claude Code 和 ECC-native workflows，但逻辑并不局限于此：只要能力可能来自仓库配置、已连接服务、env 文件或自动化层，它都能用来做审计。

它和普通 prompt 有什么不同？

普通 prompt 可以问“我该用哪些 plugins”，但 workspace-surface-audit 是围绕真实 workspace surface 设计的，并且会给出有边界的建议。这样能减少猜测，也能避免过度推荐那些当前环境根本支撑不了的工具。

对新手友好吗？

友好。只要你能描述 workspace 和目标就可以，不需要很深的基础设施知识；这个技能的目标，就是把一个粗略的搭建问题，转换成实用的清单和下一步计划。

什么时候不该用它？

当你想立刻改代码、想暴露 secret 值，或者只需要一个和 workspace 脱钩的泛泛头脑风暴答案时，不要用 workspace-surface-audit。它最适合的场景是：你要判断“我们已有些什么、还缺什么、下一步该启用什么？”

如何改进 workspace-surface-audit 技能

先把目标收窄

提升 workspace-surface-audit 结果最快的方法，就是缩小审计范围。比起“审计我的整个环境”，“审计 repo config、MCP connections 和 env surfaces，看看 Claude Code 是否已准备好”更有用。范围越具体，建议就越可执行。

提供证据，不要只给假设

如果你已经知道某些文件、服务或 connector 存在，先直接说出来。这样技能就能去验证和分类，而不是重新发现它们。好的输入会点名真实 surface，例如 .mcp.json、.env、plugin settings 或 connected apps，这会提升 workspace-surface-audit guide 的质量。

要求按优先级给出下一步

workspace-surface-audit 最好的输出不只是 inventory，而是排好优先级的决策。你应该要求它给出最值得补上的 ECC-native skill、hook、agent 或 MCP addition，并说明它为什么重要、如果暂时不做会有什么取舍。这样审计就会紧扣 adoption value，而不只是覆盖范围。

第一轮之后继续迭代

先用第一次审计找出缺口，然后每次只拿一个缺口重新运行技能。比如：“现在只审计 MCP layer，并告诉我这应该是 connector、hook 还是 skill。”第二轮往往就是 workspace-surface-audit skill 输出变得更精确、也更容易落地的阶段。