tools
为AI智能体设计的TypeScript优先工具集，提供文件读写、搜索、Shell等核心操作能力。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：tools。 它的用途是：为AI智能体设计的TypeScript优先工具集，提供文件读写、搜索、Shell等核心操作能力。 详细介绍见：https://321skill.com/skills/tools/ 请根据该页面的说明完成安装。
使用示例
“请帮我读取项目根目录下的README.md文件，并查找所有包含‘API’关键词的行。” 智能体会调用`read`工具获取文件内容，再使用`grep`工具进行搜索，并以清晰的结构化格式返回结果，包括匹配的行号和内容。或者，你可以让它“运行单元测试并总结失败用例”，它会通过`bash`工具执行测试命令并分析输出。
介绍
这个工具集旨在解决AI智能体（如Claude、GPT）在自主执行任务时，缺乏安全、可靠且易于理解的外部工具接口的问题。它提供了一套专为LLM设计的工具，包括文件读写、内容搜索、执行Shell命令、网络请求等，让智能体能够像人类开发者一样与开发环境交互。
使用方式非常简单，你可以通过npm安装整个工具集或单个工具包，然后在你的智能体项目中导入并使用。每个工具都返回一个带有kind字段的判别式联合类型，这使得LLM能够可靠地解析成功、失败或需要特殊处理的各种结果状态，而不是依赖容易出错的字符串解析。
它非常适合智能体开发者、全栈开发者以及任何需要为AI助手或自动化流程构建可靠底层操作能力的工程师。无论是开发一个能自主编码的AI程序员，还是一个能分析日志的运维助手，这个工具集都能提供坚实的基础。
需要注意的是，这些工具的设计哲学是“为概率性模型设计”，因此其API表面（如字段名、错误信息）本身就是与LLM沟通的契约。使用时请确保你的LLM能够理解这些结构化输出，并合理配置权限策略，避免智能体进行危险操作。
核心特点
核心区别在于其“TypeScript优先”和“为真实LLM设计”的理念：所有工具的输出都是LLM易于解析的判别式联合类型，而非抛出异常；同时提供了针对LLM常见错误的模糊恢复提示（如文件未找到时推荐相似文件名）和别名推回表，极大提升了智能体使用工具的可靠性。
注意事项
不适合需要传统、确定性编程接口（如直接抛出Error对象）的纯人工编码场景。
常见问题
这个工具集和普通的Node.js fs、child_process模块有什么区别？
它专为AI智能体设计，输出是LLM易解析的结构化数据，并内置了权限控制、模糊匹配、操作记录等针对自主代理的安全和易用性特性。
能否在浏览器或非Node.js环境中使用？
不能，这是一个Node.js工具集，需要Node.js 20及以上版本，部分工具（如bash）依赖操作系统能力。