SuperAPI AI 工具集

asana-api

办公与效率

查看项目

更新于 10-15 19:56

技能介绍

本技能通过 Asana REST API(根地址 https://app.asana.com/api/1.0)操作任务、项目、分区、评论和工作区。认证由运行环境注入,无需自行创建或刷新令牌;若凭证变量未设置,可填任意占位值。每条对象以字符串 gid 标识,响应数据包在顶层 data 键中,写入时字段也包在 data 内;默认只返回 gid、name、resource_type,可用 opt_fields 展开,点号表示关联字段。

主要能力:列出任务(按项目、标签、分区或负责人+工作区,支持分页与 --completed-since);获取单个任务;创建、更新、完成或删除任务;添加评论及读取 stories;搜索任务(高级搜索,需付费版,无 offset 分页、上限 100);读取项目与分区;在项目与分区之间移动任务;查找工作区、用户和项目 gid;处理子任务、标签和附件;设置自定义字段。

用法上,可先定义 asana() 辅助函数:asana() { curl -sS -H "Authorization: Bearer ${ASANA_TOKEN}" -H "Accept: application/json" -H "Content-Type: application/json" "$@"; },再用 /users/me 做连通性检查。随附的 scripts/asana_tasks.sh 封装任务列表,支持 --project、--tag、--section 或 --assignee+--workspace 之一作为选择条件,以及 --limit、--page-size、--json 等参数。

限制与约定:集合接口用 limit 与 next_page.offset 分页,offset 不透明且会过期,不可自行构造;搜索接口不支持 offset,仅按 created_at 等排序手动翻页,结果数超过约 10 万可能返回 400。速率限制按工作区与令牌计:免费版 150 请求/分钟、付费版 1500/分钟,搜索 60/分钟;并发 GET 50、写入 15。返回 429 时按 Retry-After 退避重试。错误响应将 data 替换为 errors 数组,401 通常表示凭证未配置,402 表示需付费版,403/404 表示权限或对象不存在。更多端点、写入体结构、附件上传(multipart)等细节见 references/api.md。