English | 日本語
Reusable GitHub Actions workflows shared across nozomiishii projects.
The recommended entry point: runs PR title validation, secret scan, and workflow lint (actionlint + zizmor) in one ubuntu-slim job. GitHub Actions bills per job with per-minute rounding, so sub-minute checks split across workflows multiply billable minutes; this preset reports a single required check (recommended / required) instead. Each check step runs with if: ${{ !cancelled() }}, so one failing check doesn't hide the others' findings.
PR title validation lints the title with the config bundled in @nozomiishii/commitlint-config. The workflow installs that package's nozo-commitlint CLI at a pinned version and runs it without --config, so the caller repo needs no commitlint.config.ts, no package.json, and no node_modules — a repo with nothing but workflow files passes the check. Rules live in a single place, and a rule change reaches callers when they bump the workflow ref.
On push / workflow_dispatch events only the secret scan runs — PR title validation and workflow lint are gated to pull_request events.
The job runs on ubuntu-slim by default. Callers can override the runner label with the runs-on input (e.g. with: { runs-on: self-hosted }). Keep the default GitHub-hosted runner in public repos — GitHub discourages self-hosted runners on public repositories.
name: recommended
on:
workflow_dispatch:
push:
branches: [main]
pull_request:
types: [opened, edited, reopened, synchronize]
concurrency:
# split by action so edited and synchronize runs on the same commit do not cancel each other
group: ${{ github.workflow }}-${{ github.ref }}-${{ github.event.action }}
cancel-in-progress: true
permissions: {}
jobs:
recommended:
permissions:
contents: read # required by actions/checkout
pull-requests: write # write: format revert PR titles, read: fetch PR titles / list PR files (dorny/paths-filter)
actions: read # required by zizmor persona audits and referenced_workflows resolution
uses: nozomiishii/workflows/.github/workflows/recommended.yaml@<sha> # vX.Y.ZVersions follow Conventional Commits + Release Please. Pin callers by SHA with the tag name in a trailing comment so Renovate can suggest upgrades:
uses: nozomiishii/workflows/.github/workflows/recommended.yaml@<sha> # v4.0.0MIT
