Przejdź do treści
Biblioteka skilli
DevOps i chmura · Automatyzacja

release-please

/release-please

Pomaga wdrożyć i obsługiwać Release Please do automatycznego wersjonowania, generowania changelogu i wydań GitHub w repozytoriach jednopakietowych i w trybie manifestu.

Repozytorium
dotfiles ↗
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
5
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
2
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 wdrożyć i obsługiwać Release Please do automatycznego wersjonowania, generowania changelogu i wydań GitHub w repozytoriach jednopakietowych i w trybie manifestu.

Oryginalny opis (EN)

Use when adopting or operating Release Please for automated versioning, changelog generation, and GitHub releases in single-package or manifest-mode repositories

Jak działa

  1. When to Use
  2. Choose a Mode
  3. Manifest Identity Model
  4. Prerequisites (Quick)
  5. Quick Start
  6. Lifecycle
  7. Migration from Manual Releases
  8. Common Failure Patterns (Summary)
  9. Guardrails
  10. Quick Verification Checklist
Sekcje z nagłówków SKILL.md, w oryginale · 127 linii, 582 słów
Podgląd SKILL.md
---
name: release-please
description: Use when adopting or operating Release Please for automated versioning, changelog generation, and GitHub releases in single-package or manifest-mode repositories
---

# Release Please

Lean operating guide for `googleapis/release-please` + `googleapis/release-please-action`.

Use this file for **mode selection**, **quick setup**, and **guardrails**.
Use references for **full examples**, **output contracts**, and **troubleshooting detail**.

## When to Use

Use this skill when you need:

- Conventional Commit-driven version bumps and changelog generation
- Automated Release PR creation and GitHub release tagging
- Single-package or monorepo/manifest release orchestration
- Migration off manual tags/changelog/version workflows

## Choose a Mode

- **Single-package mode**: one version stream from repo root.
- **Manifest mode**: independent versions per path/package.

If you have more than one independently-versioned package, use manifest mode.

## Manifest Identity Model

Keep these fields separate:

- `packages` object key: repository-relative package path used for file discovery, manifest versions, and action output prefixes.
- `component`: stable human-facing release identity and default tag prefix.
- `package-name`: release-strategy package identity; many strategies discover it from `package.json`, `Cargo.toml`, or equivalent.
- `include-component-in-tag`: whether tags include the component prefix; keep enabled for independently-versioned monorepo packages.

Example:

```json
"packages/my-module": {
  "component": "my-module",
  "release-type": "node"
}
```

The package key stays `packages/my-module`; the default tag becomes `my-module-v1.2.3`.

## Prerequisites (Quick)

- Conventional Commits in default branch history (`fix:`, `feat:`, `!`/BREAKING)
- Branch/workflow permissions sufficient for PR + release writes
- Workflow trigger on your default release branch (`main`/`master`)

Recommended minimum workflow permissions:

- `contents: write`
- `pull-requests: write`
- `issues: write` (optional but commonly useful)

## Quick Start

### A) Single-package (minimal)

Create `.github/workflows/release-please.yml` with `googleapis/release-please-action@v4` on push to default branch.

### B) Manifest mode

Add:

- `release-please-config.json`
- `.release-please-manifest.json`
- workflow passing `config-file` + `manifest-file`

## Lifecycle

1. Merge Conventional Commit PRs.
2. Release Please opens/updates the Release PR.
3. CI validates release PR.
4. Merge release PR.
5. Action creates tag + GitHub Release.

## Migration from Manual Releases

- Stop manual changelog/tag edits on release-managed branch.
- Seed manifest versions to currently released versions (manifest mode).
- Choose stable component names before first managed release.
- If changing an existing component name, plan tag-history migration; Release Please searches tags using the configured component.
- Merge first Release PR and validate output shape usage in downstream workflow steps.

## Common Failure Patterns (Summary)

- **No release PR**: no releasable commits, wrong branch trigger, stale autorelease labels, or token/permission mismatch
- **Wrong bump**: commit semantics mismatch with Conventional Commit expectations
- **Missing changelog entries**: non-conventional squash titles/commit history
- **Manifest mismatch**: package path keys don’t match actual directories
- **Release history not found**: `component` changed but existing tags still use the old prefix
- **Workflow chain not firing**: using `GITHUB_TOKEN` when downstream workflows require PAT/App token behavior

## Guardrails

- Enforce Conventional Commit linting in CI.
- Keep release ownership explicit (who merges release PRs).
- In monorepos, add package paths incrementally and assign stable, unique components.
- Treat component renames as release migrations, not cosmetic config edits.
- Avoid manual tags/changelog edits in release-managed paths.
- Keep release PRs small and predictable.

## Quick Verification Checklist

- [ ] Workflow triggers on push to tracked branch
- [ ] Permissions are explicitly set
- [ ] Release PR appears after releasable commit
- [ ] Merge creates expected component-prefixed tag and GitHub release
- [ ] Manifest keys remain real repository paths
- [ ] Downstream steps use path-prefixed action outputs, not component-prefixed output keys

## References

### Core upstream

- Release Please: https://github.com/googleapis/release-please
- Release Please Action: https://github.com/googleapis/release-please-action

### Local references (read these for detail)

- `references/setup-examples.md`
- `references/action-outputs.md`
- `references/return-shapes.md`
- `references/troubleshooting.md`
Pliki w paczce (5)
  • SKILL.md 5 KB
  • references/action-outputs.md 3 KB
  • references/return-shapes.md 2 KB
  • references/setup-examples.md 3 KB
  • references/troubleshooting.md 2 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · zenobi-us/dotfiles100MIT
bmad-labs/skills87MIT

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

  • 100release-please-development
    Pomaga skonfigurować release-please do automatycznych wydań, zarządzania numerami wersji, automatyzacji changelogu, semantycznego wersjonowania i wersjonowania monorepo.
  • 100release-versioning-and-changelog-automation
    Ustala schemat wersjonowania (SemVer lub CalVer) i automatyzuje generowanie changelogu oraz tagów wydań z historii commitów, na przykład przez semantic-release lub release-please.
  • 100release-management
    Zarządza wydaniami przez release-please: podbija wersje, generuje changelog i diagnozuje błędy wydań.
  • 100changelog-generation-release-automation
    Automatyzuje wydania oprogramowania, tagi Git i generowanie changelogu przy użyciu release-it i standard-version.
  • 100semantic-versioning
    Automatyzuje wersjonowanie i generowanie changeloga według semantic versioning: konfiguracja automatyzacji wydań, podbijania wersji i narzędzi changelogu.
  • 90working-with-release-please
    Konfiguruje i naprawia release-please: pliki konfiguracji i manifestu, typy wydań, komponenty monorepo i workflow GitHub Action.

Uwagi i zgłoszenia

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