VSCode Copilot 配置文件提示警告分析与解决

问题描述

在使用 VSCode Copilot 时，配置文件 Ask.agent.md 中会出现'未知工具'的警告信息。错误日志如下：

{
  "resource": "/d:/.vscode/User/globalStorage/github.copilot-chat/ask-agent/Ask.agent.md",
  "owner": "prompts-diagnostics-provider",
  "severity": 4,
  "message": "未知工具 'github/issue_read'。",
  "startLineNumber": 7,
  "startColumn": 51,
  "endLineNumber": 7,
  "endColumn": 70
}

类似的警告还包括 github.vscode-pull-request-github/issue_fetch 和 activePullRequest。

原因分析

这些警告通常由以下两种情况引起：

1. 缺少对应扩展：部分工具需要安装特定的 GitHub 扩展才能识别。例如 github.vscode-pull-request-github 需要提供 Pull Requests 功能。
2. 内置工具 Bug：github/issue_read 来自 Copilot 内置工具，无需第三方扩展。在 VSCode 1.113 版本（2026-03-24 发布）中引入，被引用在所有三个内置 agent 文件中，但没有任何已安装扩展注册该工具。

解决方案

方法一：安装缺失扩展

在扩展市场搜索并安装 GitHub Pull Requests。

• 扩展 ID：github.vscode-pull-request-github

方法二：忽略警告

若不影响使用，可忽略 severity 4 级别的警告。

关于报告

此问题已被 VSCode 团队成员确认为已知 Bug，GitHub 上已有大量 Issue 报告（如 #302880、#304842）。删除文件后更新会恢复，目前需等待官方补丁。