ClickUp项目管理集成

技能简介

该技能提供企业级ClickUp项目管理集成，支持多工作区切换、高级报表分析、客户文件夹组织及完整CRUD操作。面向需要同时管理多个客户和复杂工作层级的代理机构设计。

业务背景

专为多客户代理机构设计的集中式项目管理中枢，实现跨工作区资源统筹。通过统一入口管理不同客户的项目层级，自动生成负责人负载视图与进度报表，避免信息孤岛；自定义字段支持灵活适配各行业交付标准，降低多项目并行时的管理复杂度。

落地案例：广告代理同时服务三家客户，运营总监运行脚本获取各工作区任务统计，发现A客户有12项任务未分配，B客户设计组超负荷。随即按客户文件夹重组优先级，批量更新自定义字段标记交付风险。周报时一键导出三家的进度对比表，向管理层汇报资源调配方案。

能做什么

• 跨多个工作区的任务管理，自动包含子任务
• 生成任务统计、负责人分布、状态分析等报表
• 按客户组织文件夹结构，跟踪项目进度
• 管理空间、文件夹、列表、任务及自定义字段
• 记录工时并支持计费
• 创建文档和管理页面（API v3）
• 设置任务依赖关系和链接
• 跟踪销售管道中的潜在客户状态
• 管理 retainer 和周期性计费

使用说明

安装步骤：

1. 确保系统已安装 Python 3 和 pip
2. 安装依赖：pip install requests
3. 获取 ClickUp API Token：进入 ClickUp Settings → Apps → Generate API Token
4. 设置环境变量：export CLICKUP_API_TOKEN="pk_your_token_here"

基础操作示例：

• 列出所有工作区：python scripts/clickup_client.py get_teams
• 创建任务：python scripts/clickup_client.py create_task list_id="123" name="新任务" status="to do"
• 更新任务状态：python scripts/clickup_client.py update_task task_id="abc" status="in progress"
• 手动记录工时：python scripts/clickup_client.py create_time_entry team_id="xxx" task_id="yyy" duration=3600000 description="功能开发"
• 启动计时器：python scripts/clickup_client.py start_timer team_id="xxx" task_id="yyy"
• 停止计时器：python scripts/clickup_client.py stop_timer team_id="xxx"
• 获取任务统计：python scripts/clickup_client.py task_counts team_id="xxx"

输入与输出

见下方输入与输出表格。

风险提示

• API Token 需妥善保管，避免泄露导致数据风险
• 跨工作区操作时需明确指定 team_id，防止误操作错误空间
• 自定义任务 ID 需同时提供 custom_task_ids=true 和 team_id 参数
• 文档管理使用 API v3，参数为 workspace_id 而非 team_id
• 页面创建目前需通过 ClickUp UI 完成，API 尚处于测试阶段

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/d3layd/clickup-skill/SKILL.md
来源类型：GitHub 仓库