SuperAPI AI 工具集

cursor-port-github-app-to-origin

编程与开发

查看项目

更新于 10-16 07:14

技能介绍

用途:在应用自身代码库中运行,规划把一个现有 GitHub App 迁移成 Origin App,输出供团队使用的迁移简报(references/brief.md),其中含一份可直接发送的「Feedback for Cursor」草稿。该技能只做规划,除非用户在阅读简报后明确要求,否则不写或改代码;应先遵循 cursor-origin-api 技能查阅文档与规则。

主要能力:从源码中(而非向用户询问)查找并记录带 file:line 的事实,找不到的转为向团队提出的问题;梳理清单包括:manifest 或基础设施代码中声明的权限与事件,无法获取则由调用推导;所有 webhook 事件及其处理函数读取(含仅记录日志)的载荷字段;所有 REST 与 GraphQL 调用及其参数、过滤条件、读取的响应字段、是否每个 webhook 都执行或处于循环中、如何分页;认证方式(JWT 算法、安装后如何获知 installation ID、令牌过期处理、用户登录及其目的、是否克隆或推送 git);webhook 接收端的签名校验方式、校验时是否持有原始请求体、如何对投递去重;框架或库(如 Probot 的接收器、令牌缓存、配置加载器,Octokit App 的安装与仓库列举,app-auth 库)代表应用发起的调用,读依赖文档后标为「from <dependency>」。

使用方式与映射规则:迁移需要完整规格,但 openapi.yaml 与 llms-full.txt 各达数百 KB,难以整体读入上下文;可先保存到应用仓库之外的临时位置(避免覆盖或遗留工作区内容),再检索并只读取匹配部分。x-origin-scopes 在 openapi.yaml 中标注每个操作的作用域,operationId 位于其上一行;x-origin-webhook-events 标注每个 webhook 载荷 schema 对应的事件 slug;llms-full.txt 中的 ### <Endpoint name> 与 ### <Payload type> 标题标记该端点或载荷字段(点分路径)的说明,读取到下一个 ### 为止;后续单点问题可从 llms.txt 开始只取该节。名称匹配只是候选而非答案,需对照操作的描述、参数与响应字段核对代码传入与读取的内容,缺失的参数字段应视为变通方案或缺口。GitHub 位于 /issues/{n}/… 的拉取请求相关调用(评论、标签)在 Origin 上位于拉取请求端点下;Origin 无 GraphQL,需将每个查询拆成 REST 调用并记录扇出。应请求的作用域是所选操作 x-origin-scopes.scopes 的并集,不要直接翻译 GitHub manifest。每个 GitHub 事件与动作对最多映射到「Events」中的一个 slug,动作是 slug 的一部分,无对应 slug 的组合在 Origin 上不是事件。对代码读取的每个载荷字段,记录其是否在载荷中、在投递信封中(event.type 携带动作)、需要额外读取(说明是哪个操作、每事件调用次数)、可由其他字段计算,或缺失;载荷是快照,REST 资源有而载荷缺失的字段需要额外读取。文档未提及的能力视为当前不可用,应向团队询问;文档既未确认也未否认的行为,需提出问题并在端到端测试中加入对应步骤,不要假设其与 GitHub 上行为一致。

限制:本镜像不提供连接器、提供方、凭证、云运行时或安装;不得仅凭指导就进行认证、安装、创建应用、注册 webhook、发送反馈、发布仓库细节或迁移代码。调用时应通过可用的原生网页界面获取 Origin 当前官方公开文档,镜像中的来源固定版本并非实时 API 契约,需先确认实际能力与权限。反馈只描述用例,用 Origin 术语说明应用需要做什么、Origin 缺少什么,不含文件路径、模块名、框架细节或仓库名;反馈在明确授权发送前仅为草稿。完成前要求:关于 Origin 的每个论断都指向已保存文档中的内容;每个缺口都有指明其代价的反馈条目;反馈不泄露团队内部信息;总结中说明 native-or-mirror 问题。

适用场景:需要把 GitHub App 迁移或对照到 Origin App 时,在应用代码库内产出迁移规划简报并整理对 Origin 的反馈。

分类与平台等其余细节:暂未提供。