外观
案例:代码仓库走读与 bug 复现
案例库 · 开发 · 进阶
接手一个陌生仓库,README 只有三行;线上报错,日志里只有一行 stack。
难度 ★★☆耗时 60 分钟岗位 开发
你会得到什么
一份仓库地图 + 一份可复现的 bug 记录
准备工作
- 把仓库放在工作空间(或在任务里选择仓库目录)
- 准备好报错信息、复现步骤和运行环境说明
照着做
1. 先画地图,不改代码
陌生仓库最怕上来就改。先让它讲清结构与启动路径。
这是一个陌生仓库,请不要修改任何文件。请输出仓库地图:技术栈、目录职责、入口文件、构建与启动命令、配置来源、测试怎么跑。不确定的地方标注「待确认」,不要编。2. 定位链路,给假设
让它把「报错 → 代码路径」写出来,你才能判断它是不是在猜。
报错信息如下:<粘贴>。请沿调用链定位:报错从哪抛出、经过哪些函数、可能的触发条件。输出 3 个假设,按可能性排序,每个假设说明支持证据和验证方法。3. 最小复现与修复建议
复现步骤要短到别人能照做,修复建议要能落到文件和行。
为最可能的假设写一个最小复现步骤(环境、命令、输入、预期与实际)。确认复现后,给出修复方案:改哪个文件、为什么、有没有副作用、需要补什么测试。先不要直接改,把方案给我。验收清单
- 仓库地图中的每条结论都有文件依据
- 三个假设都有验证方法,不是空话
- 复现步骤能被他人在干净环境执行
- 修复方案标明了副作用与测试点
常见坑
这些坑,新手几乎都会踩
- 让它「顺手把 bug 修了」,改动范围失控
- 只贴报错不给环境,定位容易跑偏
- 在默认权限下执行安装脚本,触发确认就放弃(应该先看清命令)
一次复制走的完整提示词
这是一个陌生仓库,请不要修改任何文件。
1) 输出仓库地图:技术栈、目录职责、入口、构建/启动命令、配置来源、测试方式;不确定标「待确认」;
2) 报错:<粘贴>。沿调用链定位,给出 3 个按可能性排序的假设,每个附支持证据与验证方法;
3) 为最可能的假设写最小复现步骤(环境/命令/输入/预期与实际);
4) 给修复方案(文件、原因、副作用、需要补的测试),先不要改代码。改一句就能用
把提示词里的岗位、文件名、时间改成你自己的,其余结构建议保留——它已经把「先看后改、给出处、可验收」三件事写进去了。