Agent Skills › harumiWeb/exstruct › codacy-issues-fetcher

codacy-issues-fetcher

GitHub

通过运行脚本获取并格式化 Codacy 代码分析缺陷，支持按仓库或 PR 筛选，过滤严重程度，输出结构化问题列表以便审查和修复规划。

.agents/skills/codacy-issues-fetcher/SKILL.md harumiWeb/exstruct

Trigger Scenarios

用户请求检查代码库的 Codacy 发现结果用户要求按严重程度筛选 Codacy 缺陷用户需要生成结构化的问题输出用于修复计划

Install

npx skills add harumiWeb/exstruct --skill codacy-issues-fetcher -g -y

More Options

Non-standard path

npx skills add https://github.com/harumiWeb/exstruct/tree/main/.agents/skills/codacy-issues-fetcher -g -y

Use without installing

npx skills use harumiWeb/exstruct@codacy-issues-fetcher

指定 Agent (Claude Code)

npx skills add harumiWeb/exstruct --skill codacy-issues-fetcher -a claude-code -g -y

安装 repo 全部 skill

npx skills add harumiWeb/exstruct --all -g -y

预览 repo 内 skill

npx skills add harumiWeb/exstruct --list

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

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.

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).

Run one of the command patterns.

# 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

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.