开发与工程 ✓ Microsoft · 官方

Copilot 聊天故障排查

通过 Copilot Chat 调试日志解释代理行为、工具调用和加载失败。

49/ 100
谨慎使用

价值存在,但可靠性、证据或控制措施仍有明显缺口。

查看评分依据 ↓
可直接使用于
Codex · Claude Code
Star 数
★ 194k
最近更新
11 天前
License
MIT
debug-log-analysisjsonlcopilot-chatvscode
+1agent-troubleshooting

这个 Skill 能做什么,适合哪些场景?

该技能分析 Copilot Chat 写入的直接调试日志,以解释聊天代理为何采取特定行为。它可调查响应缓慢、工具或子代理调用、指令或技能未加载,以及工具失败等问题。结论必须基于日志证据,不应猜测。技能面向 Visual Studio Code Copilot Chat 的会话日志,并非通用应用监控工具。

读取目标会话的调试日志,优先分析主会话日志;必要时读取模型、系统提示、工具定义和子代理日志。使用 shell 中的 grep、jq 或 PowerShell 等命令筛选错误、慢事件、发现记录、工具调用和模型请求。遇到网络或认证问题时,可运行 Visual Studio Code 的 github.copilot.debug.collectDiagnostics 命令,并在证据不足时参考指定的 Copilot Issues wiki。

适合
  • 开发者想知道某次请求为何耗时过长,并需要从会话日志定位慢操作。
  • 用户想确认某个工具或子代理为何被调用、跳过或失败。
  • 维护者需要排查指令、技能或代理文件为何未加载。
  • Copilot Chat 出现网络超时、认证错误或模型请求失败,需要结合调试信息诊断。

如何安装这个 Skill?

使用前请注意
  • 调试日志可能包含用户提示词、系统提示词、工具参数、文件路径及认证或网络状态;使用前应获得用户授权并进行脱敏,避免将原始日志发送到不必要的外部服务。
  • 当日志缺失、损坏、截断或无法访问时,技能应明确报告证据不足,而不是继续推断根因。
  • 网络诊断和外部文档访问可能在中国大陆网络环境中不可达,应提供不依赖外部网络的替代说明。
开始前你需要
Agent 需要具备
  • Shell / 命令行
  • 网络访问
  • 本地文件系统
需要预先安装
  • grep
  • jq
  • Visual Studio Code Copilot debug logs

该技能位于 microsoft/vscode 仓库的 extensions/copilot/assets/prompts/skills/troubleshoot/SKILL.md。README 说明该仓库以 MIT 许可发布,并将多个技能打包在同一集合中;源材料未提供单独安装此技能的命令或步骤。

