From 378bb6264cec4a23e53793285179f22cfbff3fcc Mon Sep 17 00:00:00 2001
From: tian <11429339@qq.com>
Date: Sat, 30 May 2026 19:17:30 +0800
Subject: [PATCH] add edit tool usage notes to AGENTS.md

---
 AGENTS.md | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index 1c60ca9..55dde34 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -146,3 +146,22 @@ var rotation = new Rotation3D(qx, qy, qz, qw);
 4. `doc/design/2026/NavisworksAPI使用方法.md`
 5. `.agents/skills/geometry-transform/SKILL.md`（几何/变换/姿态/坐标）
 6. `.agents/skills/nw-api/SKILL.md`
+
+---
+
+## 9. 工具使用提示
+
+### edit 工具的正确格式
+
+```json
+{
+  "path": "src/.../File.cs",
+  "edits": [
+    { "oldText": "原文本（必须完全匹配）", "newText": "新文本" }
+  ]
+}
+```
+
+- `path` 是顶层字段，不在 `edits` 数组内
+- `oldText` 不能有歧义（匹配多个时提供更多上下文）
+- 多个不重叠的编辑可以放在同一个 `edits` 数组中