技能介绍

解决什么问题

在对接 Alpaca 这类券商 API 时，开发者常陷入文档陷阱：官方参考文档只告诉你 GET /v2/account 或 POST /v2/orders 这些端点怎么调，却很少说明在真实交易环境中会发生什么。你可能会遇到下单状态不同步导致的对账灾难、高频请求触发的限流、浮点数计算带来的资金精度丢失，或是 SSE 连接断开造成的数据缺失。这些“生产环境才会暴露”的坑，往往需要花费数周甚至数月去排查和重构。

技能如何工作

本技能被设计为 Alpaca 集成的路由中枢（Router / Overview）。当你面对一个陌生的 Alpaca 集成需求时，它会先帮你建立全局认知，而不是直接扔给你一堆零散的代码片段。

梳理通用协议：它首先覆盖所有 Alpaca API 家族的通用基础，包括基础 URL 配置、OAuth 或 API Key 的鉴权机制、不同 API 的消费风格（如 REST 与 WebSocket）以及底层的报文传输约定。
生成与调试代码：支持任意编程语言，能够根据需求直接生成可运行的集成代码，并在你遇到协议解析或接口报错时提供调试指导。
分发至细分技能：在完成全局梳理后，它会将你精准路由到对应的细分领域子技能（Sub-skills）。

适用边界与注意点

本技能的核心价值不仅在于“能调通接口”，更在于其内置的 lessons-learned（经验教训） 子技能矩阵。这些子技能专门针对对账（Reconciliation）、限流处理（Rate Limits）、资金精度（Money Precision）和 SSE 可靠性（SSE Reliability）等深水区问题。

需要注意的是，该技能是一个全局路由入口。如果你的问题已经非常具体（例如专门处理订单状态机或 K 线数据流），请直接使用其分发的特定子技能，以避免在通用层面上重复加载信息。它不替代官方 API 文档，而是作为连接官方文档与生产级最佳实践的桥梁。