通用方式:手动安装到 Claude Code(macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/microsoft/vscode.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/extensions/copilot/assets/prompts/skills/troubleshoot" ~/.claude/skills/
rm -rf "$tmp"

根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。

如何使用这个 Skill?

试试这样说

安装后,把下面任意一句发给 Agent 即可触发:

  • 为什么这个请求这么慢?
  • 为什么工具调用失败?

在已提供目标 Copilot Chat 会话调试日志的环境中,提出具体问题,例如“为什么这个请求这么慢?”或“为什么工具调用失败?”。技能会根据日志证据说明原因和后续处理建议。源材料未规定独立的命令行入口或日志路径设置方式。

这个 Skill 有哪些优点和局限?

优点
  • 围绕具体会话日志进行证据驱动的故障排查。
  • 覆盖延迟、工具调用、子代理、模型可用性和定制文件加载等问题。
  • 对网络或认证问题提供额外诊断路径。
局限
  • 依赖可用的 Copilot Chat 调试日志及目标会话目录。
  • 部分诊断需要 Visual Studio Code 专用命令或 Copilot Issues wiki。
  • 源材料未提供测试套件、独立安装器或跨平台验证信息。

这个 Skill 与同类方案有什么区别?

与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。

Skill FS 评分 Star 数 最近更新 License
Copilot 聊天故障排查 本页 ✓ Microsoft · 官方 49 · 谨慎使用 ★ 194k 11 天前 MIT
Copilot 会话故障诊断 ✓ Microsoft · 官方 51 · 谨慎使用 ★ 194k 11 天前 MIT
Agent Host 日志分析 ✓ Microsoft · 官方 55 · 谨慎使用 ★ 194k 11 天前 MIT
Copilot Chat OpenTelemetry 埋点指南 ✓ Microsoft · 官方 60 · 推荐 ★ 194k 11 天前 MIT
VS Code Insiders 自动化技能 ✓ Microsoft · 官方 46 · 谨慎使用 ★ 194k 11 天前 MIT

FollowSkills 如何评估这个 Skill?

FollowSkills 评估 · FSRS-2.0
谨慎使用
49/ 100 五分制 2.5 / 5
上游仓库在本次评估后已有新提交;当前评分仍对应所示审查版本,可能尚未覆盖最新改动。
1信任安全12 / 25 · 2.4/5

技能限定分析 Copilot 调试日志,并要求基于证据而非猜测;但未说明日志中的提示词、用户消息、工具参数、认证或网络信息如何脱敏、最小化和保留,也未要求用户确认读取敏感日志。诊断命令可能暴露认证与网络状态,因此在权限、数据流透明度和恢复边界方面扣分。

2可靠稳定8 / 20 · 2.0/5

日志格式、事件类型、关联方式和分步排查流程描述较完整,且包含错误、超时和缺失文件的部分处理建议;但未定义 JSONL 损坏、超大日志、路径无效、字段缺失或工具不可用时的明确失败输出。静态评估无法验证实际复现,因此不超过10分。

3适用触发10 / 15 · 3.3/5

触发场景和目标日志范围清晰,覆盖延迟、工具调用、子代理、技能加载和模型选择问题;但非适用范围、输入校验、预期结构化输出和中文支持未明确,且网络诊断及外部文档依赖可能受中国大陆网络可达性影响。

4规范维护9 / 15 · 3.0/5

文档采用目的、数据源、事件参考、排查流程、网络问题、文档参考和响应规范分层组织,示例丰富;仓库提供 MIT 许可、Microsoft 归属、版本和安全报告路径。技能自身没有版本、变更记录、维护者或独立更新路径,故扣分。

5有效结果6 / 15 · 2.0/5

对于已有可读调试日志且工具可用的用户,流程能够产出根因、证据和修复建议,直接使用价值较高;但结果依赖日志完整性、运行环境工具和外部文档,且未提供可验证的最终输出模板或代表性实测结果,静态上限为7分并扣除不确定性。

6证据核验4 / 10 · 2.0/5

技能给出了具体文件、字段、关联规则、命令和示例,具备一定可审计性;但本次仅有源文件证据,未见专门覆盖该技能关键路径的测试或第三方复现记录,仓库 CI 主要测试其他组件,因此静态上限为5分并扣分。

1 2 3 4 5 6

点击维度查看打分理由

评估于 2026年7月20日 审查版本 5b3e1be7be9e 评估证据[1][2][3][4][5][6][7][8][9][10][11]

证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。

查看完整评分方法 →

常见问题

它能分析没有 Copilot Chat 调试日志的问题吗?
不能可靠地分析。技能要求以直接调试日志为依据,并明确禁止猜测。
它会自动修改配置或代码吗?
源材料只说明它读取日志、运行诊断命令并给出解释和建议,没有说明会自动修改文件。
使用它是否需要网络?
核心日志分析面向本地文件,但网络问题诊断可能调用诊断命令并参考在线文档或 wiki,因此完整工作流可能需要网络。

同仓库的其他 Skills

均来自 microsoft/vscode

开发与工程 ✓ Microsoft · 官方

Copilot 会话故障诊断

基于会话日志解释 Copilot CLI 为何出现异常行为。

★ 194k FS 51 谨慎使用 11 天前
开发与工程 ✓ Microsoft · 官方

Agent Host 日志分析

定位 Agent Host 导出日志中的会话、传输与主机问题。

★ 194k FS 55 谨慎使用 11 天前
开发与工程 ✓ Microsoft · 官方

Copilot Chat OpenTelemetry 埋点指南

为 Copilot Chat 统一设计和维护 OpenTelemetry 埋点。

★ 194k FS 60 推荐 11 天前
开发与工程 ✓ Microsoft · 官方

VS Code Insiders 自动化技能

通过 Playwright 自动化 VS Code Insiders 与 Copilot Chat。

★ 194k FS 46 谨慎使用 11 天前
开发与工程 ✓ Microsoft · 官方

VS Code Agent 定制助手

帮助创建、修复和排查 VS Code Agent 定制文件及其加载问题。

★ 194k FS 55 谨慎使用 11 天前
开发与工程 ✓ Microsoft · 官方

VS Code 聊天定制编辑器开发技能

帮助开发者安全修改并测试 VS Code 的聊天定制管理界面。

★ 194k FS 52 谨慎使用 11 天前
开发与工程 ✓ Microsoft · 官方

VS Code 性能调查工作流

自动化复现 VS Code 场景并采集性能与内存证据。

★ 194k FS 47 谨慎使用 11 天前
开发与工程 ✓ Microsoft · 官方

可复用提示词创建器

把重复任务整理成可复用的 .prompt.md 文件。

★ 194k FS 45 不推荐 11 天前
开发与工程 ✓ Microsoft · 官方

VS Code 配置策略维护助手

规范 VS Code 企业配置策略的注册、导出与验证。

★ 194k FS 59 推荐 11 天前
设计与前端 ✓ Microsoft · 官方

VS Code 设计哲学

用价值、原则和设计动作,把“看起来不对”转化为可执行的界面改进。

★ 194k FS 58 推荐 11 天前
开发与工程 ✓ Microsoft · 官方

VS Code 集成浏览器架构指南

帮助开发者安全理解和修改 VS Code 集成浏览器的跨进程架构。

★ 194k FS 56 谨慎使用 11 天前
开发与工程 ✓ Microsoft · 官方

Code OSS 启动与调试

为 VS Code 源码构建提供隔离启动、Playwright 自动化和多进程调试端口。

★ 194k FS 54 谨慎使用 11 天前
开发与工程 ✓ Microsoft · 官方

VS Code 崩溃转储符号化

将原生 VS Code 崩溃转储转换为带方法名的可读回溯。

★ 194k FS 53 谨慎使用 11 天前
开发与工程 ✓ Microsoft · 官方

VS Code 集成测试运行助手

帮助你在 VS Code 源码仓库中准确运行和筛选集成测试。

★ 194k FS 52 谨慎使用 11 天前
开发与工程 ✓ Microsoft · 官方

运行命令配置助手

为 VS Code Agent Session 配置和更新运行按钮命令。

★ 194k FS 48 谨慎使用 11 天前
开发与工程 ✓ Microsoft · 官方

自定义代理创建器

根据工作目标和对话上下文创建专用的 .agent.md 代理文件。

★ 194k FS 42 不推荐 11 天前
开发与工程 ✓ Microsoft · 官方

Code OSS 开发日志查看器

快速定位并读取 Code OSS 开发运行日志。

★ 194k FS 51 谨慎使用 11 天前
开发与工程 ✓ Microsoft · 官方

VS Code 本地 Web 工作台

在本地 vscode.dev 中验证 VS Code 工作台和 Agents 窗口改动。

★ 194k FS 53 谨慎使用 11 天前
开发与工程 ✓ Microsoft · 官方

项目指令创建器

把对话中的规则和偏好整理成项目指令文件。

★ 194k FS 51 谨慎使用 11 天前
开发与工程 ✓ Microsoft · 官方

工作流技能构建器

把对话中的工作方法整理成可复用的 SKILL.md。

★ 194k FS 50 谨慎使用 11 天前

相关 Skills