Przejdź do treści
Biblioteka skilli
Programowanie · Przegląd i audyt

version-sentinel

/version-sentinel

Pomaga przy dodawaniu lub zmianie zależności w manifestach projektu i zapisuje wynik sprawdzenia wersji.

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

Pomaga przy dodawaniu lub zmianie zależności w manifestach projektu i zapisuje wynik sprawdzenia wersji.

Oryginalny opis (EN)

Use when adding, bumping, or changing a dependency in package.json, requirements*.txt, constraints*.txt, pyproject.toml, Cargo.toml, *.csproj, *.fsproj, or *.vbproj. Triggered automatically by version-sentinel's PreToolUse hook (where the host supports hooks) — this skill explains how to satisfy the block and record a version check.

Jak działa

  1. When you see a BLOCKED message
  2. Intentional non-latest pins
  3. What NOT to do
  4. Audit command
Sekcje z nagłówków SKILL.md, w oryginale · 45 linii, 358 słów
Podgląd SKILL.md
---
name: version-sentinel
description: Use when adding, bumping, or changing a dependency in package.json, requirements*.txt, constraints*.txt, pyproject.toml, Cargo.toml, *.csproj, *.fsproj, or *.vbproj. Triggered automatically by version-sentinel's PreToolUse hook (where the host supports hooks) — this skill explains how to satisfy the block and record a version check.
---

# Version Sentinel — Workflow

The `version-sentinel` setup blocks dependency changes until you've verified the package version against its upstream registry. Here's the required flow. (On hosts without hook support, such as Zed, this same flow applies manually — follow it whenever you touch a manifest or run an install command.)

## When you see a BLOCKED message

If a tool call exits 2 with `BLOCKED: version-sentinel`, you must:

1. **Look up the latest version.** Use a web search first:
   - `npm`:      search `"<pkg> latest version site:npmjs.com"`
   - `pip`/`pyproject`: search `"<pkg> latest version site:pypi.org"`
   - `csproj`:   search `"<pkg> latest version site:nuget.org"`
   - `cargo`:    search `"<pkg> latest version site:crates.io"`

   If web search is unavailable, fetch the registry URL directly, or consult a docs tool (e.g. context7) for the package.

2. **Record the check.** Run in the terminal:

       bash scripts/vs-record.sh <ecosystem> <pkg> <version-you-intend-to-install> <source-url>

   The source must be an `http(s)://` URL from your search OR prefixed with `intentional:` for deliberate pins.

3. **Retry with the verified version.** If the blocked input omitted the version or used a floating tag such as `latest`, rewrite it first. For example, use `npm install lodash@4.17.21`, not `npm install lodash` or `npm install lodash@latest`.

Local paths, URLs, git sources, and workspace dependencies are outside registry-version checks. A NuGet `PackageReference` without `Version` may use Central Package Management, so the manifest gate ignores that form.

## Intentional non-latest pins

If you genuinely intend to install an older version (CVE mitigation, compat, private registry), record with:

    bash scripts/vs-record.sh <ecosystem> <pkg> <version> "intentional: <brief reason>"

This passes the hook and is flagged as `intentional-pin` (not `DRIFT`) in `bash scripts/check-versions.sh` output.

## What NOT to do

- Don't fake a source URL you didn't actually see. The skill contract assumes honest reporting.
- Don't try to bypass the hook with `git commit --no-verify` or similar — the hook runs on file edits and terminal commands, not on git.
- Don't `unset VS_DISABLE` without the user's awareness; that's an escape hatch for throwaway sessions, not normal flow.

## Audit command

`bash scripts/check-versions.sh` scans manifests within 4 directory levels of the current directory and reports drift. Run it before tagging a release.

Wersje

RepozytoriumWynikLicencja
Ta strona · ksegit/version-sentinel100MIT
ksegit/version-sentinel100MIT

Migawka bazy z 13.11.2026 · wersja paczki 2dde9466eae6 (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

  • 100evaluate-dependency
    Ocenia dodanie zależności do projektu w dowolnym języku, porównuje alternatywy i wersje oraz przegląda zmiany w manifestach (go.mod, package.json, pyproject.toml, Cargo.toml i inne).
  • 100python-best-practices
    Podaje dobre praktyki przy czytaniu i pisaniu plików Python, w tym pyproject.toml i requirements.txt.
  • 100scan-before-add
    Sprawdza kandydatów na biblioteki przed dodaniem zależności do manifestów projektu, uruchamiając uzomuzo scan i zostawiając zapis tego, kto i co zatwierdził.
  • 100bump-version
    Podbija wersję pakietu membrowse w pyproject.toml i manifestach wtyczek, otwiera PR, czeka na CI i scala go.
  • 100managing-cargo-dependencies
    Opisuje wzorce zarządzania zależnościami w Cargo.toml dla workspace HASH: dodawanie, aktualizację i usuwanie zależności, układ sekcji, przypinanie wersji, domyślne cechy i zależności publiczne.
  • 90python-tooling
    Konfiguruje narzędzia Pythona, powierzchnie zależności, analizę statyczną i bramki weryfikacji przy edycji pyproject.toml, requirements.txt, pytest.ini, ruff, pyright, CI i kontroli wydań.

Uwagi i zgłoszenia

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