用途:当用户提供 GitHub Issue 链接、编号或正文,或询问某行为是否真的是缺陷时使用。先判断问题真实性,再决定是否修复。
主要流程与能力:
- 收集上下文:优先用 gh issue view <number> --json title,body,comments,labels,author,state,url;gh 不可用或未认证时改用网页或请用户补充。需阅读全部评论,其中常含维护者意见、复现方式、变通方案和重复链接。记录报告行为、期望行为、环境、复现步骤、复现仓库、维护者评论与已确认的变通方案。
- 查找上游相关上下文:搜索 issue、PR 与讨论中的编号、API、报错文本与复现关键词;注意相关 PR、重复 Issue、回归报告与变更日志。若已有 PR 修复,先确认本地是否包含该改动。
- 映射到代码:确定涉及的包、适配器、示例、文档页或共享核心模块,用 rg 搜索相关实现与测试,先读最近的测试以明确既有行为契约。
- 验证真实性:尽量本地复现,优先写最小失败测试而非完整示例;UI 或框架问题用最小示例或 fixture;记录失败命令与失败模式。无法复现时,检查是否已修复、用法错误、版本相关或信息不足。
- 判断修复是否是正确的库方向:区分“行为确实发生”与“库应当修改”;对照文档、API 语义、类型契约、向后兼容和维护者评论;考虑替代方案如文档澄清、警告、示例更新或按预期行为关闭。涉及产品/API 取舍时先让用户决定。
- 仅在方向确认后做聚焦修复:改动最小实现面,保持公共 API,遵循本地模式,避免大重构与无关改动。
- 验证:先跑原先失败的测试,再跑临近包测试、类型检查或 lint;若可能,把失败场景作为回归测试提交。
- 报告结论:说明是确认缺陷、重复/已修复、不支持用法、文档缺口还是无法定论;给出根因、修复要点、验证命令与结果、测试缺口。
限制与规则:不要先改后推缺陷,编辑前应有失败观察;已复现不代表该改动合理;链接的复现只是证据,需缩为本地测试;多适配器时优先修共享核心;不要执行 git 提交、推送或开 PR,这些交由用户。
常用命令:gh issue view <number> --json title,body,comments,labels,author,state,url;gh search issues "<query>" --repo TanStack/table;gh search prs "<query>" --repo TanStack/table;rg "<api-or-error-text>";pnpm test;pnpm typecheck;pnpm lint。若 package.json 有包级命令,优先使用最小验证命令。