SuperAPI AI 工具集

putio-sdk-dev

编程与开发

查看项目

更新于 10-16 04:53

技能介绍

用途:在 put.io SDK 仓库中开发、修改或评审 SDK/API 客户端,覆盖 TypeScript、Swift、Kotlin 等语言。技能遵循目标仓库自身指引,仓库本地规范、验证命令与发布策略优先于该共享技能。

主要能力与原则:把每个 SDK 当作公开包而非内部兼容层;TypeScript 视为完整 put.io API 客户端;公共接口保持领域优先、强类型并贴合宿主语言习惯;请求、响应与类型化错误契约需同步更新;用确定性测试配合必要的安全实时测试验证行为。来源冲突时优先顺序为本地后端行为与测试、当前自研应用用法、维护中的 SDK、归档客户端、已发布 API 文档。

使用方式:先读取所需内容,如 git ls-files '*AGENTS.md' '*SKILL.md'、README/AGENTS/docs 中的规范验证与实时测试命令、SDK 愿景、类型边界与错误映射模式、各语言说明及发布安全说明。端点变更时先定位源码、测试、固件与消费方路径,再按顺序更新请求输入类型、响应解析、操作级错误映射、公共客户端方法、单元测试、必要的安全实时测试及文档发布说明。验证使用所属仓库记录的命令,不自行推断入口;仓库应同时提供适合 CI 的确定性单元测试路径与独立的实时测试路径,缺失即视为仓库缺口。

适用场景与限制:适用于 put.io SDK 仓库内的通用 SDK 开发;不适用于通用 SDK 工作、终端用户应用代码或 CLI 消费操作。共享账号实时测试必须非破坏性;发布、手写发行、改动覆盖率阈值及不可逆的实时写入需先询问。仅在相关单元、固件与实时层均已执行时才声称完整验证。各仓库具体实现指引应保留在该仓库的 AGENTS.md 或 docs 中。