GitHub Copilot 排错
先判断是不是平台层问题
这页主要处理三类故障:
- issue 写不清,导致平台输出没法 review
- draft PR 有 diff,但没有验证和风险说明
- 团队明明不是 GitHub-first,却还硬把平台当主入口
如果你的主要痛点是仓库内探索不够,而不是 issue / PR 流失真,优先切到 Claude Code 排错 或 OpenAI Codex 排错。
常见卡点
- issue 过于模糊,导致 Copilot 输出无法 review。
- draft PR 没有验证说明,平台流只剩代码 diff。
- 团队实际上不在 GitHub 里完成交付,却还强行用平台流。
症状到原因的快速对应
- 症状:Copilot 每次都先重新猜需求。 原因:issue 里没有写清范围、禁区和验收。
- 症状:PR 看起来像“代码堆上去了”,但没人敢 review。 原因:PR 模板没要求验证结果和剩余风险。
- 症状:每轮都要拉回本地重查,平台里只留一个空壳 PR。 原因:任务本质不适合平台主入口。
诊断顺序
- 先看 issue 是否写清楚。
- 再看 PR 模板是否要求验证和风险说明。
- 最后看平台是不是当前团队真正的主工作系统。
修复动作
场景 1:issue 太模糊
先不要继续追着 Copilot 改。先补齐:
- 这轮只交付什么
- 明确不改什么
- 用什么验收
- 谁来 review
如果这些信息补不出来,说明不是工具问题,而是任务还没收口。
场景 2:draft PR 只有 diff,没有证据
先回头补 PR 说明,不要把“先 review 代码再说”当默认路径。至少补:
- 改动摘要
- 实际验证命令或行为验证
- 已知风险
- 下一步建议
如果没有这些信息,reviewer 实际上是在替系统做二次需求分析。
场景 3:平台不是主工作系统
如果主要工作发生在本地仓库、终端或执行栈里,就不要强行让 GitHub Copilot 承担全部探索。平台只负责:
- 收口任务
- 保留 review 证据
- 连接 issue 和 PR
探索和实现应该回到更合适的入口。
回退策略
- 先回到更小的 issue,只交付一个明确结果。
- 给 PR 补完整说明后再进入 review。
- 如果主要工作发生在本地仓库,切到 Claude Code 快速开始 或 OpenAI Codex 快速开始。
下次避免再犯
- issue 模板里固定“范围 / 禁区 / 验收 / reviewer”四 项
- PR 模板里固定“验证 / 风险 / 下一步”三项
- 平台只接已经足够清楚、能直接 review 的任务
什么时候直接换工具
- 需要深度仓库探索:换 Claude Code 常见任务
- 需要多阶段推进:换 OpenAI Codex 常见任务
- 需要本地探索后再交后台:换 VS Code Agents 常见任务