用途：为使用 Terra 统一健康与健身数据 API 构建应用时提供生产验证的最佳实践与规则，覆盖 500 多种可穿戴设备的接入场景。
主要能力：规则按优先级分为五类——Webhook 处理（关键，webhooks-）、数据与幂等（关键，data-）、认证与连接生命周期（高，auth-）、多设备数据（中，devices-）、测试（低至中，testing-*）。具体包括校验签名原始体、8 秒内返回 200 并异步处理、按 X-Terra-Trace-Id 去重、归档原始负载、以 natural keys 建模、时间戳本地化、reference_id 作为关联键、处理七类 auth 事件、跨设备重复合并等。
使用方式：新应用可从示例应用起步。先运行 terra version，若缺少 CLI 可安装：macOS/Linux 用 curl -fsSL https://cli.tryterra.co/install.sh | sh，Windows PowerShell 用 irm "https://cli.tryterra.co/install.ps1" | iex，或使用 Homebrew、npm。随后执行 terra examples list --select name,title,description 与 terra examples clone unified-api-web-app my-app（无需登录），阅读 README 与 AGENTS.md 并按 next_steps 配置运行。在聊天助手中无法运行 CLI 时，可让用户在终端执行上述命令，或参考 https://github.com/tryterra/terra-examples/tree/main/examples/unified-api-web-app。可用账户工具核对实际结果，例如 terra events list、terra events retrieve-payload、terra unified-api destinations list、terra users list、terra unified-api data scopes list；terra events resend 可重放真实事件，且可能重复到达，处理器需已去重。签名密钥由 terra unified-api destinations create 在创建时返回一次。编码代理（Claude Code、Codex、Cursor 等）建议使用 CLI；聊天助手使用 Terra API 管理端 MCP 服务器。编写具体功能前，先阅读 rules/ 下对应规则文件，并可用 terra docs ask（MCP 中为 docs_ask）查询文档。
适用场景：接入 Terra Unified API 的 Webhook、数据建模、认证与多设备数据整合流程。
限制：本技能只覆盖 Unified API 核心集成，移动 SDK、实时流、计划训练等由其他技能负责；CLI 与 MCP 各自能力不同，部分命令无 MCP 对应；MCP 读取载荷会将用户健康数据带入对话；资料未提供具体收费、价格或平台支持细节。