用途：面向需要调用 Spotify Ads API v3 的用户，提供广告活动、广告组、广告、素材、受众、报表及计量配置等资源的接口参考与操作指引。
主要能力：基础地址 https://api-partner.spotify.com/ads/v3，采用 OAuth 2.0 Bearer 令牌认证，所有请求需附带 Authorization、X-Spotify-Ads-Sdk、X-Spotify-Ads-Skill 头。资源层级为 Business → Ad Account → Campaign → Ad Set → Ad，并含 Draft、Audience、Asset、Reports。支持活动/广告组/广告的 CRUD、草稿创建与发布校验、受众与素材管理、聚合与异步 CSV 报表、移动应用与 Pixel/CAPI/数据集等计量配置、企业与账户管理。预算以微单位表示（乘以 1,000,000），时间戳为 UTC ISO 8601，ID 为 UUID，列表支持 limit（1-50）与 offset 分页。
使用方式：推荐通过封装脚本 scripts/api-request.sh 发起请求，技能内定义 api() 函数委托调用；认证可运行 configure 技能（Claude/Codex 为 /spotify-ads-api:configure，Antigravity 为 /configure）。调用前应按 references/live-openapi.md 获取当前 OpenAPI 文档作为 schema 依据。对活动层级写入默认走草稿流程：创建草稿 → 编辑 → 校验 → 用户明确确认后发布；发布与校验需使用最新 draft_hierarchy_version。
限制：现行活动/广告组/广告不支持 DELETE，只能改为 ARCHIVED 或 PAUSED，草稿实体可删除。更新用 PATCH，至少提供一个属性。发布为实时变更，始终需用户明确确认。部分端点语义与费率、地区限制暂未提供。