C

composio-automation

作者 ComposioHQ

composio-automation 帮助 agent 通过 Rube MCP 运行 Composio workflows:先发现当前 tool schemas,检查 Composio 连接状态,然后执行并验证任务。

Stars67.5k
收藏0
评论0
收录时间2026年7月11日
分类工作流自动化
安装命令
npx skills add ComposioHQ/awesome-claude-skills --skill composio-automation
编辑评分

该 skill 评分为 68/100,说明可以收录,但更适合作为轻量级连接器/模式类 skill 展示,而不是完整的工作流包。目录用户可以明确看出它用于通过 Rube MCP 执行 Composio 操作,也能了解 agent 应如何起步;但大多数具体任务细节仍需要 agent 依赖实时工具发现来完成。

68/100
亮点
  • 触发条件和依赖说明清晰:明确面向通过 Rube MCP 进行 Composio 自动化,并声明 `requires: mcp: [rube]`。
  • 安装和前置条件指引涵盖了必需的 MCP endpoint、连接检查,以及使用前需要 ACTIVE 的 Composio toolkit connection。
  • schema 发现指引很强:反复提示 agent 先调用 `RUBE_SEARCH_TOOLS`,以便使用最新 tool schemas,而不是凭空猜测。
注意点
  • 操作细节主要是通用的“发现/检查/执行”模式,而不是具体的 Composio 任务流程或经过测试的示例。
  • 该 skill 完全依赖 Rube MCP 可用以及 Composio 连接处于 ACTIVE;除 SKILL.md 外,没有配套脚本、参考资料或本地资源。
概览

composio-automation skill 概览

composio-automation 能做什么

composio-automation 是一个 Claude skill,用于通过 Rube MCP 运行与 Composio 相关的工作流。它的核心价值不在于提供一段固定脚本,而是教会 agent 先发现当前可用的 Composio tool schemas,验证用户的 Composio 连接状态,然后针对所请求的自动化任务执行正确的 Rube MCP tool 序列。

当你希望 agent 实际操作 Composio 相关流程,而不只是解释 Composio 概念时,就适合使用这个 skill。

最适合 Workflow Automation 用户

composio-automation skill 最适合正在围绕 Composio toolkits、integrations、connected accounts,或通过 Rube 暴露的 automation tasks 构建和运维 Workflow Automation 的用户。尤其是在 tool schemas 可能变化的场景下,它很有价值,因为该 skill 明确要求 agent 在执行前先调用 RUBE_SEARCH_TOOLS

它适合已经在 Claude 中使用 MCP tools,并希望把“发现、认证、执行、验证”做成可重复模式的团队,而不是每次都靠临时 prompt 解决。

关键采用前提

安装前,请确认你的客户端可以使用 MCP servers,并且 Rube MCP 可用。该 skill 需要:

  • 已连接 Rube MCP,并且 RUBE_SEARCH_TOOLS 可用
  • 通过 RUBE_MANAGE_CONNECTIONS 管理的 Composio connection
  • Toolkit name 为 composio
  • 工作流执行前 connection status 为 ACTIVE

如果你的环境无法向 agent 暴露 MCP tools,这个 skill 的作用会基本限于操作指导,无法真正执行。

它和通用 prompt 有什么不同

通用 prompt 可能会要求模型“使用 Composio”,但模型很容易猜测过期的 tool name,或者编造参数。composio-automation 的重点是 tool discovery:先搜索,再检查返回的 schema,确认连接状态,然后运行选定的 tool。这个顺序可以减少 schema 不匹配、认证意外和自动化执行失败。

如何使用 composio-automation skill

composio-automation 安装场景

从 ComposioHQ skill collection 安装该 skill:

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

然后用下面的地址把 Rube MCP 添加到支持 MCP 的客户端中:

https://rube.app/mcp

上游 skill 不包含额外脚本、参考资料或辅助资源,所以应从 SKILL.md 开始。这个文件就是操作规程:前置条件、设置步骤、tool discovery,以及核心工作流模式。

你需要提供给 skill 的输入

为了更好地使用 composio-automation,请给 agent 一个具体任务,并提供足够的运行上下文,以便它准确搜索 tools。建议包含:

  • 你希望完成的 Composio 任务
  • 已知的目标 toolkit 或 integration
  • Composio connection 是否已经存在
  • 涉及的 entity names、IDs、accounts、projects 或 filters
  • 期望输出,例如 “create”、“list”、“update”、“verify” 或 “summarize results”
  • 安全约束,例如 “do not delete”、“dry run first” 或 “ask before modifying”

较弱的 prompt:“Automate Composio.”

更强的 prompt:“Use the composio-automation skill to find the current Rube MCP tools for Composio. Check whether my composio connection is ACTIVE, then list available Composio toolkits connected to my account. Do not modify anything.”

