ClickUp 技能

与 ClickUp 的 REST API 进行交互，实现任务管理、报告和工作流自动化。

配置

使用此技能前，请确保已配置以下内容：

• - API 令牌： CLICKUPAPIKEY
• 团队/工作区 ID： CLICKUPTEAMID
• 任务负责人 ID： CLICKUPASSIGNEEID

检查它们是否已作为环境变量可用：
bash
echo $CLICKUPAPIKEY
echo $CLICKUPTEAMID
echo $CLICKUPASSIGNEEID

如果不可用，请将其导出为环境变量。
bash
export CLICKUPAPIKEY={value}
export CLICKUPTEAMID={value}
export CLICKUPASSIGNEEID={value}

快速开始

使用辅助脚本

查询 ClickUp 的最快方式：

bash

设置环境变量

export CLICKUPAPIKEY=pk_...
export CLICKUPTEAMID=...
export CLICKUPASSIGNEEID=...

获取在指定结束时间前到期或逾期的开放任务

./scripts/clickup-query.sh tasks --end 2026-03-28 17:00

获取在指定结束时间前到期或逾期的开放任务数量

./scripts/clickup-query.sh task-count --end 2026-03-28 17:00

获取在指定时间窗口内完成的任务

./scripts/clickup-query.sh completed-tasks --start 2026-03-24 --end 2026-03-28 17:00

获取团队下的空间

./scripts/clickup-query.sh spaces

获取指定空间 ID 下的列表

./scripts/clickup-query.sh lists 123456

在指定列表 ID 下创建任务，设置标题和截止日期，分配给 CLICKUPASSIGNEEID

./scripts/clickup-query.sh create-task {list_id} 跟进客户 2026-03-28 17:00

关闭指定任务 ID 的任务

./scripts/clickup-query.sh close-task 86e0jmdfe

直接 API 调用

适用于辅助脚本未涵盖的自定义查询或操作。示例：

bash

获取所有开放任务（包含子任务和分页）

curl https://api.clickup.com/api/v2/team/{teamid}/task?includeclosed=false&subtasks=true \
-H Authorization: {api_key}

常见操作

获取在指定结束时间前到期或逾期的开放任务

bash

使用辅助脚本

./scripts/clickup-query.sh tasks --end 2026-03-28 17:00

获取在指定结束时间前到期或逾期的任务数量

bash

使用辅助脚本

./scripts/clickup-query.sh task-count --end 2026-03-28 17:00

创建具有指定标题和截止日期的任务

步骤 1：获取所有列表

bash

使用辅助脚本

./scripts/clickup-query.sh spaces
./scripts/clickup-query.sh lists {space_id}

步骤 2：选择与任务最相关的列表
步骤 3：创建任务
bash

使用辅助脚本

./scripts/clickup-query.sh create-task {list_id} 跟进客户 2026-03-28 17:00

关闭任务

bash

使用辅助脚本

./scripts/clickup-query.sh close-task {task_id}