第6篇：上下文文件——项目的“说明书”

第6篇：上下文檔案——專案的「說明書」

嘿，朋友們！今天咱們來聊聊 Hermes 裡一個特別實用的小功能——上下文檔案。你可以把它理解成給專案寫的一份「說明書」，讓 AI 一上來就知道該按什麼規矩辦事。

為什麼需要上下文檔案？

想像一下：你新招了個實習生，啥都不懂。你是花半小時口頭交代專案背景、程式碼風格、注意事項，還是直接甩給他一份《專案手冊》讓他自己看？顯然是後者省事。

Hermes 的上下文檔案就是這個邏輯。每次你在某個專案目錄裡啟動會話，Hermes 會自動載入這個檔案裡的內容，讓 AI 從一開始就「懂規矩」——知道你的技術棧、程式碼風格、常用指令、避坑指南等等。

檔案放哪？叫什麼名？

Hermes 會在當前工作目錄（以及父目錄）裡找這些檔案：

CLAUDE.md
CONTEXT.md
AGENTS.md

按順序讀取，找到就載入。你也可以在設定檔裡自訂檔案名稱，比如：

context:
  files:
    - "PROJECT_NOTES.md"
    - "TEAM_RULES.md"

裡面寫什麼？

隨便寫！它就是純文字（支援 Markdown），你想讓 AI 知道啥就寫啥。比如：

# 專案說明

## 技術棧
- Python 3.11 + FastAPI
- PostgreSQL + SQLAlchemy

## 程式碼風格
- 使用 ruff 做 lint，行寬 88
- 型別註解必須寫全
- 測試用 pytest，放在 tests/ 目錄

## 常用指令
- `make dev` 啟動開發伺服器
- `make test` 跑全部測試

## 注意事項
- 不要直接改資料庫 schema，用 Alembic 遷移
- 提交前必須跑一遍 `make lint`

怎麼用？

兩種方式：

自動載入：只要你在專案目錄裡啟動 Hermes，它自動讀取上下文檔案，無需額外操作。
手動指定：用 /context 指令檢視當前載入了哪些檔案，或者手動載入某個檔案：

/context ./docs/project-guide.md

小技巧

保持精簡：別寫成長篇大論，AI 的上下文視窗有限，挑重點寫。
按目錄分層：根目錄放通用規則，子目錄放特定模組的說明，Hermes 會逐級載入。
配合記憶功能：上下文檔案管「專案級」的長期資訊，/remember 管「會話級」的臨時資訊，兩者配合效果更佳。

和舊版的區別

如果你用過舊版的 --context 參數或 CONTEXT.md，新版的變化是：

支援多個檔案名稱（CLAUDE.md、CONTEXT.md、AGENTS.md）
支援自訂檔案名稱設定
支援按目錄層級自動發現和載入
新增 /context 指令，方便檢視和管理

簡單說，就是從「手動指定」變成了「自動發現 + 手動控制」，更省心了。

總結

上下文檔案就是給 AI 的「入職培訓手冊」。花十分鐘寫好，以後每次會話 AI 都自動進入狀態，不用你反覆交代。強烈建議每個專案都配一個！

下篇咱們聊聊別的，敬請期待！