SuperAPI AI 工具集

clickup-local-dev-loop

编程与开发

查看项目

更新于 10-15 22:42

技能介绍

用途:在离线状态下开发 ClickUp 适配器,保持与真实 provider 数据结构一致,并提供一条受控路径来发现真实 API 漂移。

主要能力:围绕所有 ClickUp HTTP 调用建立可注入的传输接口;基于文档化的 v2/v3 schema 生成脱敏夹具,覆盖 null 与错误;使用确定性时钟、假队列和可选隔离 Workspace 做实时只读探测;模拟 429 响应头、从零开始的任务分页、评论游标、授权码和 webhook 投递重试;测试原始 body 的 HMAC 校验、脱敏、Workspace 守卫和部分写入恢复。

使用方式:用 Read、Glob、Grep 检查仓库、适配器、配置名、测试与证据;仅用 WebFetch 获取当前官方 ClickUp 文档;确认目标文件、Workspace 边界和模式后再用 Write 或 Edit。认证上,个人令牌仅用于可追责的个人/测试工作,面向用户的集成使用 OAuth 授权码;令牌经服务端受管密钥引用注入,放在 Authorization 中发送,校验授权的 Workspace ID,绝不打印令牌、OAuth 客户端密钥或 webhook 密钥。默认运行离线测试,并记录实时探测发现的 provider 漂移。

适用场景:迭代 ClickUp 适配器、编写确定性测试、验证 webhook 与分页行为、检测 API 漂移。

限制与边界:不得记录生产响应、不得用个人工作数据作夹具、默认本地/测试路径不得启用写入;夹具含个人或任务内容须删除或隔离并替换为合成数据;直接 HTTP 调用绕过传输层应使测试失败并重构边界;缺少实时凭据时跳过探测且不削弱离线测试;实时响应漂移须经官方来源复核后才更新契约。输出需区分模拟成功与 provider 确认的证据。