技能介绍

要解决什么问题

在大模型 Agent 落地时，工具调用往往分成两类：平台自带的 builtin tools（读文件、执行命令、浏览网页等），以及通过 MCP、HTTP 或插件接入的扩展工具。工程师常遇到的问题是：同一套提示词在不同运行时上，可用工具名、参数 schema、权限模型并不一致；排障时也很难区分「模型没选对工具」和「运行时根本没暴露该 builtin」。

本技能（规范名 @user_e02e04b8/builtin-tools）归类为 开发编程，面向需要在 Agent 工程里显式理解和约束内置工具的场景，而不是泛泛介绍「Agent 能做什么」。

技能如何组织思路

从工程视角，builtin tools 通常涉及这些环节：

发现：当前会话/运行时实际注册了哪些工具，与文档是否一致
选型：哪些任务应走 builtin、哪些应走外部集成，避免重复封装
约束：在 system / skill 指令里写清工具边界（例如只读目录、禁止网络、命令白名单）
联调：工具返回结构异常、超时、或模型幻觉出不存在工具名时的处理策略

技能的价值在于把上述问题收敛成可复用的叙述与约定，让团队在换模型、换 IDE Agent 或换托管平台时，仍能用同一套语言讨论「内置工具层」的行为，而不是每次从零对齐口头习惯。

适用边界与注意点

不要假设工具全集相同：Claude Code、Cursor、自建编排与各类 API 的 builtin 列表与命名可能不同，技能中的约定需按你的运行时对照验证。
安全优先：builtin 往往直连本机或租户资源；在 skill 里写工具策略时，应默认按最小权限设计，而不是「能调就用」。
与 MCP 的分工：builtin 适合低延迟、强耦合运行时的能力；跨进程、可插拔的服务更适合 MCP。混用时要在提示词里写清调用优先级，避免模型在等价能力间随机切换。

若你只是在写一次性 demo、且不涉及工具权限与可移植性，可能不必引入专门的内置工具技能；一旦进入多人协作或 CI 化 Agent，builtin 层的文档化会变得必要。