Skip to content

bird-chinese-community/BIRD.skills / birdcc-cicd

birdcc-cicd

Verified

Build or review GitHub Actions workflows for BIRD 2/3 projects using bird-chinese-community/setup-birdcc and @birdcc/cli. Use for pull-request lint/format/parse checks, BIRD2/BIRD3 matrices, BIRD_BIN, changed config files, pnpm/Turbo caching, submodule configs, action pinning, or .github/workflows changes. Route local config work to bird-agent and local editor/CLI installation to birdcc-installer.

FileKindSize
SKILL.mdskill md2.9 KB
agents/openai.yamlconfig369 B
assets/logo-small.pngbinary2.9 KB
assets/logo.pngbinary6.5 KB
evals/evals.jsonconfig3.6 KB
metadata.jsonconfig490 B
plugin.jsonconfig480 B
references/setup-birdcc.mdmarkdown4.5 KB

references/setup-birdcc.md

View on GitHub
# `setup-birdcc` GitHub Actions Reference

`setup-birdcc` prepares checkout, Node.js, pnpm, dependency and Turbo caches, optional Rust, and an
optional BIRD 2/3 binary. It does not run lint commands and does not guarantee a global `birdcc`.

## Config-only repository

Use an ephemeral CLI and disable dependency/Turbo work:

```yaml
name: BIRD config

on:
  pull_request:
    paths:
      - "**/*.conf"
      - "**/*.bird"
      - "**/*.bird2"
      - "**/*.bird3"
      - "bird.config.json"
      - "birdcc.config.json"
  push:
    branches: [main]
    paths:
      - "**/*.conf"
      - "**/*.bird"
      - "**/*.bird2"
      - "**/*.bird3"
      - "bird.config.json"
      - "birdcc.config.json"

permissions:
  contents: read

jobs:
  validate:
    runs-on: ubuntu-latest
    steps:
      - name: Set up BIRD tooling
        id: setup
        uses: bird-chinese-community/setup-birdcc@v1.0.0
        with:
          bird-version: "2"
          install-dependencies: "false"
          cache-turbo: "false"

      - name: Check formatting
        run: pnpm --package=@birdcc/cli@latest dlx birdcc fmt bird.conf --check

      - name: Lint and parse
        run: pnpm --package=@birdcc/cli@latest dlx birdcc lint bird.conf --bird
        env:
          BIRD_BIN: ${{ steps.setup.outputs.bird-bin }}
```

`pnpm --package=<package> dlx <binary>` unambiguously selects the scoped package and its `birdcc`
binary.

## Locked pnpm project

If `package.json` declares `@birdcc/cli`, keep `install-dependencies` enabled and use the lockfile:

```yaml
- name: Set up BIRD tooling
  id: setup
  uses: bird-chinese-community/setup-birdcc@v1.0.0
  with:
    bird-version: "2"
    cache-turbo: "false"

- run: pnpm exec birdcc fmt bird.conf --check
- run: pnpm exec birdcc lint bird.conf --bird
  env:
    BIRD_BIN: ${{ steps.setup.outputs.bird-bin }}
```

The action resolves and caches the pnpm store when `install-dependencies: "true"`. It then runs
`pnpm install --frozen-lockfile --prefer-offline` by default. There is no `cache-pnpm` input.

Set `cache-turbo: "true"` only for a Turborepo that uses the configured `.turbo` path.

## Existing checkout

The action checks out by default. If another step must control checkout:

```yaml
- uses: actions/checkout@v4
  with:
    fetch-depth: 0
- id: setup
  uses: bird-chinese-community/setup-birdcc@v1.0.0
  with:
    checkout: "false"
```

Keep `fetch-depth: 0` for the `changed-config-files` output.

## BIRD 2/3 matrix

Use a matrix only when the same configuration is intentionally compatible with both majors:

```yaml
strategy:
  fail-fast: false
  matrix:
    bird-version: ["2", "3"]
steps:
  - id: setup
    uses: bird-chinese-community/setup-birdcc@v1.0.0
    with:
      bird-version: ${{ matrix.bird-version }}
      install-dependencies: "false"
      cache-turbo: "false"
  - run: pnpm --package=@birdcc/cli@latest dlx birdcc lint bird.conf --bird
    env:
      BIRD_BIN: ${{ steps.setup.outputs.bird-bin }}
```

If BIRD 2 and BIRD 3 have separate entries, create a matrix object that pairs each version with its
own file instead of testing both binaries against one file.

## Current important inputs

| Input | Default | Meaning |
| --- | --- | --- |
| `checkout` | `true` | Run checkout inside the composite action |
| `fetch-depth` | `0` | Preserve history for changed-file detection |
| `install-dependencies` | `true` | Run the configured pnpm install command |
| `cache-turbo` | `true` | Cache only the Turbo cache path |
| `install-bird` | `true` | Install a BIRD binary on supported runners |
| `bird-version` | `2` | Select BIRD major 2 or 3 |
| `bird-package-source` | `auto` | Select `auto`, `ubuntu`, or `cznic` |
| `submodule-paths` | empty | Shallow-initialize selected config submodules |
| `harden-runner` | `false` | Opt into step-security hardening |

## Outputs

| Output | Use |
| --- | --- |
| `bird-bin` | Set `BIRD_BIN` or invoke the exact binary |
| `bird-version` | Record the installed runtime version |
| `turbo-cache-hit` | Inspect only when Turbo caching is enabled |
| `changed-config-files` | Newline-separated changed BIRD files in PR context |

Do not expand `changed-config-files` with an unquoted shell substitution. Read it line-by-line and
validate paths before passing them to commands.

## Supply-chain choice

- `@v1.0.0`: the currently published readable, immutable release.
- `@v1`: use only after verifying that the movable major tag exists; it was absent during the
  2026-07-29 upstream audit.
- full reviewed commit SHA: strongest pin for protected config repositories.
- `@main`: testing upstream action changes only.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall