Hermes 里的 .md 文件太多了？一篇教你看懂摸透，還能學會按需配置

很多人剛開始用 Hermes，只知道一句：

hermes chat

能聊天，能跑命令，能裝 Skill，能讓它幫你看項目，這就夠用了。

但用一陣子之后，你會發(fā)現(xiàn) Hermes 文件夾里、項目文件夾里，開始出現(xiàn)一堆 .md 文件：

SOUL.mdAGENTS.mdSKILL.mdHERMES.md.hermes.mdCLAUDE.md.cursorrulesMEMORY.mdUSER.mdREADME.md

新手看到這些文件，第一反應通常是：

這都是什么？
能不能改？
改錯了會不會出事？
我想讓 Hermes 更懂我，到底該寫在哪個文件里？
我想告訴它項目怎么跑，又該寫在哪個文件里？

這篇就用大白話講清楚。

你不用每個都改，也不用一上來折騰。普通用戶最重要的是先知道：這些 .md 文件不是一類東西，它們各自管的范圍不一樣。

先記住一句口訣：

SOUL.md：管“這個助手像誰”AGENTS.md：管“這個項目怎么干”SKILL.md：管“這類任務怎么做”

把這三個分清楚，Hermes 就不會越用越亂。

一、先給你一張總地圖

Hermes 官方文檔里專門講了 Context Files，也就是上下文文件。Hermes 會自動發(fā)現(xiàn)并加載一些文件，用來影響它在當前項目里的行為。文檔里列到的項目上下文文件包括 .hermes.md / HERMES.md、AGENTS.md、CLAUDE.md、.cursorrules、.cursor/rules/*.mdc，而 SOUL.md 是全局身份文件，只從 HERMES_HOME 里加載。

普通用戶可以先這樣理解：

文件

大白話解釋

普通用戶建議

SOUL.md

助手的性格、人設(shè)、說話方式

可以改，但別寫太長

AGENTS.md

當前項目的規(guī)矩、命令、邊界

很值得寫

SKILL.md

某類任務的操作手冊

會折騰后再動

.hermes.md / HERMES.md

Hermes 專用項目規(guī)則

高級用戶知道即可

CLAUDE.md

Claude Code 常見項目規(guī)則

用 Claude Code 會見到

.cursorrules

Cursor 的項目規(guī)則

用 Cursor 會見到

MEMORY.md / USER.md

長期記憶和用戶畫像

普通用戶別亂手改

README.md

給人看的項目說明書

可以讀，不等于 Agent 規(guī)則

你看到這些文件，不要一股腦都改。

先問自己一個問題：

我現(xiàn)在想告訴 Hermes 的，到底是“我的偏好”，還是“這個項目的規(guī)矩”，還是“以后做同類任務的方法”？

答案不同，放的位置就不同。

二、SOUL.md：這個助手到底像誰？

先講 SOUL.md。

這個文件名字聽起來最玄，但其實最好理解。

它管的是 Hermes 的長期性格和說話方式。

Hermes 官方 SOUL 指南說，SOUL.md 是 Hermes 實例的主要身份文件，是系統(tǒng)提示詞里的第一部分，用來定義 Agent 是誰、怎么說話、應該避免什么。它適合放語氣、人格、溝通風格、直接程度，以及 Hermes 如何面對不確定、分歧和模糊問題。

大白話說：

SOUL.md 不是項目說明書。SOUL.md 是這個 Hermes 的“性格底色”。

比如你希望 Hermes 長期這樣回答：

默認使用中文。先給結(jié)論，再給步驟。少說客套話，不要空泛鼓勵。不確定的信息要直接說明不確定。當我的想法有風險時，要明確提醒。不要為了討好我而假裝同意。

這些就適合放進 SOUL.md。

它回答的是這些問題：

這個助手要不要直接？
要不要溫柔？
要不要多解釋？
要不要敢反駁？
遇到不確定信息要不要提醒？
回答要偏技術(shù)文檔，還是偏大白話？

如果你每次都要重復說：

請用中文大白話，不要 AI 腔，別太空泛。

那就說明這類規(guī)則適合寫進 SOUL.md。

三、SOUL.md 不適合寫什么？

很多人最容易犯的錯，就是把項目規(guī)則塞進 SOUL.md。

比如這些就不適合：

這個項目用 pnpm。前端目錄是 frontend/。后端端口是 8000。測試命令是 npm test。不要修改 migrations。

這些是項目規(guī)則，不是助手人格。

Hermes 官方 SOUL 指南也明確說，SOUL.md 不應該放倉庫專屬代碼規(guī)范、文件路徑、命令、服務端口、架構(gòu)說明和項目工作流，這些應該放進 AGENTS.md。官方給的判斷規(guī)則也很清楚：如果它應該到處都適用，放 SOUL.md；如果它只屬于某一個項目，放 AGENTS.md。

普通用戶可以記住：

跟“我喜歡它怎么說話”有關(guān)，放 SOUL.md。跟“這個項目怎么運行”有關(guān)，別放 SOUL.md。

如果你把項目命令都塞進 SOUL.md，后面會很亂。

今天這個項目用 npm，明天那個項目用 pnpm，后天又換 Python。

全寫進 SOUL.md，Hermes 會被你喂成一個“大雜燴助手”。

四、AGENTS.md：這個項目的交通規(guī)則

接下來講 AGENTS.md。

這個文件可以理解成：

給 Agent 看的項目 README。

AGENTS.md 官方網(wǎng)站也這么解釋：它是一個專門給 AI 編程 Agent 提供上下文和指令的固定位置，可以幫助 Agent 理解項目并按規(guī)則工作。這個格式已經(jīng)被大量開源項目采用。

Hermes 官方 Context Files 文檔也說，AGENTS.md 是主要項目上下文文件，會告訴 Agent 項目結(jié)構(gòu)、約定和特殊指令；Hermes 會在 session 啟動時加載工作目錄里的 AGENTS.md，并在 Agent 進入子目錄時逐步發(fā)現(xiàn)相關(guān)上下文文件。

大白話說：

SOUL.md 告訴 Hermes：你這個助手應該怎么說話。AGENTS.md 告訴 Hermes：你在這個項目里應該怎么干活。

適合寫進 AGENTS.md 的內(nèi)容包括：

項目是干什么的；
怎么安裝依賴；
怎么啟動；
怎么測試；
目錄結(jié)構(gòu)怎么分；
哪些文件不能動；
新增依賴要不要先問；
改完以后怎么驗收；
遇到危險操作時怎么處理。

比如：

# AGENTS.md## 項目概況這是一個前端小項目，用來驗證頁面原型。## 常用命令- 安裝依賴：`npm install`- 啟動項目：`npm run dev`- 構(gòu)建項目：`npm run build`- 代碼檢查：`npm run lint`## 目錄說明- `src/`：主要源碼- `docs/`：文檔- `tests/`：測試- `.env`：環(huán)境變量文件，不要直接修改## 工作規(guī)則- 修改文件前，先說明計劃- 修改后，列出改了哪些文件- 不要刪除文件，除非我明確同意- 不要修改 `.env`- 新增依賴前必須先問我- 不要把密鑰、Token、Cookie 寫進代碼## 驗收標準完成任務后必須說明：1. 做了什么2. 改了哪些文件3. 跑了哪些檢查4. 還有什么風險

這份不復雜，但已經(jīng)能幫 Agent 少犯很多低級錯。

五、AGENTS.md 不適合寫什么？

AGENTS.md 也不是萬能垃圾桶。

不適合寫這些：

你以后說話溫柔一點。請用中文大白話。不要 AI 腔。你是我的長期內(nèi)容助手。

這些是長期風格，應該放 SOUL.md。

也不要寫太多空話：

你要非常聰明。你要努力做好。你要像世界頂級工程師一樣。

這種對 Agent 幫助很小。

AGENTS.md 最有價值的是具體規(guī)則：

怎么啟動怎么測試哪些文件不能碰什么時候必須問我完成后怎么匯報

它越像交通規(guī)則，越有用。

它越像口號，越?jīng)]用。

六、SKILL.md：這類任務的操作手冊

再講 SKILL.md。

這個文件普通用戶不一定會手寫，但一定會遇到。

尤其你裝 Hermes Skill、OpenCLI Skill、Obsidian Skill、PPT Skill、瀏覽器 Skill 時，經(jīng)常會看到某個 Skill 目錄里有一個：

SKILL.md

它到底是什么？

Hermes 官方 Skills 文檔說，Skills 是按需加載的知識文檔，用來教 Hermes 如何處理特定任務，比如生成 ASCII art、管理 GitHub PR 等。

換成大白話：

SKILL.md 是某類任務的操作手冊。

它不是某個項目的規(guī)矩。

它也不是助手性格。

它更像：

以后遇到這種任務，就按這個流程做。

比如你有一個“分析 GitHub 項目”的流程：

# SKILL.md## 什么時候使用當用戶給出 GitHub 項目鏈接，并要求判斷是否值得寫文章、是否適合普通用戶上手時使用。## 工作流程1. 先打開 README2. 核查 Star / Fork / Release3. 查安裝命令4. 查系統(tǒng)要求5. 查 Node / Python / Docker / API Key 門檻6. 找第一次最小測試方法7. 判斷適合誰、不適合誰8. 輸出常見坑和成功標志

這就適合沉淀成 Skill。

因為它不是只屬于某一個項目，而是你以后反復會用的流程。

七、什么時候該做成 SKILL.md？

普通用戶不要一上來就手寫 Skill。

更穩(wěn)的方式是：

先讓 Hermes 跑通一次任務。

如果你發(fā)現(xiàn)：

這個流程以后會反復用；
你每次都要貼同樣的步驟；
Hermes 這次終于跑對了；
你想讓它下次遇到同類任務自動想起這套方法；

這時候再考慮沉淀成 Skill。

比如這些適合做 Skill：

每次研究 GitHub 項目的流程；
每次排查 Node 項目啟動失敗的流程；
每次整理網(wǎng)頁資料到 Obsidian 的流程；
每次寫頭條 AI 工具文章的流程；
每次生成封面圖和干貨總結(jié)圖的流程。

Hermes Skills System 文檔里也提到，可以直接從一個 HTTP(S) URL 安裝單文件 SKILL.md，Hermes 會抓取、解析 frontmatter、安全掃描并安裝；這說明 SKILL.md 本質(zhì)上就是 Skill 的核心說明文件。

普通用戶記住：

AGENTS.md 是項目規(guī)則。SKILL.md 是可復用流程。

這兩個別混。

八、.hermes.md / HERMES.md：Hermes 專用項目規(guī)則

有些項目里你還可能看到：

.hermes.mdHERMES.md

這兩個是 Hermes 專用項目上下文文件。

Hermes 官方 Context Files 文檔把 .hermes.md / HERMES.md 列為項目指令文件，而且優(yōu)先級最高。文檔還寫到，項目上下文類型只會加載一個，優(yōu)先級是 .hermes.md → AGENTS.md → CLAUDE.md → .cursorrules，而 SOUL.md 會作為 Agent 身份單獨加載。

這句話對普通用戶有點重要。

意思是：

如果同一個項目里同時有 .hermes.md 和 AGENTS.md，Hermes 會優(yōu)先用 .hermes.md 這一類專用規(guī)則。

所以普通用戶一般不用主動建 .hermes.md。

除非你很確定：這個規(guī)則只給 Hermes 用，不想被其他 Agent 工具讀。

大多數(shù)情況下，寫 AGENTS.md 更通用。

九、CLAUDE.md：Claude Code 用戶常見

如果你用 Claude Code，常見的是：

CLAUDE.md

這個文件通常用來給 Claude Code 提供項目規(guī)則、代碼風格、測試方式等。

Hermes 也會檢測 CLAUDE.md 作為項目上下文文件之一，但它的優(yōu)先級低于 .hermes.md 和 AGENTS.md。

所以你可以這樣理解：

CLAUDE.md：更偏 Claude Code 的項目規(guī)則文件。AGENTS.md：更通用的 Agent 項目規(guī)則文件。

如果你同時用 Hermes、Codex、Claude Code，我建議：

核心通用規(guī)則寫 AGENTS.md；
Claude Code 特有規(guī)則再寫 CLAUDE.md；
不要在兩個文件里寫互相矛盾的內(nèi)容。

十、.cursorrules 和 .cursor/rules/*.mdc：Cursor 用戶會遇到

如果你用 Cursor，可能會見到：

.cursorrules.cursor/rules/*.mdc

這些是 Cursor 相關(guān)的項目規(guī)則文件。

Hermes 官方 Context Files 文檔也列出了 .cursorrules 和 .cursor/rules/*.mdc，說明 Hermes 可以識別這類 Cursor 規(guī)則文件。

普通用戶不用深入研究。

你只要知道：

看到 .cursorrules，不要驚訝。它通常是 Cursor 項目規(guī)則。

如果你主要用 Cursor，那它有價值。

如果你主要用 Hermes，優(yōu)先看 AGENTS.md 和 SOUL.md 就夠了。

十一、MEMORY.md / USER.md：記憶文件，別亂手改

再講兩個容易讓人好奇的文件：

MEMORY.mdUSER.md

Hermes 的功能總覽里提到，它有 Persistent Memory，也就是持久記憶，會通過 MEMORY.md 和 USER.md 記住偏好、項目、環(huán)境和學到的信息。

這兩個和前面幾個不太一樣。

它們更像 Hermes 的“長期記憶倉庫”。

大白話說：

MEMORY.md：偏向 Agent 自己記下的重要信息。USER.md：偏向關(guān)于用戶的長期畫像和偏好。

普通用戶不建議一上來手動亂改。

為什么？

因為記憶會進入上下文，寫錯了可能長期影響 Hermes 的判斷。

比如你一時興起寫進去：

用戶永遠只喜歡極簡回答。

后面你想要詳細分析時，它可能還受影響。

更穩(wěn)的方式是：

讓 Hermes 在聊天中根據(jù)真實互動自己維護記憶。
你真想改，也先備份，再少量修改。

十二、README.md：給人看的，不是專門給 Agent 的

最后講最常見的：

README.md

README 是給人看的項目說明書。

它通常寫：

項目是什么；
怎么安裝；
怎么使用；
功能介紹；
貢獻方式；
許可證。

Agent 當然也會讀 README，但 README 不一定適合放所有 Agent 規(guī)則。

比如：

不要修改 .env新增依賴前必須問我改完必須列出風險

這些更適合放 AGENTS.md。

因為 README 面向所有人，太多 Agent 規(guī)則會讓它變得很臃腫。

AGENTS.md 官方也強調(diào)，它就是一個專門給 Agent 提供上下文和指令的可預測位置，可以避免把 README 塞得太滿。

所以：

README.md：給人看。AGENTS.md：給 Agent 看。

這兩個可以互補，不需要互相替代。

十三、到底該寫哪里？看這個判斷表

如果你還是懵，就看這張表。

你想寫的內(nèi)容

放哪里

默認用中文、大白話、少廢話

SOUL.md

不確定就說明，不要裝懂

SOUL.md

遇到風險要提醒我

SOUL.md

這個項目用

pnpm install

AGENTS.md

啟動命令是

npm run dev

AGENTS.md

修改后必須跑

npm test

AGENTS.md

不要修改

.env

AGENTS.md

不要刪除用戶文件

AGENTS.md

分析 GitHub 項目的固定流程

SKILL.md

排查 Node 啟動失敗的步驟

SKILL.md

Hermes 專用項目規(guī)則

.hermes.md/

HERMES.md

Claude Code 項目規(guī)則

CLAUDE.md

Cursor 項目規(guī)則

.cursorrules

用戶長期偏好和歷史記憶

MEMORY.md/

USER.md，普通用戶別亂手改

給人看的項目介紹

README.md

再壓縮成一句話：

跟“我這個助手”有關(guān)，放 SOUL.md。跟“這個項目”有關(guān)，放 AGENTS.md。跟“這類任務”有關(guān)，做成 SKILL.md。

這個判斷基本夠用了。

十四、普通用戶怎么按需配置？

如果你只是好奇，建議這樣做：

第一步，只打開看看，不急著改。

cat ~/.hermes/SOUL.md

看看 Hermes 默認人格是什么。

第二步，給常用項目加一個最小 AGENTS.md。

先寫啟動命令、測試命令、不要改 .env、新增依賴先問我。

第三步，跑通幾次任務后，再考慮 Skill。

不要一上來就手寫復雜 SKILL.md。

第四步，別亂動 MEMORY.md / USER.md。

如果你真要動，先備份。

第五步，不同工具文件別互相打架。

如果項目里同時有 AGENTS.md、CLAUDE.md、.cursorrules，盡量讓核心規(guī)則一致。

不要這個文件說“用 npm”，那個文件說“用 pnpm”。

Agent 最怕規(guī)則沖突。

十五、最小模板給你一份

如果你想馬上動手，先從 AGENTS.md 開始。

因為它最安全，也最實用。

# AGENTS.md## 項目概況這是一個【項目類型】，主要用于【一句話說明用途】。## 常用命令- 安裝依賴：`npm install`- 啟動項目：`npm run dev`- 運行測試：`npm test`- 代碼檢查：`npm run lint`## 目錄說明- `src/`：主要源碼- `docs/`：文檔- `tests/`：測試文件- `.env`：環(huán)境變量文件，不要直接修改## 工作規(guī)則- 修改文件前，先說明計劃- 修改后，列出改了哪些文件- 涉及刪除文件、安裝新依賴、修改環(huán)境變量時，必須先問我- 不要改生產(chǎn)配置- 不要把密鑰、Token、Cookie 寫進代碼## 驗收標準完成任務后必須說明：1. 做了什么2. 改了哪些文件3. 跑了哪些檢查4. 還有什么風險

如果你想改 SOUL.md，先別寫太多。

最小版本可以這樣：

# Identity你是我的長期 AI 助手，擅長把復雜問題講清楚，并給出可執(zhí)行步驟。# Style- 默認使用中文- 先給結(jié)論，再給步驟- 不確定的信息要直接說明- 遇到風險要提醒我- 不要把簡單問題復雜化

SKILL.md 先別急著寫。

等你某個流程跑通了，再讓 Hermes 幫你總結(jié)成 Skill。

最后說一句

Hermes 里的 .md 文件確實多。

但它們不是讓你背文件名的。

它們真正的作用，是把不同層級的規(guī)則分開：

助手性格，放 SOUL.md。
項目規(guī)矩，放 AGENTS.md。
可復用流程，放 SKILL.md。
其他工具規(guī)則，按工具放 CLAUDE.md、.cursorrules。
長期記憶，交給 MEMORY.md / USER.md，普通用戶別亂手改。
人類說明，繼續(xù)放 README.md。

你不需要一次全配置。

先看懂，再按需改。

對普通用戶來說，最值得先動的是兩個：

SOUL.md：讓 Hermes 更像你的長期助手。AGENTS.md：讓 Hermes 更懂當前項目的規(guī)矩。

等你用久了，發(fā)現(xiàn)某個流程反復出現(xiàn)，再考慮：

SKILL.md：把成功流程沉淀成可復用能力。

這樣用，Hermes 就不會越用越亂。

它會慢慢從一個“什么都能聊的工具”，變成一個知道你習慣、懂項目邊界、會復用經(jīng)驗的長期助手。