核心用法
本 Skill 提供 Acuity Scheduling 的完整 API 代理能力，通过 Maton 托管网关 (gateway.maton.ai) 实现 OAuth 认证托管。用户仅需设置 MATON_API_KEY 环境变量，无需处理 Acuity 的 OAuth 流程。支持以下核心操作：
- 预约管理：创建、查询、更新、取消、改期预约
- 日历与预约类型：列出日历、预约类型及其配置
- 可用时间查询：按月份或日期获取可预约时段
- 客户管理：客户信息的增删改查（需已有预约）
- 时间段封锁：管理休息/不可用时间段
- 表单与标签：查询客户 intake 表单及预约标签
所有请求通过统一网关转发，Maton 自动注入 OAuth Token。多连接场景可通过 Maton-Connection 头指定。
显著优点
1. 零 OAuth 维护：Maton 托管 OAuth 令牌刷新，开发者无需实现授权流程
2. 原生 API 完整映射：直接透传 Acuity Scheduling 原生接口，功能覆盖全面
3. 连接管理面板：ctrl.maton.ai 提供可视化连接创建、状态监控、删除能力
4. 多连接支持：可为同一 Acuity 账户或不同账户维护多个 OAuth 连接
5. 丰富查询能力：支持按日期范围、日历、客户信息等多维度筛选预约
潜在局限
- 依赖 Maton 服务可用性：网关故障将影响所有 API 调用
- 客户操作限制：客户更新/删除仅适用于已有预约的客户
- 改期约束：重新预约必须选择系统判定为可用的时间段
- 日期解析依赖 PHP strtotime：时间字符串需符合 PHP 解析规则，存在潜在兼容性问题
- 环境变量依赖：
MATON_API_KEY泄露将导致账户级别的 API 访问权限暴露
适合人群
- 需要快速集成 Acuity Scheduling 的开发者，希望跳过 OAuth 实现
- 需要程序化管理预约、查询可用时段的业务自动化场景
- 已有 Maton 账户，希望统一管理多个 SaaS API 连接的团队
常规风险
| 风险类别 | 说明 |
|---------|------|
| 令牌泄露 | `MATON_API_KEY` 为账户级密钥，需妥善保管，避免硬编码 |
| 数据隐私 | 网关可访问完整预约、客户数据，需确认 Maton 数据处理合规性 |
| 服务锁定 | 深度依赖 Maton 网关架构，迁移成本较高 |
| 速率限制 | 受 Acuity API 自身限制及 Maton 网关双重约束 |