Hermes、Obsidian 与 OpenCode 常用配置

本文记录本机常用的 Hermes Agent、Obsidian、OpenCode 工作流，以及相关的 Skill、MCP 和 Agent。文中不记录 API Key 等敏感信息。

说明：原需求中的 “SCP” 按上下文理解为 MCP（Model Context Protocol）。

一、整体关系

组件	定位	常用场景
Hermes Agent	主 AI 助手与任务编排器	文件操作、搜索、浏览器、记忆、Skill、MCP、子 Agent、定时任务
Obsidian	Markdown 知识库	阅读、搜索、创建和维护笔记；使用 `[[双向链接]]` 组织知识
OpenCode	自主编码 Agent	实现功能、重构、调试、代码审查、并行开发
Skill	可复用操作流程与领域知识	告诉 Agent “遇到某类任务时应如何做”
MCP	外部工具服务协议	为 Agent 提供 Web 搜索、文档检索、代码搜索、LSP 等工具
Agent	执行任务的智能体角色	主 Agent 规划、子 Agent 搜索/评审/执行

推荐协作方式：

text

Obsidian/Markdown 笔记保存知识
        ↓
Hermes 读取 Skill 和笔记，负责总体编排
        ↓
OpenCode 执行较重的编码、重构和代码审查
        ↓
MCP 提供搜索、文档、代码索引与 LSP 能力

二、Hermes Agent

当前环境

版本：Hermes Agent v0.18.2 (2026.7.7.2)
安装目录：D:\software\hermesHermes Agent CN Desktop\data\versions\0.18.2-cn.2
CLI：D:\software\hermesHermes Agent CN Desktop\data\desktop-bin\hermes.bat
Hermes Home：D:\software\hermesHermes Agent CN Desktop\data\hermes-home
当前模型：gpt-5.6-sol
Provider：custom:172-16-3-6-8589
Gateway：已运行
已配置平台：Weixin

PowerShell 中 Hermes CLI 不在系统 PATH，应使用完整路径：

powershell

& "D:\software\hermesHermes Agent CN Desktop\data\desktop-bin\hermes.bat" --version

可选：为当前 PowerShell 会话定义别名函数：

powershell

function hermes {
    & "D:\software\hermesHermes Agent CN Desktop\data\desktop-bin\hermes.bat" @args
}

常用命令

powershell

# 启动/单次提问
hermes
hermes chat -q "检查当前项目并给出改进建议"

# 状态与诊断
hermes status --all
hermes doctor
hermes config
hermes config path

# 模型与配置
hermes model
hermes setup
hermes config set section.key value

# 工具与 Skill
hermes tools list
hermes tools
hermes skills list
hermes skills search <关键词>
hermes skills inspect <skill-id>
hermes skills install <skill-id>

# MCP
hermes mcp list
hermes mcp test <name>
hermes mcp add <name> --url <URL>
hermes mcp remove <name>

# 会话
hermes sessions list
hermes sessions browse
hermes sessions stats

# Profile
hermes profile list
hermes profile show <name>

# Gateway
hermes gateway status
hermes gateway restart

会话内常用命令

命令	用途
`/help`	查看当前版本支持的命令
`/new` 或 `/reset`	新建会话；工具与 Skill 配置变更后通常需要执行
`/model`	查看或切换模型
`/skills`	搜索、安装和管理 Skill
`/skill <name>`	显式加载 Skill
`/tools`	管理工具
`/reload-skills`	重新扫描 Skill
`/reload-mcp`	重新加载 MCP
`/agents`	查看子 Agent 与后台任务
`/usage`	查看上下文和 Token 使用情况
`/compress`	压缩当前会话上下文
`/stop`	停止后台任务

常用 Hermes Skill

截至 2026-07-15，Hermes CLI 报告共启用 64 个 Skill（62 builtin + 2 local）。完整分层清单和维护建议见 Hermes Skills 清单与维护。日常与 Hermes、Obsidian、OpenCode 最相关的是：

