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

maintain-ci

/maintain-ci

Zmienia i przegląda workflow GitHub Actions NeMo Relay, gdy wymagają tego uprawnienia, przypięte akcje, cache, reużywalne workflow lub bramki wydań.

Repozytorium
nemo-relay ↗
Licencja
Apache-2.0
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

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

Co robi i kiedy

Zmienia i przegląda workflow GitHub Actions NeMo Relay, gdy wymagają tego uprawnienia, przypięte akcje, cache, reużywalne workflow lub bramki wydań.

Oryginalny opis (EN)

Change or review NeMo Relay GitHub Actions workflows where permissions, pinned actions, caching, reusable workflows, or release gates require repository-specific handling. Do not use for ordinary source changes that merely run in CI.

Jak działa

  1. Standards
  2. Permission Model
  3. Caching
  4. Review Checklist
  5. Validation
  6. Canonical References
Sekcje z nagłówków SKILL.md, w oryginale · 90 linii, 526 słów
Podgląd SKILL.md
---
name: maintain-ci
description: Change or review NeMo Relay GitHub Actions workflows where permissions, pinned actions, caching, reusable workflows, or release gates require repository-specific handling. Do not use for ordinary source changes that merely run in CI.
license: Apache-2.0
---


# Maintain GitHub Actions CI

Use this skill when a change touches `.github/workflows/*.yml` or
`.github/workflows/*.yaml`, or when reviewing CI behavior for security,
reliability, or reproducibility.

## Standards

- Put `permissions:` on each job that needs token access.
- Avoid workflow-level permissions unless the repository intentionally centralizes
  them and the inheritance tradeoff is documented.
- Keep third-party actions pinned to full commit SHAs and preserve the readable
  version comment after the SHA.
- Prefer action-native or ecosystem-native caching over generic
  `actions/cache`.
- Use lockfiles or dependency manifests to drive cache invalidation.
- Keep deploy and publish permissions isolated to the jobs that need them.
- Read both caller and callee when a workflow uses `workflow_call`.
- Put release-tag validation in the earliest practical caller job when the
  pipeline has tag-based publish behavior.
- Keep release-tag policy aligned with `RELEASING.md`: raw SemVer tags only,
  no leading `v`.
- Keep Codecov component paths aligned with new crates, packages, and generated
  outputs. Dynamic plugin SDK/protocol paths belong in the plugin component.
- Keep pure-Python plugin SDK packaging as a single wheel artifact instead of
  duplicating it across every platform matrix entry.

## Permission Model

- `contents: read` is the default minimum for checkout-based build, test, docs,
  and packaging jobs.
- `pull-requests: read` is required for PR metadata lookup jobs.
- `pages: write` and `id-token: write` should be limited to Pages deployment
  jobs and any caller that invokes them through a reusable workflow.
- For reusable workflows, the caller must grant every permission the called
  jobs require. The callee cannot elevate beyond what the caller provides.

## Caching

- Prefer `astral-sh/setup-uv` cache support with `cache-dependency-glob`
  anchored to `uv.lock`.
- Prefer `Swatinem/rust-cache` with explicit `shared-key` and `workspaces`
  instead of ad hoc target-directory caching.
- Avoid caching generated outputs that can hide stale behavior unless the repo
  already relies on them deliberately.

## Review Checklist

- [ ] Each job has the minimum permissions it needs
- [ ] Reusable workflow callers grant only the scopes their callees require
- [ ] Every external action is pinned to a full SHA
- [ ] Cache settings are tied to lockfiles, manifests, or explicit tool versions
- [ ] Secrets are only passed to the jobs that consume them
- [ ] Codecov upload counts match `codecov.yml` after adding or removing upload
      jobs
- [ ] Package artifacts include any first-class SDK packages introduced by the
      change
- [ ] Concurrency, branch filters, and publish guards still reflect release intent
- [ ] Artifact upload, download, and Pages deploy steps have matching permissions
- [ ] Tag-triggered release workflows fail early when a tag violates repo policy

## Validation

Start with the narrowest useful checks:

```bash
ruby -e 'require "yaml"; Dir[".github/workflows/*.{yml,yaml}"].each { |f| YAML.load_file(f) }; puts "yaml-ok"'
uv run pre-commit run
```

Use ripgrep to inspect the workflow graph before editing:

```bash
rg -n "uses:|permissions:|workflow_call|secrets:|upload-artifact|download-artifact|upload-pages-artifact|deploy-pages|codecov|cache" .github/workflows
```

If local lint passes but the question is whether GitHub will authorize the run,
inspect GitHub's permission model and the upstream action or reusable workflow
source instead of assuming local success proves remote success.

## Canonical References

- `.github/workflows/ci.yaml`
- `.github/workflows/ci_python.yml`
- `RELEASING.md`
- `.pre-commit-config.yaml`
- `.github/ci-path-filters.yml`

Wersje

W bazie nie ma innych skilli o nazwie maintain-ci.

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

  • 100ghactions
    Obsługuje workflowy GitHub Actions, własne akcje i CI/CD: build matrix, reużywalne workflowy, akcje kompozytowe, cache i utwardzanie bezpieczeństwa.
  • 100github-actions
    Obejmuje GitHub Actions: YAML workflow, runnery, reużywalne workflow, akcje composite, uwierzytelnianie OIDC, macierze buildów, cache, sekrety i środowiska.
  • 100maintain-packaging
    Dodaje i zmienia pakiety NeMo Relay, metadane, ścieżki modułów, generowane artefakty i powierzchnie budowania wydań, w tym rejestrację w automatyzacji wersji.
  • 100github-actions
    Generuje workflow GitHub Actions: potoki CI/CD, wydania, buildy Dockera, reużywalne workflow, akcje composite i dependabot, z debugowaniem i wzmacnianiem bezpieczeństwa.
  • 100github-actions
    Tworzy i naprawia CI/CD w GitHub Actions: workflowy w .github/workflows, wyzwalacze, macierze zadań, cache, uprawnienia tokenów, wdrożenia chmurowe przez OIDC, bramki środowisk i workflowy wielokrotnego użytku.
  • 100github-actions-pipeline
    Projektuje, pisze i naprawia workflow GitHub Actions: wyzwalacze, współbieżność, cache, macierze, minimalne uprawnienia, wdrożenia z OIDC oraz diagnozę wolnych lub niestabilnych uruchomień.

Uwagi i zgłoszenia

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