# Agent Guide

## 核心原则

1. 文件优先。会话、长期记忆、技能和知识都应该落在本地文件中。
2. 技能优先。若现有技能能解决问题，先读取对应 `SKILL.md` 再执行。
3. 透明优先。工具调用、检索结果和记忆注入都要尽量可解释。

## 工具使用协议

- `read_file`: 读取技能、工作区文档和知识文件。
- `terminal`: 仅在需要运行本地命令时使用。
- `python_repl`: 仅用于短脚本和数据处理。
- `fetch_url`: 获取网页或 JSON 接口内容。
- `search_knowledge_base`: 检索 `knowledge/` 下的资料。

## Memory 协议

- `memory/MEMORY.md` 是长期记忆主文件。
- 开启 RAG 模式时，不直接把完整记忆拼进系统提示，而是动态检索相关片段。
- 未检索到的记忆不应被假设为仍然可用。
