Audit Hermes Agent Skills

审计 Hermes Agent 已安装技能的使用频率，识别长期不使用的技能并安全清理。

通过 hermes 内部 API（_find_all_skills、_read_manifest、HubLockFile）获取权威的技能来源分类（hub/builtin/local/external），结合文件系统扫描定位实际目录路径。

使用方式

所有命令使用 uv 运行（自动管理依赖）：

第一步：生成审计 XLSX

uv run ~/.hermes/skills/audit-hermes-agent-skills/scripts/audit.py

打印简单概览后生成 技能审计报告.xlsx 到当前目录。

第二步：在 Excel 中填写决策

打开 技能审计报告.xlsx，通过「我的决策」列的下拉框标记每个技能：

技能来源	下拉选项	默认值
内置技能	启用 / 禁用	当前状态
其他技能	保留 / 删除	保留

颜色标记：🟢绿色=在用，🔴粉色=建议删除，🟠橙色=建议禁用，⚪灰色=已禁用。

第三步：执行清理

uv run ~/.hermes/skills/audit-hermes-agent-skills/scripts/audit.py --apply

先打印变更摘要（删除/禁用/启用各多少），用户确认 y 后自动执行：

• 备份 config.yaml
• 备份要删除的技能目录到 ~/.hermes/skills/.audit-backups/ 并删除
• 更新 config.yaml 的 skills.disabled 列表（合并新增和移除）

核心原理

技能调用记录存储在 ~/.hermes/state.db 的 messages.tool_calls 字段中。通过解析 skill_view 和 skill_manage 工具调用，统计每个技能的调用历史。

脚本通过 三种数据源 确定技能属性和健康度：

数据源	用途	优先级
Hermes 内部 API（_find_all_skills、_read_manifest、HubLockFile）	基础来源分类：builtin / hub / local / external	主分类
Hermes Curator（hermes curator status + run.json）	交叉验证来源分类，补充 Curator 活跃度指标（activity/use/view/patches）和 consolidation/archive 关系	权威覆盖（高于 API）
文件系统扫描 + state.db tool_calls 解析	定位物理目录路径、统计调用频次	基础覆盖

Hermes Curator 集成点：

• 来源分类权责：如果 Curator 认定某技能为 agent-created，覆盖 API 返回的 local 分类（agent-created 是 local 的真子集）
• Consolidation 感知：从 Curator 的 run.json 读取技能合并关系（如 dida365-openapi → platform-integration），告知用户该技能已被 umbrella 替代
• 归档感知：curator 归档的技能在建议中标记为「已归档」，防止用户重新启用
• 活跃度指标：activity = 总操作次数，use = skill_view 调用，patches = 修改次数，last_activity = 最近活动

来源分类映射：

来源	识别方式	含义	清理方式
builtin	Hermes .bundled_manifest	Hermes 内置技能	添加到 config.yaml disabled 列表
skills.sh	~/.agents/.skill-lock.json	通过 skills.sh 安装的社区技能	bunx skills add / hermes skills uninstall
skillhub	~/.hermes/skills/.hub/lock.json	通过 SkillHub 安装的技能	skillhub remove
agent-created	Curator agent-created 列表	Agent 在用户监督下创建的技能（首次方）	直接删除目录（先备份），低优先级清理
local	不在以上任何来源	其他本地安装的技能	直接删除目录（先备份）
external	~/.agents/skills/ 路径	外部共享技能，影响所有 Agent	删除需谨慎，确认不影响其他 Agent

备份恢复

# 查看备份
ls -la ~/.hermes/skills/.audit-backups/

# 恢复单个技能
tar -xzf ~/.hermes/skills/.audit-backups/cleanup-<timestamp>/<skill-name>.tar.gz -C ~/.hermes/skills/

注意事项

• --apply 必须用户输入 y 确认，不会自动执行
• 执行前自动备份 config.yaml 和目标技能目录
• config.yaml 修改会合并现有 disabled 列表而非覆盖
• 已禁用的零调用技能不会重复建议