核心用法
ClickUp Skill 提供与 ClickUp 项目管理平台 REST API 的完整交互能力，主要功能包括：
任务查询与管理
- 获取任务列表（支持按空间、列表、负责人筛选）
- 创建、更新任务及子任务
- 任务统计与分配分析
- 支持分页查询（每页最多100条）
工作流自动化
- 每日站会报表生成
- 任务审计与优先级分析
- 未分配任务识别
- 状态分布统计
使用方式
1. 推荐方式：使用 ./scripts/clickup-query.sh 辅助脚本进行常见操作（tasks、task-count、assignees、task）
2. 直接调用：通过 curl 进行自定义查询和任务修改
显著优点
- 子任务完整性：强制要求
subtasks=true参数，避免遗漏70%+的实际工作任务 - 分页自动化：内置分页处理逻辑，确保大数据量场景下数据完整性
- 双层查询模式：辅助脚本 + 直接 API 调用，兼顾便捷性与灵活性
- 丰富的查询示例：提供负责人分布、优先级分析、任务审计等现成模式
- 完善的错误排查指南：针对401、速率限制、数据缺失等常见问题提供解决方案
潜在缺点与局限性
- 速率限制：100请求/分钟，高频操作需人工控制节奏
- 配置依赖：需预先配置 API Key、Team ID、可选的 Space/List ID
- 无实时同步：基于轮询的查询模式，非实时数据流
- 用户ID依赖：负责人筛选必须使用数字ID而非用户名，增加使用门槛
- Shell脚本依赖：辅助脚本需要本地执行环境，跨平台兼容性未明确
适合人群
- 使用 ClickUp 进行项目管理的团队
- 需要自动化报表（站会、周会）的技术负责人
- 希望集成 ClickUp 数据到内部系统的开发者
- 需要进行任务审计和 workload 分析的 PMO
常规风险
- API Token 泄露：
CLICKUP_API_KEY需妥善保管，避免硬编码提交 - 数据误操作：UPDATE/DELETE 操作不可逆，生产环境建议先测试
- 权限边界：API Token 权限与 ClickUp 用户权限一致，需注意最小权限原则
- 分页遗漏风险：未正确实现分页逻辑会导致数据不完整，影响决策
- 子任务数据膨胀：大型工作空间子任务数量可能远超预期，注意性能影响