PagerDuty 事件编排器

要解决的问题

PagerDuty 在告警触发后会进入事件生命周期管理阶段：升级策略是否命中、值班人是否被通知、runbook 是否随事件附上、事后复盘的时间线怎么自动汇总。这些操作如果靠人在多个界面之间来回点，容易漏步骤、口径不一致；如果靠手写脚本拼 REST 调用，又要重复处理鉴权、header、分页等样板代码。本技能的目标是把 Events API v2 与 REST API 封装成一条可被 agent 驱动的编排链路，让上述生命周期步骤可以程序化触发。

核心能力

• 事件触发与上报：通过 @pagerduty/pdjs 封装的便捷方法向 Events API v2 提交事件，或直接传入 url / endpoint 进行裸调用。
• 升级策略自动化：在事件创建或更新阶段应用 escalation policy，避免人工判断该找谁。
• Runbook 附件：将对应处理手册附加到事件上，让响应人打开事件即可看到操作步骤。
• 事后时间线生成：事件关闭后汇总关键节点，形成可复盘的时间线。

关键步骤

1. 初始化 pdjs 客户端，完成环境变量或 token 配置。
2. 使用 Events API v2 上报事件，触发 PagerDuty 的告警与路由逻辑。
3. 调用 REST API 读取事件详情，按需更新状态或附加 runbook。
4. 事件解决后拉取时间线数据，输出复盘所需的关键事件序列。

适用边界与注意点

• 该技能覆盖的是事件编排层，不替代 PagerDuty 账户权限、服务目录或 on-call 排班本身的配置。
• 上游 pdjs 同时支持 Node 与 Browser 环境，但部分端点会要求额外设置 header，例如 From 头，漏掉会导致请求被拒。
• 调用方式上，便捷方法适合标准流程；如果 PagerDuty 侧未来新增端点或字段，可能需要直接传 endpoint 来绕过封装限制。
• 升级策略的判断逻辑仍以 PagerDuty 平台为准，技能只负责触发与读取结果，不会替平台做路由决策。