SuperAPI AI 工具集

Skill 广场

找到适合任务的 Agent Skill,阅读介绍并复制安装命令。

更新于 11-15 00:13

编程与开发

41,139 个结果

graphql-architect

graphql-architect 是一个面向 GraphQL API 架构设计的技能,专注于 Schema 设计、解析器优化与联邦(Federation)。它采用 schema-first 的设计方式,强调使用恰当的类型与接口,并通过 DataLoader 模式解决 N+1 查询问题、实现字段级授权与片段复用。该技能还覆盖实时数据的订阅实现、查询复杂度分析与限流、错误处理与部分响应,并输出分页模式(游标/偏移)与客户端查询示例,推荐使用 Apollo Server 或类似方案。

编程与开发8 次安装

apply-openapi-overlay

apply-openapi-overlay 是一个用于将 overlay 文件应用到 OpenAPI 规范(spec)上的技能,通过 overlay 对 spec 进行转换。它适用于已准备好 overlay 文件、需要在加入工作流前测试 overlay 变更,或用户提出“apply overlay”“merge overlay”“overlay apply”等请求的场景。使用时需要提供源 OpenAPI spec(-s)和 overlay 文件(-o),输出为转换后的 OpenAPI spec(--out)。核心命令为 speakeasy overlay apply -s <spec-path> -o <overlay-path> --out <output-path>。推荐做法是将 overlay 直接加入 workflow.yaml 的 overlays 配置中,overlay 按顺序应用,后一个可覆盖前一个。该技能还提供常见问题排查,如 target not found、invalid overlay、未应用任何变更等,并关联创建 overlay、重新生成 SDK、用 overlay 修复校验错误等相关技能。

编程与开发8 次安装

check-workspace-status

check-workspace-status 是 Speakeasy SDK 生成技能集中的一项技能,用于检查当前 Speakeasy 工作区的配置与状态信息。它可帮助用户查看已配置的 SDK 目标、已发布 SDK 的版本与 URL、工作区名称与账户类型,以及未配置或生成失败的目标。该技能通过 speakeasy status 命令实现,支持 JSON 与 console 两种输出格式,适合在检查工作区认证是否正常、确认已配置哪些 SDK 目标或排查状态异常时使用。使用前需通过 speakeasy auth login 或设置 SPEAKEASY_API_KEY 环境变量完成认证。

编程与开发8 次安装

create-openapi-overlay

create-openapi-overlay 是一个用于在不修改源 OpenAPI 规范的前提下定制 SDK 生成的技能。它通过创建 Overlay 文件,以 JSONPath 定位的方式对规范进行增量修改,例如重命名操作、分组、添加描述、配置重试、标记废弃端点以及添加 SDK 专用扩展等。适用于无法直接编辑源规范、需要修复 lint 问题或为 Speakeasy SDK 生成添加定制信息的场景。该技能支持手动编写 Overlay 模板,也可通过 speakeasy overlay compare 命令对比两个规范自动生成 Overlay。

编程与开发8 次安装

fix-validation-errors-with-overlays

该技能用于在无法修改源 OpenAPI 规范的情况下,通过 overlay(覆盖层)修复校验错误。当存在 lint 错误但源规范不可编辑时,可用它添加缺失的描述、标签或操作名称。输入为带校验错误的 OpenAPI 规范(必需)和 lint 输出(可选),输出为修复校验问题的 overlay 文件。它支持通过 x-speakeasy-name-override 改善操作名称、补充 summary/description、添加 tags 数组、使用 x-speakeasy-group 进行分组、使用 x-speakeasy-retries 配置重试。注意:无效 JSON/YAML、缺失必填字段、损坏的 $ref、错误数据类型等结构性问题无法用 overlay 修复,必须直接修改源规范。

编程与开发8 次安装

get-ai-suggestions

