用途：为 ClickUp 集成提供可治理的参考架构，把提供方传输、租户策略、业务映射、持久执行与证据分层，避免 API 演进或部分失败破坏业务数据。
主要能力：使用显式 v2 与 v3 客户端（ClickUp 目前仅开放部分 v3 接口）；每次操作前将 v2 team_id 解析到应用 Workspace 租户边界；把 webhook 视为经持久幂等队列处理的签名变更信号，而非完整事件日志；写入需稳定源标识、对账与补偿/回滚策略。
使用方式：先用 Read、Glob、Grep 检查仓库、适配器、配置名、测试与证据，仅用 WebFetch 查官方 ClickUp 文档，确认目标文件、Workspace 边界与模式后再 Write 或 Edit。认证上，个人令牌仅用于可追责的个人/测试工作，面向用户的集成用 OAuth 授权码；令牌经受治理的密钥引用在服务端注入，放入 Authorization 头，校验授权 Workspace ID，绝不打印令牌、OAuth 客户端密钥或 webhook 密钥。
适用场景：需要定义源真相与字段级归属、在版本化传输之上加策略层、为命令与事件建模持久 ID/映射版本/幂等记录、加入限速感知队列、webhook 入口、对账扫描与死信审查、分离无内容遥测与敏感载荷存储、演练认证/套餐/限速/webhook 缺口/部分写入/模式漂移/回滚等场景。
限制：未经产品负责人明确策略，不得自主执行破坏性写入、跨 Workspace 路由、ACL 变更或冲突解决。源真相不明时停止双向设计；端点受套餐限制时记录依赖与获批替代；仅靠 webhook 无法对账时补充源读取与持久检查点；无法补偿时收窄写入范围或要求人工审批。输出应包含组件/数据流设计、版本矩阵、信任与租户边界、失败模式、SLO、对账、审批与回滚。