SuperAPI AI 工具集

cursor-origin-api

编程与开发

查看项目

更新于 10-16 07:14

技能介绍

用途:当任务涉及 Origin API 时,本技能负责把问题路由到 Origin 官方文档的正确章节,并提示需要先核对的几条规则。Origin 是外部产品名称,实际能力与权限应以当前官方公开文档为准,镜像内容不构成实时 API 契约,也不提供连接器、凭据、云运行时或安装。

主要能力与用法:以文档为唯一事实来源,不凭记忆写出端点、作用域、事件 slug、请求头或限制;文档与技能文件冲突时以文档为准。文档位于 https://cursor.com/docs/api/origin/,其中 llms.txt 是索引,链接各章节、端点和 Webhook 载荷;openapi.yaml 是契约,“Endpoint reference”说明其 x-origin-* 扩展;llms-full.txt 是完整参考;changelog 记录变更。单一问题从 llms.txt 开始,只取能回答该问题的章节;llms-full.txt 与 openapi.yaml 各有数百 KB,不宜整体读入上下文,需要时可在工作仓库之外本地保存并按标题或注解检索,引用 operationId 和章节名。

需先核对的规则:判断仓库是原生(在 Origin 创建)还是 GitHub 镜像,原生仓库安装拥有完整作用域和全部写权限,镜像上除 repository.pushed 外事件仍会到达,但超出元数据和内容读取的调用返回 403,且不支持合并 PR 或更改默认分支。只有 installation.* 事件无需订阅即可到达,缺少订阅会静默无事件而非报错。验证须在解析前用原始 body 校验签名,按投递 ID 去重,先返回 2xx 再处理;Origin 签名的是摘要,Standard Webhooks 不签摘要,通用验证器会失败。作用域取应用所调用操作上 x-origin-scopes.scopes 的并集。不要自行构造或解析分页 token 与 ID。乱序到达的 check-run 投递行为见“Ordering writes”章节。

限制:未经明确授权,不得仅依据指导进行认证、安装、创建应用、注册 Webhook、发送反馈、公开仓库信息或迁移代码;迁移技能只生成本地规划简报,反馈在获授权前仅为草稿。从 GitHub App 迁移请使用同插件中的 cursor-port-github-app-to-origin。其他未在资料中说明的细节暂未提供。