pir

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Post Incident Record (PIR)

事后记录（PIR）

Discover incidents from PagerDuty, enrich with Datadog and Cloudflare data, auto-determine severity, and produce completed PIR forms for each incident.

从PagerDuty中发现事件，结合Datadog和Cloudflare的数据丰富事件信息，自动判定严重程度，并为每个事件生成完整的PIR表单。

Arguments

参数

```
$ARGUMENTS[0]
```
— (optional) Start date in
```
YYYY-MM-DD
```
format. Defaults to today.
```
$ARGUMENTS[1]
```
— (optional) End date in
```
YYYY-MM-DD
```
format. Defaults to today.
```
$ARGUMENTS[2]
```
— (optional) Comma-separated local repo paths for codebase root cause analysis (e.g.
```
~/repos/frontend,~/repos/backend
```
).

```
$ARGUMENTS[0]
```
—（可选）起始日期，格式为
```
YYYY-MM-DD
```
，默认值为今日。
```
$ARGUMENTS[1]
```
—（可选）结束日期，格式为
```
YYYY-MM-DD
```
，默认值为今日。
```
$ARGUMENTS[2]
```
—（可选）用于代码库根因分析的本地仓库路径，多个路径用逗号分隔（例如
```
~/repos/frontend,~/repos/backend
```
）。

PIR Form Fields

PIR表单字段

Each PIR maps to these fields — see PIR Form Fields for format, examples, and output template:

Field	Required	Source
Impact Summary	Yes	Synthesised from all skills
What	Yes	PagerDuty incident + Datadog + Cloudflare
Who	Yes	Datadog (RUM/error tracking) + Cloudflare (user counts)
Culprit	Yes	Cloudflare (JA4, traffic sources) + Datadog (error traces) + PagerDuty (trigger details) + Codebase analysis (culprit commits)
Incident date	Yes	PagerDuty incident created timestamp
When	Yes	PagerDuty created/resolved + Datadog timeline
Remediation	Optional	PagerDuty notes + Datadog monitors
Incident controller	Optional	PagerDuty escalation policy responders

每个PIR对应以下字段——有关格式、示例和输出模板，请查看PIR表单字段：

字段	是否必填	数据来源
影响摘要	是	综合所有技能生成
事件内容	是	PagerDuty事件 + Datadog + Cloudflare
受影响用户	是	Datadog（RUM/错误追踪） + Cloudflare（用户数量）
根因	是	Cloudflare（JA4、流量来源） + Datadog（错误追踪） + PagerDuty（触发详情） + 代码库分析（问题提交记录）
事件日期	是	PagerDuty事件创建时间戳
时间线	是	PagerDuty创建/解决时间 + Datadog时间线
修复措施	可选	PagerDuty备注 + Datadog监控
事件负责人	可选	PagerDuty升级策略响应人

Severity Auto-Classification

严重程度自动分类

Determine severity from the collected data — do NOT ask the user:

Severity	Criteria
SEV1	Service outage or >50% error rate on critical path; cascading failures; >30 min duration
SEV2	Partial degradation; 10-50% error rate; single service affected; 10-30 min duration
SEV3	Minor impact; <10% error rate; brief spike (<10 min); limited user impact

Use the highest applicable severity when multiple criteria match.

根据收集到的数据判定严重程度——请勿询问用户：

严重程度	判定标准
SEV1	服务中断或关键路径错误率>50%；级联故障；持续时间>30分钟
SEV2	服务部分降级；错误率10-50%；仅单个服务受影响；持续时间10-30分钟
SEV3	影响轻微；错误率<10%；短暂峰值（<10分钟）；用户影响范围有限

当多个标准匹配时，适用最高级别的严重程度。

Execution

执行流程

Step 1: Gather Date Range

步骤1：收集日期范围

See step1-gather-date-range.md

查看step1-gather-date-range.md

Step 2: Discover Incidents from PagerDuty (Task subagent)

步骤2：从PagerDuty发现事件（任务子Agent）

See step2-discover-incidents.md — Runs

Skill("pagerduty-oncall")

via a Task subagent to isolate context.

查看step2-discover-incidents.md — 通过任务子Agent运行

Skill("pagerduty-oncall")

以隔离上下文。

Step 3: Enrich with Datadog and Cloudflare

步骤3：结合Datadog和Cloudflare丰富事件信息

Run 3a and 3b in parallel using Task subagents:

使用任务子Agent并行执行3a和3b：

3a. Datadog (Task subagent)

3a. Datadog（任务子Agent）

See step3a-enrich-datadog.md — Runs

Skill("datadog-analyser")

via a Task subagent.

查看step3a-enrich-datadog.md — 通过任务子Agent运行

Skill("datadog-analyser")

。

3b. Cloudflare (Task subagent)

3b. Cloudflare（任务子Agent）

See step3b-enrich-cloudflare.md — Runs

Skill("traffic-spikes-investigator")

via a Task subagent.

查看step3b-enrich-cloudflare.md — 通过任务子Agent运行

Skill("traffic-spikes-investigator")

。

Step 4: Codebase Analysis (Task subagent, conditional)

步骤4：代码库分析（任务子Agent，条件执行）

See step4-codebase-analysis.md — Only runs when

$ARGUMENTS[2]

(repos list) is provided. Investigates recent commits on

origin/main

to identify culprit code changes. Saves findings to

.codebase-analysis-tmp/report.md

查看step4-codebase-analysis.md — 仅当提供

$ARGUMENTS[2]

（仓库列表）时运行。调查

origin/main

分支的近期提交记录，识别导致问题的代码变更。将分析结果保存到

.codebase-analysis-tmp/report.md

。

Step 5: Synthesise PIR for Each Incident

步骤5：为每个事件生成PIR

See step5-synthesise-pir.md

查看step5-synthesise-pir.md

Step 6: Save and Present Results

步骤6：保存并展示结果

See step6-save-and-present.md

<tags> <mode>think</mode> <custom>yes</custom> </tags>

查看step6-save-and-present.md

<tags> <mode>think</mode> <custom>yes</custom> </tags>