기본 패턴
text
역할 나누기
- AGENTS.md: 저장소 규칙과 기본 지침
- Skills: 반복 가능한 작업 절차 패키지
- MCP: 외부 시스템과 도구 연결
- Automations: 정기적으로 돌아가는 백그라운드 작업설명
- Customization 문서는 이 네 가지를 경쟁 관계가 아니라 서로 보완하는 층으로 설명합니다.
- Skills는
SKILL.md와 선택적 스크립트, 레퍼런스, 에셋으로 구성되는 재사용 워크플로우이며, 반복 작업을 매번 긴 프롬프트로 다시 설명할 필요를 줄여 줍니다. - MCP는 외부 도구, 문서 서버, 이슈 트래커 같은 로컬 저장소 밖 시스템에 Codex를 연결할 때 쓰는 표준 인터페이스입니다.
- Automations는 Codex app에서 백그라운드로 정기 실행되는 작업이며, Git 저장소에서는 로컬 프로젝트나 Worktree 중 어디에서 돌릴지 고를 수 있습니다.
- 공식 가이드는 자동화를 바로 스케줄링하기보다, 먼저 일반 스레드에서 수동으로 시험해 프롬프트와 diff 품질을 확인한 뒤 일정 작업으로 승격하라고 권합니다.
짧은 예제
text
반복 작업을 올리는 순서
1. 수동 프롬프트로 한 번 잘 되는지 확인
2. 자주 쓰이면 Skill로 승격
3. 외부 시스템이 필요하면 MCP 연결
4. 정기 점검이 되면 Automation으로 예약빠른 정리
| 층 | 주 역할 |
|---|---|
| AGENTS.md | 저장소 규칙과 기본 행동 |
| Skill | 반복 가능한 절차와 보조 자료 |
| MCP | 외부 시스템 접근 |
| Automation | 정기 실행과 백그라운드 처리 |
| Worktree 기반 자동화 | 현재 로컬 작업과 변경 분리 |
주의할 점
아직 수동으로도 안정적이지 않은 프롬프트를 바로 자동화하면 실패를 예약하는 셈이 됩니다. 먼저 일반 스레드에서 결과를 검증하고, 그다음 Skill이나 Automation으로 올리는 순서를 지키는 편이 안전합니다.
참고 링크
3 sources