主题
Hermes、Obsidian 与 OpenCode 协作方式
结论
三者的职责应保持清楚：
| 组件 | 主要职责 |
|---|---|
| Hermes Agent | 长期助手、资料整理、任务编排、文件与自动化工具 |
| Obsidian / VitePress | 保存、关联和发布 Markdown 知识 |
| OpenCode | 软件项目中的规划、实现、测试和代码审查 |
详细配置已经拆到独立模块，本页只保留协作主线，避免同时维护多份易过时的版本、MCP 和 Skill 清单。
一、整体工作流
text
用户提出目标
↓
Hermes 收束问题、检查资料、拆解任务
↓
需要编码时由 OpenCode 在明确仓库中执行
↓
Hermes 检查文件、diff、测试和构建结果
↓
将稳定经验写成 Markdown 笔记或 Skill
↓
VitePress 构建并发布二、什么时候使用 Hermes
- 跨多个文件或资料源整理知识；
- 联网核验当前事实；
- 维护 Obsidian/VitePress 笔记；
- 调度多个独立子任务；
- 使用 Memory、Skill、MCP、Cron 和消息平台；
- 对最终产物进行统一验证和汇总。
三、什么时候使用 OpenCode
- 在一个明确代码仓库中实现功能；
- 阅读代码、定位调用关系；
- 先 Plan 再 Build；
- 运行测试、构建和代码审查；
- 使用项目 Agent、Command、Skill 或 MCP。
详见 OpenCode 进阶使用手册。
四、什么时候写入笔记
适合写入：
- 已核验的配置流程；
- 可复用的排错方法；
- 项目架构和稳定决策；
- 带来源的研究结论；
- 能帮助未来执行的检查清单。
不适合写入：
- API Key、密码、Cookie；
- 当前会话的临时进度；
- 未验证的命令输出；
- 很快过期且没有日期的状态；
- 与其他页面完全重复的大段内容。
五、推荐任务模板
text
目标：最终要交付什么？
范围：允许读取和修改哪些文件或仓库？
资料：是否需要联网，权威来源是什么？
执行：Hermes 直接处理，还是调用 OpenCode？
安全：哪些写操作、外部系统或 Secret 需要确认？
验收：测试、构建、链接、线上页面分别如何验证？
沉淀：结果写入笔记、项目规则还是 Skill？六、笔记仓库维护流程
text
1. 搜索现有同主题笔记。
2. 判断是新增模块、补充专题还是合并旧页面。
3. 创建/修改 Markdown。
4. 更新 topic index、VitePress nav 和 sidebar。
5. 检查本地链接和敏感信息。
6. 运行 pnpm docs:build。
7. 查看 Git diff，确认没有误改用户内容。