用途：通过全局 clickup CLI 操作 ClickUp 的任务与文档，适合在终端或自动化流程中读写 ClickUp 数据。触发场景包括 ClickUp URL、任务 ID、列表 ID、文档 ID、页面 ID、负责人、状态、截止日期、评论、清单等。
主要能力：读取任务与评论；添加或删除评论；读取或更新状态；列出列表内任务；查看当前用户；创建任务与子任务；列出我的任务；搜索任务；分配任务；设置截止日期与优先级；移动任务；添加链接、清单项、标签；更新描述；通知关注者；列出、读取、创建文档；读取、创建、更新页面。
使用方式：先运行 clickup --help 检查环境。命令示例：clickup get <url-or-id>、clickup comments <url-or-id>、clickup comment <url-or-id> "message"、clickup status <url-or-id> [status]、clickup tasks <list_id>、clickup me、clickup create [list_id] "title"、clickup my-tasks、clickup search "query"、clickup assign <task> <user>、clickup due <task> "date"、clickup priority <task> <level>、clickup subtask <task> "title"、clickup move <task> <list_id>、clickup link <task> <url> ["description"]、clickup checklist <task> "item"、clickup delete-comment <comment_id>、clickup watch <task> <user>、clickup tag <task> "tag_name"、clickup description <task> "text"、clickup docs ["query"]、clickup doc <doc_id>、clickup create-doc "title" [--content "..."]、clickup page <doc_id> <page_id> [--content-format text/plain]、clickup create-page <doc_id> "title" [--content "..."] [--sub-title "..."]、clickup edit-page <doc_id> <page_id> [--name "..."] [--sub-title "..."] [--content "..."]。
执行原则：规范化目标；用最窄命令读取；做最小写入；仅在需要确认时重新读取。使用 --json 获取结构化输出。写入前先读取当前状态，除非请求的变更已经精确。不要读取 .env 或密钥，读取 shell 环境变量。
注意事项：clickup status <task> 可列出有效状态，状态更新支持部分匹配；assign 和 watch 可解析用户名、邮箱或用户 ID；clickup due <task> clear 和 clickup due <task> none 可清除截止日期；clickup docs 还支持 --id、--creator、--deleted、--archived、--parent-id、--parent-type、--limit；clickup doc 支持 --max-page-depth；create-page 支持 --parent-page-id、--sub-title、--content-format；edit-page 需至少提供 --name、--sub-title 或 --content 之一，并支持 --content-edit-mode 与 --content-format；watch 会发布一条 @mention 评论。URL 格式：任务为 https://app.clickup.com/t/{task_id}，文档为 https://app.clickup.com/{workspace_id}/v/dc/{doc_id}/{page_id}。创建文档时同时设置文档标题与页面名称，页面名称不可为空；markdown 内容使用 --content-format text/md，否则可能被转义；不要在页面内容中重复文档标题；确认文档 URL 包含 workspace、doc、page 三个 ID。安装、配置与完整命令参考见 README.md；遇到 CLI 缺失、认证或工作区错误时指向 README.md。