关于 composio
Composio 是一个路由 Skill,帮助 Agent 用户和应用开发者选择合适的 Composio 产品与指南。它区分个人应用访问和平台集成,并涵盖设置、操作、故障排查及最新文档查询。
主要功能
- 01将请求分流至 For You 或 Platform
- 02依据任务选择相关指南
- 03提供设置与集成指引
- 04指导经授权的工具执行和故障排查
- 05针对易变信息查阅当前规范文档
适用场景
- 01为个人 Agent 选择 Composio 设置方式
- 02将 Composio 集成到应用中
- 03通过已连接的工具执行应用工作流
- 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.mdfor-you.mdplatform.md详细介绍
Composio
将本技能用作路由。先识别产品和任务,只加载相关指南,对易变的细节查阅权威文档,然后回答问题或完成用户请求的工作。
1. 选择产品
不要混用两种产品。它们使用不同的凭证和设置路径。
| Composio For You | Composio Platform | |
|---|---|---|
| 适用场景 | 有人希望自己的 Agent 使用自己的应用 | 开发者正在构建一个让用户连接账户的产品 |
| 主要入口 | MCP 或 Composio CLI | 应用内的 SDK 会话 |
| 凭证 | 客户端需要请求头时使用 ck_... 消费者密钥 | COMPOSIO_API_KEY 项目密钥 |
| 控制台 | dashboard.composio.dev → For You | dashboard.composio.dev → Platform |
只有在上下文无法确定产品时,才提出一个简短问题:
这是用于你自己的 Agent 和账户,还是用于让你的用户连接其账户的产品?
如果提到了某个个人 AI 客户端但没有产品代码,按 For You 处理。如果涉及应用代码库、SDK、用户或租户身份、后端或产品 Agent,则按 Platform 处理。
2. 选择任务
在采取行动前,先确定所请求的结果:
- 解释或探索: 回答问题、比较方案,或查找当前 API。
- 设置: 首次建立凭证、MCP 客户端、CLI 或 SDK。
- 构建或修改: 将 Composio 集成到现有 Agent 或应用中。
- 运行: 为实际任务查找、连接并执行工具。
- 调试或迁移: 诊断故障、更新旧版集成,或从旧版直接执行或 Tool Router 迁移。
不要把解释、文档查询或范围较小的 Bug 修复变成入门引导。
3. 仅加载相关指南
- For You:阅读 Composio For You。
- Platform:阅读 Composio Platform。
- 提供方、连接或执行失败:另请阅读 Errors and provider gotchas。
完成所选任务
- 对于问题,需要时获取当前文档,并给出具体答案。不要修改项目或强制调用工具。
- 对于设置或集成,检查现有环境,保留其架构和身份模型,做最小但有用的改动;在凭证和用户授权可用时,通过一次安全的真实工具调用进行验证。
- 对于运行类请求,只连接任务所需的应用,并执行所请求的工作流。
- 对于调试,获取 Composio 日志或请求 ID,定位出错的环节,修复该环节;在用户授权执行时进行重试。
稳定规则
- 在选择凭证、URL、SDK 或命令之前,先确认产品。
- 将控制台(dashboard)引导流程视为一种上下文,而非该 Skill 的身份。当开发者带着来自“快速开始”的现有
COMPOSIO_API_KEY进入时,直接使用它,切勿在聊天中创建、轮换、替换、打印或索取该密钥。在此路径下不要运行composio dev init。 - 对于没有控制台凭证交接的一般首次 Platform 设置,请遵循 Platform 指南中的当前设置路径。
- 切勿编造工具包(toolkit)或工具的 slug。请在运行时或通过 CLI 发现它们。
- 不要构建服务商 OAuth 流程。需要认证时,Composio 会返回 Connect Link。
- 新的 Platform 集成应使用 Sessions。保留应用现有的用户身份和 Agent 架构。
- 将凭证排除在源代码管理、URL、日志、聊天和命令输出之外。
- 在诊断失败的工具调用之前,先获取日志或请求 ID。
- 优先选择能完成当前任务的最小配置。除非请求或现有代码有明确需要,否则不要在首次路径中加入工具包过滤器、标签策略、沙箱控制、自定义认证、服务商特定加固及其他高级选项。
- 不要编造仓库事实。在提供或检查之前,切勿声称某个文件、框架、环境变量加载器、身份字段、Agent 路径或依赖项存在。如果无法获取代码库上下文,请说明未知项,并请求访问权限或一个必要细节。
- 在 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,或必要的实时证据。
应使用文档完成任务。除非用户明确要求,否则不要仅向用户提供链接。