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.
- Autor
- nirholas ↗
- Repozytorium
- three.ws ↗
- Licencja
- Apache-2.0
- Ostatnia zmiana repozytorium
- 13.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 3
Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.
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
- CLI
- Library
- Audiences
- Linking
- Worked example
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.