Agent sentinel

Agent Sentinel：让 AI Agent 跑得更稳、装得更安心、协作更专业的本地保障层。诊断环境、网络与资源；安装前审查第三方 Skill 的恶意或高风险信号；崩溃或上下文中断后提供本地恢复简报。

Install

npx -y skills add hangzhouxiaozhu/agent-sentinel

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

面向 AI Agent 新手的本地护航 skill：定位并帮助恢复环境、网络和系统资源问题；在宿主接入安装前策略时审计第三方 skill 风险；在崩溃或上下文中断后基于显式本地摘要生成恢复简报；将短而模糊的用户反馈补全为清晰、专业、可执行的工作指令。用于 macOS、Linux 和 Windows。

SKILL.md

4.8 KB, as published. Nobody here has run it

Agent Sentinel

将 Sentinel 作为 AI Agent 的“新手保障层”：帮助用户恢复工作、提升协作质量，不制造焦虑，也不隐式修改系统。Hermes 使用完整适配器；其他宿主按其公开生命周期接口接入。

工作原则

按以下顺序处理问题：

只读诊断问题。
仅对低风险、可逆的 Sentinel 自身操作自动修复，例如清理 Sentinel 过期日志。
修复后验证结果；不要把“建议”或“请求 Hermes 执行”说成已经完成。
需要用户操作时，用不超过两句的人话给出唯一下一步。
没有需要用户处理的事项时保持静默。

不要自动更改 DNS、代理、防火墙、系统权限、用户文件或计划任务。安装和计划任务由 install.sh 或 install.ps1 显式执行。

定时巡检

每 10 分钟执行 guardian_tick()：

检查内存、CPU、磁盘和 GPU。磁盘接近满时只清理 Sentinel 自己超过保留期的日志；内存危险时保存诊断快照，并请求 Hermes 压缩上下文。
检查本地网关、DNS、代理和用户实际配置的服务连通性。先重试，再以明确的下一步请求用户协助。
检查 skill 完整性和 Sentinel 日志可写性。

崩溃与上下文恢复

当用户说“崩了”“闪退”“上下文丢了”或“失忆了”时，先恢复原会话或查看宿主错误；不要猜测已经丢失的上下文。

宿主只可通过 save_recovery_checkpoint() 保存自己显式提供的短摘要、待办和产物；不要自动复制完整对话或读取 session transcript。
重启、崩溃或上下文重置后，调用 get_recovery_plan() 取得恢复简报，并先确认当前文件、环境和用户目标仍然有效。
没有检查点时，请用户补充当前目标、已完成步骤和待办；不要虚构历史。
OpenClaw 优先使用其持久化 session、compaction、memory flush 与重启恢复。详见 references/openclaw-recovery.md。

模糊意图补全

在处理用户消息前调用 guardian_before_user_message()。保留用户原话，并附加解释性上下文；不要把不确定的猜测当作事实。

高置信度：补全为可执行的最小操作，如“太暗”“乱码”。
低置信度：提出一个最小澄清问题，如“你说的是图片、页面还是文档？”

审美偏好记忆

只在用户明确表达偏好时记录，例如“我喜欢留白多一点”“以后默认简洁”“不要渐变”。偏好只保存在本机，并且只能作为辅助约束：当前任务的明确要求始终优先。

对视觉结果优先检查目的、层级、可读性、一致性和留白；避免无目的装饰和一次改动太多事情。
不要从浏览记录、对话历史或一次性评价推断长期画像。
用户说“忘记我的偏好”或“清除我的偏好”时立即清除本地记录。

安装前安全筛查

Hermes 主循环可在安装 skill 前调用 guardian_on_skill_install(skill_path)。筛查结果是风险证据，不是“绝对安全”的保证：

发现确定性的破坏命令或硬编码密钥时阻止安装。
对网络访问、动态执行和环境变量访问给出可解释的风险提示。
不要仅凭来源名称放行高风险行为。

日志与隐私

日志保存在 ~/.hermes/logs/，只记录硬件、网络、健康和审计诊断；不得记录对话内容、API 请求体、密钥或用户文件内容。

安装

手动安装后，用户可选择执行：

bash install.sh

或在 Windows PowerShell 中执行：

.\install.ps1

这两个脚本会明确创建 Sentinel 所需的目录和定时任务。模块导入与巡检本身不执行安装或系统配置变更。

可移植核心

将 scripts/sentinel_core.py 和 scripts/adapters/generic.py 用作非 Hermes 宿主的接入点。宿主只需将“用户消息前”“定时诊断”“安装第三方 skill 前”映射到对应方法，并在启动前通过 SENTINEL_HOME 指定自己的本地状态目录。不要假设其他 AI 平台拥有 Hermes 的 hook；为每个平台实现适配器前，先确认其公开且稳定的生命周期 API。