用途：在 ClickUp 集成中基于实测的请求与功能使用数据做成本与负载调优，而非臆测价格或默认升级套餐。
前置信息：需按端点统计请求数、延迟、429 次数、分页深度、轮询间隔、缓存命中率；由授权所有者提供当前 Workspace 套餐与功能使用事实；明确新鲜度目标与已批准的数据保留策略。
主要契约：速率限制按 token 计算且随 Workspace 套餐变化；Get Tasks 每页最多 100 条，全量扫描会成倍放大请求；Webhook 可替代轮询，但需安全且持久的事件处理；部分功能与参数受套餐限制，商业价格须由账户所有者提供。
用法：按端点、token 边界、调用方、结果大小与业务操作度量请求；识别重复读取、空页、过宽轮询、重试风暴与不必要写入；对分页、条件缓存、Webhook 失效与调度合并建模；将自定义字段与套餐受限操作单独计量；比较方案时兼顾新鲜度、故障恢复、安全和所有者提供的商业事实；实施一项受限变更并验证请求、延迟、错误与陈旧度差异。
工具纪律：用 Read、Glob、Grep 检查仓库、适配器、配置名、测试与证据；仅用 WebFetch 获取当前官方 ClickUp 文档；确认目标文件、Workspace 边界与所需模式后再写入。
认证：个人 token 仅用于可追责的个人或测试工作，面向用户的集成使用 OAuth 授权码；通过受管密钥引用在服务端注入，置于 Authorization 头，校验授权的 Workspace ID，绝不打印 token、OAuth 客户端密钥或 Webhook 密钥。
边界与限制：未经所有者批准，不得更改付费套餐、削减必需的审计或数据控制、创建宽泛 Webhook 或接受陈旧数据。若价格或套餐事实过期，标注财务估算不完整并获取当前账户数据；若优化加剧陈旧则回滚或收紧失效策略；请求减少后 429 仍存续，先检查 token 共享与重置头；Webhook 替代导致事件丢失时恢复轮询回退并修复持久处理。资料未提供具体定价与更多示例。