ChatGPT 워크 도구 및 스킬 참조 - 종합 개요

Codex 도구 참조란 무엇이며 왜 중요한가

Codex 도구 참조는 ChatGPT 워크(Codex라고도 함)를 위한 232개의 호출 가능한 도구 인터페이스와 44개의 완전한 스킬 정의를 나열하는 공개 호스팅 인벤토리입니다. 이는 개발자와 AI 에이전트가 브라우저 자동화부터 데이터 분석, GitHub 관리, Gmail 작업에 이르기까지 ChatGPT의 확장된 기능을 구동하는 정확한 API를 발견하고, 이해하고, 호출할 수 있는 단일 진실 공급원 역할을 합니다. TypeScript 선언, 도구 설명 및 각 스킬에 대한 전체 SKILL.md 소스를 노출함으로써, 이 참조는 다소 불투명한 "플러그인" 생태계를 투명하고, 재현 가능하며, 감사 가능하게 만듭니다.

주요 도구 카테고리에 대한 자체 포함된 개요

1. 핵심 호출 가능 인터페이스 (223개 도구 + 9개 세션 제어)

파일 및 프로세스 조작 – apply_patch, exec_command, view_image, write_stdin, update_plan.
협업 기본 요소 – collaboration.spawn_agent, collaboration.send_message, collaboration.list_agents, collaboration.interrupt_agent, collaboration.wait_agent.
스킬 관리 – 재사용 가능한 명령 패키지를 발견하고 로드하기 위한 skills__list, skills__read.
플러그인 처리 – 필요한 기능이 누락된 경우 플러그인을 제안하는 request_plugin_install.
MCP 리소스 – 서버 측 데이터를 모델에 노출하는 list_mcp_resource_templates, list_mcp_resources, read_mcp_resource.

2. 고급 기능 그룹 (스킬)

카테고리	대표 스킬	일반적인 사용 사례
문서 및 시각 자료	`answers-charts`, `answers-images`, `documents`, `imagegen`, `pdf`, `Presentations`, `Spreadsheets`, `visualize`, `writing-blocks`	차트 생성, Word/Google Docs 편집, 래스터 이미지 생성, PDF 렌더링, 슬라이드 데크 제작, 스프레드시트 생성 또는 대화형 시각화 렌더링.
브라우저 및 사이트	`control-browser`, `sites:sites-building`, `sites:sites-hosting`, `sites:sites-preview-troubleshooting`	Playwright를 사용하여 인증된 웹 상호작용 자동화, 정적 사이트 구축 및 호스팅 또는 미리보기 실패 문제 해결.
컨텍스트 및 상호작용	`demos:answers-ask-user-input`, `openai-library:library`, `personal-context`, `resolve-recipients`	누락된 데이터에 대해 사용자에게 메시지 표시, ChatGPT 라이브러리 액세스, 대화 연속성 유지 또는 메시지 전송 전 수신자 ID 명확히 구분.
OpenAI, 스킬 및 플러그인	`openai-docs`, `plugin-creator`, `plugin-management:plugin-management`, `skill-creator`, `skill-installer`, `template-creator`	OpenAI 제품 문서 검색, 새 플러그인 스캐폴드, 설치된 플러그인 관리, 새 스킬 생성 또는 설치 및 기존 아티팩트에서 재사용 가능한 템플릿 생성.
데이터 분석	`data-analytics:build-dashboard`, `data-analytics:build-report`, `data-analytics:visualize-data`, `data-analytics:metric-diagnostics`, `data-analytics:market-sizing`	KPI 대시보드 구축, 임원 보고서 작성, 데이터 품질 검증, 지표 이상 진단 및 투명한 가정으로 시장 규모 추정.
워크 반려동물 및 데모	`work-pets:create-pet`, `work-pets:update-pet`, `work-pets:pets`, `demos:onboarding-setup-pet`	사용자 경험을 개인화하는 애니메이션 ChatGPT 워크 "반려동물" 생성, 미리보기 및 관리.
자동화	`automations.create`, `automations.update`, `automations.list`, `automations.peek`	Gmail, Slack, GitHub 및 기타 커넥터에 대한 반복 알림, 조건 감시 작업 또는 웹훅 기반 자동화 예약.
GitHub	리포지토리 CRUD, 이슈/PR 수명 주기, 워크플로 아티팩트 및 코드 검색을 다루는 80개 이상의 도구(예: `github_create_issue`, `github_fetch_pr`, `github_merge_pull_request`).	언어 모델에서 직접 엔드투엔드 소프트웨어 개발 워크플로우 활성화.
Gmail	라벨 관리, 메시지 읽기, 초안 작성, 전송, 전달 및 대량 작업을 위한 21개 도구(예: `gmail_apply_labels_to_emails`, `gmail_create_draft`, `gmail_bulk_label_matching_emails`).	AI 에이전트가 이메일을 구성, 작성 및 처리하는 개인 비서 역할을 하도록 허용.

