SuperAPI AI 工具集

clickup-migration-deep-dive

通用与其它

查看项目

更新于 10-15 22:42

技能介绍

用途:把数据迁入 ClickUp 工作区或在 ClickUp 工作区之间迁移,强调每批可恢复、可对账、可安全中止。

主要能力:源实体与目标层级盘点;字段、用户、状态、日期、附件、评论、依赖关系的映射版本管理;完整分页抽取并持久化不可变源 ID 与内容哈希;先跑无写入转换报告,再以严格上限做代表性试点迁移;写入前先持久化目标 ID,仅重试幂等或瞬时任务;按计数与抽样字段哈希对账,隔离异常并取得切换批准。

必要用法:需具备源导出/API 权限与目标工作区/列表白名单;使用 Read、Glob、Grep 检查仓库与配置,WebFetch 仅用于官方 ClickUp 文档,确认目标文件与工作区边界后再 Write/Edit。认证用个人令牌(仅个人/测试)或 OAuth 授权码(面向用户的集成),令牌经受管密钥引用在服务端注入,放入 Authorization 头,校验授权工作区 ID,绝不打印令牌、OAuth 客户端密钥或 webhook 密钥。

关键约束:Get Tasks 每页 100 条、从 0 开始分页,需明确是否包含已关闭任务、子任务及多列表任务;优先级与日期须用官方值与毫秒时间戳;自定义字段定义/选项须先解析,已有任务字段走各自的值端点;ClickUp 未记录通用事务性批量创建端点,故部分进度必须持久化并可恢复。生产切换、身份重分配、附件传输、私有内容扩展、删除或影响用户可见工作的回滚均需显式批准。

输出:映射版本,抽取/转换/迁移/跳过/隔离计数,ID 映射,对账结果,切换决定与回滚状态,并列出每个未决负责人与截止时间。错误处理:源 ID 已映射则校验目标哈希后恢复,不重复;映射目标缺失则隔离并更新映射版本;触发限流则检查点并在文档所述重置后恢复;试点对账失败则停止大范围迁移并修正转换。