Copilot 聊天故障排查
通过 Copilot Chat 调试日志解释代理行为、工具调用和加载失败。
技能限定分析 Copilot 调试日志，并要求基于证据而非猜测；但未说明日志中的提示词、用户消息、工具参数、认证或网络信息如何脱敏、最小化和保留，也未要求用户确认读取敏感日志。诊断命令可能暴露认证与网络状态，因此在权限、数据流透明度和恢复边界方面扣分。
日志格式、事件类型、关联方式和分步排查流程描述较完整，且包含错误、超时和缺失文件的部分处理建议；但未定义 JSONL 损坏、超大日志、路径无效、字段缺失或工具不可用时的明确失败输出。静态评估无法验证实际复现，因此不超过10分。
触发场景和目标日志范围清晰，覆盖延迟、工具调用、子代理、技能加载和模型选择问题；但非适用范围、输入校验、预期结构化输出和中文支持未明确，且网络诊断及外部文档依赖可能受中国大陆网络可达性影响。
文档采用目的、数据源、事件参考、排查流程、网络问题、文档参考和响应规范分层组织，示例丰富；仓库提供 MIT 许可、Microsoft 归属、版本和安全报告路径。技能自身没有版本、变更记录、维护者或独立更新路径，故扣分。
对于已有可读调试日志且工具可用的用户，流程能够产出根因、证据和修复建议，直接使用价值较高；但结果依赖日志完整性、运行环境工具和外部文档，且未提供可验证的最终输出模板或代表性实测结果，静态上限为7分并扣除不确定性。
技能给出了具体文件、字段、关联规则、命令和示例，具备一定可审计性；但本次仅有源文件证据，未见专门覆盖该技能关键路径的测试或第三方复现记录，仓库 CI 主要测试其他组件，因此静态上限为5分并扣分。
- 调试日志可能包含用户提示词、系统提示词、工具参数、文件路径及认证或网络状态；使用前应获得用户授权并进行脱敏，避免将原始日志发送到不必要的外部服务。
- 当日志缺失、损坏、截断或无法访问时，技能应明确报告证据不足，而不是继续推断根因。
- 网络诊断和外部文档访问可能在中国大陆网络环境中不可达，应提供不依赖外部网络的替代说明。
它能做什么 & 适用场景
该技能分析 Copilot Chat 写入的直接调试日志，以解释聊天代理为何采取特定行为。它可调查响应缓慢、工具或子代理调用、指令或技能未加载，以及工具失败等问题。结论必须基于日志证据，不应猜测。技能面向 Visual Studio Code Copilot Chat 的会话日志，并非通用应用监控工具。
读取目标会话的调试日志，优先分析主会话日志；必要时读取模型、系统提示、工具定义和子代理日志。使用 shell 中的 grep、jq 或 PowerShell 等命令筛选错误、慢事件、发现记录、工具调用和模型请求。遇到网络或认证问题时，可运行 Visual Studio Code 的 github.copilot.debug.collectDiagnostics 命令，并在证据不足时参考指定的 Copilot Issues wiki。
- 开发者想知道某次请求为何耗时过长，并需要从会话日志定位慢操作。
- 用户想确认某个工具或子代理为何被调用、跳过或失败。
- 维护者需要排查指令、技能或代理文件为何未加载。
- Copilot Chat 出现网络超时、认证错误或模型请求失败，需要结合调试信息诊断。
优缺点一览
- 围绕具体会话日志进行证据驱动的故障排查。
- 覆盖延迟、工具调用、子代理、模型可用性和定制文件加载等问题。
- 对网络或认证问题提供额外诊断路径。
- 依赖可用的 Copilot Chat 调试日志及目标会话目录。
- 部分诊断需要 Visual Studio Code 专用命令或 Copilot Issues wiki。
- 源材料未提供测试套件、独立安装器或跨平台验证信息。
如何安装
该技能位于 microsoft/vscode 仓库的 extensions/copilot/assets/prompts/skills/troubleshoot/SKILL.md。README 说明该仓库以 MIT 许可发布，并将多个技能打包在同一集合中；源材料未提供单独安装此技能的命令或步骤。
如何使用
在已提供目标 Copilot Chat 会话调试日志的环境中，提出具体问题，例如“为什么这个请求这么慢？”或“为什么工具调用失败？”。技能会根据日志证据说明原因和后续处理建议。源材料未规定独立的命令行入口或日志路径设置方式。