소개

Codex가 같은 API, 로그 소스, 내보낸 받은편지함 데이터, 로컬 데이터베이스 또는 팀 스크립트를 반복해서 사용한다면 해당 작업을 명령어로 만드세요. Codex가 어느 폴더에서나 명령어를 실행하고, 결과를 확인하거나 범위를 좁히고, git, gh, rg, 테스트, 레포지토리 스크립트와 조합해 사용할 수 있어야 합니다.

CLI와 함께 사용할 스킬도 추가하세요. Codex가 언제 CLI를 사용해야 하는지, 어떤 명령어를 먼저 실행해야 하는지, 출력량을 줄이려면 어떻게 해야 하는지 기록하세요. 다운로드한 파일의 저장 위치와 승인이 필요한 쓰기 명령어도 명시하세요.

이 워크플로우에서 $cli-creator는 Codex가 명령어를 만드는 데 쓰입니다. $skill-creator를 사용하면 Codex가 $ci-logs처럼 재사용할 수 있는 스킬을 저장하고 이후 작업에서 이름으로 호출할 수 있습니다.

사용 방법

CLI가 수행할 작업 정하기

구현 기술을 고르기 전에 Codex에 맡길 작업부터 정하세요. 잘 설계한 CLI는 반복적인 조회, 검색, 다운로드, 내보내기, 초안 작성, 업로드, 폴링, 안전한 쓰기 작업을 어느 레포지토리에서나 Codex가 실행할 수 있는 명령어로 제공합니다.

문서, 파일 또는 명령어 공유하기

Codex가 참고할 구체적인 자료를 제공하세요. 문서나 OpenAPI 명세, 민감한 정보를 제거한 curl 명령어, 내보낸 파일이나 데이터베이스의 경로, 로그 폴더, 기존 스크립트 등을 사용할 수 있습니다. CLI를 익숙한 형식으로 만들고 싶다면 --help 출력 예시를 gh, kubectl 또는 팀에서 사용하는 도구에서 짧게 발췌해 붙여 넣으세요.

명령어에 인증이 필요하다면 지원해야 할 환경 변수 이름, 설정 파일 경로 또는 로그인 플로우를 Codex에 알려 주세요. 비밀 값은 셸이나 설정 파일에 직접 설정하세요. 비밀 값을 채팅에 붙여 넣지 마세요. 인증 정보가 없으면 CLI의 설정 검사가 실패하고 그 이유가 명확히 표시되도록 Codex에 요청하세요.

Codex에 CLI와 스킬을 만들어 달라고 요청하기

이 페이지의 시작 프롬프트에 Codex가 참고할 자료와 CLI가 가장 먼저 지원해야 할 작업을 입력하세요.

Codex는 코드를 작성하기 전에 어떤 명령어를 어떻게 사용할 수 있게 만들지 보여 주고, 구현을 진행하는 데 꼭 필요한 정보가 빠져 있을 때만 질문해야 합니다.

어느 폴더에서나 명령어가 작동하는지 확인하기

Codex가 cargo run, python path/to/script.py 또는 패키지를 설치하지 않고 실행하는 명령어만 테스트하고 끝내지 않도록 하세요. 이후 작업에서 사용할 때와 같은 방식으로 다른 레포지토리나 임시 폴더에서 설치한 명령어를 테스트하도록 요청하세요.

에이전트가 다음 작업에서 사용할 방식으로 CLI 테스트하기

Codex가 지나치게 큰 JSON 데이터를 반환하면 기본 응답의 범위를 좁히고 전체 페이로드를 파일로 내보내는 기능을 추가하도록 요청하세요. Codex가 승인이 필요한 작업을 구분하지 못하면 다른 작업에서 CLI를 사용하기 전에 함께 저장한 스킬을 업데이트하도록 요청하세요.

나중에 스킬 사용하기

CLI가 다시 필요할 때는 문서를 다시 붙여 넣는 대신 스킬을 호출하세요.

반복해서 수행할 작업이라면 채팅에서 스킬을 한 번 테스트한 뒤 Codex에 같은 스킬 호출을 해당 채팅에서 예약 작업으로 설정해 달라고 요청하세요.