Skill	用途	典型触发场景
`hermes-agent`	Hermes 配置、工具、Profile、Gateway、MCP、故障排查	“配置 Hermes”“检查 Hermes 状态”
`obsidian`	文件系统方式管理 Obsidian 笔记	“创建笔记”“搜索我的知识库”
`opencode`	让 Hermes 调度 OpenCode 编码	“用 OpenCode 实现/重构/审查”
`claude-code`	调度 Claude Code	需要 Claude Code 处理代码任务
`codex`	调度 Codex CLI	需要 Codex 处理代码任务
`plan`	为复杂开发任务生成可执行计划	多步骤功能开发前
`systematic-debugging`	系统化定位根因	Bug、测试失败、行为异常
`test-driven-development`	测试驱动开发	要求先写测试再实现
`requesting-code-review`	提交前代码审查	改动完成、准备提交前
`simplify-code`	并行清理和简化代码	功能完成后的重构整理
`github-code-review`	GitHub PR 审查	审查 PR、提交评论
`github-pr-workflow`	PR 生命周期管理	分支、提交、开 PR、CI、合并
`computer-use`	桌面 GUI 操作	必须点击桌面应用时
`fund-portfolio-analysis`	本地基金分析 SOP	基金分析相关任务

常用加载方式：

text

/skill hermes-agent
/skill obsidian
/skill opencode

或启动时预加载：

powershell

hermes --skills hermes-agent,obsidian,opencode

Hermes MCP

当前 Hermes 已启用：

MCP	状态	用途
`exa-websearch`	enabled	Exa Web 搜索

检查与测试：

powershell

hermes mcp list
hermes mcp test exa-websearch

Hermes Agent/子 Agent 使用方式

Hermes 有三种常见任务执行层级：

当前主 Agent：负责理解需求、调用工具、验证结果。
delegate_task 子 Agent：适合独立研究、代码审查和并行子任务；父会话结束后不保证继续运行。
独立 Hermes 进程：适合长任务或完全隔离的任务，可用 hermes chat -q 或独立 Profile。

经验选择：

简单任务：当前 Agent 直接做。
多个互不依赖的研究任务：并行子 Agent。
长时间、需完整工具权限的任务：独立 Hermes 进程。
多个 Agent 同时改代码：使用独立 Git worktree，避免冲突。

三、Obsidian

笔记库与当前仓库

当前技术笔记仓库：

text

D:\data\docs

所有正文位于：

text

D:\data\docs\docs

这是一个 VitePress 文档站点，也可以直接作为 Obsidian Vault 使用。当前笔记规范：

文件名使用 kebab-case。
Frontmatter 通常只写 title:，长文可加 outline: deep。
正文以中文为主，技术术语保留英文。
每个主题目录使用 index.md 作为目录页。
Obsidian 内部关联优先使用 [[笔记名]]；VitePress 导航链接使用相对 Markdown 链接。

Obsidian Skill 的工作方式

obsidian Skill 采用 filesystem-first 工作流：

先确定 Vault 的绝对路径。
用文件搜索工具查找笔记。
用文件读取工具读取 Markdown。
用定点 patch 修改已有笔记。
用完整文件写入创建新笔记。

Hermes 默认通过 OBSIDIAN_VAULT_PATH 获取 Vault 路径；若未设置，则尝试 ~/Documents/Obsidian Vault。本仓库建议显式配置为：

text

D:\data\docs

常用笔记请求

text

在 Obsidian 中搜索包含 “MCP” 的笔记。
在 docs/ai 下创建一篇 OpenCode 使用笔记，并更新目录页。
把这次排错过程追加到相关笔记，保留已有内容。
为 Hermes、OpenCode 和 Agent 笔记添加双向链接。
检查新笔记的 VitePress 构建是否通过。

Obsidian 常用插件记录

Editing Toolbar
Obsidian Git
Omnivore
Tag Wrangler
VSCode Editor
ePub Reader
Remotely Save
ITS Theme

四、OpenCode

当前环境

OpenCode 版本：1.17.18
配置目录：C:\Users\GhostCloud\.config\opencode
主配置：C:\Users\GhostCloud\.config\opencode\opencode.json
默认模型：ghostcloud/GLM-5.2
OpenAI-compatible endpoint：http://172.16.3.6:8589/v1
插件：oh-my-openagent
自动更新：已开启

