# 坑（事故）条目
编号 G-____　日期：____________　状态：□已解决 □部分解决 □已知债
关联模块：____________　严重程度：□轻 □中 □重（业务中断 / 数据丢失 / 仅影响体验）

> 四条铁律：
> 1. 「现象」要写线上当时的样子（报什么错、几个进程、多少字节），不写"有问题"
> 2. 「根因」要落到机制层，不写"因为没注意"
> 3. 「对策」要能一步一步照着做，不写"重新部署"
> 4. 「预防」必须落成至少一个可执行动作（写进脚本 / 红线 / skill / 验收清单）

## 1. 现象（越具体越好；拿不到具体的，说明你当时没盯日志，这就是下次要装的监控）

- 发生时间：____________　持续：____________
- 用户看到什么：____________
- 服务端日志关键行：____________
- 当时的量化状态：进程数 ____ / 内存 ____ MB / 请求成功率 ____% / 数据行数 ____

## 2. 根因（机制层，回答"为什么会发生"）

- 直接原因：____________
- 表层原因：____________
- 根本原因（为什么系统允许它发生）：____________
- 当时为什么没被发现：____________（监控缺什么 / 谁该看没看）

## 3. 对策（当时怎么救，可执行步骤）

1. ____________
2. ____________
3. ____________
恢复耗时：____ 分钟　是否有数据丢失：□无 □少量 ____ 条 □大量 ____ 条
（数据量写不出来 = 备份没演练过）

## 4. 预防（必须落地成一个动作，不能只写"下次注意"）

勾选至少一个 + 写明具体动作：
- [ ] 写进部署/运维 skill：____________
- [ ] 写进校验脚本（会自动报错）：____________
- [ ] 写进红线条款：____________
- [ ] 写进验收清单：____________
- [ ] 补监控/告警：____________
- [ ] 补测试（把这次事故写成断言）：____________
- [ ] 只写文档不做事：□（如果勾了这个，等于没预防）

## 5. 关联

- 涉及模块 / 系统：____________
- 关联知识库条目：____________（如 16-database / 19-read-ai-code）
- 同类坑（之前也踩过）：____________
- 是不是 AI 生成的产物：□是（那还要过一遍四步验收法）□否

## 6. 30 天后复盘（到点提醒自己）

- 这个坑复发了吗？□是（说明预防没生效，或预防动作没被执行）□否
- 预防动作变成日常流程了吗？□是 □否，卡在哪：____________
- 这条最终是怎么根治的（如果有）：____________
- 一句话总结给下一个人：____________

---
## 已收录的同类条目索引（避免重复踩）
| 编号 | 一句话现象 | 已解决 | 预防动作落在哪 |
|------|-----------|-------|--------------|
| G-01 | PM2 雪崩，孤儿进程 PPID=1 占端口 | 是 | 启动必带 --save |
| G-06 | 证书过期，https 000 / 301 死链 | 是 | 到期前 7 天巡检 |
| G-12 | JSON blob 写坏，整库读不出来 | 否（设计债） | 热点数据不塞 blob |
| G-15 | SPA 84 URL 只返 3120 字节空壳 | 是 | 预渲染静态正文块 |
| G-17 | 空字段被默认值填平，算出精确错价 | 部分 | 「算不了」是合法输出 |
| G-21 | subagent 写错目录，4 篇文档作废 | 是 | prompt 强制绝对路径 |