核心用法
ClickUp Skill 提供与ClickUp项目管理平台的REST API交互能力，主要功能包括：
查询操作：通过./scripts/clickup-query.sh脚本快速获取任务列表、任务统计、负责人分配情况；支持直接curl调用进行自定义查询。关键参数subtasks=true必须始终启用，否则将遗漏70%以上的实际工作任务。
任务管理：支持创建任务（POST到list端点）、更新任务（PUT到task端点）、获取特定任务详情，可设置名称、描述、负责人、状态、优先级等字段。
数据筛选：按Space、List、负责人、状态过滤；支持包含/排除已关闭任务；内置分页循环处理（每页100条限制）。
显著优点
- 开箱即用：提供封装好的shell脚本，降低API调用门槛
- 数据完整性强制：文档明确强调必须包含子任务，避免常见数据遗漏错误
- 工作流模板丰富：内置日报生成、任务审计、优先级分析等实用模式
- 灵活的双模式设计：脚本快速查询 + 直接API满足自定义需求
潜在局限
- 认证依赖：需预配置API Token和Team ID，无OAuth流程说明
- 速率限制：100请求/分钟限制，大规模数据同步需自行实现退避逻辑
- shell脚本依赖： helper脚本需要本地bash/curl/jq环境，纯API场景需手动实现
- 无实时Webhook支持：仅支持主动轮询，无事件驱动架构说明
适合人群
项目管理专员、数据分析人员、DevOps工程师、需要自动化ClickUp工作流的团队管理员，尤其适合已具备基础API调试能力的用户。
常规风险
API密钥明文存储于环境变量，存在泄露风险；错误配置subtasks=false将导致严重数据不完整；分页逻辑遗漏会造成决策依据失真。