Przejdź do treści
Biblioteka skilli
Programowanie · Automatyzacja

ship-feed

/ship-feed

Buduje czytelny kanał wydań z historii commitów, klasyfikuje zmiany według odbiorców i łączy wpisy changelogu z commitami, które je wywołały.

Repozytorium
three.ws ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
13.11.2026

Ocena i bezpieczeństwo

95/ 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ść30 / 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
3
Przestarzałość

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

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co robi i kiedy

Buduje czytelny kanał wydań z historii commitów, klasyfikuje zmiany według odbiorców i łączy wpisy changelogu z commitami, które je wywołały.

Oryginalny opis (EN)

Build a readable release feed from a GitHub repo's commit history, classify commits by audience, and link changelog entries to the commits that produced them. Use for release notes, changelog coverage checks, or explaining why a commit was classified a certain way.

Jak działa

  1. CLI
  2. Library
  3. Audiences
  4. Linking
  5. Worked example
Sekcje z nagłówków SKILL.md, w oryginale · 50 linii, 318 słów
Podgląd SKILL.md
---
name: ship-feed
description: Build a readable release feed from a GitHub repo's commit history, classify commits by audience, and link changelog entries to the commits that produced them. Use for release notes, changelog coverage checks, or explaining why a commit was classified a certain way.
---

# Ship feed

`@three-ws/shipfeed` parses commits (Conventional Commits 1.0.0, reverts, GitHub merge subjects), scores who each is for, and matches changelog entries to commits with no extra metadata. Zero dependencies, Node 18+.

## CLI

```bash
npx @three-ws/shipfeed                          # current repo (from the git origin remote), read from GitHub
npx @three-ws/shipfeed --local                  # read commits from the local clone with git log
npx @three-ws/shipfeed --repo owner/name --limit 300 --branch main
npx @three-ws/shipfeed --changelog https://example.com/changelog.json
npx @three-ws/shipfeed explain <sha>            # why one commit was classified and linked as it was
npx @three-ws/shipfeed stats                    # velocity, audience mix, changelog coverage
npx @three-ws/shipfeed post --telegram --chat <id> --token <t>   # dry run; add --send to deliver
```

Other flags: `--site <url>` (permalink base), `--scopes a,b,c` (scopes that count as product when scoring), `--min-audience holder|developer|internal`, and output modes `--json`, `--markdown`, `--rss`, `--no-color`.

Unauthenticated GitHub allows 60 requests an hour per IP. Pass a token (or set `GITHUB_TOKEN`) to raise it. Never print the token.

## Library

```js
import { shipfeed, parseCommitMessage, classify, linkCommits } from '@three-ws/shipfeed';

const feed = await shipfeed({
  repo: 'owner/name',
  changelogUrl: 'https://example.com/changelog.json',
  siteUrl: 'https://example.com',
  limit: 200,
  productScopes: ['checkout', 'editor'],
});
feed.releases;  // each with .commits (shortSha, headline, confidence, why)
feed.stats;     // includes coverage, 0..1
feed.ships;     // bursts of work never written up
```

## Audiences

`holder` (uses the product), `developer` (builds against it), `internal` (works on it). Merge commits, `chore(deps):` bumps and lockfile-only changes come back `noise: true`.

## Linking

An explicit `Changelog: <slug>` trailer always wins. Otherwise a time window, IDF-weighted term overlap, tag agreement (a `fix` entry prefers `fix:` commits) and proximity decide. Every link carries a score and reasons, so a wrong link is visible. Use `explain <sha>` when a link looks wrong.

## Worked example

To find what shipped but was never announced: run `npx @three-ws/shipfeed stats --repo owner/name --changelog <url>`, read the coverage figure, then run the default report and look at the unlinked `ships`.

Wersje

W bazie nie ma innych skilli o nazwie ship-feed.

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

  • 100changelog-automation
    Automatyzuje generowanie changelogu z commitów, pull requestów i wydań w formacie Keep a Changelog oraz standaryzuje konwencje commitów.
  • 100changelog-automation
    Automatyzuje generowanie changelogu z commitów, pull requestów i wydań w formacie Keep a Changelog oraz standaryzuje konwencje commitów.
  • 100generate-release-notes
    Tworzy kategoryzowane notatki o wydaniu lub wpisy changelogu na podstawie historii gita i komunikatów w formacie Conventional Commits.
  • 95git-commit-pr-message
    Generuje komunikaty commitów, tytuły i opisy PR oraz wpisy changelogu: analizuje zmiany, wymusza Conventional Commits, skanuje wrażliwe treści, łączy zgłoszenia i aktualizuje CHANGELOG.md.
  • 90doncheli-changelog
    Generuje wpisy CHANGELOG.md z historii commitów Git i przygotowuje na tej podstawie notatki o wydaniu.
  • 100changelog-generator
    Tworzy notatki do wydań z Conventional Commits, oblicza kolejną wersję semantyczną z historii commitów i generuje CHANGELOG.md, także w CI.

Uwagi i zgłoszenia

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