基于 Rube MCP 自动化 Wiz 云安全操作awesome-codex-skills 的完整实战指南【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills本指南以 composio-skills/wiz-automation/SKILL.md 为核心文档系统讲解如何通过 Rube MCP 桥接 Composio 的 Wiz 工具集Toolkit在 Codex CLI / API 中自动化 Wiz 云安全平台的日常操作。读完本文你将掌握 Rube MCP 的接入与连接管理、工具发现Tool Discovery、「搜索工具 → 校验连接 → 执行工具」的三步核心工作流以及 schema 合规、会话复用、分页处理等关键实践要点能够直接在本地环境落地一套可复用的 Wiz 自动化 Skill。一、背景Codex Skill 与 Rube MCP 的协作关系在 awesome-codex-skills 仓库中每个 Skill 都是一个包含SKILL.md的独立目录其中 YAML frontmatter 的name与description元数据决定 Codex 何时触发该 Skill正文则提供逐步执行指引参见 README.md 的 What Are Codex Skills? 一节。wiz-automation这个 Skill 正是仓库中数百个 composio-skills 自动化能力之一它的定位非常明确通过Rube MCP统一 MCP 网关获得对Composio Wiz 工具集的访问能力用一句 Wiz 相关的自然语言任务描述驱动 Codex 自动完成工具搜索、连接校验与工具执行强调「先搜索工具再执行」的动态 schema 原则避免硬编码导致调用失败。从仓库结构看这一「Rube MCP Composio Toolkit」模式是 composio-skills 目录下的标准范式——composio-skills/composio-automation/SKILL.md、composio-skills/composio-search-automation/SKILL.md 等数百个 Skill 均采用同构的 frontmatter 与工作流骨架wiz-automation只是将 toolkit 替换为wiz从而复用同一套成熟的自动化基建。wiz-automation/SKILL.md的 frontmatter 是理解其运行方式的关键--- name: wiz-automation description: Automate Wiz tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---其中requires.mcp: [rube]声明了本 Skill 的运行时依赖——必须存在名为rube的 MCP 服务即 Rube MCPCodex 才会将本 Skill 视为可触发description中特别强调 Always search tools first这一约束贯穿整个工作流设计。二、前置条件动手前必须满足的 3 项要求原文档明确列出运行任何 Wiz 自动化工作流前需满足Rube MCP 已连接环境内必须可调用RUBE_SEARCH_TOOLS它是后续所有工具发现的入口Wiz 连接已激活通过RUBE_MANAGE_CONNECTIONS建立 toolkit 为wiz的连接且状态必须为 ACTIVE先搜索后执行任何工作流开始前都要先调用RUBE_SEARCH_TOOLS获取当前工具 schema因为工具定义会随平台演进而变化。这三条共同保证了「连接可用 schema 最新」的执行前提是后续所有步骤的安全底座。三、环境配置四步完成 Rube MCP 接入wiz-automation/SKILL.md给出的接入方式极为轻量将https://rube.app/mcp添加为 MCP 服务器端点即可无需任何 API Key。具体按以下四步操作验证 Rube MCP 可用确认RUBE_SEARCH_TOOLS有响应证明 MCP 通道已建立发起 Wiz 连接调用RUBE_MANAGE_CONNECTIONStoolkit 参数指定为wiz完成授权若连接状态不是 ACTIVE根据返回的认证链接在浏览器中完成 OAuth 授权确认状态在运行任何工作流前再次确认连接状态显示为 ACTIVE。值得强调的是第 3 步——Rube MCP 将第三方服务的 OAuth 授权流程封装为「返回认证链接」Agent 无需在代码中管理客户端密钥这大幅降低了多租户、多账户场景下的接入复杂度。四、工具发现永远先调用 RUBE_SEARCH_TOOLS原文档强调「在执行工作流前始终先发现可用工具」并给出了标准调用形态RUBE_SEARCH_TOOLS queries: [{use_case: Wiz operations, known_fields: }] session: {generate_id: true}各参数含义与建议如下参数含义使用建议queries[].use_case自然语言描述你要完成的任务场景越具体越好例如 list Wiz projects 或 create a Wiz scan finding exportqueries[].known_fields你已知的字段信息无已知字段时传空字符串让平台全量推荐session.generate_id是否为本次搜索生成新会话 ID新工作流建议置为true由平台生成该调用的返回内容非常丰富原文档明确指出它至少包含四类信息可用工具 slugtool slugs后续RUBE_MULTI_EXECUTE_TOOL中要使用的工具标识输入 schema每个工具的参数定义包括字段名、类型与必填性推荐的执行计划recommended execution plans平台基于 use_case 给出的步骤编排建议已知陷阱known pitfalls针对该工具/场景的易错点提示。从仓库同构 Skill 的写法可以推断见 composio-skills/composio-automation/SKILL.md 的 Tool Discovery 一节这一「use_case known_fields session」三段式查询是 Rube MCP 系列 Skill 的通用约定wiz-automation仅将 use_case 替换为 Wiz 相关语义。五、核心工作流三步完成一次 Wiz 操作原文档将完整工作流收敛为三个步骤每一步都有对应的标准调用模板下面逐一展开。Step 1发现可用工具RUBE_SEARCH_TOOLS queries: [{use_case: your specific Wiz task}] session: {id: existing_session_id}与「工具发现」章节的首次查询不同在已存在会话的工作流中应复用会话session传入id: existing_session_id而不是重新generate_id。这样平台能够基于会话上下文给出更连贯的推荐与执行计划。Step 2校验连接RUBE_MANAGE_CONNECTIONS toolkits: [wiz] session_id: your_session_id执行前必须用本调用确认wiztoolkit 对应的连接为 ACTIVE。若返回非 ACTIVE 状态应回到配置章节的第 3 步重新完成授权而不是带着失效连接继续执行。Step 3执行工具RUBE_MULTI_EXECUTE_TOOL tools: [{ tool_slug: TOOL_SLUG_FROM_SEARCH, arguments: {/* schema-compliant args from search results */} }] memory: {} session_id: your_session_id这是实际触发 Wiz 操作的一步三个关键点tool_slug 取自搜索结果绝不能凭记忆硬编码必须使用 Step 1 返回的 slugarguments 必须符合 schema字段名与类型严格以搜索结果的 schema 为准memory 参数必须携带即使没有跨步骤状态也要显式传memory: {}这是原文档明确强调的规范session_id 与 Step 1/2 保持一致保证整条工作流的会话连续性。此外RUBE_MULTI_EXECUTE_TOOL支持tools数组一次调用可批量执行多个工具例如「先查询 Wiz 项目列表再对指定项目触发扫描」这是提升多步骤任务效率的关键能力。六、已知陷阱六个必须规避的常见错误原文档专门总结了实践中最高频的六类问题值得逐条牢记永远先搜索工具 schema 会变化绝不在未调用RUBE_SEARCH_TOOLS的情况下硬编码 tool slug 或参数先查连接执行工具前必须通过RUBE_MANAGE_CONNECTIONS确认连接为 ACTIVEschema 合规严格使用搜索结果中给出的字段名与类型多一个或少一个字段都可能导致调用失败memory 必带RUBE_MULTI_EXECUTE_TOOL调用中始终包含memory即使为空也要写成{}会话复用同一工作流内复用会话 ID新工作流再生成新的会话 ID——前者保证上下文连贯后者避免跨任务污染处理分页检查响应中的分页 token持续拉取直至数据完整避免因分页截断而漏掉后续结果。其中第 6 条特别容易被忽略Wiz 平台数据量大的查询如全量项目、告警列表几乎必然分页Agent 应在代码逻辑中形成「读取 token → 继续请求 → 直到无 token」的循环闭环。七、快速参考表操作到方法的映射原文档结尾提供了一张可直接对照使用的速查表完整保留如下操作方法查找工具RUBE_SEARCH_TOOLS使用 Wiz 相关的 use case建立连接RUBE_MANAGE_CONNECTIONStoolkit 为wiz执行工具RUBE_MULTI_EXECUTE_TOOL使用搜索发现的 tool slug批量操作RUBE_REMOTE_WORKBENCH配合run_composio_tool()函数获取完整 schema对带schemaRef的工具调用RUBE_GET_TOOL_SCHEMAS其中「批量操作」与「完整 schema」是两条进阶路径RUBE_REMOTE_WORKBENCH适合在远程工作台中执行规模化、可编排的任务而某些工具在搜索结果中只返回schemaRef引用而非完整定义此时需额外调用RUBE_GET_TOOL_SCHEMAS展开细节。仓库内所有 composio-skills 目录下的同构 Skill例如 composio-skills/composio-search-automation/SKILL.md 的 Quick Reference 一节均维持这五项映射关系可作为跨 Toolkit 的通用参考。八、总结与落地建议wiz-automationSkill 的价值在于它以最少的配置仅一个 MCP 端点、零 API Key将 Wiz 云安全能力接入 Codex 智能体并以「动态 schema 连接校验 会话管理」的工程化约束规避了 Agent 调用的典型失败模式。落地时请始终遵循三原则搜索先行每个工作流、每次执行前都重新发现工具确保 schema 最新连接前置ACTIVE 状态是执行的前置条件避免在失效连接上浪费时间会话一致工作流内复用 session_id并显式携带memory。如需将此 Skill 安装到本地 Codex可参照 README.md 的 Quickstart 说明将 Skill 目录放入$CODEX_HOME/skills默认~/.codex/skills后重启 Codex 即可被自动加载。结合仓库中数百个同构 Skill 的统一模式掌握本文这套工作流后你便能举一反三地驾驭任意 Composio Toolkit 的自动化任务。【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考