cloudlayer-automation

cloudlayer-automation skill 概览

cloudlayer-automation 的作用

cloudlayer-automation 是一个 Claude skill，用于通过 Composio 的 Rube MCP server 执行 Cloudlayer 操作。它的核心价值不是提供一套固定的 Cloudlayer 操作模板，而是指导 agent 先发现当前 Cloudlayer tool schema，确认用户的 Cloudlayer 连接状态，然后再用正确的 Rube tool calls 执行所需工作流。

当你希望 AI agent 帮你自动化 Cloudlayer 相关工作时，可以使用这个 skill，例如文档、截图、渲染或转换流程。这样就不需要手动猜测当前哪些 Composio tool slug 或输入字段仍然有效。

最适合的用户与工作流

cloudlayer-automation skill 最适合已经在使用 Cloudlayer，或愿意通过 Composio/Rube MCP 连接 Cloudlayer 的用户。它适用于工作流自动化团队、运营构建者、内部工具开发者，以及需要通过自然语言指令重复执行 Cloudlayer 操作的 AI-agent 用户。

当任务依赖当前 tool schema 时，它尤其有用。该 skill 明确要求在执行前先调用 RUBE_SEARCH_TOOLS，从而减少因示例过期、字段改名或假设不完整导致的失败。

面向 Workflow Automation 的关键差异点

对于 Workflow Automation，cloudlayer-automation 最强的能力在于强制执行“先发现、再确认连接”的模式：

1. 搜索可用的 Cloudlayer tools；
2. 检查或激活 Cloudlayer connection；
3. 查看返回的 schema 和注意事项；
4. 根据发现到的 tool 要求执行。

这让 cloudlayer-automation 比泛泛地提示“调用 Cloudlayer”更可靠，因为它会推动 agent 向 Rube MCP 获取最新执行方案，而不是自行编造参数。

如何使用 cloudlayer-automation skill

cloudlayer-automation 安装与设置背景

在 Claude skills 环境中从 Composio skills repository 安装该 skill，例如：

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

上游 skill 本身依赖 Rube MCP，而不是本地脚本。请在你的 client 中将 https://rube.app/mcp 添加为 MCP server，然后确认 RUBE_SEARCH_TOOLS 可用。接着使用 RUBE_MANAGE_CONNECTIONS，toolkit 设为 cloudlayer；如果连接状态不是 ACTIVE，请先完成返回的授权流程，再让 agent 执行 Cloudlayer 操作。

请先阅读 composio-skills/cloudlayer-automation/SKILL.md。在当前 repository snapshot 中没有配套的 scripts/、references/ 或 resources/ 文件夹，因此实际行为主要集中在这一个文件里。

skill 需要你提供哪些输入

为了更好地使用 cloudlayer-automation，请向 agent 提供业务目标、目标 Cloudlayer 操作、源材料、输出预期和运行约束。较弱的提示词是：“用 Cloudlayer 做一个 PDF。”更好的提示词是：

“Use the cloudlayer-automation skill. First search Rube tools for current Cloudlayer schemas. I need to generate a PDF from this hosted HTML page: https://example.com/invoice/123. Output should be A4, portrait, print background enabled, and saved or returned according to the available Cloudlayer tool response. If required fields differ from my wording, ask before execution.”

这样效果更好，因为它告诉 skill 要发现什么、执行什么，以及哪些细节不能靠猜。

推荐的执行工作流

一份实用的 cloudlayer-automation 使用指南应按以下顺序执行：

1. 要求 agent 调用该 skill，并针对具体 Cloudlayer 用例调用 RUBE_SEARCH_TOOLS。
2. 让它在执行前总结发现到的 tool slug、必填字段、可选字段和已知注意事项。
3. 通过 RUBE_MANAGE_CONNECTIONS 确认 cloudlayer connection status。
4. 提供或确认最终输入。
5. 执行选定的 Rube tool。
6. 检查结果、错误、返回的文件链接、ID 或后续操作。

