Improve docstrings for Tool and ToolSpec#1582

Copilot wants to merge 2 commits intomainusethis-python/usethis-python:mainfrom

copilot/improve-docstrings-tool-toolspecusethis-python/usethis-python:copilot/improve-docstrings-tool-toolspecCopy head branch name to clipboard