hermes

Hermes

使用时机

将此技能用于 Hermes Agent 的自托管和日常运维：安装、设置、模型／提供商选择、网关平台、Slack 频道设置、命令查询、更新、插件、工具、技能、记忆、配置档案、MCP、cron、Kanban、delegate_task 子 Agent、日志、仪表板、教程和长时间运行的 tmux 会话。

不要依赖过时的记忆命令。Hermes 更新很快。每次处理 Hermes 任务时，都要相对于此技能目录解析 scripts/hermes_check.py，并运行：

python3 <skill-dir>/scripts/hermes_check.py --json

如果命令行为很重要，还要刷新生成的本地命令快照：

python3 <skill-dir>/scripts/hermes_check.py --write-help <skill-dir>/references/command-map.generated.md

更改配置前，先报告是否有可用更新。未经用户明确批准，不要运行 hermes update，除非用户已要求更新。

决策流程

1. 使用 scripts/hermes_check.py 验证本地状态。
2. 使用 hermes --help 和 hermes <command> --help 作为可执行命令的事实依据。
3. 只加载所需的参考文件：
   • references/setup-and-update.md：安装、版本管理、更新、配置健康检查、备份和安全更新策略。
   • references/getting-started-tutorials.md：首次运行设置、自托管方式、引导式使用流程和面向用户的教程。
   • references/command-catalog.md：命令类别和常见 CLI 模式。
   • references/official-links.md：官方文档、发布信息、参考资料和故障排除链接。
   • references/slack-gateway.md：Slack 应用、频道、Socket Mode、清单、网关和允许列表设置。
   • references/operations-runbook.md：tmux 会话、单次执行、配置档案、cron、webhook、记忆、技能和自主性防护措施。
   • references/kanban-operations.md：持久任务看板、配置档案工作器、依赖关系、隔离工作区、任务分发和任务通知。
   • references/delegation-vs-kanban.md：delegate_task、子 Agent 委派，以及如何在委派、Kanban、tmux、cron 和后台终端任务之间进行选择。
   • references/slash-commands.md：会话内的 /... 命令、网关斜杠命令，以及优先使用 CLI 命令的时机。
   • references/providers-tools-security.md：密钥路径、配置区段、提供商、工具集、审批模式、脱敏和隐私。
   • references/plugins-and-tools.md：用户／运维人员的插件安装、工具启用、MCP 连接和安全验证。
   • references/voice-and-media.md：STT、TTS、语音模式、图像输入和媒体相关故障排除。
   • references/self-improvement.md：发现 Hermes 行为变化、命令变更或运维经验后，如何更新此技能。
   • references/troubleshooting.md：日志、Slack 故障、令牌问题、过时技能、网关问题和社区已知问题。
   • 仅在需要精确的本地帮助输出时使用 references/command-map.generated.md。
4. 对于交互式 Hermes 或 tmux 操作，发送按键前先读取当前窗格内容。说明提示信息，并在发送输入前建议选择。
5. 检查时优先使用确定性命令和脚本。将非确定性指导保留在参考文档或 Hermes 对话中。
6. 每项 Hermes 任务结束时，运行 references/self-improvement.md 中的自我改进检查。

常见请求路由

• “安装 Hermes”或“自托管 Hermes” -> getting-started-tutorials.md、setup-and-update.md，然后是 official-links.md。
• “设置 Slack 频道” -> slack-gateway.md，运行 scripts/hermes_slack_check.py，然后查看 troubleshooting.md。
• “检查我的 Hermes 是否运行正常” -> 运行 scripts/hermes_ops_check.py，然后查看 setup-and-update.md。
• “启用插件/工具/MCP 服务” -> plugins-and-tools.md、providers-tools-security.md。
• “教我如何使用 Hermes” -> getting-started-tutorials.md、slash-commands.md、command-catalog.md。
• “使用 Kanban”、“派发工作者”或“协调配置档案” -> kanban-operations.md、operations-runbook.md。
• “使用 delegate_task”、“委派此任务”、“启动子 Agent”或“并行子任务” -> delegation-vs-kanban.md；如果工作必须持久化、对人可见、可重启或分配给指定配置档案，则改用 Kanban。

当前 CLI 基线

截至 Hermes Agent v0.12.0，优先使用：

hermes
hermes chat -q "single query"
hermes -z "script-friendly one-shot"
hermes setup
hermes model
hermes doctor
hermes config check
hermes update --check
hermes gateway setup
hermes gateway status
hermes slack manifest

避免使用基于旧版第三方示例的 hermes run；当前 Hermes 在 v0.12.0 中没有将 run 作为根命令提供。

安全规则

• 将 ~/.hermes/.env、Slack 令牌、OAuth 令牌和 ~/.hermes/auth.json 视为机密。切勿打印完整令牌值。
• 启用 Slack 或其他网关前，先设置或验证允许列表。
• 决定是否更新前，使用 hermes update --check；进行高风险更改时，使用 hermes backup 或更新备份标志。
• 对于自动化，先从只读/报告工作流开始，添加验证步骤，然后仅在多次手动运行成功后，才通过 cron/webhooks 进行调度。
• 对于需要长期保留的 Hermes 行为，优先使用文件而非聊天：config.yaml、.env、SOUL.md、AGENTS.md、技能和运行手册。