SuperAPI AI 工具集

clickup-performance-tuning

通用与其它

查看项目

更新于 10-15 22:42

技能介绍

用途:在保证完整性、排序、新鲜度与限流安全的前提下,针对已测量的瓶颈调优 ClickUp 吞吐量与数据新鲜度;拒绝以丢弃记录换取速度的优化。

主要能力:按端点与业务操作分别测量后再调整缓存或并发;校验分页终止、排序、过滤与对账;合并重复读取,缓存稳定的层级元数据并显式失效;依据令牌剩余/重置响应头与下游队列容量设定并发;用 Webhook 触发失效或定向读取,同时保留对账扫描;对同一队列做基准对比。

必要用法:先用 Read、Glob、Grep 检查仓库、适配器、配置名、测试与证据,仅用 WebFetch 查阅 ClickUp 官方文档,确认目标文件、Workspace 边界与模式后再写。认证上,个人令牌仅用于可追责的个人/测试工作,面向用户的集成用 OAuth 授权码;令牌经受管密钥引用在服务端注入,放在 Authorization 中,校验授权的 Workspace ID,绝不打印令牌、OAuth 客户端密钥或 Webhook 密钥。

已知契约:Get Tasks 每页 100 条、页码从 0 开始,对已关闭任务与子任务有显式过滤,多列表任务用 include_timl;任务评论在最新 25 条之后用 start 加 start_id;v2 任务接口没有通用字段选择参数,不要臆造。Webhook 失效可减少轮询,但投递必须签名、幂等并对账。

限制与边界:未经负责人批准的 SLO,不得提高并发、延长新鲜度窗口、省略分页或用 Webhook 取代对账。分页循环重复或跳记录时先停止并修复游标/页状态;缓存返回过期任务状态时失效并回滚;429 增加时降低并发并遵守重置头;出现 Webhook 缺口时恢复对账读取并修复事件处理。输出应包含基线/调优后延迟与请求数、完整性、新鲜度、缓存命中率、并发、429 与回滚决定。