即使你之前用过同一个工作流，也不要跳过发现步骤。该 skill 自身的说明要求始终先搜索 tools，因为 schemas 可能发生变化。

能提升结果质量的提示词模式

可以使用这样的提示词结构：

Use cloudlayer-automation. Task: [Cloudlayer outcome]. Source: [URL, HTML, template, or data]. Output: [PDF/image/other format, dimensions, filename, delivery requirement]. Constraints: [auth, timeout, page size, headers, wait conditions]. First discover current Cloudlayer tools with RUBE_SEARCH_TOOLS and show the schema before execution.

这能给 agent 足够的上下文来选择 tools，并避免它把 Cloudlayer 自动化当成普通的浏览器任务或文件任务来处理。

cloudlayer-automation skill 常见问题

没有 Rube MCP，cloudlayer-automation 还有用吗？

没有。该 skill 需要 rube MCP server，并依赖 RUBE_SEARCH_TOOLS 和 RUBE_MANAGE_CONNECTIONS。如果你的 Claude client 无法使用 MCP tools，这个 skill 就不能执行 Cloudlayer 操作；最多只能描述预期工作流。

它和普通 Cloudlayer 提示词有什么不同？

普通提示词可能会幻觉出不存在的 API 名称、参数或认证步骤。cloudlayer-automation skill 的设计目标是在行动前先向 Composio/Rube 查询实时 Cloudlayer tooling。对于需要 agentic execution 的场景来说，只要当前 schemas 比静态文档更重要，它就更适合。

这个 skill 适合新手吗？

如果你的 MCP 环境已经配置好，它对新手是友好的。设置负担主要在连接层面：添加 Rube MCP endpoint，确认 RUBE_SEARCH_TOOLS，授权 Cloudlayer toolkit，并检查 connection 是否为 ACTIVE。从未配置过 MCP 的新手可能在这一步需要帮助。

什么时候不应该使用这个 skill？

如果你需要直接编写 Cloudlayer API code、使用本地渲染库，或运行一个必须脱离 Composio/Rube 的工作流，就不要使用 cloudlayer-automation。如果你无法与已连接的 tooling environment 共享源 URL、HTML 或所需文档数据，也应避免使用它。

如何改进 cloudlayer-automation skill

执行前改进 cloudlayer-automation 输入

最常见的失败模式是输出要求描述不充分。在运行 skill 之前，请先定义页面尺寸、方向、viewport、源类型、认证需求、预期格式、命名规则，以及 agent 在完成 schema discovery 后是否可以自动继续执行。

更好的输入示例：

“Generate a PDF from authenticated dashboard URL X. If the discovered Cloudlayer tool supports wait conditions, wait until network idle or selector .report-ready. Use A4 landscape. If authentication cannot be handled by the active Cloudlayer connection, stop and explain the missing requirement.”

要求确认 schema，而不只是执行动作

为了获得更安全的结果，请要求 agent 在 tool execution 前展示发现到的 schema。可以让它提供：

• 选定的 Cloudlayer tool slug；
• 必填字段；
• 与任务相关的可选字段；
• 它计划采用的假设；
• Rube search response 中暴露的风险或缺失输入。

这个小检查点可以在发生不可逆或高成本的自动化运行之前，提前发现不匹配之处。

根据返回的错误和产物迭代

第一次运行后，不要只是重复提交同一个提示词。把返回的 error、job ID、response fields 或 artifact URL 粘贴回对话中，并在需要时要求 skill 重新检查 schema。对于渲染类工作流，应围绕具体变量迭代：viewport、wait time、print background、margins、source URL accessibility 或 template data completeness。

加强团队场景下的 skill 使用

如果你的团队经常使用 cloudlayer-automation，可以为常见 Cloudlayer 任务创建内部 prompt snippets，并包含必要默认值，例如 page format、approval rules 和 storage destination。请将这些 snippets 与上游 skill 分开维护，这样核心行为——先搜索 tools、确认连接、用当前 schema 执行——仍然便于更新。