SuperAPI AI 工具集

clickup-incident-runbook

部署与运维

查看项目

更新于 10-15 22:42

技能介绍

用途:在 ClickUp 支撑的生产行为异常时,按分诊、遏制、恢复、复盘流程处理 API 与 Webhook 事故,先区分供应商健康、凭据范围、限流耗尽、Webhook 暂停、数据漂移与应用故障,再采取恢复动作。

主要能力:使用 Read、Glob、Grep 检查仓库、适配器、配置名、测试与证据;WebFetch 仅用于获取当前官方 ClickUp 文档;确认目标文件、Workspace 边界与请求模式后才用 Write 或 Edit。

关键契约:ClickUp 状态、API 可达性、租户授权与应用副作用是相互独立的信号;Webhook 在响应失败或超过七秒后失败,失败事件在投递尝试后不会重发;fail_count=100 时 Webhook 被暂停,返回 401 会立即暂停;429 恢复应遵循每令牌的 reset 头而非猜测延迟。

认证:个人令牌仅用于可追责的个人或测试工作,面向用户的集成使用 OAuth Authorization Code;令牌通过受治理的密钥引用在服务端注入,放在 Authorization 中发送,验证已授权 Workspace ID,绝不打印令牌、OAuth 客户端密钥或 Webhook 密钥。

使用方式:声明范围、指挥官、严重级别、受影响 Workspace、写入冻结与证据保留边界;检查供应商状态并运行仅元数据的身份与限流探测;分类故障;在轮换凭据前用禁用写入、熔断、暂停队列或回滚进行遏制;一次恢复一条通道,并从持久记录核对遗漏或重复的业务操作;仅在验证、干系人沟通、证据捕获与后续任务分配后关闭。

限制与边界:未经指挥官与负责人批准,不得轮换共享令牌、重新激活 Webhook、重放队列、修改任务或压制证据。证据含工作内容时须先脱敏或隔离;Webhook 事件丢失时从源头读取核对,不要假设 ClickUp 会重发;凭据归属不明时冻结写入并升级;恢复导致错误率上升时回到遏制并回滚。输出应包含时间线、故障类别、遏制措施、受影响 Workspace 与操作、恢复证据、核对结果、后续负责人、未解决风险与下一次决策截止时间。