專案規則
AGENTS.md 會進模型上下文，作用接近 Cursor 的 rules：告訴 agent 這個 repo 的結構、指令、慣例與禁區。TUI 裡跑 /init 可產生或更新初稿，再自己改成團隊真正在用的內容。
請把專案的 AGENTS.md 提交到 Git。
檔案會從哪裡讀
OpenCode 會看多個位置，用途不同：
- 專案：工作目錄往上找到的
AGENTS.md（只對這個 repo 有效） - 全域：
~/.config/opencode/AGENTS.md（所有 session）
同一層若同時有 AGENTS.md 與 CLAUDE.md，只用 AGENTS.md。沒有 AGENTS.md 時，會相容 Claude Code 的 CLAUDE.md（專案）與 ~/.claude/CLAUDE.md（全域）。
也可用 opencode.json 的 instructions 指向其他檔案或遠端 URL，讓團隊沿用既有規則而不必複製一份。
建議寫什麼
寫 agent 每次都需要、但提示詞裡不該重複貼的內容：
- 套件管理器與常用指令（測試、lint、dev server）
- 目錄地圖：程式在哪、不要改 generated 檔
- 語言與風格（例如本站用繁體中文、台灣用詞）
- 權限邊界：禁止推送到 main、禁止碰
.env - 「不確定時先搜 docs／跑測試」這類決策規則
保持短。把整本設計文件貼進去會占上下文，細節改放 Skills，需要時再載入。
# 專案規則
- 套件管理用 `uv`，不要用 pip 直接裝。
- 改文件後執行 `uv run zensical build` 確認能建置。
- 不要提交 `.env` 或 API key。
- 測試指令：`uv run pytest`
可在規則裡點名 MCP，例如「查官方文件時用 context7」。MCP 設定見 MCP。
若要停用 Claude Code 相容路徑：
只關 skills 或只關 ~/.claude/CLAUDE.md 則用 OPENCODE_DISABLE_CLAUDE_CODE_SKILLS、OPENCODE_DISABLE_CLAUDE_CODE_PROMPT。