get-ai-suggestions 是 Speakeasy SDK 生成技能集中的一项技能,用于借助 AI 为 OpenAPI 规范提供改进建议。它通过 speakeasy suggest 命令分析规范,可针对 operation ID(方法名)和错误类型给出建议,例如把自动生成的 get_api_v1_users_list 转换为更直观的 listUsers。建议可打印到控制台,也可输出为 overlay 文件,再通过 workflow.yaml 应用到 SDK 生成流程中。使用前需完成认证,非交互环境可设置 SPEAKEASY_API_KEY 环境变量。

编程与开发8 次安装

improve-operation-ids

improve-operation-ids 是 Speakeasy SDK 生成技能集中的一项技能,用于将 SDK 中自动生成、可读性差的丑陋方法名(如 GetApiV1Users)改进为直观的分组方法名(如 sdk.users.list())。它通过分析 OpenAPI 规范,生成更合理的 operation ID 建议,并可选地输出 overlay 文件,从而在重新生成 SDK 时应用这些命名改进。该技能适用于 SDK 方法命名混乱、需要统一命名风格的场景,支持交互式与非交互式(CI/CD、AI 代理)环境,非交互式环境需通过 SPEAKEASY_API_KEY 环境变量配置认证。

编程与开发8 次安装

merge-openapi-specs

merge-openapi-specs 是一个用于将多个 OpenAPI 规范文件合并为单一规范的技能,基于 speakeasy merge 命令实现。它适用于将微服务各自的规范整合为统一 API、合并不同版本的规范文件,以及组合公开与内部 API 规范等场景。使用时通过 -s 参数逐个指定待合并的规范(至少两个),用 -o 指定合并后的输出路径。当规范之间存在冲突时,后指定的规范会覆盖先前规范中的重复路径,而 schema 冲突可能需要手动解决,建议合并后检查输出正确性。常见问题包括重复 schema 名称、跨规范 $ref 引用缺失以及重复路径,可通过重命名 schema、确保引用完整或调整基础路径来处理。该技能与 validate-openapi-spec、start-new-sdk-project、create-openapi-overlay 等相关技能配合使用。

编程与开发8 次安装

regenerate-sdk

regenerate-sdk 是一个用于在 OpenAPI 规范变更后重新生成 SDK 的技能。它通过执行 speakeasy run 命令来运行已配置的工作流并重新生成 SDK 代码。适用于 OpenAPI 规范更新、workflow.yaml 或 overlay 配置变更、以及需要使用最新 Speakeasy 版本重新生成的场景。触发词包括 "regenerate SDK"、"run speakeasy"、"speakeasy run"、"rebuild SDK"、"update SDK"、"spec changed"。使用前需确保 .speakeasy/workflow.yaml 存在、OpenAPI 规范已配置、并完成认证(通过 speakeasy auth login 或设置 SPEAKEASY_API_KEY 环境变量)。命令支持运行全部目标、指定目标或指定源,并提供 AI 友好的输出模式。

编程与开发8 次安装

karakeep-knowledge

Karakeep Knowledge 是一个面向编程智能体的技能,通过官方 Karakeep MCP 服务器,为编码代理提供一份本地持久化的知识收藏。它把保存的网站、源码内容、截图和可搜索文本集中到一个集合中,供代理在编码任务中复用。该技能复用官方 Karakeep MCP 服务器和用户已有账号,不需要云端账号或外部 AI 提供商。主要使用场景包括:为编程代理配置或连接 Karakeep、检查本地知识服务状态、在需要时查阅已保存的组件库、框架、设计参考或说明文档、保存或导入用户要求添加的参考资料、检查项目就绪状态并核对已批准文档、草稿与会话报告、按请求或既有自动整理策略整理已保存的知识。使用时遵循四条路由:设置或连接、使用集合、同步仓库知识、整理集合。普通使用为只读;导入、打标签、同步、整理、创建账号和修改配置都需要相应请求或有效的长期策略。

编程与开发8 次安装