프롬프트 작성의 기본
프롬프트는 알고 싶은 것, 만들고 싶은 것, 바꾸고 싶은 것을 ChatGPT에 전달하는 방법입니다. 질문을 해도 되고, 지시를 내리거나 목표를 제시해도 됩니다. 특별한 문법이나 정해진 형식은 필요하지 않습니다. 평소 쓰는 말로 시작하고, 응답을 검토한 뒤 후속 메시지로 결과를 다듬으세요.
짧은 프롬프트만으로도 충분한 경우가 많습니다. 규모가 크거나 중요한 작업이라면 다음 중 필요한 내용을 포함하세요.
- 목표: ChatGPT가 무엇을 해야 하나요?
- 컨텍스트: 어떤 정보나 자료가 도움이 되나요?
- 결과물: 어떤 형식과 분량이 필요한가요? 어느 정도로 상세해야 하나요?
- 제약 조건: 무엇을 그대로 유지해야 하나요? ChatGPT가 피해야 할 행동이나 실행 전에 사용자에게 확인해야 할 사항은 무엇인가요?
도움이 되는 항목만 사용하세요. 모든 항목을 채우거나 특정 형식을 따를 필요는 없습니다.
필요한 결과 설명하기
세부 절차를 나열하기보다 원하는 결과부터 설명하세요. 누가 읽는지, 어떤 형식으로 제공하는지에 따라 결과물이 달라진다면 그 정보도 포함하세요.
이 회의 메모를 바탕으로 프로젝트 팀에 공유할 내용을 짧게 정리해 주세요.
결정 사항과 다음에 할 일을 먼저 제시해 주세요.
이 프롬프트는 무엇을 만들고 누가 읽을지를 알려 줍니다. 절차 자체가 중요할 때는 절차를 설명하세요. 그 외에는 ChatGPT가 직접 검색하고 정보를 비교하면서 접근 방식을 조정할 여지를 두세요.
도움이 되는 컨텍스트 추가하기
결과에 영향을 줄 만한 정보를 공유하세요. 관련 자료만 추가하고, ChatGPT가 각 자료에서 무엇을 참고해야 하는지 설명하세요.
- ChatGPT에 자료 요약, 비교, 변환 또는 검토용 파일 만들기를 요청할 때는 문서, 스프레드시트, 프레젠테이션 또는 PDF 파일을 첨부하세요.
- 시각적 컨텍스트가 필요한 작업이라면 스크린샷이나 다이어그램 등 이미지 입력을 추가하세요. 이미지만 제공하지 말고 어느 부분을 봐야 하는지 짚어 주세요.
- 최신 정보가 필요하면 ChatGPT에 웹 검색을 요청하고, 결과를 확인해야 한다면 출처도 요청하세요.
- 관련 채팅에서 파일, 자료 또는 로컬 폴더를 함께 사용하려면 프로젝트를 사용하세요.
연결된 자료 사용하기
ChatGPT가 연결된 자료에 접근할 수 있다면 어디에서 무엇을 찾아야 하는지 알려 주세요. 검색 방법을 하나하나 설명할 필요는 없습니다.
Drive에 있는 최신 프로젝트 계획과 프로젝트 Slack 채널의 관련 결정 사항 및 새 소식을 바탕으로 현황 보고를 작성해 주세요.
연결된 자료를 사용하려면 해당 플러그인이 필요합니다. 이용 가능 여부는 요금제와 워크스페이스 설정에 따라 달라질 수 있습니다.
플러그인 사용하기
플러그인은 ChatGPT와 Codex에서 재사용할 수 있는 지침을 제공하고 Google Drive, Gmail, Slack, GitHub 같은 도구를 연결합니다. 두 제품 모두 같은 공용 디렉터리에서 공개 플러그인을 가져옵니다. 필요한 결과를 요청하면 현재 사용 중인 제품이 이용 가능한 도구 중에서 적절한 도구를 선택합니다. ChatGPT에서 특정 플러그인을 선택하려면 Composer에 @를 입력하세요.
ChatGPT와 Codex에서 플러그인을 찾아 설치하고 사용하는 방법을 알아보세요.
ChatGPT 개인 맞춤 설정하기
여러 채팅에 공통으로 적용할 선호 사항은 설정 > 개인 맞춤 설정 메뉴에 맞춤 지침으로 입력하세요. 현재 채팅에만 필요한 내용은 프롬프트에 넣으세요.
기본 성격, 맞춤 지침, 기타 앱 환경설정을 지정하세요.
문제가 생기지 않도록 제약 조건 정하기
제약 조건은 불필요한 일이 늘어나거나 ChatGPT가 사용자의 의도와 다른 행동을 하는 것을 막기 위한 간단한 지침입니다. 특정 내용을 바꾸면 결과물을 쓸 수 없게 되는 경우나, 다른 사람에게 영향을 주기 전에 직접 검토하려는 경우에 추가하세요.
- 승인된 날짜와 예산 금액은 그대로 유지해 주세요.
- 제공된 자료만 사용해 주세요. 정보가 빠져 있으면 추측하지 말고 표시해 주세요.
- 명시된 예산 범위 안에서 추천해 주세요.
- 메시지는 초안으로 작성해 주세요. 보내지 마세요.
가장 중요한 제약 조건 한두 가지에 집중하세요. ChatGPT의 모든 작업 단계를 통제할 필요는 없습니다.
바로 사용할 수 있는 결과물 요청하기
결과물을 어떻게 사용할지 ChatGPT에 알려 주세요. 용도를 알면 적절한 분량과 세부 수준, 구성을 선택하는 데 도움이 됩니다.
- 임원이 회의 전에 훑어볼 수 있도록 한 페이지로 요약해 주세요. 결정 사항과 다음에 할 일을 먼저 제시해 주세요.
- 이 메모를 바탕으로 결정 사항, 담당자, 기한이 담긴 후속 이메일을 작성해 주세요.
- 계획한 지출과 실제 지출을 한눈에 비교할 수 있는 표를 만들고, 차이가 10%를 넘는 항목을 강조해 주세요.
중요한 작업이라면 ChatGPT에 최종 점검을 요청하세요. 예를 들어 각 실행 항목에 담당자와 기한이 있는지 확인하거나 검증하지 못한 정보를 표시하도록 하세요. 그런 다음 결과물을 사용하거나 공유하기 전에 직접 검토하세요.
후속 메시지로 결과 다듬기
첫 프롬프트부터 완벽할 필요는 없습니다. 결과를 검토한 다음 원하는 변경 사항을 구체적으로 요청하세요.
도입부에서 바로 본론으로 들어가 주세요. 근거는 그대로 두고 권고 사항을 배경 설명 앞으로 옮겨 주세요.
처음부터 다시 시작하지 않아도 누락된 자료를 추가하거나, 방향을 바로잡거나, 다른 선택지를 요청하거나, 설명의 깊이를 조절할 수 있습니다.
작업 방향 조정과 메시지 대기열
Codex가 작업 중일 때도 현재 실행이 끝날 때까지 기다리지 않고 새 메시지를 보낼 수 있습니다.
- 방향 조정 기능은 메시지를 현재 실행에 반영합니다. 방향을 바꾸거나, 빠진 세부 사항을 추가하거나, 새로운 정보를 전달할 때 사용하세요.
- 대기열에 추가 기능은 다음 실행에 사용할 메시지를 저장합니다. 현재 작업이 끝난 후에 처리할 요청에 사용하세요.
ChatGPT 데스크톱 앱에서는 설정 > 일반 > 후속 메시지 동작 메뉴에서 기본 동작을 선택하세요. 대기 중인 메시지는 Composer 위에 표시되며, 여기서 내용을 편집하거나 순서를 바꾸거나 메시지를 전송 또는 삭제할 수 있습니다. 설정에는 기본값을 바꾸지 않고 메시지 하나에만 다른 동작을 적용하는 단축키도 표시됩니다.
Codex CLI에서 Codex가 작업 중일 때 Enter를 누르면 현재 턴의 방향을 조정할 수 있고, Tab을 누르면 다음 턴에 사용할 메시지를 대기열에 추가할 수 있습니다. 자세한 내용은 대화형 단축키를 참고하세요.
하나의 프롬프트로 구성하기
연결된 자료를 바탕으로 프로젝트 현황 보고를 작성한다면 다음과 같이 요청할 수 있습니다.
월요일 경영진 회의에 사용할 프로젝트 현황 보고서를 한 페이지로 작성해 주세요. Drive에 있는 최신 프로젝트 계획과 프로젝트 Slack 채널의 관련 결정 사항 및 새 소식을 활용해 주세요.
경영진이 내려야 할 결정과 다음에 할 일을 먼저 제시해 주세요. 진행 상황, 위험 요인, 담당자, 기한을 정리해 주세요. 승인된 날짜와 예산 금액은 그대로 유지해 주세요. 서로 맞지 않거나 빠진 정보는 표시하고, 아무것도 보내거나 게시하지 마세요.
마무리하기 전에 다음에 할 일마다 담당자와 기한이 명시되어 있는지 확인해 주세요.
이 프롬프트는 목표, 컨텍스트, 결과물, 제약 조건을 제시하고, 모든 단계를 일일이 지정하지 않고도 최종 점검을 요청합니다.
음성 받아쓰기 사용하기
ChatGPT 데스크톱 앱의 Composer에서 받아쓰기 버튼을 선택한 다음 말하세요. ChatGPT가 음성을 텍스트로 변환해 Composer에 입력하므로 프롬프트를 보내기 전에 내용을 검토하고 수정할 수 있습니다.
Chat 프롬프트 예시
질문하거나 아이디어를 얻고, 초안을 작성하거나 일상적인 결정을 내릴 때는 Chat을 사용하세요. 원하는 결과부터 설명하고, 답변에 영향을 주는 세부 사항만 추가하세요.
주제 이해하기
투자 경험이 없는 사람에게 복리의 원리를 설명해 주세요.
구체적인 예를 하나 들고, 설명에 사용하는 금융 용어는 모두 뜻을 풀어 주세요.
글 초안 작성하고 다듬기
여행 일정 때문에 이번 초대를 거절하는 이메일 초안을 친근한 어조로 작성해 주세요.
120단어 미만으로 쓰고, 다음 행사에 참여할 여지는 남겨 주세요.
선택지 비교하기
1년에 두 번 해외여행을 가는 한 사람이 사용할 요금제를 고르려고 합니다. 이 두 휴대전화 요금제의 중요한 차이점을 표로 비교해 주세요. 그런 다음 하나를 추천하고 그 요금제를 선택하면 무엇을 얻고 무엇을 포기해야 하는지 설명해 주세요.
실용적인 계획 세우기
각각 30분이 채 걸리지 않는 평일 저녁 식사 다섯 끼를 계획해 주세요. 땅콩은 제외하고, 같은 재료를 여러 끼에 활용해 주세요. 마지막에 장보기 목록을 하나로 합쳐 주세요.
ChatGPT Work용 프롬프트 작성하기
간단한 질문, 짧은 글 수정, 아이디어 구상, 간단한 초안 작성에는 Chat을 사용하세요. 여러 자료나 도구를 활용하거나, 여러 단계를 거치거나, 변경을 적용하거나, 규모가 큰 결과물을 만드는 작업에는 ChatGPT Work를 사용하세요.
ChatGPT Work에서는 필요한 결과를 설명하고, 원본 자료를 제공하고, 대상 독자와 검토 방법을 알려 주세요. ChatGPT에 계획을 세우고 필요한 정보를 수집한 다음 파일을 만들고 작업을 마치기 전에 점검하도록 요청하세요.
ChatGPT Work 효율적으로 사용하기
ChatGPT Work는 시간이 많이 들거나 반복되는 작업, 또는 재사용할 수 있는 완성된 파일을 만드는 데 유용합니다. 크레딧을 더 많이 사용하는 작업이라도 시간을 절약하거나 품질을 높이거나 중요한 결정을 내리는 데 도움이 된다면 그만한 가치가 있습니다.
직접 검토할 수 있는 결과물 하나부터 시작하세요.
- 관련 자료만 포함하고, 필요에 따라 조회 기간을 제한하세요.
- 대상 독자, 결과물 형식, 원하는 분량을 지정하세요.
- 꼭 필요한 작업과 선택적으로 개선하거나 다듬을 부분을 구분하세요.
- 접근 방식이 중요하다면 계획을 요청하세요. 다른 사람이 의존하는 정보를 전송, 게시 또는 변경하기 전에 ChatGPT가 반드시 사용자의 승인을 받도록 하세요.
- ChatGPT가 더 이상 필요하지 않은 작업을 시작하면 범위를 좁히거나 작업을 중지하세요.
첫 결과물을 검토하고 지침을 다듬으세요. 만족스러운 결과를 얻으면 그 워크플로우를 재사용하세요.
원본 자료로 완성된 파일 만들기
첨부한 분기 보고서를 바탕으로 경영진용 요약 보고서와 슬라이드 6장짜리 프레젠테이션을 만들어 주세요.
대상 독자는 경영진입니다. 경영진이 내려야 할 결정 세 가지를 먼저 제시하고, 보고서에 나온 사실과 직접 분석한 내용을 구분해 주세요. 각 수치의 출처가 어느 파일인지 밝히고, 마무리하기 전에 요약 보고서와 슬라이드의 내용이 일치하는지 확인해 주세요.
의사 결정에 필요한 정보 조사하기
직원이 50명인 회사에서 사용할 고객 지원 플랫폼 세 가지를 조사해 주세요. 최신 자료를 바탕으로 가격, 보안, 연동 기능, 마이그레이션에 필요한 작업량을 비교해 주세요. 추천 의견을 메모로 작성하고, 출처 링크와 판단의 전제, 계약 전에 답을 찾아야 할 질문을 포함해 주세요.
출시 준비 조율하기
첨부한 제품 개요를 바탕으로 출시 계획을 작성해 주세요. 일정, 담당자, 작업 간 선후 관계, 위험 요인, 공지 초안, 고객용 FAQ, 출시 당일 체크리스트를 포함해 주세요. 최종 파일을 만들기 전에 아직 결정하지 않은 사항을 표시해 주세요.
반복 작업은 먼저 일반 채팅에서 프롬프트를 다듬으세요. 일관된 결과가 나오면 해당 채팅에서 작업을 예약하세요. 실행할 때마다 새 채팅을 시작해야 한다면 독립적인 예약 작업을 만드세요.
Codex용 프롬프트 작성하기
ChatGPT로 코드, 코드베이스 또는 개발자 도구를 다루려면 Codex를 사용하세요. 효과적인 Codex 프롬프트는 원하는 동작을 설명하고, 관련 코드나 재현 단계를 알려 주며, 지켜야 할 주요 제약 조건과 변경 사항을 검증할 방법을 명시합니다.
여러 단계가 필요한 작업에서 코드를 편집하기 전에 Codex가 먼저 조사하고 접근 방식을 제안하도록 하려면 앱의 Composer에 /plan을 입력하세요. 목표 모드를 사용할 수 있다면 계획을 세운 뒤 /goal로 지속적으로 수행할 목표를 설정하세요. 현재 사용할 수 있는 명령어 목록은 앱 슬래시 명령어를 참고하세요.
예시 읽는 방법
각 워크플로우에는 다음 내용이 포함됩니다.
- 사용 시점 및 가장 적합한 Codex 사용 환경(IDE, CLI 또는 클라우드)
- 진행 단계와 단계별 사용자 프롬프트 예시
- 컨텍스트 안내: Codex가 자동으로 확인하는 정보와 직접 첨부해야 하는 정보
- 검증 방법: 결과물을 확인하는 방법
참고: IDE 확장 프로그램은 열려 있는 파일을 컨텍스트에 자동으로 포함합니다. CLI에서는 경로를 명시하거나
/mention과@경로 자동 완성으로 파일을 첨부하세요.
Codex는 파일 및 네트워크 접근을 제한하는 샌드박스에서 로컬 명령어를 실행합니다. 작업에 이 범위를 벗어나는 접근이 필요하면 Codex는 사용자의 승인 정책에 따라 다음 단계를 진행합니다.
코드베이스 설명 요청하기
새로 프로젝트에 참여하거나 서비스를 인수할 때, 또는 프로토콜, 데이터 모델, 요청 플로우를 파악할 때 사용하세요.
IDE 확장 프로그램 워크플로우(로컬에서 가장 빠르게 탐색하는 방법)
-
관련성이 가장 높은 파일을 여세요.
-
살펴볼 코드를 선택하세요(선택 사항이지만 권장합니다).
-
Codex에 다음과 같이 요청하세요.
선택한 코드에서 요청이 어떤 경로로 처리되는지 설명해 주세요. 다음 내용을 포함해 주세요. - 관련 모듈이 각각 어떤 역할을 하는지 짧게 정리해 주세요. - 어떤 데이터를 어디에서 검증하는지 알려 주세요. - 이 코드를 수정할 때 놓치기 쉬운 점을 한두 가지 짚어 주세요.
검증 방법:
- 직접 확인할 수 있는 다이어그램이나 체크리스트를 요청하세요.
요청 플로우를 단계별로 번호를 붙여 정리해 주세요. 그런 다음 관련 파일을 나열해 주세요.
CLI 워크플로우(세션 기록과 셸 명령어가 필요할 때)
-
대화형 세션을 시작하세요.
codex -
필요하면 파일을 첨부하고 다음과 같이 요청하세요.
이 서비스에서 사용하는 프로토콜을 이해하고 싶습니다. @foo.ts @schema.ts 두 파일을 읽고 스키마와 요청 및 응답 플로우를 설명해 주세요. 어떤 필드가 필수이고 어떤 필드가 선택 사항인지, 하위 호환성을 위해 어떤 규칙을 지켜야 하는지에 집중해 주세요.
컨텍스트 안내:
- Composer에서
@를 사용해 워크스페이스의 파일 경로를 삽입하거나/mention으로 특정 파일을 첨부할 수 있습니다.
버그 수정하기
로컬에서 잘못된 동작을 재현할 수 있을 때 사용하세요.
CLI 워크플로우(재현과 검증을 빠르게 반복하는 방법)
-
리포지터리 루트에서 Codex를 시작하세요.
codex -
Codex에 재현 절차와 원인으로 의심되는 파일을 알려 주세요.
버그: 설정 화면에서 "Save"를 클릭하면 간혹 "Saved"가 표시되는데도 변경 사항이 저장되지 않습니다. 재현 절차: 1) 앱을 시작합니다: npm run dev 2) /settings 경로로 이동합니다. 3) "Enable alerts" 토글의 상태를 바꿉니다. 4) Save를 클릭합니다. 5) 페이지를 새로고침하면 토글이 원래 상태로 돌아갑니다. 제약 조건: - API 구조를 바꾸지 마세요. - 수정 범위는 최소화하고 가능하면 회귀 테스트를 추가해 주세요. 먼저 로컬에서 버그를 재현한 다음 패치를 제안하고 검사를 실행해 주세요.
컨텍스트 안내:
- 사용자가 제공하는 정보는 재현 단계와 제약 조건입니다. 대략적인 증상 설명보다 이 정보가 더 중요합니다.
- Codex가 제공하는 정보는 명령어 출력, 탐색 중 발견한 호출 지점, 실행 중 발생한 스택 트레이스입니다.
검증 방법:
- Codex가 수정 후 재현 단계를 다시 실행하도록 하세요.
- 평소 사용하는 검사 파이프라인이 있다면 실행을 요청하세요.
수정 후 린트 검사와 이번 수정에 필요한 최소 범위의 테스트 모음을 실행해 주세요. 실행한 명령어와 결과를 알려 주세요.
IDE 확장 프로그램 워크플로우
-
버그가 있다고 의심되는 파일과 해당 코드를 직접 호출하는 파일을 여세요.
-
Codex에 다음과 같이 요청하세요.
"Saved"가 표시되는데도 변경 사항이 저장되지 않는 버그를 찾아 주세요. 수정안을 제안한 뒤 UI에서 검증하는 방법을 알려 주세요.
테스트 작성하기
테스트할 범위를 정확하게 지정하려는 경우에 사용하세요.
IDE 확장 프로그램 워크플로우(코드 선택)
-
함수가 있는 파일을 여세요.
-
함수를 정의하는 줄을 선택하세요. 명령 팔레트에서 “Add to Codex Thread”를 선택해 해당 줄을 컨텍스트에 추가하세요.
-
Codex에 다음과 같이 요청하세요.
이 함수의 단위 테스트를 작성해 주세요. 다른 테스트에서 사용하는 규칙을 따라 주세요.
컨텍스트 안내:
- “Add to Codex Thread” 명령어는 선택한 줄(줄 번호로 지정한 범위)과 열려 있는 파일을 컨텍스트로 제공합니다.
CLI 워크플로우(프롬프트에 경로와 줄 범위 지정)
-
Codex를 시작하세요.
codex -
함수 이름을 지정해 요청하세요.
@transform.ts 파일에 있는 invert_list 함수의 테스트를 추가해 주세요. 정상 동작과 경계 사례를 모두 확인해 주세요.
스크린샷으로 프로토타입 만들기
디자인 시안, 스크린샷 또는 참고용 UI를 실제로 동작하는 프로토타입으로 만들 때 사용하세요.
CLI 워크플로우(이미지와 프롬프트 사용)
-
스크린샷을 로컬에 저장하세요(예:
./specs/ui.png). -
Codex를 실행하세요.
codex -
이미지 파일을 터미널로 끌어와 프롬프트에 첨부하세요.
-
이어서 제약 조건과 결과물의 구성을 알려 주세요.
이 이미지를 바탕으로 새 대시보드를 만들어 주세요. 제약 조건: - react, vite, tailwind를 사용하고 코드는 typescript로 작성해 주세요. - 간격, 타이포그래피, 레이아웃을 이미지와 최대한 비슷하게 맞춰 주세요. 결과물: - UI를 렌더링하는 새 라우트/페이지 - 구현에 필요한 소규모 컴포넌트 - 로컬 실행 방법을 담은 README.md
컨텍스트 안내:
- 이미지는 시각적 요구 사항을 보여 줍니다. 프레임워크, 라우팅, 컴포넌트 스타일 등 구현상의 제약 조건은 별도로 지정하세요.
- 마우스 포인터를 올렸을 때의 상태, 유효성 검사 규칙, 키보드 조작 등 이미지에서 알 수 없는 동작은 글로 설명하세요.
검증 방법:
- 허용되는 경우 Codex에 개발 서버를 실행하고 프로토타입을 확인할 정확한 위치를 알려 달라고 요청하세요.
개발 서버를 시작하고 프로토타입을 볼 수 있는 로컬 URL과 라우트를 알려 주세요.
IDE 확장 프로그램 워크플로우(이미지와 기존 파일 사용)
-
Codex 채팅에 이미지를 끌어다 놓거나 붙여넣어 첨부하세요.
-
Codex에 다음과 같이 요청하세요.
새 설정 페이지를 만들어 주세요. 첨부한 스크린샷을 기준으로 UI를 구현해 주세요. 이 프로젝트의 다른 파일에 쓰인 디자인과 시각적 패턴을 따라 주세요.
실시간으로 변경 사항을 확인하며 UI 다듬기
Codex가 코드를 편집하는 동안 설계, 수정, 새로고침, 추가 수정을 빠르게 반복하고 싶을 때 사용하세요.
CLI 워크플로우(Vite 실행 후 짧은 프롬프트로 반복 수정)
-
Codex를 시작하세요.
codex -
별도의 터미널 창에서 개발 서버를 시작하세요.
npm run dev -
Codex에 변경을 요청하세요.
랜딩 페이지의 스타일을 개선할 방법을 두세 가지 제안해 주세요. -
방향을 정하고 짧고 구체적인 프롬프트로 다듬으세요.
2번 안으로 진행해 주세요. 헤더만 다음과 같이 수정해 주세요. - 잡지 지면처럼 글자의 크기와 배치를 다듬어 주세요. - 여백을 늘려 주세요. - 모바일에서도 보기 좋게 표시되는지 확인해 주세요. -
한 번에 한 가지 개선 사항에 집중해 요청을 반복하세요.
이번에는 화면이 덜 복잡해 보이도록 다듬어 주세요. 레이아웃은 유지하되 색상 구성을 단순화하고 불필요한 테두리를 없애 주세요.
검증 방법:
- Codex가 코드를 수정하는 동안 브라우저에서 변경 사항을 확인하세요.
- 마음에 드는 변경 사항은 커밋하고 나머지는 되돌리세요.
- 직접 수정하거나 되돌린 내용은 Codex에 알려 주세요. 그래야 다음 프롬프트를 처리하면서 해당 내용을 덮어쓰지 않습니다.
클라우드에 리팩터링 위임하기
로컬 컨텍스트를 활용해 접근 방식을 설계한 다음, 시간이 오래 걸리는 구현을 병렬로 실행할 수 있는 클라우드 채팅에 맡기려는 경우에 사용하세요.
로컬에서 계획 세우기(IDE)
-
변경 사항을 명확하게 비교할 수 있도록 현재 작업을 커밋하거나 최소한 스태시에 저장하세요.
-
Codex에 리팩터링 계획을 요청하세요.
$plan스킬을 사용할 수 있다면 명시적으로 호출하세요.$plan 다음 목표에 맞춰 인증 하위 시스템을 리팩터링해야 합니다. - 토큰 파싱, 세션 로딩, 권한 처리의 책임을 분리합니다. - 순환 import를 줄입니다. - 테스트하기 쉽게 만듭니다. 제약 조건: - 사용자가 보는 동작은 바꾸지 마세요. - 공개 API는 안정적으로 유지해 주세요. - 단계별 마이그레이션 계획을 포함해 주세요. -
계획을 검토하고 필요한 변경 사항을 조율하세요.
계획에 다음 내용을 반영해 주세요. - 각 마일스톤에서 어떤 파일을 이동할지 정확히 명시해 주세요. - 롤백 전략을 포함해 주세요.
컨텍스트 안내:
- Codex가 로컬에서 현재 코드의 진입점, 모듈 경계, 종속성 그래프를 파악할 단서 등을 살펴볼 수 있을 때 계획을 가장 효과적으로 세울 수 있습니다.
클라우드에 위임하기(IDE → 클라우드)
-
아직 설정하지 않았다면 Codex 클라우드 환경을 설정하세요.
-
프롬프트 Composer 아래의 클라우드 아이콘을 클릭하고 사용할 클라우드 환경을 선택하세요.
-
다음 프롬프트를 입력하면 Codex가 클라우드에 새 채팅을 만듭니다. 계획과 로컬 소스 변경 사항을 포함한 기존 채팅의 컨텍스트가 새 채팅으로 이어집니다.
계획의 마일스톤 1을 구현해 주세요. -
클라우드에서 코드 변경 내역을 검토하고 필요하면 추가로 수정하세요.
-
클라우드에서 바로 PR을 만들거나, 변경 사항을 로컬로 가져와 테스트하고 마무리하세요.
-
계획의 나머지 마일스톤도 같은 방식으로 진행하세요.
클라우드에 위임한 작업은 격리된 환경에서 실행됩니다. 해당 환경에서 인터넷 접근을 활성화하지 않으면 에이전트 실행 단계에서는 인터넷에 접근할 수 없습니다. 자세한 내용은 클라우드 인터넷 접근을 참고하세요.
로컬에서 코드 리뷰하기
커밋하거나 PR을 만들기 전에 코드를 한 번 더 검토받고 싶을 때 사용하세요.
CLI 워크플로우(작업 트리 검토)
-
Codex를 시작하세요.
codex -
리뷰 명령어를 실행하세요.
/review -
필요하면 중점적으로 검토할 사항을 지정하세요.
/review 경계 사례와 보안 이슈를 중점적으로 검토해 주세요.
검증 방법:
- 리뷰 피드백을 반영해 수정한 다음
/review를 다시 실행해 문제가 해결됐는지 확인하세요.
GitHub pull request 리뷰하기
브랜치를 로컬로 가져오지 않고 리뷰 피드백을 받고 싶을 때 사용하세요.
먼저 리포지터리에서 Codex의 코드 리뷰 기능을 활성화하세요. 자세한 내용은 코드 리뷰를 참고하세요.
GitHub 워크플로우(댓글로 리뷰 요청)
-
GitHub에서 pull request를 여세요.
-
댓글에 Codex를 태그하고 중점적으로 검토할 부분을 명시하세요.
@codex review -
필요하면 지침을 더 구체적으로 작성하세요.
@codex review 보안 취약점과 보안상 우려되는 부분을 검토해 주세요.
문서 업데이트하기
문서를 정확하고 명확하게 수정해야 할 때 사용하세요.
IDE 또는 CLI 워크플로우(로컬에서 편집 및 검증)
-
수정할 문서 파일을 찾아 IDE에서 열거나, IDE 또는 CLI에서
@로 해당 파일을 지정하세요. -
Codex에 작업 범위와 검증 요구 사항을 알려 주세요.
"advanced features" 문서에 인증 문제 해결 방법을 추가해 주세요. 모든 링크가 유효한지 확인해 주세요. -
Codex가 수정안을 작성하면 문서를 검토하고 필요에 따라 다듬으세요.
검증 방법:
- 렌더링된 페이지를 읽어 보세요.