mcpField
A
analyse-issue

analyse-issue

github.com/tenfyzhongDevelopment046 installsUpdated 2w ago
Repository

About analyse-issue

A workflow skill for developers analyzing GitHub issues against a local repository. It verifies repository alignment, inspects relevant code, and structures evidence, possible causes, and next steps.

Key features

  1. 01Parse issue URLs or numbers
  2. 02Verify local and remote repository alignment
  3. 03Fetch issue details and comments
  4. 04Search code and trace execution paths
  5. 05Summarize evidence and next steps

Use cases

  1. 01Investigate a reported software defect
  2. 02Check whether an issue matches the current repository
  3. 03Plan tests and fixes for a suspected problem

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/tenfyzhong/skills-hub --skill analyse-issue

After installing, type/analyse-issuein Claude Code to confirm it loaded.

Details

From the project README

Analyse Issue

Overview

Fetch the issue details, verify repo alignment, and inspect the local codebase to confirm or refute the reported problem. Provide an evidence-backed analysis with clear next steps.

Workflow

1) Parse the issue input
  • If input is a GitHub issue URL, extract owner/repo and issue number.
  • If input is just a number, assume the current repo unless the user specifies another repo.
  • If the provider is not GitHub or is unclear, ask for clarification before proceeding.
2) Verify local repo matches the issue
  • Ensure the current directory is inside a git repo (git rev-parse --show-toplevel).
  • Identify the target remote (prefer origin); normalize SSH/HTTPS to owner/repo.
  • If the issue URL repo does not match the local owner/repo, stop and ask the user to switch directories or confirm the target repo.
  • If no remote or multiple candidates exist, ask the user which repo to use.
3) Fetch issue content

Prefer gh when available:

  • gh issue view <num> --json title,body,labels,comments,author,createdAt,updatedAt
  • If URL provided, run against that repo: gh issue view <num> -R owner/repo --json ...

Fallbacks:

  • gh api repos/{owner}/{repo}/issues/{num} and .../comments if you need more fields.
  • If gh is unavailable but GITHUB_TOKEN exists, use curl with the GitHub API.
  • If neither works, ask the user to paste the issue content.

Capture at least: title, body, labels, environment details, repro steps, expected/actual behavior, and key comment insights.

4) Analyze the codebase
  • Translate the issue into concrete signals (keywords, error messages, stack traces, config names).
  • Use rg to locate relevant code, tests, and configs.
  • Trace the execution path: entry points -> core logic -> dependencies.
  • Identify likely failure points: missing checks, edge cases, incorrect assumptions, data shape mismatches, concurrency/timing issues.
  • If appropriate and safe, run focused tests; otherwise propose targeted tests to validate the hypothesis.
5) Confirm or qualify the issue
  • Provide evidence with file references and reasoning.
  • If you can only reason without running tests, state assumptions and confidence.
  • If evidence is insufficient, list the exact missing info needed.
6) Respond with a structured analysis

Include:

  • Issue summary (expected vs actual)
  • Repo match verification
  • Evidence (files/functions)
  • Root-cause hypothesis or confirmed cause
  • Suggested fix approach
  • Questions or missing data
  • Next steps (tests, logs, repro)

Output conventions

  • Respond in the user's language when clear; default to Chinese for Chinese prompts.
  • Keep analysis concise but include concrete file pointers and evidence.
  • Do not claim confirmation without code-based evidence or reproduction.

Comments

Markdown supported