用途:从 GitHub issue 报告出发,系统化复现并调查 bug。与语言、框架无关,适用于任意项目类型。
主要能力与流程:
- 理解问题:用 gh issue view $ARGUMENTS --json title,body,comments,labels,assignees 拉取 issue,提取症状、预期行为、复现步骤、环境线索与出现频率;若缺少步骤或描述模糊会标注缺失项。若未提供编号或 URL,会先向用户询问。
- 提出假设:在改代码前,用原生内容搜索工具查找与症状相关的代码路径(错误信息、功能名、路由、模型/服务/控制器名),列出 2-3 个可能根因、涉及文件和预期为何产生该症状,并按可能性排序。
- 复现:按 bug 类型分路线。后端/逻辑/数据类走测试复现,写最小失败测试;UI/交互类使用 agent-browser CLI 做浏览器自动化(要求不要使用其他浏览器 MCP 或内置浏览器控制工具),命令如 agent-browser open、agent-browser snapshot -i、agent-browser click @ref、agent-browser fill @ref "text"、agent-browser screenshot bug-evidence.png;需要特定数据、角色或外部状态的走人工/环境特定复现。若复现失败,会回看其余假设、检查环境差异并查看相关文件近期 git 改动。
- 调查:结合应用日志、错误跟踪、浏览器控制台、数据库状态、请求响应周期追踪代码路径,检查 nil/空集合、边界条件、竞态等,并用 git log 查近期改动。
- 记录发现:整理根因(含文件与行号)、已验证的复现步骤、证据(截图、测试输出、日志、控制台错误)、建议修复与待解决问题。
限制:对外操作前必须先向用户展示完整报告并征得确认,未经明确确认不得向 GitHub issue 发表评论或采取外部动作;发表评论使用 gh issue comment $ARGUMENTS --body 命令。浏览器复现需项目开发服务器已运行并确认端口,端口可从 AGENTS.md、CLAUDE.md、package.json 的 dev 脚本、.env 推断,默认 3000。本 skill 的具体安装方式、收费与价格信息暂未提供。