특정 작업 잘하기

스킬

• 반복해서 재사용하는 특정 절차
• AGENTS.md처럼 매번 컨텍스트에 포함되지는 않음
• 필요할 때 검색해서 로딩함
• 스킬 파일의 구조: .agent/skills 폴더에 스킬별로 폴더를 만들어 저장

.agent/skills/
└── my-skill/
    ├── SKILL.md      # 필수: 지침과 메타데이터
    ├── scripts/      # 선택: 실행 가능한 코드
    ├── references/   # 선택: 문서
    └── assets/       # 선택: 템플릿과 리소스

SKILL.md

• 스킬을 설명한 마크다운 파일
• frontmatter로 이름과 설명을 기술

---
name: commit
description: 변경 사항을 의미 있는 단위로 스테이징하고 커밋합니다. 사용자가 커밋을 만들거나, 커밋을 정리하거나, push 전에 브랜치를 정돈하려고 할 때 사용합니다.
---

• 기본적으로 frontmatter만 로딩
• 프롬프트에 따라 description이 맞으면 나머지 파일 내용 전체가 로딩됨
• $commit과 같이 명시적으로 로딩할 수 있음
  • Claude에서는 /commit
• 에이전트에게 스킬을 만들라고 명령할 수도 있음

skills.sh

• 여러 AI 에이전트들을 지원하는 오픈소스 스킬 생태계

훅 hook

• 특정한 이벤트가 발생했을 때 자동으로 미리 저장된 스크립트를 실행

규칙 rules

• Codex와 Claude가 다름
• Codex: 특정 명령을 실행할 때 허용, 확인 요청, 차단 여부를 정하는 정책
• Claude: CLAUDE.md와 비슷하지만 특정한 경로의 파일들(예: *.ts)에만 적용되는 지침

목표 goal

• 일반 프롬프트: "다음 작업을 해줘"
• 목표: "이 상태가 참이 될 때까지 계속 작업해줘"
• 끝 상태는 분명하지만 거기까지 가는 경로가 불확실한 작업에 사용
  • 성능 개선처럼 측정과 수정이 반복되는 작업
  • 불안정하게 실패하는 테스트의 재현과 원인 분석
  • 의존성 마이그레이션이나 여러 단계의 리팩터링
  • 벤치마크 기반 튜닝
• 목표에 필요한 것들
  • 측정 가능한 최종 상태 하나
  • 명시적인 확인 방법
  • 중요한 제약 조건
• 목표가 너무 오래 실행되지 않게 하려면 조건에 작업 횟수나 시간 제한을 부여

서브 에이전트 subagent

• 전문화된 서브 에이전트를 병렬로 생성해 동시에 작업을 하게 할 수 있음
• Codex에서는 "subagent를 만들어서 작업해라" 등으로 지시하면 됨
• 모델이 한 번에 안정적으로 다룰 수 있는 정보에는 한계가 있으므로 여러 개의 서브 에이전트를 만들어 컨텍스트 오염과 부패를 막음
• 메인 에이전트는 요구 사항, 결정, 최종 출력에 집중
• 서로 독립적인 작업은 병렬로 실행해 시간을 줄일 수 있음
• 읽기 중심 작업에 병렬 에이전트를 사용하는 것이 좋음
• 쓰기 중심 병렬 워크플로는 여러 에이전트가 동시에 코드를 편집해 충돌 가능성이 있음

플러그인 plugin

• 스킬, 앱 통합, MCP 서버 등을 재사용할 수 있게 만든 묶음
• 에이전트 기능을 확장
• 예: Gmail 플러그인을 설치해 Codex가 Gmail을 읽고 관리하게 함

컴퓨터 & 브라우저 제어

• 컴퓨터 마우스, 키보드 및 웹 브라우저를 제어하는 것도 가능
• MCP 등으로 직접 연결되어 있지 않은 앱이나 웹사이트도 연동할 수 있음

Codex Record & Replay

• 사용자가 한 번 직접 시연하면, Codex가 그 과정을 재사용 가능한 Skill로 전환해 주는 기능
• 사용자는 절차를 녹화
• Codex는 필요한 화면 내용과 조작 흐름을 관찰
• Computer Use, 브라우저 동작, 플러그인 등 사용 가능한 도구와 함께 스킬 재사용
• macOS용 Codex 앱 기능
• Computer Use 활성화 필요
• 말로 설명하기 복잡하지만 매번 비슷하게 반복되는 업무에 적합