wiz-automation

wiz-automation skill 概览

wiz-automation 能做什么

wiz-automation 是一个 Claude skill，用于通过 Composio 的 Rube MCP toolkit 自动化 Wiz 安全运营。它的核心价值不在于内置一组固定、写死的 Wiz 操作，而是教会 agent 先用 RUBE_SEARCH_TOOLS 发现当前可用的 Wiz tool schema，验证 Wiz 连接状态，然后再针对请求的任务执行合适的 Rube MCP tools。

这一点很重要，因为 Wiz 和 MCP tool schema 都可能变化。wiz-automation skill 更适合那些希望让 agent 协助处理可重复云安全工作流、同时在执行前仍会检查实时可用 tools 的团队。

最适合用于 Workflow Automation

当你的工作涉及 Wiz 任务时，可以将 wiz-automation 用于 Workflow Automation，例如调查云安全 findings、列出资产、检查 issue 上下文、准备摘要，或通过已认证的 Composio 连接协调可重复的 Wiz 操作。它对已经在使用 Wiz，并希望 Claude 驱动基于工具的工作流，而不只是起草文本的安全、DevOps、平台和云运营用户最有价值。

它不能替代 Wiz 访问控制、安全评审或变更审批。更合适的定位是：在你的 Wiz 连接处于 active 状态后，它作为一个自动化层，调用当前可用的 Rube MCP tools。

关键采用前提

最大的前置条件是 MCP setup。你必须在客户端中配置 Rube MCP，RUBE_SEARCH_TOOLS 必须可用，并且 Wiz toolkit connection 必须通过 RUBE_MANAGE_CONNECTIONS 处于 active 状态。如果你的环境无法使用 MCP tools，这个 skill 仍然可以解释工作流，但无法执行真正的 Wiz 自动化。

如何使用 wiz-automation skill

安装和设置 wiz-automation

使用以下命令从 repository 安装该 skill：

npx skills add ComposioHQ/awesome-claude-skills --skill wiz-automation

然后在你的客户端中添加 Rube MCP：

https://rube.app/mcp

上游 skill 说明 MCP endpoint 不需要单独的 API key，但你仍然需要一个 active 的 Wiz connection。在 Claude 或其他兼容的 MCP client 中，确认 RUBE_SEARCH_TOOLS 可用。然后使用 RUBE_MANAGE_CONNECTIONS 并指定 toolkit wiz；如果状态不是 ACTIVE，先完成返回的认证流程，再让 agent 执行 Wiz 工作流。

先进行 tool discovery

最重要的使用规则是：先搜索 tools。不要让 agent 猜测 Wiz tool 名称或输入字段。一个高质量的 wiz-automation 使用 prompt 应该明确要求 agent 为具体任务发现 tools、检查连接，然后再执行。

示例：

“Use the wiz-automation skill. First call RUBE_SEARCH_TOOLS for the use case ‘find critical Wiz issues affecting internet-exposed cloud resources and summarize owner, severity, and remediation’. Check the wiz connection with RUBE_MANAGE_CONNECTIONS. If active, choose the safest matching tools, show the planned calls before execution, and summarize results with IDs and next actions.”

这比“check Wiz issues”更好，因为它定义了目标对象、筛选条件、输出字段和安全执行方式。

能提升结果质量的 prompt 输入

给 agent 足够的运营上下文，帮助它选择合适的 Rube tools：

• 目标：investigation、reporting、inventory、triage，或 remediation planning。
• 范围：cloud account、project、subscription、environment、business unit，或 time window。
• 筛选条件：severity、exposure、vulnerability、control failure、status、owner，或 asset type。
• 输出格式：table、executive summary、ticket-ready notes、CSV-style fields，或 action plan。
• 防护要求：先 read-only、批量变更前先询问、避免 destructive actions、保留 IDs。

