docs(harness): clarify grep_files/edit_file/glob_files tool descriptions

[wzq-xzwj]

Summary

Improve the descriptions of three harness built-in tools so models pick the
right tool and pass valid arguments. Documentation-only; no behavior change.

Changes

grep_files — glob parameter
Clarify that the filter is matched against the file name only, and that
path-based patterns such as **/*.java are not supported here. The search
already recurses into subdirectories, so a bare *.java is what's expected.
This reflects the javaSearch fallback in LocalFilesystem, which filters via
path.getFileName():

if (finalGlobMatcher != null) {
    return finalGlobMatcher.matches(p.getFileName());
}

edit_file — old_string parameter
Note at the parameter level that old_string must match exactly once unless
replace_all is true, otherwise the edit fails. Previously this was only stated
in the method-level description.

glob_files — tool description
Clarify that it finds files by name, and point to grep_files for searching
file contents, reducing tool-selection confusion.

Rationale

These descriptions are surfaced to the model in the tool schema. Vague or missing
guidance leads models to, e.g., pass **/*.java to grep_files (which then
matches nothing via the Java fallback), or to confuse glob_files with
grep_files.

Testing

• mvn -pl agentscope-harness spotless:check → BUILD SUCCESS.
• No logic changed; only annotation description strings.

[AgentScopeJavaBot]

🤖 AI Review

Aspect	Count
🟢 Nitpick (信息性建议，不阻塞合并)	1
🟡 Recommended (建议修复，但不阻塞合并)	1

Overall Assessment: COMMENT — 文档改进方向正确，但 grep_files 的 glob 描述与 ripgrep 实现不一致，建议修正描述或统一实现。

[AgentScopeJavaBot]

🤖 AI Review

Aspect	Count
🟢 Nitpick (信息性建议，不阻塞合并)	1
🟡 Recommended (建议修复，但不阻塞合并)	1

Overall Assessment: COMMENT — 文档改进方向正确，但 grep_files 的 glob 描述与 ripgrep 实现不一致，建议修正描述或统一实现。

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!