用途:调查 PagerDuty 事件,面向值班升级策略(escalation policy)场景,回答事件、值班状态、事件分析或 PagerDuty 调查类问题。
主要能力:支持两种模式。LIST 模式按时间窗口列出并过滤事件;SINGLE-INCIDENT 模式针对单个事件(从 PagerDuty URL 或 incident 简写提取 ID)拉取详情,并获取同一服务前后 ±2 小时的相关事件。可拉取升级策略、事件列表、事件日志、备注与分析数据,生成包含事件汇总表、跨团队关联、时间线、关键发现和建议的报告。
使用方式:需安装 pd CLI(https://github.com/martindstone/pagerduty-cli)并设置 PAGERDUTY_API_TOKEN。先验证令牌:test -n "$PAGERDUTY_API_TOKEN" && echo "TOKEN_SET" || echo "TOKEN_MISSING",再执行 pd auth add --token "$PAGERDUTY_API_TOKEN"。目标升级策略按 config.json 的 escalation_policies 数组、PD_ESCALATION_POLICIES 环境变量顺序解析,两者为空则包含全部。脚本位于 ${CLAUDE_SKILL_DIR}/scripts/,均从 stdin 读取、写 stdout,需先经 extract-json.js 再经对应 filter/parse 脚本。中间文件与报告保存到 .pagerduty-oncall-tmp/。
限制:需有效 PagerDuty REST API 令牌;事件详情需顺序获取以避免 API 限流;pd CLI 的 --until 为排他;事件详情须使用内部 id 而非 incident_number;报告时间戳使用本地时区,机器解析元数据使用 UTC ISO8601。其他细节暂未提供。