AGENT SKILL

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

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