For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
기본 탐색 메뉴
Theme

추천
API 대시보드
ChatGPT 사용해 보기
Codex

Codex use case

워크플로우를 스킬로 저장하기

반복 작업에 Codex가 언제든 활용할 수 있는 스킬을 만드세요.

Difficulty Easy
Time horizon 5m

원하는 결과를 얻은 Codex 채팅, 리뷰 규칙, 테스트 명령어, 릴리스 체크리스트, 디자인 규칙, 글쓰기 예시, 특정 레포지토리용 스크립트 등을 바탕으로 Codex가 다음 작업에서도 활용할 스킬을 만드세요.

Best for

  • 절차가 정리되어 있고 Codex에 다시 맡기고 싶은 워크플로우
  • 채팅할 때마다 긴 프롬프트를 붙여 넣는 대신 스킬을 재사용하려는 팀

Contents

    ← All use cases

    워크플로우를 스킬로 저장하기

    반복 작업에 Codex가 언제든 활용할 수 있는 스킬을 만드세요.

    원하는 결과를 얻은 Codex 채팅, 리뷰 규칙, 테스트 명령어, 릴리스 체크리스트, 디자인 규칙, 글쓰기 예시, 특정 레포지토리용 스크립트 등을 바탕으로 Codex가 다음 작업에서도 활용할 스킬을 만드세요.

    Easy
    5m

    원하는 결과를 얻은 Codex 채팅, 리뷰 규칙, 테스트 명령어, 릴리스 체크리스트, 디자인 규칙, 글쓰기 예시, 특정 레포지토리용 스크립트 등을 바탕으로 Codex가 다음 작업에서도 활용할 스킬을 만드세요.

    Easy
    5m

    Related links

    에이전트 스킬

    Best for

    • 절차가 정리되어 있고 Codex에 다시 맡기고 싶은 워크플로우
    • 채팅할 때마다 긴 프롬프트를 붙여 넣는 대신 스킬을 재사용하려는 팀

    Skills & Plugins

    • Skill Creator
      워크플로우에 관한 정보를 모아 스킬의 기본 구조를 만듭니다. 핵심 지침을 간결하게 작성한 뒤 결과를 검증합니다.
    Skill Why use it
    Skill Creator 워크플로우에 관한 정보를 모아 스킬의 기본 구조를 만듭니다. 핵심 지침을 간결하게 작성한 뒤 결과를 검증합니다.

    Starter prompt

    $skill-creator를 사용해 다음 작업을 수행하는 Codex 스킬을 만들어 주세요. [GitHub PR에서 Buildkite 검사가 실패하는 문제 해결 / PR 메모를 인라인 리뷰 댓글로 변환 / 병합된 PR을 바탕으로 우리 팀의 릴리스 노트 작성] 스킬을 만들 때 다음 자료를 활용해 주세요. - 실제 작업 예시: [“이 채팅을 사용해 주세요”라고 적거나, 병합된 PR 링크를 넣거나, 잘 작성된 Codex 답변을 붙여 넣으세요] - 참고 자료: [Slack 스레드, PR 리뷰 링크, 런북 URL, 문서 URL 또는 티켓을 붙여 넣으세요] - 레포지토리: [이 스킬이 특정 레포지토리에 의존한다면 해당 레포지토리의 경로를 입력하세요] - 재사용할 스크립트 또는 명령어: [테스트 명령어], [미리 보기 명령어], [로그 조회 스크립트], [릴리스 명령어] - 원하는 결과물 예시: [다음 작업에서 본보기로 삼을 Slack 업데이트 메시지, 변경 로그 항목, 리뷰 댓글, 티켓 또는 최종 답변을 붙여 넣으세요]
    $skill-creator를 사용해 다음 작업을 수행하는 Codex 스킬을 만들어 주세요. [GitHub PR에서 Buildkite 검사가 실패하는 문제 해결 / PR 메모를 인라인 리뷰 댓글로 변환 / 병합된 PR을 바탕으로 우리 팀의 릴리스 노트 작성] 스킬을 만들 때 다음 자료를 활용해 주세요. - 실제 작업 예시: [“이 채팅을 사용해 주세요”라고 적거나, 병합된 PR 링크를 넣거나, 잘 작성된 Codex 답변을 붙여 넣으세요] - 참고 자료: [Slack 스레드, PR 리뷰 링크, 런북 URL, 문서 URL 또는 티켓을 붙여 넣으세요] - 레포지토리: [이 스킬이 특정 레포지토리에 의존한다면 해당 레포지토리의 경로를 입력하세요] - 재사용할 스크립트 또는 명령어: [테스트 명령어], [미리 보기 명령어], [로그 조회 스크립트], [릴리스 명령어] - 원하는 결과물 예시: [다음 작업에서 본보기로 삼을 Slack 업데이트 메시지, 변경 로그 항목, 리뷰 댓글, 티켓 또는 최종 답변을 붙여 넣으세요]

    Codex가 두고두고 쓸 스킬 만들기

    반복하는 작업에 필요한 지침, 자료, 스크립트를 스킬로 만들어 Codex가 재사용할 수 있게 하세요. 처음 작업할 때 Codex가 좋은 결과를 내는 데 도움이 된 작업 내용, 문서, 명령어, 예시를 스킬에 담을 수 있습니다.

    실제로 도움이 되었던 예시 하나로 시작하세요. PR의 변경 사항을 체리픽한 Codex 채팅, Notion의 릴리스 체크리스트, 유용한 PR 댓글 모음, 출시 절차를 설명한 Slack 스레드 등이 좋은 출발점입니다.

    사용 방법

    1. Codex가 사용할 컨텍스트를 추가하세요.

      보존하려는 Codex 채팅에서 Slack 스레드나 문서 링크를 붙여 넣고 Codex가 기억해야 할 규칙, 명령어, 예시를 추가하세요.

    2. 시작 프롬프트를 실행하세요.

      프롬프트에서 만들 스킬의 이름을 지정한 다음, $skill-creator에 보존할 작업 내용, 문서, PR, 명령어 또는 결과물을 전달합니다.

    3. Codex에 스킬 생성과 검증을 맡기세요.

      생성된 스킬에는 $skill-name과 스킬이 실행되어야 하는 조건이 명시되어 있어야 합니다. 재사용할 지침도 적절한 위치에 있어야 합니다.

      ~/.codex/skills에 있는 스킬은 어느 레포지토리에서나 사용할 수 있습니다. 현재 레포지토리에 있는 스킬은 커밋해서 팀원들과 함께 사용할 수 있습니다.

    4. 스킬을 사용한 뒤 채팅에서 업데이트하세요.

      다음에 PR, 알림, 리뷰, 릴리스 노트 또는 디자인 작업을 다룰 때 새 $skill-name을 호출하세요. 잘못된 테스트 명령어를 사용하거나, 리뷰 규칙을 놓치거나, 런북의 단계를 건너뛰거나, 그대로 보내기 어려운 초안을 작성했다면 수정할 내용을 스킬에 반영해 달라고 Codex에 요청하세요.

    참고 자료 제공하기

    스킬이 어떻게 동작해야 하는지 보여 주는 자료를 $skill-creator에 제공하세요.

    가지고 있는 자료 추가할 내용
    Codex 채팅에서 보존하려는 워크플로우 해당 채팅에서 use this chat이라고 입력하세요. Codex는 채팅의 컨텍스트, 명령어, 수정 사항, 피드백을 바탕으로 스킬을 만들 수 있습니다.
    문서 또는 런북 릴리스 체크리스트를 붙여 넣거나, 인시던트 대응 런북 링크를 추가하거나, API 문서 PDF를 첨부하거나, 레포지토리에 있는 마크다운 가이드의 위치를 Codex에 알려 주세요.
    팀 대화 팀원이 알림에 관해 설명한 Slack 스레드를 붙여 넣거나, 프런트엔드 규칙이 담긴 PR 리뷰 링크를 추가하거나, 고객이 겪는 문제를 설명한 지원 대화를 첨부하세요.
    스킬이 재사용할 스크립트 또는 명령어 앞으로 Codex가 작업할 때 실행할 테스트 명령어, 미리보기 명령어, 릴리스 스크립트, 로그 수집 스크립트 또는 로컬 도우미 명령어를 추가하세요.
    좋은 결과물 앞으로의 작업에서 본보기로 삼을 결과물을 추가하세요. 병합된 PR, 변경 로그의 최종 항목, 승인된 출시 공지, 해결된 티켓, 변경 전후 스크린샷, Codex의 최종 답변 등이 해당합니다.

    자료가 Slack, Linear, GitHub, Notion 또는 Sentry에 있다면 플러그인으로 해당 도구를 Codex에 연결하거나, 시작 프롬프트에서 도구를 언급하거나, 관련 부분을 채팅에 붙여 넣으세요.

    Codex가 만드는 파일

    대부분의 스킬은 SKILL.md 파일 하나로 시작합니다. 워크플로우에 필요하면 $skill-creator가 상세한 참고 문서, 스크립트 또는 에셋을 추가할 수 있습니다.

    • my-skill/
      • SKILL.md Required: instructions and metadata
      • references/ Optional: longer docs
      • scripts/ Optional: repeatable commands
      • assets/ Optional: templates and starter files

    만들어 볼 만한 스킬

    앞으로도 같은 런북을 읽거나, 같은 CLI를 실행하거나, 같은 기준으로 리뷰하거나, 같은 형식으로 팀에 진행 상황을 공유하거나, 같은 브라우저 플로우를 테스트해야 한다면 같은 방식으로 스킬을 만드세요. 다음은 몇 가지 예시입니다.

    • $buildkite-fix-ci 스킬은 실패한 작업의 로그를 다운로드하고 오류를 진단한 뒤, 오류를 해결하는 데 필요한 최소한의 코드 수정을 제안합니다.
    • $fix-merge-conflicts 스킬은 GitHub PR을 체크아웃하고 대상 브랜치의 변경 사항을 반영한 뒤, 충돌을 해결하고 푸시에 사용할 정확한 명령어를 알려 줍니다.
    • $frontend-skill 스킬은 Codex가 사용자의 UI 취향에 맞춰 기존 컴포넌트를 활용하고, 스크린샷으로 결과를 반복 검토하고, 사용자의 기준에 맞는 에셋을 선택하고, 브라우저에서 마무리 작업을 하도록 안내합니다.
    • $pr-review-comments 스킬은 리뷰 메모를 적절한 어조의 간결한 인라인 댓글로 정리하고 관련 GitHub 링크를 넣습니다.
    • $web-game-prototyper 스킬은 플레이 가능한 첫 게임 루프의 범위를 정하고, 에셋을 선택하고, 조작감을 조정하고, 스크린샷을 찍은 뒤 브라우저에서 게임을 다듬습니다.

    Related use cases

    목표를 향해 작업하기

    Codex가 여러 대화 턴에 걸쳐 작업을 이어가야 하고 종료 조건의 충족 여부를 확인할 수 있다면 `/goal`을 사용하세요.

    Engineering Automation

    Codex가 사용할 CLI 만들기

    Codex에 어느 폴더에서나 실행할 수 있고 레포지토리 스크립트와 조합하거나 파일을 다운로드할 때 쓸 수 있는 CLI를 만들어 달라고 하세요

    Engineering Code

    대규모 코드베이스 이해하기

    Codex는 낯선 코드베이스의 구조를 정리하고 각 모듈의 역할과 데이터 흐름을 설명합니다. 코드를 수정하기 전에 어떤 파일을 먼저 읽으면 좋을지도 알려 줍니다.

    Engineering Analysis