ops-hygiene

🧹 智能代理周期性维护与安全审计

基于标准操作程序的智能代理维护方案,提供分层安全检查、密钥审计与系统健康监控,确保代理环境安全可靠。

收藏
3.1k
安装
1.2k
版本
v1.0.0
CLS 安全性认证2026-05-11
点击查看完整报告 >

使用说明

Ops Hygiene 是一套专为 AI Agent 设计的标准化运维维护程序,通过分层的维护机制确保代理环境的健康、安全与有序。该技能提供了从实时输入过滤到月度安全审计的完整维护体系,类似于为数字代理建立的"个人卫生习惯"。

核心用法围绕多时间维度的维护周期展开:在每次外部交互时通过 prompt-guard 过滤不可信输入;每次会话启动时加载记忆文件并检查密钥泄露;每30分钟执行一次"心跳"检查,包括邮件分类、Git状态监控、内存整理和资源检查;每日生成日志并扫描密钥;每周更新攻击模式数据库并检查依赖;每月执行全面安全审计和权限审查。配套的脚本工具(secret-scan.sh、security-audit.sh、heartbeat-dispatch.sh)实现了本地化的自动化检查,其中心跳调度器采用分层设计,优先使用本地LLM(The Reef API)进行邮件分类,仅在必要时才调用云端资源,有效控制成本。

显著优点体现在其系统化的安全思维和成本优化策略。技能内置了"三明治防御"等输入处理机制,提供从实时防护到定期审计的纵深防御体系。所有检查脚本均采用 set -euo pipefail 严格模式,确保执行可靠性。特别值得一提的是其智能的本地优先架构:heartbeat-dispatch.sh 能够利用本地 Ollama 和 Reef API 处理大部分任务,显著降低 token 消耗;同时支持安静时段(23:00-07:00)配置,避免夜间打扰。

潜在局限主要源于其 T3 级社区来源属性,虽代码质量达到 A 级标准,但在企业级合规场景中可能缺乏官方背书。此外,技能配置相对复杂,需要用户正确设置 .secrets 文件权限(建议 600)、维护 hygiene-state.json 状态跟踪,并确保本地 Python 和 Bash 环境完备。对于非技术用户,多层次的维护周期可能带来较高的学习成本。

适合目标群体包括长期自主运行的 AI Agent 系统、对数据隐私要求极高的个人开发者、以及需要定期安全审计的小型开发团队。特别适合那些采用"本地优先"架构、希望减少云端依赖同时保持系统健康的场景。

使用风险方面,尽管代码本身通过所有安全扫描,但用户需确保敏感文件权限配置正确,避免密钥文件被其他进程读取。脚本依赖本地服务(如 localhost:11434 的 Ollama),若服务未启动可能导致检查失败。此外,自动化维护虽便利,但过度依赖可能掩盖系统性问题,建议定期人工审查审计日志而非完全自动化处理。

安全解读

核心用法

ops-hygiene 是一套完整的代理环境运维卫生标准操作规程,通过多周期检查清单保障系统健康与安全。核心工作流包括:

实时防护:每次外部交互时通过 prompt-guard 过滤不可信输入,采用「三明治防御」策略包裹内容
会话启动:自动读取 SOUL.md、USER.md、MEMORY.md 及 HEARTBEAT.md 恢复上下文

心跳周期:每 30 分钟轮换执行邮件分类、Git 状态检查、内存整理、进程监控、资源健康检查

每日任务:创建日志、密钥扫描、审计日志审查、子代理清理、Git 提交

周/月维护:Prompt-guard 规则更新、依赖审计、凭证轮换、内存压缩、完整安全审计

关键脚本包括 secret-scan.sh(密钥泄露检测)、security-audit.sh(月度综合审计)、health-check.sh(系统体检)及 heartbeat-dispatch.sh(智能心跳调度器,支持本地 LLM 分流以降低 Token 成本)。

显著优点

1. 分层防御架构:从实时输入过滤到月度全面审计,覆盖 5 个时间维度的纵深防护
2. 成本优化设计:心跳调度器采用「本地优先」策略,常规检查零 LLM 调用,异常才上云

3. 零外部依赖:纯 Shell 实现,仅使用系统标准工具,无供应链攻击面

4. 状态持久化:通过 JSON 文件跟踪任务执行状态,避免重复工作

5. 安静时段感知:23:00-07:00 仅记录不告警,减少夜间干扰

局限性与风险

1. 密钥文件访问:需读取 .secrets 本地文件获取 API Key,依赖文件权限配置正确
2. 扫描模式覆盖不全:缺少 OpenRouter、Together AI 等新兴服务的密钥检测规则

3. 错误处理待完善:依赖命令缺失时的提示不够友好

4. 仅限本地服务:当前版本不直接支持云端 API 监控,需配合其他工具

适合人群

  • 长期运行的自主 AI 代理系统
  • 对安全合规有要求的自动化工作流
  • 需要定期「数字断舍离」的复杂 Agent 环境
  • 希望降低运维 Token 成本的团队

常规风险

  • RISK-001(低风险):secrets 文件读取需确保 600 权限,建议添加前置校验
  • RISK-002(提示级):密钥扫描规则需定期人工更新以覆盖新型服务

整体通过 S 级安全认证(95/100),适合生产环境部署。

ops-hygiene 内容

scripts文件夹
手动下载zip · 10.2 kB
health-check.shtext/x-shellscript
请选择文件