AI 소비를 위해 참조가 구성되는 방식

스킬 페이지는 모델이 모호함 없이 정확한 명령 세트를 읽을 수 있도록 SKILL.md 소스를 그대로 재현합니다.
도구 선언은 모델이 구문 분석하여 올바르게 타입이 지정된 JSON 페이로드를 생성할 수 있는 TypeScript 서명으로 제공됩니다.
가용성 플래그(세션 구성, 권한, 설치된 플러그인)는 명시적으로 문서화되어 있으므로 모델은 누락된 기능을 정상적으로 처리할 수 있습니다.

해커 뉴스 댓글에서 얻은 커뮤니티 통찰

@simonw – "배경(및 생성 프롬프트)은 이 댓글을 참조하세요: https://news.ycombinator.com/item?id=49504625#49505116"
저자는 원래 생성 프롬프트를 가리키며, 이 참조가 기본 Codex 구성에서 프로그래밍 방식으로 생성되었음을 확인합니다. 이 출처는 인벤토리가 정적 스냅샷이 아닌 실제 시스템을 반영한다는 것을 독자에게 확신시킵니다.

@simonw – "가장 흥미로운 스킬은 control-browser입니다. 이는 ChatGPT 워크에 Node.js REPL을 통해 Playwright 인스턴스를 시작하는 방법을 알려준 다음, 사용 지침을 검색하기 위해 nodeRepl.write(await browser.documentation());을 실행합니다."
이 댓글은 스킬이 방대한 마크다운 블롭을 포함하는 대신 런타임 호출에 문서화의 무거운 작업을 위임하는 디자인 패턴을 강조합니다. 이를 통해 스킬이 간결해지고 중복이 줄어들며 문서가 기본 라이브러리와 동기화 상태를 유지할 수 있습니다.

@satvikpendem – "Codex가 동일한 모든 작업을 수행할 수 있다면 이것이 Codex와 어떻게 다른지 이해할 수 없습니다."
구분점은 Codex는 기본 실행 엔진을 지칭하는 반면, ChatGPT 워크(UI 계층)는 엄격한 도구 호출 계약을 시행하고, 스킬 선택을 위한 큐레이션된 UI를 제공하며, 안전 검사(예: 권한 게이팅, 토큰 예산 책정)를 추가한다는 것입니다. 이 참조는 해당 계약을 명시적으로 만듭니다.

@montroser – "일반 크기 화면에서 웹사이트를 테스트하는 방법에 대한 것을 하나 받을 수 있을까요? 4K 모니터가 아닌 이상 왼쪽 사이드바는 자체적으로 스크롤되어야 합니다."
이 요청은 실질적인 한계를 강조합니다. 즉, 많은 브라우저 자동화 스킬이 기본 뷰포트를 가정합니다. control-browser에 set_viewport 매개변수를 추가하면 이러한 UI 특정 테스트 요구 사항을 해결할 수 있습니다.

