关于 analyse-issue
这是一个帮助开发者分析 GitHub Issue 的工作流技能，会先核对 Issue 与本地仓库是否匹配，再检查代码以验证或评估问题。输出包括证据、可能原因、修复方向和后续验证步骤。
主要功能
- 01解析 Issue 链接或编号
- 02核验本地仓库与远程仓库
- 03获取 Issue 内容与评论
- 04检索代码并追踪执行路径
- 05整理证据、原因与后续步骤
适用场景
- 01分析报告中的软件缺陷
- 02确认 Issue 是否对应当前代码库
- 03为问题定位制定测试与修复计划
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/analyse-issue确认已加载。
详细介绍
分析 Issue
概览
获取 Issue 详情，确认仓库是否匹配，并检查本地代码库，以核实或排除所报告的问题。提供有明确证据支持的分析，并说明清晰的后续步骤。
工作流程
1）解析 Issue 输入
- 如果输入是 GitHub Issue URL，提取所有者、仓库和 Issue 编号。
- 如果输入只有编号，除非用户指定其他仓库，否则使用当前仓库。
- 如果提供方不是 GitHub 或不明确，先询问用户以澄清。
2）确认本地仓库与 Issue 匹配
- 确认当前目录位于 Git 仓库内（
git rev-parse --show-toplevel）。 - 确定目标远程仓库（优先使用
origin）；将 SSH/HTTPS 地址规范化为owner/repo。 - 如果 Issue URL 中的仓库与本地的
owner/repo不匹配，请停止并让用户切换目录或确认目标仓库。 - 如果没有远程仓库或存在多个候选项，请询问用户要使用哪个仓库。
3）获取 Issue 内容
如果可用，优先使用 gh：
gh issue view <num> --json title,body,labels,comments,author,createdAt,updatedAt- 如果提供了 URL，则针对该仓库运行：
gh issue view <num> -R owner/repo --json ...
备用方式：
- 如果需要更多字段，使用
gh api repos/{owner}/{repo}/issues/{num}和.../comments。 - 如果
gh不可用但存在GITHUB_TOKEN，则使用curl调用 GitHub API。 - 如果两者都无法使用，请让用户粘贴 Issue 内容。
至少记录：标题、正文、标签、环境详情、复现步骤、预期行为与实际行为，以及评论中的关键信息。
4）分析代码库
- 将 Issue 转化为具体线索（关键词、错误消息、堆栈跟踪、配置名称）。
- 使用
rg定位相关代码、测试和配置。 - 跟踪执行路径：入口点 -> 核心逻辑 -> 依赖项。
- 找出可能的故障点：缺少检查、边缘情况、错误假设、数据结构不匹配、并发/时序问题。
- 如适当且安全，运行针对性测试；否则提出验证假设所需的目标测试。
5）确认问题或说明判断条件
- 提供文件引用和推理作为证据。
- 如果只能通过推理分析而未运行测试，请说明假设和置信度。
- 如果证据不足，请列出确切的缺失信息。
6）以结构化分析作答
包括：
- Issue 摘要（预期行为与实际行为）
- 仓库匹配验证
- 证据（文件/函数）
- 根因假设或已确认的原因
- 建议的修复方案
- 问题或缺失数据
- 后续步骤（测试、日志、复现）
输出规范
- 用户语言明确时使用该语言作答；中文提示默认使用中文。
- 分析应简洁，但须提供具体的文件路径和证据。
- 未经代码证据或复现验证，不要声称问题已确认。
评论
支持 Markdown