Codex로 반복 작업 자동화하기: 스크립트화하면 좋은 1인 개발 잡무 목록

매번 같은 명령을 입력하고, 파일을 하나씩 열고, 결과를 눈으로 확인하는 일은 작아 보여도 집중력을 계속 끊습니다. 특히 1인 개발자는 기획·개발·운영을 모두 맡기 때문에 이런 잡무가 누적될수록 실제 제품 개선에 쓸 시간이 줄어듭니다.

조코헌트에 출시된 프로덕트는 296개입니다. 웹 서비스, AI 도구, 생산성 도구, 개발자 도구처럼 분야는 달라도 출시 과정에서 이미지 처리, 테스트 데이터 준비, 로그 정리처럼 반복되는 작업은 자주 등장합니다. 이때 Codex를 매번 질문에 답하는 도구로만 쓰기보다, 한 번 실행할 수 있는 작은 스크립트를 만드는 조수로 활용해볼 수 있습니다.

1. 먼저 ‘반복’이 아니라 ‘규칙’을 찾기

반복 횟수보다 판단 가능성을 보세요

스크립트화 후보는 매일 하는 일만이 아닙니다. 한 달에 한 번 하더라도 입력과 출력의 규칙이 명확하고, 실수했을 때 다시 되돌리기 어렵다면 자동화 가치가 있습니다.

다음 질문에 답해보세요.

입력 파일이나 폴더가 일정한가?
변환 규칙을 문장으로 설명할 수 있는가?
결과를 사람이 최종 확인할 수 있는가?
실패했을 때 원본을 보존할 수 있는가?

네 가지 중 대부분에 답할 수 있다면 일회성 스크립트로 만들기 좋습니다. 반대로 매번 예외적인 판단이 필요하거나 결과를 즉시 외부에 전송하는 작업은 처음부터 완전 자동화하지 않는 편이 안전합니다.

가장 좋은 첫 후보는 ‘되돌릴 수 있는 작업’입니다

파일 복사, 이름 변경, 이미지 리사이즈, 포맷 변환처럼 원본을 따로 보관할 수 있는 작업부터 시작하세요. 데이터 삭제나 운영 DB 수정처럼 복구 비용이 큰 작업은 자동화보다 검증 절차를 먼저 설계해야 합니다. Codex의 실행 범위와 승인 방식을 정할 때는 Codex 샌드박스와 승인 모드 이해하기의 기준도 참고할 만합니다.

2. 바로 스크립트화할 수 있는 잡무 목록

파일과 이미지 처리

여러 이미지의 가로세로 크기 통일
파일 확장자 일괄 변경
특정 규칙에 따른 파일명 정리
폴더 안 파일을 날짜나 종류별로 분류
사용하지 않는 임시 파일 목록 만들기

요청할 때는 “이미지를 줄여줘”보다 입력 폴더, 출력 폴더, 파일 형식, 원본 보존 여부, 실패 시 처리 방식을 함께 적으세요. 예를 들어 “원본은 건드리지 않고 output 폴더에 저장하며, 변환 실패 파일은 건너뛰고 목록을 남겨라”처럼 제약을 명시하면 결과를 검토하기 쉽습니다.

데이터와 로그 정리

개발용 더미 데이터 생성
CSV·JSON 형식 변환
로그에서 특정 패턴만 추출
오래된 로컬 로그를 날짜별 파일로 분리
테스트용 계정이나 레코드의 일괄 생성·삭제 목록 작성

더미 데이터는 실제 개인정보를 복사하지 말고, 필드별 형식과 필요한 경계값을 정의해 생성하도록 하세요. 데이터베이스에 직접 쓰는 대신 먼저 파일로 출력하게 만들면 결과를 확인한 뒤 적용할 수 있습니다. 운영 데이터 변경이 포함된다면 DB 스키마 마이그레이션 안전하게 하기에서 다룬 것처럼 변경 순서와 복구 방법을 함께 기록해야 합니다.

3. Codex에게 스크립트를 맡기는 요청 구조

목표보다 실행 계약을 먼저 적기

좋은 요청은 “이 작업 자동화해줘”에서 끝나지 않습니다. 다음 순서로 작성하면 재작업이 줄어듭니다.

현재 폴더 구조와 입력 예시
원하는 출력 형태
지켜야 할 제약
실패·예외 처리 방식
실행 명령과 테스트 방법

예시는 다음처럼 쓸 수 있습니다.

scripts/resize-images.ts를 만들어줘.
- 입력: assets/source 안의 png, jpg 파일
- 출력: assets/optimized 폴더
- 원본 파일은 수정하지 않기
- 이미 처리된 파일은 건너뛰기
- 실패한 파일명과 오류를 별도 목록으로 저장하기
- 샘플 파일 3개로 실행 테스트하고 사용법을 README에 추가하기

프로젝트 규칙이나 명령어가 있다면 AGENTS.md 작성법처럼 문서화해 요청의 일부로 포함하세요. 스크립트가 프로젝트의 포맷터, 런타임, 디렉터리 규칙을 어기지 않게 하는 데 도움이 됩니다.

4. 자동 실행보다 검증 가능한 실행을 설계하기

안전장치를 기본값으로 두기

작은 스크립트라도 다음 장치를 넣는 편이 좋습니다.

기본값은 미리보기 모드로 실행
실제 변경 전 대상 파일 목록 출력
원본 덮어쓰기 금지
처리 성공·실패 개수와 파일명 기록
재실행해도 결과가 망가지지 않도록 멱등성 확보
입력 폴더가 비어 있거나 예상 형식이 아니면 중단

특히 삭제·이동·대량 수정 작업은 --dry-run 같은 미리보기 옵션을 먼저 만들고, 확인 후 실제 실행 옵션을 추가하세요. 스크립트가 짧다는 이유로 검증을 생략하면 수동 작업보다 복구가 어려워질 수 있습니다.

첫 실행은 작은 샘플로 끝내기

전체 폴더를 한 번에 처리하지 말고 파일 몇 개나 테스트 데이터 일부만 대상으로 실행하세요. 결과가 예상과 다르면 Codex에게 로그와 실제 출력물을 함께 보여주고 수정합니다. 코드가 만들어졌다는 사실보다, 반복 실행해도 같은 규칙으로 안전하게 처리되는지가 더 중요합니다. 마지막으로 AI가 짠 코드를 믿어도 될까의 검증 항목처럼 입력 경계와 오류 상황을 확인하세요.

5. 자동화의 기준은 ‘시간 절약’보다 ‘주의력 회수’

스크립트화의 목적은 거대한 자동화 시스템을 만드는 데 있지 않습니다. 오늘도 반복하는 파일 정리 한 가지, 매번 복사하는 데이터 준비 한 가지를 명령어 하나로 줄이는 데 있습니다.

이번 주에는 잡무를 목록으로 적고, 되돌릴 수 있으며 규칙이 분명한 작업 하나만 고르세요. Codex에게 요구사항과 안전장치를 함께 전달하고, 샘플 실행 결과를 검토한 뒤 프로젝트의 scripts 폴더에 남겨두면 됩니다. 그렇게 만든 작은 도구가 쌓이면 개발자는 작업을 처리하는 사람에서, 작업이 스스로 굴러가게 설계하는 사람으로 조금씩 이동합니다.