Communitygithub.com

bluesky-social/atproto

将 AT Protocol 客户端和消费者代码从旧的 `@atproto/api`、`@atproto/lexicon` 和 `@atproto/xrpc` 栈迁移到 `@atproto/lex`。适用于现代化任何调用 XRPC 服务的代码。

atproto 是什么?

该技能用于指导开发者将基于旧版 AT Protocol 技术栈(`@atproto/api`、`@atproto/lexicon`、`@atproto/xrpc`)的客户端和消费者代码,迁移到新的统一库 `@atproto/lex`。它详细描述了迁移过程中需要替换的关键 API 和模式,例如使用 `Client` 替代 `AtpAgent`,处理响应时使用 `result.data` / `result.headers[...]` 替代旧方式,以及将 `XRPCError` 的 try/catch 替换为更简洁的错误处理机制。技能还涵盖了数据类型处理的变化,如使用 `jsonStringToLex`/`stringifyLex` 替代手工序列化、移除对 `BlobRef` 的 `instanceof` 检查、改用 `CID` 相关处理、日期时间处理方式的现代化,以及 DID 类型的改变。支持 Bluesky 的 AT Protocol 生态,主要适用于使用 Node.js/TypeScript 的开发者。通过遵循此技能提供的步骤和示例,开发者可以安全、高效地完成代码现代化,确保与最新的 AT Protocol API 兼容。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add bluesky-social/atproto

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

atproto 是做什么的?

将 AT Protocol 客户端和消费者代码从旧的 @atproto/api、@atproto/lexicon 和 @atproto/xrpc 栈迁移到 @atproto/lex。适用于现代化任何调用 XRPC 服务的代码——替换 AtpAgent 为 Client、result.data / result.headers[...] 响应处理、XRPCError try/catch、jsonStringToLex / stringifyLex、BlobRef instanceof 检查、来自 multiformats 的 CID、AT Proto 日期时间上的 new Date().toISOString()、裸 string DID 等。

相关技能