node-ci
저장소에서 파생되어 폐쇄적으로 실패하며 공급망이 구성상 안전한 작성자 CI를 제공합니다. 이 스킬이 해결하는 문제: 모델이 engines에서 벗어난 Node 버전을 하드코딩하거나(또는 EOL), 작업이 건너뛰어질 때 통과하는 집계 검사를 작성하고, 더 이상 코어팩이 제공되지 않는 러너에서 corepack enable을 사용하며, 고정되지 않은 액션과 기본적으로 넓은 권한을 가진 워크플로우를 생성하는 것입니다.
사용하지 말아야 할 경우
- 릴리스/배포 워크플로우 →
node-release. - 검사 실행 내용(린트 규칙, 테스트 구성) →
node-lint/node-testing/node-typescript; 이 스킬은 이들을 연결합니다. - Dependabot/의존성 정책 →
node-supply-chain(단, 이 스킬이 생성하는 모든 워크플로우는 해당 고정/권한 규칙을 준수합니다).
워크플로우
- 하드코딩하지 말고 파생하라:
package.json#engines과 유지 관리되는 Node 라인(nodejs.org 릴리스 일정을 기준으로 현재 LTS/EOL 확인 —references/ci-playbook.md에 버전 게이트 테이블 있음)을 교차한 매트릭스. 허용-실패로 선택적 다음-Current 라인. - Lockfile에서 패키지 매니저: 올바른 lockfile에 키가 지정된 setup-node 캐시; pnpm은 해당 설정 액션을 통해 — 현재 러너에서 corepack에 의존하지 마십시오(최신 Node 라인에 번들되지 않음; 플레이북에서 확인됨).
- 구조: lint / typecheck / test 작업 → 하나의 폐쇄-실패 집계기가 유일한 필수 검사:
if: always()와 함께failure,cancelled, 그리고skipped에서 실패하는 명시적 결과 테스트(플레이북에 정확한 YAML 있음 — 순진한needs체인은 건너뛰기에서 통과함). - 병합 대기열: 필수 검사를 뒷받침하는 모든 워크플로우는
pull_request와 함께merge_group을 선언해야 합니다. 그렇지 않으면 대기열이 조용히 중단됩니다. - 구성상 위생: 최상위
permissions: contents: read, 작업별로만 권한 상승; 서드파티 액션은 버전 주석과 함께 SHA 고정(공식actions/*는 주요 태그 + Dependabot);concurrency와 cancel-in-progress; 모든 곳에timeout-minutes. - 속도 작업은 측정된 작업이다: 먼저 실행 시간을 읽은 다음 lockfile 키가 지정된 캐싱, 매트릭스 축소, 스위트 분할을 수행하라 — 속도를 위해 게이트를 조용히 삭제하지 마십시오.
- 검증:
그런 다음 푸시하고 의도적으로 실패한 구간에서 집계기가 빨갛게 변하는지 확인하십시오(한 번 폐쇄-실패를 증명하십시오).python3 "${CLAUDE_SKILL_DIR}/scripts/check_workflows.py"
출력 사양
스키마 검증과 검사기 스크립트를 통과하는 워크플로우; engines에 대해 문서화된 매트릭스; 실패/취소/건너뛴 구간에서 실패함이 입증된 단일 집계기 필수 검사; 대기열이 켜져 있을 때 merge_group 존재; 고정되지 않은 서드파티 액션 없음; 기본적으로 넓은 권한 없음.
주의사항
- 필수 검사 이름은 보고된 검사(작업
name:)와 일치해야 하며, 파일 이름이 아닙니다 — 이름을 바꾸면 분기 규칙이 조용히 유실됩니다. - 경로 필터에 의해 건너뛰어진 매트릭스 구간은 여전히 순진한 집계기를 만족시킵니다 — 플레이북의 결과 검사가 해결책입니다.
main푸시에서cancel-in-progress: true는 배포 인접 실행을 취소할 수 있습니다 — 동시성 그룹을 의도적으로 ref로 범위를 지정하십시오.- LTS 테이블과 설정 액션 주요 버전을 버전 게이트하십시오; 작성 시점에 재확인하십시오.
파일
references/ci-playbook.md— engines-파생 매트릭스, 캐시/pnpm 설정, 폐쇄-실패 집계기 YAML, merge_group, 모노레포 필터링, 원격 캐시.scripts/check_workflows.py— 정적 워크플로우 감사(고정되지 않은 서드파티 액션, 누락된 권한, EOL Node 버전, 집계기/merge_group 존재); 위반 시 0이 아닌 종료 코드.