ClickUp Operator

在 ClickUp 内部执行操作，采用快速、低摩擦的路由模型。

执行顺序

SKILL.md 是该技能的入口点与流量控制器。

请按以下顺序执行：

1. 判断用户是否需要首次运行引导（first-run onboarding）、安全验证（safe validation），还是常规运行（normal operation）。
2. 若尚未连接 ClickUp，或用户默认配置尚不明确，则优先阅读引导/配置相关文档。
3. 完成配置后，在响应真实 ClickUp 请求前，需先阅读路由与运行相关文档。
4. 若配置为全新或存在不确定性，应在将该技能视为生产就绪（production-ready）前先行执行验证。

分阶段路由

阶段 1：首次运行引导

在以下情况下使用本阶段：

• 用户刚刚安装该技能
• ClickUp MCP 尚未确认正常工作
• 用户尚未定义其路由默认值
• 用户明确请求设置 ClickUp Operator

按如下顺序阅读文档：

1. references/guided-onboarding.md
2. references/internal-install.md
3. references/structure-discovery.md
4. templates/guided-onboarding-checklist.md
5. templates/structure-discovery-worksheet.md
6. references/configuration.md
7. templates/config.template.yaml

然后执行：

• 向用户确认所发现的默认配置
• 仅在获得用户确认后才保存配置
• 在声明配置完成前，执行冒烟测试（smoke test）

阶段 2：针对已上线环境的安全验证

在以下情况下使用本阶段：

• ClickUp 已正常运行
• 用户不希望当前配置被干扰
• 目标是确认打包后的技能行为与线上实际行为一致

按如下顺序阅读文档：

1. references/safe-live-validation.md
2. examples/safe-live-smoke-test.md
3. references/configuration.md

阶段 3：常规运行

在以下情况下使用本阶段：

• ClickUp MCP 已正常运行
• 路由默认值已明确
• 用户希望执行常规的 ClickUp 任务/创意/读取类操作

按如下顺序阅读文档：

1. references/routing-rules.md
2. references/configuration.md

仅当行为表现异常或为新近配置时，才参考验证类文档。

适用场景

• 用户希望创建 ClickUp 任务、提醒或创意条目
• 用户希望将某项内容移至其他列表或项目中
• 用户希望修改负责人（assignee）或截止日期（due date）
• 用户希望了解哪些事项即将到期、当前活跃，或列在今日清单中
• 用户希望直接操作 ClickUp，而非讨论“应如何操作”

核心行为准则

1. 对明确的 ClickUp 操作立即执行。
2. 将可复用逻辑与账户专属配置分离。
3. 仅当缺失信息会实质性影响正确结果时，才发起追问。
4. ClickUp 操作完成后，保持响应简短，并聚焦于最终结果。

路由规则

• 通用创意（未绑定具体项目）：发送至已配置的 ideas 列表。
• 通用待办事项、提醒或行动项：发送至已配置的 general to-do 列表。
• 明确关联某项目的条目：发送至该项目对应的列表。
• 已发展为多步骤实际计划的条目：将其提升为独立的专用项目列表。

有关常规运行期间的详细决策规则与响应标准，请参阅 references/routing-rules.md。

配置

本技能有意避免硬编码绑定单一账户。执行任何操作前，必须加载用户的配置。

必需的配置类别包括：

• workspace 和 space 默认值
• 通用列表 ID（general list IDs）
• 成员 ID 或负责人解析默认值（member IDs or assignee resolution defaults）
• 读取查询所用的活跃状态过滤器（active status filters for read queries）
• 截止日期策略默认值（due-date policy defaults）

请以 references/configuration.md 和 templates/config.template.yaml 作为配置建立的契约依据。

如需内部安装或线上账户配置，请参考 references/internal-install.md； 如需在已上线 workspace 上进行低风险验证，请参考 references/safe-live-validation.md； 如需为结构已组织好的 ClickUp workspace 进行引导配置，请参考 references/structure-discovery.md； 如需端到端的完整用户引导流程，请参考 references/guided-onboarding.md。

读取行为

• 默认忽略已完成条目。
• 对于面向行动的读取请求，除非用户明确要求，否则仅返回配置中定义的活跃状态。
• 对于“我今日清单上有哪些事项？”类请求，默认行为为：
  • 仅返回分配给已配置默认负责人（default assignee）的任务
  • 仅返回截止日期为当天的任务
  • 除非用户特别要求，否则不包含明日及之后的溢出任务

验证

在确认该技能包（package）稳定可靠前，请使用 examples/test-cases.md 中的示例提示语，在已配置的账户上运行测试，并验证输出是否符合预期的路由逻辑与默认行为。

执行完整内部验证，请使用 examples/internal-smoke-test.md； 执行最低风险的线上验证流程，请使用 examples/safe-live-smoke-test.md。

当前已知细节说明：

• 当前 ClickUp MCP 接口中的同日精确过滤（即 due_date_from 与 due_date_to 设置为完全相同的日期）在“今日”类读取场景下可能不可靠
• 若同日过滤行为异常，请优先采用更稳妥的读取策略，而非假设路由逻辑有误

产品定位

若该技能包正准备对外发布共享，请参考 references/public-packaging.md，确保对外传达的产品故事、能力边界及配置预期清晰明确。