대규모 코드베이스에 걸쳐 반복 가능한 JavaScript 및 TypeScript 코드모드 적용

대규모 마이그레이션, API 재작성, 검토 가능한 diff를 통한 리팩토링을 위해 에이전트가 AST 기반 JavaScript 또는 TypeScript 코드모드가 필요할 때 jscodeshift를 사용합니다.

대규모 코드베이스에 걸쳐 반복 가능한 JavaScript 및 TypeScript 코드모드 적용란 무엇인가요?

이 스킬은 AST(추상 구문 트리) 기반의 JavaScript 및 TypeScript 코드모드를 대규모 코드베이스에 대해 반복 가능하게 적용할 수 있도록 지원합니다. 주로 Facebook의 jscodeshift 도구를 활용하며, bulk 마이그레이션, API 변경, 대규모 리팩토링 작업에서 일관되고 검토 가능한 diff를 생성하는 데 유용합니다. 지원 환경은 Node.js, npm/pnpm, Git이며, CLI 기반으로 설치 및 실행됩니다. 주요 기능으로는 jscodeshift 실행기 사용, AST 노드 조작, VSCode 디버거 연동 등을 포함하며, 공식 문서와 npm 패키지를 통해 상세한 사용법을 확인할 수 있습니다. 이 스킬은 Agent Skill Exchange 플랫폼에도 등록되어 있어, AI 에이전트가 복잡한 코드 변환 작업을 자동화하고 재현성을 확보하는 데 도움을 줍니다.

지원 대상~Claude Code~Codex CLI~Cursor

npx skills add https://github.com/agentskillexchange/skills/tree/main/skills/apply-repeatable-javascript-and-typescript-codemods-across-large-codebases-with-jscodeshift

문서

대규모 코드베이스에 걸쳐 반복 가능한 JavaScript 및 TypeScript 코드모드를 jscodeshift로 적용하기

사전 요구 사항

Node.js, npm 또는 pnpm, Git

설치

환경에 맞는 업스트림 설치 또는 설정 경로를 사용하세요:

$ npm install -g jscodeshift
변환을 더 읽기 쉽게 만드세요.
/docs 내 문서를 업데이트하려면 npm run docs를 사용하세요.
문서를 로컬에서 보려면 npx http-server ./docs를 사용하세요.

업스트림의 요구 사항 및 주의 사항:

const {run: jscodeshift} = require('jscodeshift/src/Runner')
const path = require('node:path');
AST 노드는 특정 필드 집합을 가진 일반 JavaScript 객체입니다.

기본 사용법 또는 시작하기 노트:

npm에서 jscodeshift를 받으세요:
이렇게 하면 실행기가 jscodeshift로 설치됩니다.
VSCode 디버거
출처: https://github.com/facebook/jscodeshift
업스트림 문서에서 추출: https://raw.githubusercontent.com/facebook/jscodeshift/HEAD/README.md

문서

https://jscodeshift.com

출처

Agent Skill Exchange

대규모 코드베이스에 걸쳐 반복 가능한 JavaScript 및 TypeScript 코드모드 적용