Przejdź do treści
Biblioteka skilli
Programowanie · Testowanie

cli-analysis

/cli-analysis

Uruchamia narzędzie pyscn do analizy jakości kodu Pythona: bramki jakości w CI/CD, raporty HTML, JSON i CSV, pełne analizy i konfigurację projektu.

Repozytorium
pyscn ↗
Licencja
MIT
Ostatnia zmiana repozytorium
26.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 26.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Uruchamia narzędzie pyscn do analizy jakości kodu Pythona: bramki jakości w CI/CD, raporty HTML, JSON i CSV, pełne analizy i konfigurację projektu.

Oryginalny opis (EN)

Run the pyscn command-line tool for Python code quality analysis - CI/CD quality gates, HTML/JSON/CSV reports, full analysis runs, and project configuration. Use when user wants a CI check, a shareable report file, or to configure pyscn for a project.

Jak działa

  1. Commands
  2. analyze — full analysis and reports
  3. check — CI quality gate
  4. Configuration
  5. Reporting Results
Sekcje z nagłówków SKILL.md, w oryginale · 57 linii, 405 słów
Podgląd SKILL.md
---
name: cli-analysis
description: Run the pyscn command-line tool for Python code quality analysis - CI/CD quality gates, HTML/JSON/CSV reports, full analysis runs, and project configuration. Use when user wants a CI check, a shareable report file, or to configure pyscn for a project.
---

# Python Code Quality Analysis with the pyscn CLI

Use the `pyscn` command-line tool when the task needs report files, CI integration, or project configuration.

No install needed: `uvx pyscn@latest <command>` (or `pip install pyscn` for a permanent install).

## Commands

| Command | Purpose |
|---------|---------|
| `pyscn analyze <path>` | Comprehensive analysis: complexity, dead code, clones, coupling (CBO), cohesion (LCOM), dependencies, architecture |
| `pyscn check <path>` | Fast pass/fail quality gate for CI with predefined thresholds |
| `pyscn init` | Generate a `.pyscn.toml` config file |

## analyze — full analysis and reports

```bash
pyscn analyze .                          # human-readable summary + health score
pyscn analyze --json src/                # also write a JSON report file
pyscn analyze --html src/                # interactive HTML report
pyscn analyze --select complexity,deadcode src/   # only specific analyses
pyscn analyze --skip-clones src/         # clones are the slowest analysis
pyscn analyze --min-complexity 10 --min-severity critical src/
```

Key flags:
- `--json` / `--html` / `--csv` / `--yaml`: generate a report file
- `--select`: `complexity,deadcode,clones,cbo,lcom,deps,communities`
- `--skip-clones`, `--skip-cbo`, `--skip-deps`, ...: skip individual analyses
- `--clone-threshold` (default 0.65), `--min-complexity` (default 5), `--min-cbo`
- `--no-open`: don't auto-open HTML reports in a browser (use in scripts)

**Report files are NOT written to stdout.** They go to `.pyscn/reports/` under the current working directory with timestamped names like `analyze_20260702_221139.json`, and the path is printed on completion. To consume results programmatically: run with `--json`, capture the printed path (or take the newest file in `.pyscn/reports/`), then read that file.

## check — CI quality gate

```bash
pyscn check .                                        # complexity + deadcode + clones
pyscn check --select complexity --max-complexity 10 src/
pyscn check --select deps src/                       # fail on circular dependencies
pyscn check --allow-dead-code --skip-clones src/
pyscn check -q .                                     # quiet: output only on issues
```

Exit codes: `0` no issues, `1` quality issues found, `2` analysis failed (invalid input, missing files). Default gates: complexity > 10 fails, critical dead code fails, clones warn only, dependency cycles fail.

`--select` accepts: `complexity`, `deadcode`, `clones`, `deps`, `mockdata`, `di` (dependency-injection anti-patterns).

## Configuration

Settings load in priority order: command-line flags > `.pyscn.toml` > `[tool.pyscn]` in `pyproject.toml` > defaults. Run `pyscn init` to scaffold `.pyscn.toml` when a project wants persistent thresholds.

## Reporting Results

Summarize the health score and grade, list the specific functions/files behind each failing category, and suggest fixes. For CI setup, recommend `pyscn check` in the pipeline and `pyscn analyze --html` for periodic deep reviews.

Wersje

RepozytoriumWynikLicencja
Ta strona · ludo-technologies/pyscn100MIT
ludo-technologies/polyscan100MIT

Migawka bazy z 13.11.2026 · wersja paczki daf5b2284608 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100health-check
    Podaje ogólną ocenę zdrowia jakości kodu Pythona narzędziem pyscn: przegląd jakości, ocena, podsumowanie długu technicznego i porównanie przed i po.
  • 90refactoring
    Szuka w kodzie Python celów refaktoryzacji: duplikaty, zbyt złożone funkcje i martwy kod, przy użyciu narzędzia pyscn.
  • 100quality-constraints
    Zestawia bramki jakości, które repozytorium już uruchamia, albo pisze krótki plik ograniczeń dla nowego projektu.
  • 100quality-gate
    Uruchamia adaptacyjne bramki jakości z automatycznym wykrywaniem bazy odniesienia i zapisem dowodów przed PR.
  • 100code-review-specialist
    Przeprowadza przegląd kodu z analizą bezpieczeństwa, wydajności i jakości, przy ocenie pull requestów i jakości kodu.
  • 95qc
    Pilnuje jakości kodu: bramki jakości, analiza statyczna, standardy, przeglądy i dług techniczny.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.