failure-md/spec
GitHub: failure-md/spec
AI 智能体故障模式定义与处理协议规范,通过 Markdown 文件标准化记录四类故障模式、检测方法、健康检查与响应流程,确保无静默错误发生。
Stars: 0 | Forks: 0
# FAILURE.md
**AI 智能体的故障模式定义与处理协议 —— 定义所有错误状态与响应。**
FAILURE.md 是一个纯文本 Markdown 文件,您可以将其放置在任何 AI 智能体项目的根目录下。它定义了四种故障模式(优雅降级、部分故障、级联故障、静默故障),包含检测方法和针对每种模式的响应程序、健康检查配置、心跳监控、错误模式匹配、通用恢复步骤以及审计日志 —— 从而确保没有故障模式未被处理,且静默错误不可能发生。
- 完整规范:[failure.md](https://failure.md)
- AI 可读:[llms.txt](https://failure.md/llms.txt)
- 许可证:MIT
## 快速开始
将 [`FAILURE.md`](./FAILURE.md) 复制到您的项目根目录:
```
your-project/
├── AGENTS.md
├── CLAUDE.md
├── FAILURE.md ← add this
├── README.md
└── src/
```
## AI 智能体安全栈
FAILURE.md 是用于 AI 智能体安全性、质量和问责制的十二文件开放标准的一部分:
### 运营控制
| Spec | Purpose | Repo | Site |
|------|---------|------|------|
| THROTTLE.md | 速率与成本控制 —— 在达到限制前减速 | [throttle-md/spec](https://github.com/throttle-md/spec) | [throttle.md](https://throttle.md) |
| ESCALATE.md | 人工通知与审批协议 | [escalate-md/spec](https://github.com/escalate-md/spec) | [escalate.md](https://escalate.md) |
| FAILSAFE.md | 安全回退至最后已知良好状态 | [failsafe-md/spec](https://github.com/failsafe-md/spec) | [failsafe.md](https://failsafe.md) |
| KILLSWITCH.md | 紧急停止 —— 终止所有智能体活动 | [killswitch-md/spec](https://github.com/killswitch-md/spec) | [killswitch.md](https://killswitch.md) |
| TERMINATE.md | 永久关闭 —— 未经人工干预不得重启 | [terminate-md/spec](https://github.com/terminate-md/spec) | [terminate.md](https://terminate.md) |
### 数据安全
| Spec | Purpose | Repo | Site |
|------|---------|------|------|
| ENCRYPT.md | 数据分类与保护要求 | [encrypt-md/spec](https://github.com/encrypt-md/spec) | [encrypt.md](https://encrypt.md) |
| ENCRYPTION.md | 技术加密标准与密钥轮换 | [encryption-md/spec](https://github.com/encryption-md/spec) | [encryption.md](https://encryption.md) |
### 输出质量
| Spec | Purpose | Repo | Site |
|------|---------|------|------|
| SYCOPHANCY.md | 反盲目附和 —— 要求引用来源,强制执行诚实异议 | [sycophancy-md/spec](https://github.com/sycophancy-md/spec) | [sycophancy.md](https://sycophancy.md) |
| COMPRESSION.md | 上下文压缩 —— 安全地总结,验证一致性 | [compression-md/spec](https://github.com/compression-md/spec) | [compression.md](https://compression.md) |
| COLLAPSE.md | 漂移预防 —— 检测崩溃,强制执行恢复 | [collapse-md/spec](https://github.com/collapse-md/spec) | [collapse.md](https://collapse.md) |
### 问责制
| Spec | Purpose | Repo | Site |
|------|---------|------|------|
| **FAILURE.md** | **故障模式映射 —— 每一个错误状态与响应** | **[failure-md/spec](https://github.com/failure-md/spec)** | **[failure.md](https://failure.md)** |
| LEADERBOARD.md | 智能体基准测试 —— 追踪质量,检测回归 | [leaderboard-md/spec](https://github.com/leaderboard-md/spec) | [leaderboard.md](https://leaderboard.md) |
## 为什么存在此规范
AI 智能体会消耗资金、发送消息、修改文件并调用外部 API —— 且通常是自主进行的。监管法规正在跟上步伐:
- **EU AI Act**(2026 年 8 月)—— 强制要求人工监督和关停能力
- **Colorado AI Act**(2026 年 6 月)—— 要求进行影响评估和透明度披露
- **美国各州法律** —— 加利福尼亚州、德克萨斯州、伊利诺伊州及其他州已有活跃的 AI 治理要求
这些规范为您智能体的安全边界提供了标准化、可审计的记录。
## 贡献
欢迎提交 PR 以增加额外的检测模式、特定语言的解析器和集成指南。
## 许可证
MIT —— 详情见 [LICENSE](LICENSE)。
## 免责声明
本规范按“原样”提供,不附带任何形式的保证。它不构成任何司法管辖区的法律、监管或合规建议。使用本规范并不保证符合任何适用法律、法规或标准 —— 包括 EU AI Act (2024/1689)、Colorado AI Act (SB 24-205) 或任何其他立法。组织应咨询合格的专业人士以确定其监管义务。作者对因使用本规范而产生的任何损失或后果不承担任何责任。
标签:AI Safety, CSP, LLM, Markdown, Unmanaged PE, 人工智能代理, 优雅降级, 健康检查, 分布式计算, 协议规范, 后端开发, 子域名变形, 安全标准, 审计日志, 容错机制, 开源标准, 异常处理, 心跳检测, 故障模式, 系统可靠性, 级联故障, 运维监控, 配置错误, 防御加固, 静默错误