用途:以交互方式调查缺陷报告,随后通过 gh CLI 创建结构清晰的 GitHub Issue。
主要能力与流程:先确认环境,运行 gh auth status 检查认证;如未登录,提示用户先执行 gh auth login 并停止。再用 git remote -v 确认处于带 GitHub 远程仓库的 git 仓库内,否则询问应提交到哪个仓库。
阶段一:逐个问题采访用户,围绕发生了什么、期望行为、复现步骤、环境、出现频率、影响程度,并在已知信息基础上给出推荐答案,能通过代码库回答的就不提问。
阶段二:排查代码库,搜索可能相关的代码路径,查看近期改动(如 git log --oneline -10 -- <file>),总结可疑点、可能原因与建议修复方案。
阶段三:在创建 Issue 前建议 2-4 个相关测试场景,询问用户是否观察到、是否纳入本 Issue 或单独提交。
阶段四:按 Description、Steps to Reproduce、Expected Behavior、Actual Behavior、Possible Suspects、Suggested Solutions、Related Scenarios to Verify、Environment 结构撰写 Issue,先展示标题与正文供用户确认。确认后执行 gh issue create --title "<title>" --body "<body>";正文较长时可写入临时文件并改用 --body-file /tmp/issue-body.md。创建后展示 gh 返回的 Issue URL。
适用场景:已有 GitHub 仓库与 gh CLI 环境,需要把零散缺陷信息整理为规范 Issue 的开发或测试协作流程。
限制:依赖 gh CLI 安装并认证、依赖 git 仓库与 GitHub 远程;未认证时流程终止。资料未提供其他平台支持、费用、权限或离线使用说明。