AgentSkillsCN

codacy-issues-fetcher

在 ExStruct 工作区中运行 `scripts/codacy_issues.py`，即可检索并格式化 Codacy 分析问题。适用于用户希望查看仓库或拉取请求中的 Codacy 检测结果时使用，可按严重程度进行筛选，或生成结构化的问题输出，以便于评审与修复计划的制定。

SKILL.md
--- frontmatter
name: codacy-issues-fetcher
description: Retrieve and format Codacy analysis issues by running `scripts/codacy_issues.py` in the ExStruct workspace. Use when users ask to inspect repository or pull-request Codacy findings, filter by severity, or produce structured issue output for review and fix planning.

Codacy Issues Fetcher

Run scripts/codacy_issues.py as the primary interface to Codacy issue retrieval. Avoid reimplementing API calls unless the script itself must be changed.

Workflow

  1. •Confirm prerequisites.
  • •Run from repository root so scripts/codacy_issues.py is reachable.
  • •Ensure CODACY_API_TOKEN is set and valid.
  • •Prefer explicit org and repo if user provides them; otherwise rely on Git origin auto-detection.
  1. •Choose scope and severity.
  • •Repository scope: omit --pr.
  • •Pull request scope: pass --pr <number>.
  • •Severity filter (--min-level): Error, High, Warning, Info.
  • •Provider (--provider): gh, gl, bb (default is effectively gh).
  1. •Run one of the command patterns.
powershell
# Repository issues (explicit target)
python scripts/codacy_issues.py <org> <repo> --provider gh --min-level Warning

# Pull request issues (explicit target)
python scripts/codacy_issues.py <org> <repo> --pr <number> --provider gh --min-level Warning

# Pull request issues (auto-detect org/repo from git origin)
python scripts/codacy_issues.py --pr <number> --min-level Warning
  1. •Parse output JSON and respond with actionable summary.
  • •Trust payload fields: scope, organization, repository, pullRequest, minLevel, total, issues.
  • •issues entries are formatted as: <level> | <file_path>:<line_no> | <rule> | <category> | <message>
  • •Report high-severity findings first, then summarize counts.

Error Handling

  • •HTTP 401 / Unauthorized: token invalid or missing permissions. Ask user to set or refresh CODACY_API_TOKEN.
  • •CODACY_API_TOKEN is not set: export the environment variable before retrying.
  • •Invalid --provider: use only gh, gl, or bb.
  • •Segment validation errors (Invalid org/repo/pr): sanitize input and rerun.

Output Policy

  • •Return concise triage-ready results, not raw command logs.
  • •Include the exact command you used when reproducibility matters.
  • •If no issues match the selected --min-level, state that explicitly.