Motion

核心用法

本Skill提供对Motion（智能日程管理工具）的完整API接入能力，通过Maton网关实现托管OAuth认证，支持任务、项目、工作空间、评论、重复任务等全生命周期管理。

认证方式：使用MATON_API_KEY环境变量，通过Authorization: Bearer头部认证。OAuth连接需在ctrl.maton.ai管理，支持多连接切换。

主要功能模块：

• 任务管理：CRUD操作、移动、取消分配、自定义字段、自动调度（支持HARD/SOFT/NONE截止日期类型）
• 项目管理：创建、查询、模板化阶段管理
• 工作空间与用户：多工作空间切换、团队成员查询
• 协作功能：评论系统、标签管理
• 重复任务：周期任务自动化创建

特色能力：AI自动调度（autoScheduled参数）、优先级智能分级（ASAP/HIGH/MEDIUM/LOW）、GitHub Flavored Markdown支持。

显著优点

1. 零OAuth开发成本：Maton托管OAuth流程，开发者只需关注业务逻辑
2. 完整CRUD覆盖：原生Motion API 100+端点能力，非只读集成
3. 智能调度原生支持：直接调用Motion核心AI排程能力
4. 多连接管理：支持多Motion账号/团队场景
5. 多语言示例：Python、JavaScript、Bash全覆盖

潜在缺点与局限性

1. 速率限制较严格：个人版12 req/min，团队版120 req/min，高频场景需缓存策略
2. 网关依赖风险：所有请求经gateway.maton.ai中转，非直连Motion官方API
3. 环境变量单一认证：仅支持API Key，无精细化权限控制（如只读token）
4. 连接管理额外步骤：OAuth授权需在浏览器完成connect.maton.ai流程，无法纯程序化
5. 文档更新滞后风险：Motion官方API迭代时，网关可能存在适配延迟

适合人群

• 个人效率用户：需要AI自动规划日程的知识工作者
• 小型敏捷团队：12人以内、需轻量级项目协作的远程团队
• 自动化集成开发者：构建周报生成、任务同步、提醒机器人等场景
• 现有Motion付费用户：已使用Motion Premium/Team计划，需扩展自动化

常规风险

| 风险类型 | 说明 | 缓解建议 |

|---------|------|---------|

| 密钥泄露 | `MATON_API_KEY`暴露导致账号数据被读取/修改 | 使用密钥管理服务，禁止硬编码 |

| 速率超限 | 批量操作触发429错误 | 实现指数退避重试，缓存常用查询 |

| OAuth会话失效 | 用户撤销授权导致连接变为INACTIVE | 定期检查`ctrl.maton.ai/connections`状态 |

| 网关服务中断 | Maton网关不可用时完全失效 | 关键场景保留Motion原生导出能力作为降级 |

| 数据隐私 | 任务内容经第三方网关 | 敏感任务避免存储描述字段，或评估Maton安全合规 |

技术细节速览

• Base URL: https://gateway.maton.ai/motion/v1/...
• 分页：Cursor-based (meta.nextCursor)
• 时间格式：ISO 8601
• 项目描述：支持HTML；任务描述：支持Markdown
• 默认超时/重试策略：文档未明确，建议自行实现