mcpField
C
composio

composio

github.com/composiohqAgent 工作流30.8k8.2k 次安装今天更新
代码仓库

关于 composio

Composio 是一个路由 Skill,帮助 Agent 用户和应用开发者选择合适的 Composio 产品与指南。它区分个人应用访问和平台集成,并涵盖设置、操作、故障排查及最新文档查询。

主要功能

  1. 01将请求分流至 For You 或 Platform
  2. 02依据任务选择相关指南
  3. 03提供设置与集成指引
  4. 04指导经授权的工具执行和故障排查
  5. 05针对易变信息查阅当前规范文档

适用场景

  1. 01为个人 Agent 选择 Composio 设置方式
  2. 02将 Composio 集成到应用中
  3. 03通过已连接的工具执行应用工作流
  4. 04排查或迁移现有集成

MCP 相关

对于 Composio For You,该 Skill 将 MCP 列为 Agent 访问个人应用的主要入口之一,并提供设置 MCP 客户端的指引。README 未说明它会提供 MCP 服务。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/composiohq/composio --skill composio

安装后在 Claude Code 中输入/composio确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
errors.md
for-you.md
platform.md

详细介绍

Composio

将本技能用作路由。先识别产品和任务,只加载相关指南,对易变的细节查阅权威文档,然后回答问题或完成用户请求的工作。

1. 选择产品

不要混用两种产品。它们使用不同的凭证和设置路径。

Composio For YouComposio Platform
适用场景有人希望自己的 Agent 使用自己的应用开发者正在构建一个让用户连接账户的产品
主要入口MCP 或 Composio CLI应用内的 SDK 会话
凭证客户端需要请求头时使用 ck_... 消费者密钥COMPOSIO_API_KEY 项目密钥
控制台dashboard.composio.dev → For Youdashboard.composio.dev → Platform

只有在上下文无法确定产品时,才提出一个简短问题:

这是用于你自己的 Agent 和账户,还是用于让你的用户连接其账户的产品?

如果提到了某个个人 AI 客户端但没有产品代码,按 For You 处理。如果涉及应用代码库、SDK、用户或租户身份、后端或产品 Agent,则按 Platform 处理。

2. 选择任务

在采取行动前,先确定所请求的结果:

  • 解释或探索: 回答问题、比较方案,或查找当前 API。
  • 设置: 首次建立凭证、MCP 客户端、CLI 或 SDK。
  • 构建或修改: 将 Composio 集成到现有 Agent 或应用中。
  • 运行: 为实际任务查找、连接并执行工具。
  • 调试或迁移: 诊断故障、更新旧版集成,或从旧版直接执行或 Tool Router 迁移。

不要把解释、文档查询或范围较小的 Bug 修复变成入门引导。

3. 仅加载相关指南

完成所选任务

  • 对于问题,需要时获取当前文档,并给出具体答案。不要修改项目或强制调用工具。
  • 对于设置或集成,检查现有环境,保留其架构和身份模型,做最小但有用的改动;在凭证和用户授权可用时,通过一次安全的真实工具调用进行验证。
  • 对于运行类请求,只连接任务所需的应用,并执行所请求的工作流。
  • 对于调试,获取 Composio 日志或请求 ID,定位出错的环节,修复该环节;在用户授权执行时进行重试。

稳定规则

  1. 在选择凭证、URL、SDK 或命令之前,先确认产品。
  2. 将控制台(dashboard)引导流程视为一种上下文,而非该 Skill 的身份。当开发者带着来自“快速开始”的现有 COMPOSIO_API_KEY 进入时,直接使用它,切勿在聊天中创建、轮换、替换、打印或索取该密钥。在此路径下不要运行 composio dev init。
  3. 对于没有控制台凭证交接的一般首次 Platform 设置,请遵循 Platform 指南中的当前设置路径。
  4. 切勿编造工具包(toolkit)或工具的 slug。请在运行时或通过 CLI 发现它们。
  5. 不要构建服务商 OAuth 流程。需要认证时,Composio 会返回 Connect Link。
  6. 新的 Platform 集成应使用 Sessions。保留应用现有的用户身份和 Agent 架构。
  7. 将凭证排除在源代码管理、URL、日志、聊天和命令输出之外。
  8. 在诊断失败的工具调用之前,先获取日志或请求 ID。
  9. 优先选择能完成当前任务的最小配置。除非请求或现有代码有明确需要,否则不要在首次路径中加入工具包过滤器、标签策略、沙箱控制、自定义认证、服务商特定加固及其他高级选项。
  10. 不要编造仓库事实。在提供或检查之前,切勿声称某个文件、框架、环境变量加载器、身份字段、Agent 路径或依赖项存在。如果无法获取代码库上下文,请说明未知项,并请求访问权限或一个必要细节。
  11. 在 SDK 或 API 示例中,请使用当前公开页面或 schema 中的准确标识符和调用形式。复制所请求语言的文档化形式,而不是在 TypeScript 与 Python 之间转换名称;如果某个必要细节没有文档说明,请解释其行为,但不要编造代码。

规范信息

对于稳定的决策,请使用随附的参考资料。面向用户的来源列表只包含实际查阅过的公开 https://docs.composio.dev/... 页面;随附参考资料名称、本地路径和 file:// URL 均应省略。对于版本、服务商适配器、客户端特定设置、工具包行为,或可能已变更的 API,请在回答或编辑代码之前,以当前规范文档和当前 CLI 或工具 schema 作为主要来源:

当来源之间存在分歧时,优先采用当前 API 参考和实时端点行为,而非任何标记为 Legacy 的页面,并明确说明 REST API 版本。

https://docs.composio.dev/llms.txt
https://docs.composio.dev/docs/<page>.md
https://docs.composio.dev/toolkits/<toolkit>.md

如果这些主要来源无法回答 Composio 产品或故障排查问题,请查询公开的统一知识搜索:https://docs.composio.dev/api/knowledge-search?q=<question>。

结果可能是规范文档、KB、工具包、示例或参考页面。请利用返回的证据回答问题;公开记录无法证明用户账户、项目、连接或工具调用的实时状态。

当知识搜索提供证据时,请引用结果返回的 canonicalUrl,而非搜索 API 的 URL。如果 canonicalUrl 是相对路径,请在引用前加上 https://docs.composio.dev 前缀。

只有当摘录或页面直接回答了问题时,才将结果视为证据。如果没有公开来源直接记录某个确切错误或症状,请如实说明,不要根据相邻结果进行诊断;应请求日志或请求 ID,或必要的实时证据。

应使用文档完成任务。除非用户明确要求,否则不要仅向用户提供链接。

评论

支持 Markdown