用途:该技能为代理商式工作流提供 ClickUp 集成,用于跨多个客户、项目和工作区进行任务与项目管理,并生成报表。
主要能力:按 Team(工作区)→ Space → Folder → List → Task 的层级进行操作;自动包含子任务;提供任务数、按负责人负载、按状态、按优先级的统计及每日站会报表;支持多工作区切换;支持客户文件夹组织与销售流程跟踪;支持工时计时器与手动工时条目;通过 API v3 创建文档;支持任务依赖(阻塞/等待)与任意任务关联。
使用方式:先设置令牌 export CLICKUP_API_TOKEN="pk_your_token_here",再调用 python skills/clickup/scripts/clickup_client.py <command> key=value。例如 get_teams 列出工作区,get_spaces team_id="xxx" 获取空间,create_task list_id="123" name="New Task" status="to do" 创建任务,update_task task_id="abc" status="in progress" 更新任务,create_time_entry、start_timer、stop_timer 记录工时,task_counts、assignee_breakdown、standup_report 生成报表。复杂操作可导入 ClickUpClient 直接调用。所有操作需显式提供 ID;文档接口使用 workspace_id,任务接口使用 team_id;自定义任务 ID 需同时传 custom_task_ids=true 与 team_id。
限制:受 100 请求/分钟速率限制,批量操作需间隔重试;文档页面 API 处于测试阶段,可能需在 ClickUp UI 创建页面;时长与时间戳使用毫秒;401、404、429、400 等错误需检查令牌、ID、速率与 JSON 格式。具体收费与价格资料未提供。