ci
Debug and change repository CI workflows. Use for triggers, checks, promotion, release, or workflow failures.
- License 许可
- Apache-2.0
- 最近更新
- 2026-10-16
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- ci
- metadata
- { "source-of-truth": [ ".github/workflows/", ".github/workflows/pr-validation.yml", ".github/workflows/build-image-testing.yml" ] }
- description
- Debug and change repository CI workflows. Use for triggers, checks, promotion, release, or workflow failures.
02 资源文件 2
- 参考文档references/failure-modes.md497 B
- 参考文档references/workflow-map.md337 B
03 SKILL.md 正文
CI
Use when
- A workflow failed, did not start, or ran the wrong checks.
- A trigger, permission, path filter, or reusable workflow call changes.
Do not use when
- The issue is purely local validation: use build.
- The change is package placement: use packages.
- The change is release procedure: use release-artifacts.
First checks
gh run list --repo projectbluefin/bluefin --limit 20
gh run view RUN_ID --repo projectbluefin/bluefin --log-failed
gh run rerun RUN_ID --repo projectbluefin/bluefin --failed-only
Read the actual workflow before describing or changing its behavior. Shared logic belongs in the reusable workflow that owns it; callers should stay thin.
Hard rules
- Verify the pull request base branch before debugging missing checks.
- Preserve action pinning and workflow permissions.
- Do not add PAT-based authentication.
- Keep end-to-end suites on their configured event.
- Update this skill when workflow behavior changes.
Verification
actionlint .github/workflows/*.yml
just check
pre-commit run --all-files
For a completed run:
gh run watch RUN_ID --repo projectbluefin/bluefin --exit-status
References
When to Use
Use for Workflow failures, triggers, permissions, or promotion checks.
When NOT to Use
Do not use for Pure local build or package decisions.
Core Process
Read the affected YAML, identify the owning reusable workflow, validate locally.
Common Rationalizations
- "A shortcut is harmless." Follow the source-of-truth and verification rules instead.
Red Flags
- Changing a caller when the behavior belongs in shared workflow logic.
04 同仓库更多 Skills
variants
Determine the correct image, stream, flavor, branch, and workflow target.
skill-improvement
Add, refactor, validate, and maintain agent skills without duplicating facts.
setup-hook-tests
Add or extend Bats coverage for setup-hook scripts.
security
Review image supply-chain, signing, COPR, and secure-boot changes.
release-artifacts
Prepare, verify, or troubleshoot image release and promotion artifacts.
packages
Add, remove, or classify RPM, Flatpak, COPR, and Homebrew inputs.