例如，不要写“make a Wiz report”，而是写：“Create a read-only report of open high and critical Wiz issues for production AWS accounts from the last 30 days. Include issue ID, affected resource, severity, cloud account, exposure reason, remediation guidance, and owner if available. Do not modify anything.”

依赖前应先阅读的文件

repository 路径是 composio-skills/wiz-automation，有用的源文件是 SKILL.md。预览中没有额外的 scripts/、references/、rules/ 或 README.md 文件，因此安装前请仔细查看 SKILL.md。尤其要关注 prerequisites、setup、tool discovery pattern 和 core workflow pattern，因为这些内容定义了 agent 应该如何调用 Rube MCP，而不是自行猜测和即兴执行。

wiz-automation skill 常见问题

wiz-automation 只适合 Composio 用户吗？

它适合能够访问 Rube MCP，并通过 Composio 连接 Wiz toolkit 的用户。该 skill 依赖 RUBE_SEARCH_TOOLS 和 RUBE_MANAGE_CONNECTIONS 等 MCP tools。没有这些 tools 时，它只能提供指导，无法执行自动化。

它比普通 Wiz prompt 好在哪里？

普通 prompt 可能会让模型凭记忆推理 Wiz 的能力和接口。wiz-automation skill 会引导 agent 使用实时 tool discovery、当前 schema、connection check 和结构化执行。这样可以减少因 tool 名称过时、参数缺失，或假设了当前并未通过 Rube 暴露的 Wiz API 形态而导致的失败。

新手可以使用 wiz-automation skill 吗？

可以，前提是已经有人配置好了 MCP 和 Wiz connection。新手应从 read-only 任务开始，例如列出 issues、总结 findings，或构建 triage reports。在你了解当前可用 tools 以及 Wiz connection 拥有哪些权限之前，不要请求 remediation 或批量操作。

什么时候不应该使用 wiz-automation？

当你只需要离线文档、MCP tools 不可用，或你的组织要求任何安全平台操作都必须先经过人工审批时，不应使用它。也要避免“fix all Wiz problems”这类模糊且范围过大的任务。应将它们拆分为 discovery、review 和 approved execution 几个步骤。

如何改进 wiz-automation skill 的使用效果

用明确范围改进 wiz-automation prompts

大多数糟糕结果都源于范围描述不足。请补充 environment、cloud provider、account、severity、status、time range 和 desired output。范围明确的 prompt 能帮助 RUBE_SEARCH_TOOLS 返回更好的候选 tools，也能帮助 agent 避免发起过宽的 Wiz 查询。

较弱示例：“Find risky assets.”

更强示例：“Use wiz-automation to find internet-exposed production assets with critical Wiz issues in AWS accounts tagged env=prod. Start read-only, return resource ID, issue ID, severity, exposure path, owner, and recommended remediation.”

为更安全的自动化加入 review gates

对于安全运营，要求 agent 将计划和执行分开。一个好的模式是：discover tools、check connection、propose tool calls、wait for approval、execute，然后 summarize。如果当前可用的 Wiz tools 包含 update、ticketing 或 remediation 相关动作，这一点尤其重要。

有用的指令：“Before any non-read-only action, show the selected tool slug, required inputs, expected effect, and rollback or verification step.”

基于首次输出继续迭代

拿到第一轮结果后，应根据 tools 实际返回的内容继续细化。如果缺少重要字段，让 agent 使用 known_fields 或更精确的 use case 再运行一次 discovery query。如果输出范围太大，就按 severity、account、project、asset type 或 issue status 收紧筛选条件。

好的追问：“Narrow this to open critical issues on externally reachable compute resources only, group by owning team, and include the exact Wiz IDs needed for ticket creation.”

留意常见失败模式

主要失败模式包括跳过 RUBE_SEARCH_TOOLS、臆测 schema、在 Wiz connection 尚未 active 前就执行，以及请求超出已连接账号权限范围的操作。改进 wiz-automation 的最佳方式，是强制要求 tool discovery，把第一轮保持为 read-only，并要求 agent 在执行前明确暴露自己的假设。