Community라이팅 & 에디팅github.com

Paldom/node-skills

고품질 오픈소스 Node.js, TypeScript, Next.js 및 React 앱과 패키지를 유지 관리하기 위한 에이전트 스킬 - 린팅, 타입 안전성, 테스트, 패키징 및 릴리스, CI 품질 게이트.

node-skills란 무엇인가요?

이 스킬은 Node.js 기반 프로젝트의 CI/CD 워크플로우를 설정하고 감사하여, 저장소 `engines` 필드에 명시된 Node 버전과의 불일치를 방지하고, 모든 CI 게이트가 실패 시 명확하게 실패하며(fail-closed), 서드파티 액션이 고정되지 않거나 불필요하게 넓은 권한으로 인한 공급망 문제를 예방합니다. 주로 Claude Code, Cursor, Codex와 같은 AI 코딩 에이전트가 사용하며, `node-ci`, `node-release`, `node-lint`, `node-testing`, `node-typescript`, `node-supply-chain` 등의 하위 스킬로 구성됩니다. 이 스킬은 `package.json#engines`을 기반으로 매트릭스를 동적으로 생성하고, lockfile에 맞는 패키지 매니저를 자동 선택하며, 병합 대기열(merge queue)을 지원하고, 모든 작업에 타임아웃과 동시성 제한을 설정합니다. 또한 `scripts/check_workflows.py` 스크립트로 정적 감사를 수행하여 릴리스 전에 워크플로우의 안전성과 정확성을 검증합니다. 이 스킬의 주요 목표는 수동으로 CI 구성을 하드코딩하거나 유지보수할 때 발생하는 일반적인 실수를 제거하고, 재현 가능하고 안전한 CI 파이프라인을 제공하는 것입니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add Paldom/node-skills

Installed? Explore more 라이팅 & 에디팅 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

node-ci

저장소에서 파생되어 폐쇄적으로 실패하며 공급망이 구성상 안전한 작성자 CI를 제공합니다. 이 스킬이 해결하는 문제: 모델이 engines에서 벗어난 Node 버전을 하드코딩하거나(또는 EOL), 작업이 건너뛰어질 때 통과하는 집계 검사를 작성하고, 더 이상 코어팩이 제공되지 않는 러너에서 corepack enable을 사용하며, 고정되지 않은 액션과 기본적으로 넓은 권한을 가진 워크플로우를 생성하는 것입니다.

사용하지 말아야 할 경우

  • 릴리스/배포 워크플로우 → node-release.
  • 검사 실행 내용(린트 규칙, 테스트 구성) → node-lint / node-testing / node-typescript; 이 스킬은 이들을 연결합니다.
  • Dependabot/의존성 정책 → node-supply-chain(단, 이 스킬이 생성하는 모든 워크플로우는 해당 고정/권한 규칙을 준수합니다).

워크플로우

  1. 하드코딩하지 말고 파생하라: package.json#engines과 유지 관리되는 Node 라인(nodejs.org 릴리스 일정을 기준으로 현재 LTS/EOL 확인 — references/ci-playbook.md에 버전 게이트 테이블 있음)을 교차한 매트릭스. 허용-실패로 선택적 다음-Current 라인.
  2. Lockfile에서 패키지 매니저: 올바른 lockfile에 키가 지정된 setup-node 캐시; pnpm은 해당 설정 액션을 통해 — 현재 러너에서 corepack에 의존하지 마십시오(최신 Node 라인에 번들되지 않음; 플레이북에서 확인됨).
  3. 구조: lint / typecheck / test 작업 → 하나의 폐쇄-실패 집계기가 유일한 필수 검사: if: always()와 함께 failure, cancelled, 그리고 skipped에서 실패하는 명시적 결과 테스트(플레이북에 정확한 YAML 있음 — 순진한 needs 체인은 건너뛰기에서 통과함).
  4. 병합 대기열: 필수 검사를 뒷받침하는 모든 워크플로우는 pull_request와 함께 merge_group을 선언해야 합니다. 그렇지 않으면 대기열이 조용히 중단됩니다.
  5. 구성상 위생: 최상위 permissions: contents: read, 작업별로만 권한 상승; 서드파티 액션은 버전 주석과 함께 SHA 고정(공식 actions/*는 주요 태그 + Dependabot); concurrency와 cancel-in-progress; 모든 곳에 timeout-minutes.
  6. 속도 작업은 측정된 작업이다: 먼저 실행 시간을 읽은 다음 lockfile 키가 지정된 캐싱, 매트릭스 축소, 스위트 분할을 수행하라 — 속도를 위해 게이트를 조용히 삭제하지 마십시오.
  7. 검증:
    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이 아닌 종료 코드.

관련 스킬