setup-ci-quality-gates
Set up CI quality gates and architecture checks on GitHub Actions, and reproduce those gates locally via a ci.sh mirror. Use when creating workflows, branch protection rulesets, auto-merge, AI review layers, or building scripts/ci.sh to mirror .github/workflows when GitHub Actions is quota-blocked.
- License 许可
- MIT
- 最近更新
- 2026-11-15
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- setup-ci-quality-gates
- metadata
- { "tags": [ "ci", "github-actions", "quality-gates", "code-review", "cubic", "repowise", "rust", "python", "typescript", "self-lint", "architecture", "aes" ], "triggers": [ "setup ci", "quality gates", "ci pipeline", "code review bot", "architecture enforcement", "replicate ci", "branch protection", "self-lint", "local ci", "run ci locally", "ci.sh", "mirror workflow", "reproduce gates", "offline ci", "self-hosted runner" ], "related_skills": [ "lint-arwaky", "add-docs", "testing-suite" ] }
- description
- Set up CI quality gates and architecture checks on GitHub Actions, and reproduce those gates locally via a ci.sh mirror. Use when creating workflows, branch protection rulesets, auto-merge, AI review layers, or building scripts/ci.sh to mirror .github/workflows when GitHub Actions is quota-blocked.
- when-to-use
- Use when replicating this repo's CI setup: ci.yml jobs, branch-protection ruleset, auto-merge workflow, AI review layers (cubic, Repowise), local scripts/ci.sh that mirrors the remote workflow, or running the same CI gates locally in a container when GitHub Actions is quota/billing-blocked.
- argument-hint
- [<repo-root>]
02 资源文件 8
- 参考文档references/ai-review-layers.md1.3 KB
- 参考文档references/auto-merge.yml.md1.3 KB
- 参考文档references/branch-protection.md679 B
- 参考文档references/ci-workflow.md1.8 KB
- 参考文档references/container-image.md2.3 KB
- 参考文档references/local-ci.md6.6 KB
- 参考文档references/self-lint.md1.5 KB
- 参考文档references/verify-runtimes.md967 B
03 SKILL.md 正文
CI Quality Gates System
Replicate the CI setup used by this repo: quality gates enforced by GitHub Actions + a branch-protection ruleset, architecture enforcement via the project's own linter (self-lint), and two AI review layers (cubic, Repowise). This is a copy-and-extend blueprint, not a one-off checklist — adapt names and paths to the target repo.
Language-agnostic. The pattern (quality gates → branch protection → AI review) applies to any language. The commands below are this repo's Rust flavor; substitute per language:
| Concern | Rust | Python | TypeScript/JS |
|---|---|---|---|
| Format | cargo fmt --check |
ruff format --check |
prettier --check |
| Lint | cargo clippy -D warnings |
ruff check + mypy |
eslint + tsc --noEmit |
| Tests | cargo nextest run |
pytest |
vitest / jest |
| Security deps | cargo audit |
bandit + pip-audit |
npm audit / eslint-plugin-security |
| Build | cargo build --release |
python -m build |
tsc / vite build |
The self-lint job is the one part that is inherently project-specific: it
runs this linter (lint-arwaky-cli) on the repo's own multi-language
workspace (crates/, modules/, packages/).
Architecture overview
PR opened / pushed
│
├─ CI workflow (.github/workflows/ci.yml)
│ ├─ Format (cargo fmt --check)
│ ├─ Clippy (cargo clippy -D warnings)
│ ├─ Build (cargo build --release)
│ ├─ Tests (cargo nextest run)
│ └─ Self-Lint (lint-arwaky-cli check . == 0 violations)
│
├─ cubic AI reviewer (www.cubic.dev) — ultrareview
└─ Repowise bot (.repowise/bot.yaml) — health gate advisory
│
└─ Ruleset "Protect main" (GitHub rulesets)
├─ required_status_checks: Format, Clippy, Build, Tests,
│ Self-Lint
├─ strict: true (must be up to date)
├─ non_fast_forward + deletion: blocked
└─ auto-merge workflow (squash) merges when all pass
```text
## 1. GitHub Actions workflow (.github/workflows/ci.yml)
Five jobs on `ubuntu-latest` (Rust flavor shown; see the table at the top
for Python/TypeScript equivalents). Cache with sccache + Swatinem/rust-cache.
| Job | Command | Notes |
|---|---|---|
| `fmt` | `cargo fmt --all -- --check` | rustfmt component only |
| `clippy` | `cargo clippy --all-targets -- -D warnings` | clippy component; install `mold` linker |
| `build` | `cargo build --release` | needs: build for downstream |
| `test` | `cargo nextest run --workspace --lib --tests -j 2` | needs: build; install nextest via curl |
| `self-lint` | `lint-arwaky-cli check .` == 0 violations | needs: build; also assert ≥24 AES codes on `workspaces-bad` |
Key env in `.github/workflows/ci.yml`: `RUSTC_WRAPPER=sccache`,
`CARGO_BUILD_JOBS=4`, `RUST_MIN_STACK=33554432`. (`CARGO_INCREMENTAL=0`
belongs in `scripts/ci.sh` for local runs, not in the workflow.)
### Self-lint job (architecture enforcement)
The differentiator: CI fails if the repo violates its own architecture
rules — the `self-lint` job asserts zero whole-repo violations plus the
AES rule engine still firing all 24 codes on the intentional-violation
fixture workspace (`workspaces-bad`), catching a linter that silently
stops detecting anything.
See `references/self-lint.md` for the job script (exit-code-authoritative
check, fixture assertion, and the `cargo build --release` prerequisite).
## 2. Branch protection: GitHub Ruleset
Create a ruleset "Protect main - quality gates" (Settings → Rules →
Rulesets), `target: branch`, enforcement `active`:
- **required_status_checks**: Format, Clippy, Build, Tests, Self-Lint —
with `strict: true` (requires up-to-date).
- **non_fast_forward**: blocked.
- **deletion**: blocked.
Effect: no direct push to `main`; every change must go through a PR that
passes all gates. (This is why all work here uses worktrees + PRs.)
## 3. Auto-merge (.github/workflows/auto-merge.yml)
See `references/auto-merge.yml.md` for the squash-merge workflow and
PR-metadata env-var rules.
## 4. AI review layers
See `references/ai-review-layers.md` for cubic and Repowise configuration.
## 5. Local quality gates (scripts/ci.sh)
Reproduce CI locally before pushing — the pre-push hook runs the same
gates (Rust flavor; swap commands per language from the table at the top):
```bash
bash scripts/ci.sh # fmt + clippy + self-lint + AES codes + tests
CARGO_INCREMENTAL=0 cargo clippy --workspace --all-targets -- -D warnings
cargo nextest run --workspace --lib --tests
lint-arwaky-cli check . # whole repo, must be 0 violations
scripts/ci.sh should also accept --container and run the identical gates
inside a Podman/Docker image where every dependency, browser, and the linter
are baked in. That removes the hosted-runner quota as a merge dependency.
See references/local-ci.md for the full local-mirror procedure (script
structure, container image design, runtime verification, and the version-drift
pitfall that makes local runs disagree with CI), merged from the former
local-ci skill.
6. Supporting workflows
| Workflow | Purpose |
|---|---|
release.yml |
Build release binaries, smoke-test, attest-build-provenance |
release-tag.yml |
Tag release PRs |
auto-release.yml |
Release on workflow_run after merge |
cleanup-branches.yml |
Delete merged branches |
labeler.yml |
Auto-label PRs (uses actions/labeler) |
Checklist — replicate on a new repo
- [ ]
.github/workflows/ci.ymlwith fmt/clippy/build/test/self-lint jobs - [ ] Self-lint job runs the project's own linter, fails on violations
- [ ] Ruleset on
main: required status checks + strict + no fast-forward - [ ] Auto-merge workflow (squash) gated on the same checks
- [ ] cubic + Repowise apps installed on the repo
- [ ]
.repowise/bot.yaml+.repowiseIgnore+health-rules.json - [ ]
scripts/ci.shmirrors CI for local run + pre-push hook (seereferences/local-ci.md) - [ ] Release/labeler/cleanup workflows if the release train is needed
Routing
| Reference | Purpose |
|---|---|
references/branch-protection.md |
GitHub Ruleset and required status checks |
references/ci-workflow.md |
The five CI jobs (fmt, clippy, build, test, self-lint) |
references/container-image.md |
Container image design for local CI mirroring |
references/self-lint.md |
Self-lint job script and AES rule assertion |
references/auto-merge.yml.md |
Squash-merge auto-merge workflow |
references/ai-review-layers.md |
cubic and Repowise configuration |
references/local-ci.md |
Local quality gates mirror via scripts/ci.sh |
references/verify-runtimes.md |
Runtime version verification |
04 同仓库更多 Skills
github-workflow
Umbrella for GitHub auth, repo management, issues, PRs, Mergify, and releases. Subsumes github-auth and repo-manager.
brave-automation
baa CLI: Brave profiles, Google sessions, credentials.
aes
AES docs, layers, rule fixes, and legacy migration.
pretext
Build creative browser demos with DOM-free text layout.
popular-web-designs
54 real design systems (Stripe, Linear, Vercel) as HTML/CSS.
p5js
p5.js sketches: gen art, shaders, interactive, 3D.