name: project-clickup description: ClickUp项目管理集成，用于事件跟踪和任务管理 allowed-tools:

Bash(python *)

ClickUp项目管理

查询和管理ClickUp中的任务，用于事件跟踪和项目管理。

认证

此技能使用凭证代理服务管理的凭据。在生产环境中，凭据通过JWT认证自动注入。

对于本地开发，设置：

CLICKUP_API_TOKEN - 您的ClickUp API令牌（个人访问令牌）
CLICKUP_TEAM_ID - 您的工作空间/团队ID（可选，如果未设置则自动检测）

可用脚本

list_spaces.py - 发现工作空间结构

列出工作空间中的所有空间、文件夹和列表：

# 列出空间
python list_spaces.py

# 包括列表和文件夹
python list_spaces.py --include-lists

# JSON输出
python list_spaces.py --json

search_tasks.py - 搜索任务

在工作空间中搜索所有任务：

# 按查询搜索
python search_tasks.py --query "payment error"

# 按状态筛选
python search_tasks.py --query "incident" --status "investigating"

# 最近更新的任务
python search_tasks.py --updated-since 24h

# 组合筛选
python search_tasks.py --query "api" --status "open" --updated-since 7d --json

选项：

--query, -q - 搜索文本（匹配名称和描述）
--status, -s - 按状态筛选（可重复用于多个状态）
--assignee, -a - 按指派人ID筛选
--list-id - 按列表ID筛选
--space-id - 按空间ID筛选
--updated-since - 自何时起更新的任务（例如，“1h”、“24h”、“7d”）
--created-since - 自何时起创建的任务
--include-closed - 包括已关闭的任务
--limit - 最大结果数（默认：50）
--json - 输出为JSON

get_task.py - 获取任务详情

检索特定任务的完整详情：

# 基本详情
python get_task.py abc123

# 包括评论
python get_task.py abc123 --include-comments

# 包括子任务
python get_task.py abc123 --include-subtasks

# 完整详情作为JSON
python get_task.py abc123 --include-comments --include-subtasks --json

选项：

--include-comments, -c - 包括任务评论
--include-subtasks, -s - 包括子任务
--json - 输出为JSON

add_comment.py - 添加任务评论

将调查发现添加到任务：

# 简单评论
python add_comment.py abc123 --message "在日志中找到根本原因"

# Markdown评论
python add_comment.py abc123 -m "## 调查总结
- 支付服务中的错误
- 由配置更改引起"

选项：

--message, -m - 评论文本（支持Markdown）
--json - 输出为JSON

ClickUp层次结构

理解ClickUp的结构有助于导航：

工作空间（团队）
└── 空间
    ├── 文件夹（可选）
    │   └── 列表
    │       └── 任务
    │           └── 子任务
    └── 列表（无文件夹）
        └── 任务

调查工作流

1. 发现结构

首先，找到事件跟踪的位置：

python list_spaces.py --include-lists

查找类似“事件”、“SRE”、“值班”等的空间/列表。

2. 搜索相关事件

搜索与您调查相关的事件：

python search_tasks.py --query "payment" --status "investigating"

3. 获取事件详情

审查完整的事件上下文：

python get_task.py abc123 --include-comments

4. 记录发现

添加您的调查发现：

python add_comment.py abc123 --message "根本原因：数据库连接池耗尽"

任务属性

状态

任务有可配置的状态。常见事件状态：

to do / open - 新事件
investigating - 主动调查
in progress - 修复进行中
resolved / complete - 事件已解决
closed - 事后分析完成

优先级

1 = 紧急
2 = 高
3 = 正常
4 = 低

自定义字段

团队通常使用自定义字段用于：

严重性（P0、P1、P2等）
受影响的服务
影响范围
客户影响
根本原因类别

与其他技能的集成

ClickUp与调查工作流集成：

开始：在ClickUp中检查现有事件票证
调查：使用可观测性技能查找根本原因
记录：将发现作为评论添加到ClickUp任务中
关联：与部署关联技能链接以进行变更分析

提示

使用任务ID - 从ClickUp URL复制任务ID（格式：abc123）
先广泛搜索 - 从一般查询开始，然后筛选
检查评论 - 之前的调查笔记可能有线索
边进行边记录 - 添加评论记录发现以提高团队可见性