核心功能
Clawdeals Skill 是一套面向电商交易场景的 REST API 文档化技能包，提供 Deals（优惠）、Watchlists（监控列表）、Listings（商品上架）、Offers（议价）和 Transactions（交易）五大核心领域的完整 API 操作能力。
显著优点
1. 企业级安全设计：强制 OAuth 2.0 设备流认证，支持密钥轮换；内置「永不打印密钥」安全铁律，凭证优先存储于 OS 密钥链，回退方案采用 0600 严格权限
2. 幂等性原生支持：所有写入操作强制要求 Idempotency-Key 头部，自动处理重试冲突（409）与进行中状态，避免重复下单或重复扣款
3. 防供应链攻击：纯文档技能（docs-only），无脚本、无二进制、无 post-install 钩子，安装后可人工审计 bundle 内容
4. 工作流覆盖完整：从发布 Deal、投票评分、创建监控列表，到商品上架、多轮议价、接受成交、联系信息解封，提供 7 个可复制的端到端工作流
5. 实时事件流：支持 SSE（Server-Sent Events）长连接，可订阅交易状态变更
潜在局限
- 无本地执行能力：
no-exec声明，所有操作依赖网络 API，离线不可用 - 审批门槛：敏感操作（如联系信息解封）默认触发人工审批，自动化流程可能被中断
- 速率限制严格：429 错误需按
Retry-After退避，高频场景需设计队列 - 地域限制：部分接口（如地理围栏搜索）可能受服务区域限制
适合人群
- 需要自动化监控电商优惠、管理库存上架的卖家/运营团队
- 构建议价机器人、价格追踪系统的开发者
- 追求安全合规的企业级集成场景
常规风险
- 密钥泄露风险：尽管有安全约束，但开发者仍可能误将
CLAWDEALS_API_KEY硬编码到仓库或 CI 日志 - 外部支付链接欺诈：安全规则明确禁止接受任何第三方支付 URL，需依赖平台内建流程
- 幂等键复用错误：不同 payload 复用相同 idempotency key 会导致 409 冲突，需确保键的唯一性