API Key 存放于本地配置/secret 文件中，不应复制到笔记、Git 或聊天记录。

常用命令

powershell

# 版本与认证
opencode --version
opencode auth list

# 启动交互式 TUI
opencode

# 单次任务
opencode run "检查测试失败原因并修复"
opencode run "审查当前改动，列出高风险问题" --thinking

# 指定 Agent 或模型
opencode run "为该功能制定计划" --agent plan
opencode run "重构认证模块" --model ghostcloud/GLM-5.2

# 附加上下文文件
opencode run "审查配置安全性" -f opencode.json -f package.json

# 会话
opencode session list
opencode -c
opencode -s <session-id>

# MCP 与统计
opencode mcp list
opencode stats

交互式 TUI 应通过 Ctrl+C 退出；不要输入 /exit，因为它不是 OpenCode 的退出命令。

Hermes 调度 OpenCode

一次性编码任务优先使用：

powershell

opencode run "实现需求、运行测试，并报告修改文件"

交互式长任务应由 Hermes 以后台 PTY 启动，然后通过进程工具提交后续指令和查看日志。并行开发时，每个 OpenCode 会话应使用不同的 worktree/工作目录。

任务完成后的验证标准：

确认实际修改了哪些文件。
查看 Git diff。
运行测试或构建。
报告真实输出与剩余风险。

OpenCode Skill

当前用户级 Skill：

Skill	路径	用途
`powershell-reliable`	`C:\Users\GhostCloud\.config\opencode\skills\powershell-reliable\SKILL.md`	PowerShell 5.1/7、CMD、Windows 管理与自动化

它还包含 PowerShell/CMD、Registry、Services、Networking、WMI/CIM、Active Directory 等参考资料和校验脚本。

OpenCode MCP

当前 MCP 状态：

MCP	状态	用途
`websearch`	connected	Exa Web 搜索
`context7`	connected	查询最新库/框架文档
`grep_app`	connected	搜索公开代码库中的真实代码用例
`lsp`	connected	代码符号、定义、引用和诊断
`codegraph`	disabled	代码图谱服务，当前未启用

检查命令：

powershell

opencode mcp list

OpenCode Agent

安装 oh-my-openagent 后，当前常见 Agent 如下。

主 Agent

Agent	定位	建议用途
`Sisyphus`	ultraworker，默认主执行者	复杂开发、综合任务
`Prometheus`	Plan Builder	需求澄清与制定计划
`Atlas`	Plan Executor	按既定计划执行实现

子 Agent

Agent	定位	建议用途
`explore`	代码库探索	查文件、符号、调用关系，只读分析
`librarian`	外部资料与代码示例检索	官方文档、开源用例、最佳实践
`oracle`	高级分析顾问	架构、疑难 Bug、复杂权衡
`Metis`	计划顾问	发现计划中的遗漏和隐含假设
`Momus`	计划批评者	严格审查计划质量
`Sisyphus-Junior`	子任务执行者	被主 Agent 委派的具体实现任务
`multimodal-looker`	多模态查看	图片、截图等视觉材料分析
`build`	构建型子 Agent	实施具体代码任务
`plan`	规划型子 Agent	生成项目计划
`general`	通用子 Agent	非专项任务

系统 Agent

compaction、summary、title 等主要用于上下文压缩、摘要和会话标题，通常无需手动选择。

Agent 选择建议

text

先了解陌生项目            → explore
查官方 API/框架文档        → librarian + context7
制定复杂开发计划           → Prometheus
审查计划是否遗漏风险       → Metis / Momus
执行已确认的计划           → Atlas
直接完成复杂编码任务       → Sisyphus
疑难架构或深层 Bug         → oracle

五、常用组合工作流

工作流 1：写技术笔记

text

1. Hermes 加载 obsidian Skill。
2. 搜索 docs/ 下是否已有同主题笔记。
3. 创建或定点更新 Markdown。
4. 更新对应 index.md。
5. 运行 pnpm docs:build 验证 VitePress。

工作流 2：实现代码功能

text