推荐的工作流模式

可靠的 composio-automation 使用流程应按以下顺序进行:

  1. 针对具体 use case 调用 RUBE_SEARCH_TOOLS,不要使用模糊的通用查询。
  2. 在后续 discovery 或 execution 中复用返回的 session ID。
  3. 针对 toolkit composio 调用 RUBE_MANAGE_CONNECTIONS
  4. 如果 connection 不是 ACTIVE,按返回的 authentication link 完成认证。
  5. 检查返回的 tool slug、schema、required fields 和 pitfalls。
  6. 只有在 schema 已知后再执行。
  7. 验证结果,并说明发生了哪些变化。

这很重要,因为 Rube 可以返回当前的 tool schemas 和 execution plans。跳过 discovery,最容易导致参数无效。

实用 prompt 写法

如果是只读任务,请明确说明:

“Use composio-automation to search current Composio tools via Rube MCP, confirm my connection, and retrieve the requested data. This is read-only; do not create, update, or delete resources.”

如果任务会改变状态,请要求先确认:

“Discover the correct Composio tool schema first. Prepare the exact tool call for creating the automation, explain the fields, and wait for my approval before execution.”

如果是在排查问题:

“Use RUBE_SEARCH_TOOLS to identify the relevant Composio operation and known pitfalls. Check connection status with RUBE_MANAGE_CONNECTIONS, then explain whether the failure is authentication, missing fields, unavailable tool, or execution error.”

composio-automation skill 常见问题

composio-automation 适合新手吗?

适合,前提是新手使用的是支持 MCP 的客户端,并且能够按 authentication link 完成授权。这个 skill 的工作流本身很简单,但周边生态并不是完全开箱即用:用户需要理解 agent 正在调用 Rube MCP tools,而且 Composio 访问依赖一个 active connection。

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

如果你只需要文档、概念性建议或静态代码示例,不要使用 composio-automation。如果你的客户端无法连接 Rube MCP、组织策略禁止外部 MCP servers,或者你无法授权 Composio connection,它也不适合。

对于不需要执行的调研,普通 prompt 加上 Composio 文档可能就足够了。

它能替代 Composio 文档吗?

不能。该 skill 会指向 Composio toolkit documentation,并通过 Rube MCP discovery 获取当前 schemas。它是一个执行工作流,不是完整的 API reference。遇到边界情况、权限、计费或特定 toolkit 行为时,应同时阅读 Composio docs 和 RUBE_SEARCH_TOOLS 返回的 tool schema。

必须进行 tool search,是因为该 skill 依赖实时 schemas。MCP tools 暴露的具体 slugs、required fields 和 constraints,可能与模型记忆或示例不同。RUBE_SEARCH_TOOLS 会在 agent 真正提交调用前提供当前执行面,这是 composio-automation skill 的核心可靠性收益。

如何改进 composio-automation skill

优化 composio-automation prompts

提升 composio-automation 结果的最佳方式,是把宽泛目标改写成可执行的操作请求。说明 action、scope、connection expectation 和 confirmation policy。

不要写:“Set up a Composio workflow.”

可以写:“Search current Rube MCP tools for Composio operations related to GitHub issue automation. Confirm the composio connection is ACTIVE. If a create or update action is needed, show the proposed tool call and wait for approval.”

这样可以帮助 agent 为 discovery 选择更精确的 use_case,并避免意外写入。

避免常见失败模式

常见失败包括跳过 RUBE_SEARCH_TOOLS、假设 connection 已经 active、使用过期参数名,或把认证问题当作 tool 问题处理。如果一次运行失败,请让 agent 对问题进行分类:

  • Discovery failure
  • Connection inactive
  • Missing required field
  • Permission or account limitation
  • Tool execution error
  • Ambiguous user intent

这样迭代会聚焦在真正问题上,而不是反复重试同一个错误调用。

基于第一次输出继续迭代

第一次运行后,可以通过追问返回的 tool slug、required fields、被省略的 optional fields,以及 Rube 给出的 warnings 来提升质量。对于会改变状态的工作流,执行前要求 preflight summary,执行后要求 post-run verification。

一个有效的 follow-up 是:“Based on the discovered schema, identify required inputs I have not provided yet and ask only for those. Do not execute until all required fields are known.”

为团队使用扩展 skill

团队可以通过在上游文件之外添加本地说明来改进该 skill:已批准的 Composio use cases、命名规范、允许的写操作、rollback expectations,以及安全 prompt 示例。由于当前 repository path 只暴露 SKILL.md,团队特定的 guardrails 应记录在你自己的 workspace 或 agent instructions 中,而不是假定 package 已经包含这些内容。

评分与评论

暂无评分
分享你的评价
登录后即可为这个技能评分并发表评论。
G
0/10000
最新评论
保存中...