Safety Checks

🛡️ AI Agent 运行时安全验证套件

AI Agent 运行时安全验证套件,支持模型版本锁定、降级链路检查、缓存新鲜度检测与会话状态隔离验证,防止静默降级与状态污染

收藏
3.2k
安装
1.4k
版本
1.0.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

safety-checks 是一套面向 AI Agent 的运行时安全验证技能,通过 /sc 命令及其子命令实现四大核心功能:

  • 模型锁定检查/sc model):验证当前调用的 LLM 版本是否符合预期配置,防止模型漂移导致的不可复现行为
  • 降级链路验证/sc fallback):检查 API、模型、存储等三层降级链路的可用性,确保故障时可平滑切换
  • 缓存新鲜度检测/sc cache):识别超 TTL 的缓存条目,避免使用过期数据
  • 会话隔离检查/sc session):检测跨会话状态泄漏(全局变量、文件锁、临时文件、环境变量污染)

显著优点

1. 运行时验证优于静态配置:传统静态规则无法捕捉系统状态漂移,该技能在 HEARTBEAT 或事前触发时主动探测实际运行状态
2. 四层安全纵深:从模型层到会话层的完整覆盖,形成防御纵深

3. Claude Code 兼容:支持 .claude/settings.json 等配置路径,降低迁移成本

4. 无外部依赖:检查逻辑完全在 Agent 信任边界内执行,不调用第三方安全服务

潜在缺点与局限性

  • 依赖约束引擎:完整的安全策略强制执行需要额外安装 leegitw/constraint-engine
  • 云模型限制:若使用 Claude/GPT 等云端模型,数据仍需经云服务商处理,技能本身无法解决此信任边界问题
  • 被动检测:仅能发现问题并告警,自动修复(如 --clear)仍需显式授权
  • 版本格式绑定:模型版本格式要求 {provider}-{model}-{version}-{date},非标准命名可能无法识别

适合人群

  • 运行多 Agent 生产环境且需行为一致性的团队
  • 对缓存策略和降级方案有合规要求的金融/医疗 AI 应用
  • 使用 Claude Code 或 OpenClaw 框架的开发者

常规风险

| 风险类型 | 说明 |
|---------|------|
| 配置漂移 | 默认配置可能随框架更新变化,需锁定 `.openclaw/safety-checks.yaml` 版本 |
| 误报干扰 | 严格的 TTL 设置可能导致频繁缓存清理,影响性能 |
| 会话清理副作用 | `/sc session --clear-state` 可能误删其他进程依赖的临时文件 |
| 降级测试风险 | `--test` 参数实际触发降级路径,可能对线上流量产生影响 |

Safety Checks 内容

手动下载zip · 4.6 kB
SKILL.mdtext/markdown
请选择文件