본문으로 건너뛰기
cccskills
무료GitHub에 공개

troubleshooting

Symptom to cause to fix for build, CI, and runtime failures, plus the pre-commit checklist. Use when something is broken or before opening a pull request.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

projectbluefin/finpilot스타 129(GitHub 129 + cccskills 0)

실행 점수 미검증

설치 방법 보기

포함된 파일(1)

  • SKILL.md2.4 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

Troubleshooting

Before a pull request

  • Conventional Commit message.
  • just lint — shellcheck on every tracked script.
  • just check — Justfile syntax.
  • just test-unit — the suite.
  • just validate-brewfiles / just validate-flatpaks if those changed.
  • just build if the image changed.

CI runs the same checks; running them locally only makes the pull request quiet.

Build

SymptomCauseFix
bootc container lint fails on a nonempty /runa script wrote to /run into an image layerremove it in 90-cleanup.sh; that phase deliberately does not mount /run as tmpfs
a third-party repository is live in the final imagea script enabled it and did not disable ituse copr_install_isolated, or disable it explicitly
the package layer rebuilds on every overlay editpackages drifted into the overlay phasekeep packages in 20-packages-and-services.sh
hadolint flags the Containerfilea rule in .github/hadolint.yamlfix it, or add a suppression with a reason

CI

SymptomCauseFix
validate never runsbranch protection names a check no workflow producesthe context must be exactly validate
Renovate logs a skip and opens nothingRENOVATE_TOKEN is not setexpected; set the secret to turn Renovate on
Renovate fails on Validate RENOVATE_TOKENthe token is expired or lacks the workflow scoperecreate the token
the promotion PR never opensstable does not existcreate the branch
the promotion PR will not mergestable requires an approvalset required approvals to 0
a Renovate PR waits foreverauto-merge is offenable it in Settings

Runtime

The two most common first-boot surprises — no Flatpaks, and no brew — are in the README's Troubleshooting section.

SymptomCauseFix
ujust shows no custom commands60-custom.just was not written or importedcheck that 10-overlay.sh copied the recipes

Capturing what you learned

When a fix here was non-obvious, put it in the skill that owns the area, in the same pull request. That is the only home for durable learning.

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

ci

무료

GitHub Actions, Renovate, the two-branch release model, signing, and promotion. Use when changing workflows, dependency policy, or releasing.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

projectbluefin/finpilot1292026년 10월 26일 업데이트

customize

무료

Decide where a package, app, or command belongs — dnf5 at build time, Homebrew, Flatpak, or ujust — and how each is validated. Use when adding or removing something from the image.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

projectbluefin/finpilot1292026년 10월 26일 업데이트

Bootstrap a new image from this template: rename the project, enable Actions and Renovate, protect the branch, and reach a first green build. Use when forking the template or when setup has stalled.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

projectbluefin/finpilot1292026년 10월 26일 업데이트

overview

무료

Architecture, repository layout, and file map for this template. Use when orienting to the repository, tracing how the image is assembled, or deciding which skill covers a task.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

projectbluefin/finpilot1292026년 10월 26일 업데이트

projectbluefin의 스킬 모두 보기

이 스킬의 문제 신고