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, 人工智能代理, 优雅降级, 健康检查, 分布式计算, 协议规范, 后端开发, 子域名变形, 安全标准, 审计日志, 容错机制, 开源标准, 异常处理, 心跳检测, 故障模式, 系统可靠性, 级联故障, 运维监控, 配置错误, 防御加固, 静默错误