用途:该技能让 AI 通过 ClickUp API 以编程方式管理项目任务、空间、列表、文档、目标、仪表盘、自动化规则与时间追踪,用于同步任务、生成报表、按事件自动建任务,或接入 CI/CD 与聊天机器人等实时场景。
主要能力:可创建、查询、更新任务(如 POST /api/v2/list/{list_id}/task、GET /api/v2/list/{list_id}/task、PUT /api/v2/task/{task_id});获取空间与列表(GET /api/v2/team/{team_id}/space);访问文档与目标(GET /api/v2/folder/{folder_id}/doc);记录时间(POST /api/v2/task/{task_id}/time_entry);查询自动化规则(GET /api/v2/space/{space_id}/automation);读取仪表盘(GET /api/v2/team/{team_id}/dashboard)。支持分页,如 ?page=1&limit=50。
使用方式:所有请求需在 Authorization 头携带 Bearer token,token 存于环境变量(如 $CLICKUP_API_TOKEN),基址为 https://api.clickup.com/api/v2。典型流程是先 GET /api/v2/team 取 team id,再访问嵌套资源;可用 Python requests 或 curl 调用,输出可管给 jq 解析。示例:curl -H "Authorization: $CLICKUP_API_TOKEN" https://api.clickup.com/api/v2/list/456/task。集成可用 webhook(POST /api/v2/webhook),配置可写入 JSON 如 {"api_base": "https://api.clickup.com/api/v2", "team_id": "123"}。
适用场景:将 ClickUp 数据与其他应用同步、按事件自动建任务、生成每日汇总或仪表盘更新、在消息应用中实时管理任务。
限制:需有效 token 认证,401 未授权、429 触发限流(应指数退避重试)、404 未找到;分页需处理 next_page。文档未提供具体收费、价格与配额信息。