feat(tool): add shell command build-in tool

[fang-tech]

AgentScope-Java Version

1.0.4-SNAPSHOT

Description

relate to #92, This is the built-in tool that enables the complete functionality of the skill and allows the execution of resources.

Checklist

Please check the following items before code is ready to be reviewed.

• Code has been formatted with mvn spotless:apply
• All tests are passing (mvn test)
• Javadoc comments are complete and follow project conventions
• Related documentation has been updated (e.g. links, examples, etc.)
• Code is ready for review

[codecov]

Codecov Report

❌ Patch coverage is 72.25806% with 86 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
.../agentscope/core/tool/coding/ShellCommandTool.java	72.50%	22 Missing and 11 partials ⚠️
...cope/core/tool/coding/WindowsCommandValidator.java	68.53%	16 Missing and 12 partials ⚠️
...ntscope/core/tool/coding/UnixCommandValidator.java	71.79%	10 Missing and 12 partials ⚠️
.../agentscope/core/tool/coding/CommandValidator.java	86.95%	1 Missing and 2 partials ⚠️

📢 Thoughts on this report? Let us know!

[Copilot]

Pull request overview

This PR introduces a new built-in Shell Command Tool that enables agents to execute shell commands with comprehensive security features and cross-platform support. The implementation includes command whitelisting, user approval callbacks, timeout management, and platform-specific validators for Windows and Unix-like systems.

Key changes:

• Added ShellCommandTool with security validation, timeout control, and cross-platform command execution
• Implemented platform-specific validators (UnixCommandValidator and WindowsCommandValidator) to handle OS-specific command separators and patterns
• Added comprehensive test coverage with 1,284 lines of tests covering various scenarios including timeouts, security validation, and edge cases
• Updated documentation in both English and Chinese with detailed usage examples, security warnings, and feature descriptions

Reviewed changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 17 comments.

Show a summary per file

File	Description
docs/zh/task/tool.md	Added comprehensive Chinese documentation for the Shell Command Tool, including usage examples, security features, and configuration options
docs/en/task/tool.md	Added English documentation for the Shell Command Tool with security notices and usage examples
agentscope-core/src/main/java/io/agentscope/core/tool/coding/ShellCommandTool.java	Core implementation of the shell command execution tool with security validation, timeout handling, and cross-platform support
agentscope-core/src/main/java/io/agentscope/core/tool/coding/CommandValidator.java	Interface defining the contract for command validation with ValidationResult inner class
agentscope-core/src/main/java/io/agentscope/core/tool/coding/UnixCommandValidator.java	Unix/Linux/macOS-specific command validator implementing whitelist checking and multiple command detection
agentscope-core/src/main/java/io/agentscope/core/tool/coding/WindowsCommandValidator.java	Windows-specific command validator with Windows path and extension handling (.exe, .bat, .cmd)
agentscope-core/src/test/java/io/agentscope/core/tool/coding/ShellCommandToolTest.java	Comprehensive test suite with 1,284 lines covering command execution, security validation, timeouts, and cross-platform scenarios
agentscope-core/src/test/java/io/agentscope/core/tool/coding/WindowsCommandValidatorTest.java	Detailed tests for Windows command validator covering executable extraction, extension handling, and validation logic

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.