关于 android-networking-retrofit-okhttp
面向 Android 开发者的网络层构建技能，使用 Retrofit 和 OkHttp。它侧重明确的 API 契约、稳健的错误处理，以及兼顾数据与持久化边界的迁移安全模式。
主要功能
- 01配置 Retrofit 和 OkHttp
- 02设置拦截器
- 03定义类型化 API 契约
- 04稳健的错误处理
- 05验证离线与重试行为
适用场景
- 01搭建 Android API 网络层
- 02将 API 故障映射为应用错误
- 03测试缓存过期与重试行为
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/android-networking-retrofit-okhttp确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
agents/openai.yamlreferences/official-links.mdpatterns.mdscenarios.mdscripts/run_examples.sh详细介绍
Android 网络 Retrofit OkHttp
适用场景
- 在请求涉及以下内容时使用此技能：Android Retrofit 设置、Android OkHttp 拦截器、Android API 错误映射。
- 主要目标：使用 Retrofit、OkHttp、拦截器、API 契约和稳健的错误处理构建 Android 网络栈。
- 当范围扩大时转交给以下技能：
android-serialization-offline-syncandroid-security-best-practices
工作流
- 确认涉及的数据源、持久化边界、同步模型和设备能力。
- 在接入网络、存储、媒体或后台 API 之前，明确建模契约。
- 应用推荐的 AndroidX 或平台模式，并采用便于安全迁移的默认设置。
- 根据示例应用和场景验证离线、重试和进程终止后的行为。
- 必要时将安全、性能或发布风险升级给关联的支持技能。
防护措施
- 优先使用类型化模型和显式序列化器，而非临时映射或 bundle。
- 确保后台工作具备幂等性，并能感知取消操作。
- 不要将存储、媒体或网络细节泄漏到表示层代码中。
- 将用户数据持久性、隐私和迁移路径视为实现的一部分。
反模式
- 在主线程执行磁盘或网络调用，导致线程阻塞。
- 将可重试的同步失败视为面向用户的终止错误。
- 在没有映射层的情况下混用缓存模型和网络传输模型。
- 在存在范围更窄的 API 时，仍请求广泛的存储或通知权限。
示例
顺利路径
- 场景：为任务刷新建模同步请求和网络故障。
- 命令：
cd examples/orbittasks-compose && ./gradlew :app:testDebugUnitTest
边缘情况
- 场景：处理 XML 夹具中的过期缓存和重试行为。
- 命令：
cd examples/orbittasks-xml && ./gradlew :app:testDebugUnitTest
故障恢复
- 场景：区分网络提示词与序列化、安全和离线同步请求。
- 命令：
python3 scripts/eval_triggers.py --skill android-networking-retrofit-okhttp
完成检查清单
- 实现路径明确且精简，并且对应正确的 Android 接口。
- 已运行或更新相关示例命令和基准提示词。
- 请求涉及相邻技能时，已记录技能交接信息。
- 官方参考资料涵盖所选模式以及主要迁移或故障排查路径。
官方参考资料
评论
支持 Markdown