失败案例库 (Failure Case Studies)

每个案例都是从真实事故中抽象而来，用于教学和模式验证。

案例索引

案例	类型	影响	涉及模式
runaway-cron-tokens	资源失控	一夜烧掉 $47 API token	cron-job-pattern
silent-data-corruption	数据损坏	连续 3 天产出错误报告	maker-checker, checkpoint-pattern
concurrent-state-conflict	状态冲突	两个 agent 互相覆盖 STATE.md	state-file-pattern, multi-agent-isolation
prompt-injection-escalation	安全漏洞	从网页注入执行了未授权命令	secret-management, anti-patterns

使用方式

每个案例遵循统一结构：

场景描述 → 根因分析 → 事故日志 → 解决方案 → 关联模式

• 场景描述: 发生了什么，面向非技术人员也能理解
• 根因分析: 哪个 pattern 缺失导致了这个问题
• 事故日志: 脱敏后的关键日志片段（时间戳、token 用量、错误信息）
• 解决方案: 具体引用哪些 convention 文件来修复
• 关联模式: 到 conventions/ 的链接

如何贡献新案例

1. 从真实事故中提取，脱敏处理
2. 确保能映射到至少一个 existing convention
3. 提交 PR，标题格式: [failure] <案例名>