@enraged_camel – "AI가 생성한 웹사이트는 왜 항상 똑같이 생겼나요? Bootstrap 같은 느낌이 듭니다."
이 댓글은 더 광범위한 디자인 편향을 암시합니다. 즉, 많은 시각 생성 스킬(예: imagegen, visualize)이 기본 스타일 라이브러리에 의존합니다. 이러한 스킬에 다양성 매개변수(테마, 레이아웃 그리드, 디자인 시스템)를 도입하면 "Bootstrap 효과"를 완화할 수 있습니다.

@felixgallo – "Sam Altman의 과거, OpenAI의 안전 변경 사항 및 HuggingFace 사태를 고려할 때 ChatGPT 워크를 사용하는 것은 심각한 실수입니다."
정치적이긴 하지만, 이 댓글은 개발자에게 플랫폼과 거버넌스의 신뢰성을 평가하도록 상기시킵니다. 참조의 오픈 소스 특성은 도구 정의에 대한 독립적인 감사를 허용함으로써 일부 위험을 완화합니다.

@darepublic – "이러한 워크 도구 중 일부는 작업 속도를 늦추고 수많은 토큰을 낭비할 수 있습니다."
실제로 도구를 호출하면 요청/응답 페이로드에 대한 토큰 오버헤드가 발생합니다. 참조의 명시적인 max_output_tokens 필드(예: exec_command에서)는 개발자가 현실적인 한계를 설정하고 비용이 무제한으로 증가하는 것을 방지하는 데 도움이 됩니다.

개발자를 위한 실용적인 교훈

참조를 계약으로 사용 – 사용자 정의 ChatGPT 워크 통합을 구축할 때 페이로드 호환성을 보장하기 위해 TypeScript 선언을 직접 가져옵니다.
스킬 재사용 활용 – 일반적인 패턴(예: "누락된 컨텍스트에 대해 사용자에게 묻기")을 다시 구현하는 대신, 기존 demos:answers-ask-user-input 스킬을 호출하여 프롬프트를 일관되게 유지합니다.
권한 감사 – 각 도구는 필요한 권한(예: sandbox_permissions, require_escalated)을 나열합니다. 스킬을 활성화하기 전에 배포의 보안 정책에 대해 이를 검증합니다.
최소한의 마찰로 확장 – 새로운 기능을 추가하려면 skill-creator 스킬을 만들고, 플러그인 디렉토리를 스캐폴드한 다음, plugin-management를 통해 등록합니다. 이 참조에는 이 워크플로우를 자동화하는 plugin-creator 스킬이 이미 포함되어 있습니다.
토큰 예산 모니터링 – exec_command 및 functions.wait와 같은 도구는 max_output_tokens 및 yield_time_ms를 노출합니다. 불필요한 토큰 소비를 방지하기 위해 예상되는 명령 출력 크기에 따라 이러한 값을 조정합니다.
UI 제약 조건 계획 – 워크플로가 시각적 레이아웃(예: 반응형 디자인 테스트)에 의존하는 경우, control-browser 스킬에 뷰포트 제어 매개변수를 추가하거나 탐색 전에 원하는 크기를 설정하는 상위 수준 스킬로 래핑하는 것을 고려합니다.

결론

Codex 도구 참조는 저수준 OS 명령부터 고수준 비즈니스 분석에 이르기까지 ChatGPT 워크가 수행할 수 있는 모든 작업에 대한 종합적이고 기계 판독 가능한 카탈로그입니다. 도구 서명과 전체 스킬 소스를 모두 노출함으로써, 개발자는 기능을 프로그래밍 방식으로 발견하고, 보안 경계를 감사하고, 강력한 AI 기반 워크플로우를 구축할 수 있습니다. 해커 뉴스의 커뮤니티 댓글은 도구 집합의 향후 개선을 안도할 수 있는 실제 우려 사항(문서 디자인, UI 인체공학, 토큰 효율성 및 플랫폼 신뢰)을 표면화합니다.