1. Hermes 检查仓库规则与 Git 状态。
2. 用 Prometheus/plan 生成实施计划。
3. 用 Atlas、Sisyphus 或 opencode run 执行。
4. 用 explore/librarian 并行补充代码库与外部资料。
5. 运行测试、构建并检查 diff。
6. 用代码审查 Skill 或 oracle 做最终审查。

工作流 3：排查疑难 Bug

text

1. 加载 systematic-debugging Skill。
2. 用 explore 定位相关代码和调用链。
3. 用 lsp 查看符号、引用和诊断。
4. 用 librarian/context7 核对官方文档。
5. 必要时让 oracle 分析根因与修复风险。
6. 修复后运行回归测试，记录真实结果。

工作流 4：检索并沉淀知识

text

1. Hermes/Exa 或 OpenCode websearch 搜索最新资料。
2. context7 查询库的当前文档。
3. grep_app 查找真实项目用法。
4. Hermes 汇总并写入 Obsidian/VitePress 笔记。
5. 使用相关链接和 [[双向链接]] 连接已有知识。

六、路径速查

内容	路径
技术笔记仓库	`D:\data\docs`
笔记正文	`D:\data\docs\docs`
Hermes CLI	`D:\software\hermesHermes Agent CN Desktop\data\desktop-bin\hermes.bat`
Hermes Home	`D:\software\hermesHermes Agent CN Desktop\data\hermes-home`
Hermes 配置	`D:\software\hermesHermes Agent CN Desktop\data\hermes-home\config.yaml`
Hermes 环境变量	`D:\software\hermesHermes Agent CN Desktop\data\hermes-home\.env`
Hermes Skills	`D:\software\hermesHermes Agent CN Desktop\data\hermes-home\skills`
OpenCode 配置	`C:\Users\GhostCloud\.config\opencode\opencode.json`
OpenCode Skills	`C:\Users\GhostCloud\.config\opencode\skills`

七、安全与维护

不在笔记中保存 API Key、Token、Cookie 或完整认证 Header。
不提交 Hermes .env、OpenCode secret 文件或包含密钥的配置副本。
Hermes 工具、Skill 或 MCP 变更后，优先 /reset 或重启会话。
OpenCode 并行修改代码时必须隔离工作目录或 Git worktree。
所有“已完成”结论都应由真实测试、构建或命令输出验证。
版本、模型、MCP 和 Agent 列表会变化，应定期用命令重新检查。

Hermes、Obsidian 与 OpenCode 常用配置 ​

一、整体关系 ​

二、Hermes Agent ​

当前环境 ​

常用命令 ​

会话内常用命令 ​

常用 Hermes Skill ​

Hermes MCP ​

Hermes Agent/子 Agent 使用方式 ​

三、Obsidian ​

笔记库与当前仓库 ​

Obsidian Skill 的工作方式 ​

常用笔记请求 ​

Obsidian 常用插件记录 ​

四、OpenCode ​

当前环境 ​

常用命令 ​

Hermes 调度 OpenCode ​

OpenCode Skill ​

OpenCode MCP ​

OpenCode Agent ​

主 Agent ​

子 Agent ​

系统 Agent ​

Agent 选择建议 ​

五、常用组合工作流 ​

工作流 1：写技术笔记 ​

工作流 2：实现代码功能 ​

工作流 3：排查疑难 Bug ​

工作流 4：检索并沉淀知识 ​

六、路径速查 ​

七、安全与维护 ​

相关笔记 ​

参考资料 ​

Hermes、Obsidian 与 OpenCode 常用配置

一、整体关系

二、Hermes Agent

当前环境

常用命令

会话内常用命令

常用 Hermes Skill

Hermes MCP

Hermes Agent/子 Agent 使用方式

三、Obsidian

笔记库与当前仓库

Obsidian Skill 的工作方式

常用笔记请求

Obsidian 常用插件记录

四、OpenCode

当前环境

常用命令

Hermes 调度 OpenCode

OpenCode Skill

OpenCode MCP

OpenCode Agent

主 Agent

子 Agent

系统 Agent

Agent 选择建议

五、常用组合工作流

工作流 1：写技术笔记

工作流 2：实现代码功能

工作流 3：排查疑难 Bug

工作流 4：检索并沉淀知识

六、路径速查

七、安全与维护

相关笔记

参考资料