用途:本技能用于在创建或修改智能体定义时,指导如何选择正确的 VS Code Copilot 工具,并识别不同环境下工具可用性的差异。
适用场景:配置智能体 frontmatter 中的 tools 数组;排查“tool not found”错误;为本地(VS Code)与云端(GitHub)两种环境适配智能体。
主要能力:技能会提供全部可用工具的列表,即使其中多数不会被直接使用,也可据此为其他智能体挑选正确工具。
工具与环境:两种环境均安全可用的包括 search(代码与文件搜索)、web(外部信息搜索)、github/(仓库、PR、issue 操作)、memory/(记忆存储,如已配置)。仅 VS Code 可用而云端不可用的包括 vscode、execute / read(终端执行与读取)、edit(直接编辑文件)、todo、copilot-container-tools/、io.github.chromedevtools/。云端替代方案:用 PR 描述或 GitHub API 代替 edit,用 GitHub Actions 工作流代替 execute,用 issue/PR 描述跟踪任务代替 todo。
最佳实践:核对工具名称(区分大小写);为双环境智能体优先选用通用工具;需环境特定功能时在定义中加入条件指令;使用驼峰或斜杠命名,绝不用蛇形命名;常见组合可直接用工具集简写(如 search、edit),除非需要细粒度控制。
常见错误:使用 read_file、run_in_terminal 等蛇形命名会被 VS Code 静默忽略;误以为 execute、edit 在云端可用;在指令中硬编码工具列表,应改为动态引用自身可用工具列表。