ClickUp

ClickUp 是什么

把 ClickUp 层级化工作项接入 Agent，可读取和修改 workspace、space、folder、list、task、user 与 webhook。

适用场景

适合项目任务同步、自动建卡、状态更新、团队查询、Webhook 集成和跨系统工作流。

核心能力与工作机制

清单说明 ClickUp 层级、自定义任务 ID、分页、任务 CRUD、空间与列表管理、用户和 webhook，并提供多语言示例。

执行流程

配置 Maton Key 并授权 ClickUp，先列 workspace 与目标层级；精确定位 list/task 后预览写入内容，经确认再创建更新，最后查询资源或 webhook。

输入与输出

需要 Maton Key、OAuth 连接、workspace/space/list/task ID、字段和分页条件。输出项目层级、任务和用户数据；写请求会创建、更新或删除真实资源并管理 webhook。

依赖、账号与权限

依赖网络、Maton 服务、ClickUp 账号和 MATON_API_KEY，受 API 限速和权限影响。

副作用、限制与风险

错误层级 ID 会操作错误项目，删除任务或空间可能不可逆；Webhook 会向外部地址发送事件数据。可创建、修改和删除空间、文件夹、列表、任务与 webhook，也可删除授权连接。

不适用边界

未确认工作区、父级和目标任务前不得写入或删除，不能绕过 ClickUp 成员权限。

失败处理与验收

认证或限速错误先处理连接与退避；写入超时按 task ID/custom ID 查询，避免重复任务。回查任务字段、父级、负责人、状态和 webhook，必要时在 ClickUp UI 抽查。

适合谁使用

适合使用 ClickUp 的项目团队、运营和自动化开发者。

来源、版本与许可

本条目依据 SkillHub 热门榜、发布者详情和版本 1.0.5 的完整 SKILL.md 整理，核验日期为 2026 年 9 月 21 日。完整 SKILL.md 未声明许可证，公开可下载不代表可以任意复制、修改或再分发。 SkillHub 当前两套安全扫描状态为 benign、benign；该状态只是平台信号，不能替代对脚本、凭据、网络请求、数据外送与后续版本的人工审查。

常见问题

1. ClickUp 主要解决什么问题？

把 ClickUp 层级化工作项接入 Agent，可读取和修改 workspace、space、folder、list、task、user 与 webhook。适合项目任务同步、自动建卡、状态更新、团队查询、Webhook 集成和跨系统工作流。是否采用它，应以实际任务边界和可核验材料为准，不要因为榜单热度而跳过来源审查。

2. 开始前需要准备什么？

需要 Maton Key、OAuth 连接、workspace/space/list/task ID、字段和分页条件。准备阶段不要代替用户猜测关键事实；缺少会改变路线、费用或权限的输入时，应先补齐再执行。

3. 它怎样完成任务并交付结果？

配置 Maton Key 并授权 ClickUp，先列 workspace 与目标层级；精确定位 list/task 后预览写入内容，经确认再创建更新，最后查询资源或 webhook。每个阶段都要保留输入、决策、输出和检查点，不能把计划、预览或排队状态描述成最终交付。

4. 需要哪些工具、账号或权限？

依赖网络、Maton 服务、ClickUp 账号和 MATON_API_KEY，受 API 限速和权限影响。凭据应放在安全环境中，并按最小权限授权；账号、网络或本地依赖不满足时应明确停止条件。

5. 它会产生哪些外部操作或副作用？

可创建、修改和删除空间、文件夹、列表、任务与 webhook，也可删除授权连接。涉及外部写入、上传、发送、付费或持久配置时，应在实际动作前说明影响范围并取得相应确认。

6. 哪些情况不适合使用？

未确认工作区、父级和目标任务前不得写入或删除，不能绕过 ClickUp 成员权限。超出来源明确能力、专业资质或授权范围时，应切换到更合适的工具或交给专业人员处理。

7. 失败或结果异常时怎样恢复？

认证或限速错误先处理连接与退避；写入超时按 task ID/custom ID 查询，避免重复任务。恢复时优先查询已有任务、日志或备份，避免无上限重试、重复扣费、重复发送或覆盖唯一原件。

8. 如何验收结果并控制风险？

回查任务字段、父级、负责人、状态和 webhook，必要时在 ClickUp UI 抽查。验收应基于真实文件、页面、任务终态或权威来源，并把未能实际检查的部分明确标记出来。