Update Tool usage instructions.

llm-assist/AGENTS.md

@@ -36,11 +36,31 @@ dotnet test --filter "FullyQualifiedName~ClassName.MethodName"  # Run single tes
 
 - Code and comments are in **Chinese**.
 - Namespace: `OCES.Resonance.Core` (Core), `OCES.Resonance.AtlFieldExtractor` (extractor), `OCES.Resonance.Core.Tests` (tests).
-- Git commit style: `WIP: <description>` (no conventional commits).
 
-## AI 助手工具说明（DeepSeek TUI）
+## AI 助手工具说明
 
-当前工作环境为 DeepSeek TUI，文件操作工具采用**延迟加载**机制，不在初始工具列表中。首次调用会触发加载并返回 schema 提示（不执行），用正确参数重试后正常执行。
+### 工具使用优先级
+
+**优先使用 Rider MCP 服务器工具**（`Rider_*` 系列）。该类工具直接通过 IDE 执行操作，结果更准确、上下文更丰富。
+
+| 场景 | 优先使用 | 回退方案 |
+|------|---------|---------|
+| 读取文件 | `Rider_read_file` / `Rider_get_file_text_by_path` | `read_file` |
+| 写入/编辑 | `Rider_replace_text_in_file` / `Rider_create_new_file` | `write_file` / `edit_file` |
+| 搜索文件 | `Rider_find_files_by_glob` / `Rider_search_file` | `list_dir` / glob |
+| 搜索内容 | `Rider_search_text` / `Rider_search_in_files_by_text` | `grep_files` |
+| 正则搜索 | `Rider_search_regex` / `Rider_search_in_files_by_regex` | `grep_files` |
+| 代码重构 | `Rider_rename_refactoring` / `Rider_move_type_to_namespace` | `edit_file`（手动）|
+| 构建 | `Rider_build_solution` | `bash dotnet build` |
+| 运行测试 | `Rider_execute_run_configuration` | `bash dotnet test` |
+| 代码问题 | `Rider_get_file_problems` | —（无等效回退） |
+| 符号查找 | `Rider_search_symbol` / `Rider_get_symbol_info` | `grep_files`（语义降级） |
+
+**回退规则**：仅当 Rider MCP 工具不可用（未在工具列表中、调用报错）时，才使用对应的默认工具。
+
+### 默认工具说明（DeepSeek TUI / OpenCode 等）
+
+当前工作环境可能为 DeepSeek TUI 或 OpenCode，文件操作工具因平台而异，采用**延迟加载**机制的工具首次调用会触发加载并返回 schema 提示（不执行），用正确参数重试后正常执行。
 
 ### 可用文件操作工具