Cofa Ready Kit

시험장에서 열어 둘 문서는 이것 하나입니다: .cofa-kit/README.md

시작하기 · 한 번 복사할 통합 요청 · 수정 요청 · 작업 내역 정리 · MCP·플러그인 · 전체 문서 지도

순서: 받기 → 이 README 열기 → 2번 통합 요청 한 번 보내기 → 필요한 MCP 화면 저장 → 작업·검증 → 직접 제출. 통합 요청이 목표·스킬·MCP·키트 플러그인 준비와 반복 개선을 연결하므로 여러 시작 요청을 이어 붙일 필요가 없습니다.

11월 4일 재응시 안내 반영: 18:40 접속 준비 → 19:00 시작, 모든 단계 23:00 종료. 작업 최대 180분 뒤 질문 준비 대기와 서술형 6×5분이 이어집니다. 공개 Skill·MCP·Plugin 사용은 안내에 명시돼 있으며, 실제 과제의 허용 범위와 제공 CLI 지원을 확인합니다. 규칙과 PDF 출처

화면별 상세 순서와 복구법은 시험 진행 안내에 있습니다. Codex가 파일을 수정하는 동안 같은 파일을 에디터에서 함께 편집하지 않으면 저장 충돌을 줄일 수 있습니다.

1. 키트 받기

Cofa 안의 일반 터미널, 실제 과제 폴더에서 아래 한 줄을 실행합니다. Ask Codex 입력칸에 넣는 셸 명령이 아닙니다.

git clone --depth 1 https://github.com/ripplelover/cofa-ready-kit.git .cofa-kit

왼쪽 파일 목록에서 **.cofa-kit → README.md**를 엽니다. 시험 중에는 외부 브라우저로 GitHub에 들어가지 않고 이 로컬 파일을 봅니다. 과제 폴더의 원래 README.md는 문제, .cofa-kit/README.md는 이 사용법입니다. 작업 위치는 실제 과제 폴더로 유지합니다.

파일을 못 찾으면 파일·에디터 영역을 선택한 뒤 Ctrl+P로 .cofa-kit/README.md를 검색합니다. 문서 링크가 클릭되지 않으면 왼쪽 파일 목록에서 링크에 적힌 경로를 엽니다.

이미 .cofa-kit이 있거나 다운로드가 실패하면 지우거나 반복 실행하지 말고 제공 Codex에 현재 상태와 원인을 확인해 달라고 요청합니다. 받지 못하더라도 실제 문제 자료로 작업을 진행할 수 있습니다.

마크다운 원문이 읽기 불편하면

• 먼저 편집 영역을 넓힙니다. 가이드에 안내된 Ctrl+B로 탐색기를 접고, 패널 경계를 직접 드래그해 README 영역을 넓힐 수 있습니다. 필요한 제목은 Ctrl+F로 찾습니다. [참가자 상세 가이드 p.2]
• 미리보기는 지원할 때만 사용합니다. 일반 VS Code는 별도 확장 설치 없이 파일 탭 우클릭 → Open Preview, 또는 파일 편집 영역에서 Ctrl+Shift+V로 미리보기를 엽니다. 다만 Cofa가 이 기능을 제공하는지는 확인되지 않았습니다. Cofa 터미널의 같은 단축키는 붙여넣기입니다. 메뉴가 없으면 기존 화면으로 진행합니다. VS Code 공식 안내
• 미리보기가 없어도 스킬은 사용할 수 있습니다. 화면 렌더링과 Codex의 파일 읽기는 별개입니다. 표가 복잡하면 제출 확정 전에 제공 Codex에 아래처럼 요청합니다.

아직 제출 확정 전이야. .cofa-kit/README.md를 읽고 현재 단계에서 내가 할 일만
표나 긴 설명 없이 짧은 번호 목록으로 보여 줘. 터미널 명령과 Codex 요청문을 구분하고,
필요한 명령·요청문은 그대로 복사할 수 있게 별도 블록으로 보여 줘.

2. 제공 Codex에 시작 요청 보내기

아래 Terminal의 일반 셸에서 codex를 실행하고, 그 안의 Codex 입력칸을 사용합니다. 이미 Codex가 실행 중이면 같은 대화를 이어갑니다. /status로 모델·권한을 확인하고 /model에서 실제 제공된 허용 모델을 선택하며 개인 로그인·API 키를 추가하지 않습니다.

아래 블록 하나를 제공 Codex 입력칸에 복사합니다. 실제 과제 확인부터 도구 준비·반복 수정·검증·제출 준비까지 요청합니다. 아직 제출 확정 전이어야 합니다.

Codex 입력칸에 /를 입력했을 때 goal이 있으면 첫 줄의 /goal을 그대로 사용하세요. 없거나 “지원하지 않는 명령”이라고 나오면 같은 블록에서 맨 앞 /goal 만 지우고 일반 요청으로 보냅니다. 이미 목표가 실행 중이면 새 목표를 만들지 말고 /goal을 뺀 내용으로 같은 대화를 이어갑니다. /goal은 일반 셸 명령이 아닙니다. 공식 Goal 명령

/goal .cofa-kit/prompts/BOOTSTRAP.md를 읽고 도구 준비부터 실제 과제 구현·반복 검증·제출 준비까지 진행해 줘. 아직 제출 확정 전이야.
현재 위치와 실제 과제 README·AGENTS.md·필수 제출물을 먼저 확인해 줘.
키트의 README와 examples는 실제 시험 문제가 아니며 기존 코드·사용자 변경·작업 기록은 보존해 줘.
.cofa-kit/prompts/SCENARIO.md와 .cofa-kit/prompts/IMPROVE.md도 적용하고 필요한 스킬은 네가 골라 직접 읽어 줘.

지원되는 기능을 실제로 확인하고, MCP 설정 준비와 이 키트 플러그인의 설치·연결 확인까지 진행해 줘.
cofa_local과 Context7·Microsoft Learn·DeepWiki·OpenAI Docs를 준비하되 기존 설정·스킬과 중복되면 보존해 줘.
MCP 탭에 저장할 JSON은 네가 만들어 한 블록으로 보여 줘. 기존 mcpServers에 추가·저장하는 화면 조작은 내가 할게.
JSON 생성·설정 저장·도구 표시·실제 호출 성공·Goal 활성화 여부를 구분해서 알려 줘.
준비한 스킬·MCP·플러그인 중 현재 작업에 필요한 것만 쓰고, 원격 문서 질의에는 시험 내용을 넣지 마.
미지원·실패·설정 대기에는 가능한 로컬 도구로 과제 작업을 계속하고, 플랫폼 설정을 바꿔 우회하지 마.

실제 요구·업무 질문과 완료 기준을 짧게 정리한 뒤, 구현 → 실제 검사 → 문제 수정 → 기존 기능 확인을 반복해 줘.
기능 정확성·핵심 사용 흐름·가독성·설명력을 살피고, 매번 계속할지 묻지 말고 맡긴 작업을 이어가 줘.
화면의 남은 시간과 개선 중단 시각을 내가 아직 알려 주지 않았다면 한 번 짧게 물어보고 독립적인 점검은 계속해 줘.
개선 중단 시각은 최종 검사·문서·저장·직접 제출 여유를 남겨 정하고, 그 시각에는 새 개선을 멈추고 제출 준비로 전환해 줘.
이미 기준을 충족했고 새 개선 근거가 없으면 억지로 바꾸거나 같은 검사를 반복하지 마.
각 작업이 끝나면 한 일·이유·방법·실제 확인·남은 일을 쉬운 말로 짧게 알려 줘.
Browser 확인·업무 메신저·제출은 내가 직접 할게. 제출 확정 뒤에는 Goal·스킬·MCP를 포함한 AI 작업을 중단해 줘.

첫 응답에서 실제 문제 파일을 읽었는지, 필수 제출물이 무엇인지 확인합니다. 업무 질문은 오른쪽 실무자 에이전트에 본인이 보내고, 받은 답을 Codex에 전달합니다. 사용법은 Cofa Helper, 반복 장애는 문제 신고로 문의합니다.

한 번 복사하는 것은 작업 요청입니다. MCP 탭 저장·실제 승인 창·필수 업무 답변·Browser 확인·제출은 직접 해야 합니다. MCP JSON을 받으면 기존 mcpServers 안에 서버 항목을 합쳐 저장하고 같은 대화에 저장했어. 연결을 확인하고 계속해 줘.라고 보내세요. 이미 연결돼 있으면 다시 저장할 필요가 없습니다. /goal 미지원이면 일반 요청으로 진행하며, 중간에 멈췄을 때 같은 대화에서 계속 요청합니다.

설정에 실패해도 파일 직접 읽기와 기존 도구로 계속합니다. 도구 준비만 하고 답변을 끝내지 않도록 통합 지침에 연결했습니다. Codex가 읽는 전체 준비 절차

3. 진행하면서 필요한 말만 복사하기

업무 답변을 전달한 뒤 구현할 때:

확인된 조건부터 구현하고 관련 검증까지 진행해 줘.
한 일·왜 필요한지·어떻게 바꿨는지·실제 확인 결과·내가 할 일을 쉬운 말로 짧게 알려 줘.

수정이 끝나 검증할 때:

실제 요구사항과 대조해 정상·오류·경계 사례를 확인해 줘.
마지막 수정 이후의 검사 결과를 확인하고 실패·미검증·필수 누락을 구분해 줘.

제출을 확정하기 전에:

실제 필수 문서를 구현·검증 기록에 맞춰 정리해 줘.
작업 내역을 구현 기능·AI 활용·내가 확인한 판단·검증 결과·남은 한계로 나열해 줘.
내가 설명해야 할 문제 정의·선택 이유·검증 근거·남은 한계를 짚어 줘.
필수 파일의 실제 경로와 내가 직접 확인할 항목을 알려 줘.
저장 충돌과 전체 10GB 용량 기준도 확인해 줘. 디스크 검사는 선택형 submission-check를 사용하되,
실제 제출 대상·에디터 저장 상태·플랫폼 최종 완료는 별도 확인이라고 구분해 줘.

시간이 줄어들면 화면의 남은 시간은 __분이야. 필수 오류와 제출 준비를 우선해 줘.라고 실제 시간을 전달합니다. 작업 종료 10분 전부터 본인이 저장·필수 파일·제출 화면을 확인합니다.

알아서 수정·검증을 반복하게 하려면

2번 통합 요청에 이미 포함된 흐름입니다. 아래는 진행 중 시간·품질 기준을 바꾸거나 예전 시작 요청으로 작업 중일 때만 같은 대화에 보냅니다. 빈칸을 실제 값으로 바꾸고 개선 중단 시각은 최종 검증·저장·직접 제출 시간을 남겨 정합니다.

.cofa-kit/prompts/IMPROVE.md도 읽고 적용해 줘. 아직 제출 확정 전이야.
현재 __:__ KST, 화면의 작업 남은 시간은 __분, 개선 중단 시각은 __:__ KST야.
내가 중요하게 보는 품질은 [원하는 기능·사용성·가독성 등]이야.
첫 구현에서 끝내지 말고 요구 점검 → 중요한 문제 수정 → 실제 검증 → 회귀 확인을 반복해 줘.
매번 계속할지 묻지 말고 진행하되, 새 문제나 개선 근거가 없으면 억지로 바꾸지 마.
개선 중단 시각에는 최종 관련 검사·문서·저장·제출 안내로 전환해 줘.
화면은 내가 직접 확인할게. 수동 확인 항목을 알려 주고 독립된 검사는 계속해 줘.

마음에 안 들면 다시 clone하거나 새 대화를 만들 필요가 없습니다. 같은 대화에 문제: __ / 원하는 결과: __ / 유지할 것: __ / 현재 시각·남은 시간: __를 보내고 실제 수정·검증까지 요청합니다. 예: “핵심 결과가 아래에 묻히고 글자가 작아. 결과를 먼저 보여 주고 표를 읽기 쉽게 해 줘. 계산과 필터 동작은 유지해 줘.” 이 예시는 현재 과제에 해당할 때만 적용합니다.

/goal은 선택 사항입니다. 공식 Codex CLI에는 목표를 유지하며 작업하는 /goal이 있지만 Cofa 버전의 지원은 별도로 확인합니다. Codex 입력칸의 / 목록에 있으면 목표에 위 지침·품질 기준·개선 중단 시각을 넣습니다. 없으면 위 일반 요청으로 진행하고, 중간에 멈췄을 때 같은 대화에서 계속 요청합니다. 어떤 방식도 시험 타이머와 연동된 정시 자동 종료를 보장하지 않습니다. 복사할 목표·수정 요청과 중단 방법

제출 확정 뒤에는 AI·Skill·MCP 사용을 중단합니다. 키트는 Cofa의 제출 상태를 감지해 자동 차단하지 않으므로 본인이 사용을 멈춰야 합니다. 후속 서술형은 AI와 복사/붙여넣기 없이 직접 답합니다. 최종 업로드 후 완료 화면의 제출 ID·시각·파일 수·크기를 확인합니다. 화면별 상세 안내

작업이 끝나면 무엇을 했는지 보기

위 시작 요청을 보냈다면 각 작업이 끝날 때 한 일 → 왜 → 어떻게 → 실제 확인 → 남은 일을 쉬운 말로 4~6문장 안팎으로 먼저 알려 주도록 연결돼 있습니다. 스킬을 직접 읽어 써도 같은 완료 요약을 따릅니다. 파일 목록이나 어려운 용어만 나열하지 않고, 확인하지 못한 것은 그대로 밝힙니다. 이는 Codex가 따르는 지침이며 자동 실행 서비스는 아닙니다.

중요 내역은 기존 작업 기록에 남기고, 제출 준비나 상세 내역 요청 때 아래 항목도 정리합니다. 스킬 이름을 다시 고르거나 MCP를 추가할 필요가 없습니다.

이미 작업 중이거나 목록이 안 나오면 제출 확정 전에 제공 Codex 입력칸에 이것만 보냅니다.

아직 제출 확정 전이야. .cofa-kit/skills/cofa-explain/SKILL.md를 읽고 작업 내역을 정리해 줘.
먼저 무엇을 왜 어떻게 했는지와 확인 결과·남은 일을 쉬운 말로 짧게 설명해 줘.
실제 파일·현재 대화·검증 기록으로 확인되는 기능과 AI 활용을 나열해 줘.
내가 판단하거나 확인했다는 근거가 없으면 추정하지 말고 확인 필요로 표시해 줘.
기존 작업 기록이 있으면 보존하며 갱신하고 경로를 알려 줘. 없으면 우선 여기 보여 줘.

목록을 읽으며 정말 구현됐는지, 왜 그 선택을 했는지, 무엇을 확인하지 못했는지 본인이 확인합니다. 이는 제출 전 작업 기록이며 실제 서술형 답안이 아닙니다. 확정 뒤에도 기록을 열람할 수 있다고 가정하지 말고, 후속 문항은 AI·복사/붙여넣기 없이 직접 답합니다.

4. 특정 스킬을 직접 쓰고 싶다면

매번 스킬을 직접 고를 필요는 없습니다. 위 시작 요청으로 Codex에 선택을 맡깁니다. 아래는 직접 지정하고 싶을 때만 쓰는 메뉴입니다. 반도체 분석에는 해당 스킬, 실제 예측 모델 과제에는 모델 평가 스킬을 골라 읽도록 진행 지침에 연결했습니다.

MCP도 연결되어 실제 도구 목록에 보이는 것 중에서 Codex가 필요한 도구를 고릅니다. 로컬 검사에는 cofa_local의 6개 도구 중 필요한 것을, 공개 OpenAI 기술문서가 필요하면 선택해 연결한 openai_docs를 사용하도록 구성했습니다. 여러 개를 준비해 두되 매번 모두 호출하지 않습니다. git clone만으로 스킬 목록 등록이나 MCP 연결까지 되는 것은 아닙니다. MCP가 없으면 CLI·기존 도구로 진행합니다.

예를 들어 반도체 분석과 검증을 같이 시킬 때도 설치 없이 파일 두 개를 읽게 하면 됩니다.

.cofa-kit/skills/cofa-semiconductor/SKILL.md와
.cofa-kit/skills/cofa-verify/SKILL.md를 읽고 적용해 줘.
먼저 단위·분모·재검사 기준을 확인하고, 분석 후 실제 결과를 검증해 줘.
미확인 업무 기준과 실행하지 못한 검사는 구분해서 알려 줘.

$스킬이름으로 호출하는 방법은 선택형 설치·여러 스킬 사용법에 있습니다. 기본 사용에는 설치가 필요 없습니다.

5. 더 필요한 것만 찾아보기

모든 설명서·요청문·스킬은 전체 문서 지도에서 찾습니다. 설명서와 요청문 위에도 이 첫 화면과 문서 지도로 돌아오는 링크가 있습니다.

MCP를 연결하고 싶다면

사전 체험에서 확인한 최상위 이름은 **mcpServers**입니다. 아래 명령은 로컬 검사 + 공식 문서, 두 서버의 설정 후보를 만듭니다. 화면의 로컬 command·args와 원격 HTTP url 지원을 확인한 뒤 직접 저장합니다. 초기 Codex CLI에서도 스킬은 그대로 읽어 사용할 수 있습니다.

1. 일반 터미널의 실제 과제 폴더에서 다음을 실행합니다.

python3 .cofa-kit/scripts/install.py --workspace . --mcp-json --with-openai-docs

2. Cofa MCP 탭의 mcpServers 안에 출력된 cofa_local·openai_docs를 추가하고 저장합니다. 기존 서버는 보존합니다. 원격 url 지원이 확인되지 않으면 명령 끝의 --with-openai-docs를 빼서 로컬 서버만 생성·연결합니다. 생성기는 설정 출력만 하며 네트워크 연결·설정 저장·스킬 설치를 하지 않습니다.
3. 제공 Codex에 cofa_local의 profile_csv를 실제 호출해 .cofa-kit/examples/defects.csv를 요약해 줘. 도구가 없거나 실패하면 그대로 알려 줘.라고 요청해 연결을 확인합니다. openai_docs도 추가했다면 시험 자료를 포함하지 않은 Codex MCP 연결 상태 확인 방법 같은 일반 기술 질의로 별도 확인합니다.

연결 후에는 2번의 시작 요청만 보내면 됩니다. 이미 작업 중이면 아직 제출 확정 전이야. .cofa-kit/prompts/SCENARIO.md를 다시 읽고 현재 연결된 허용 MCP와 스킬 중 필요한 것만 골라 기존 작업을 이어가 줘.라고 보냅니다. 새 기능을 위해 매번 스킬·도구 이름을 지정할 필요가 없습니다.

외부 MCP를 더 추가하려면

외부 MCP 추가가 가능하다는 사용자 확인을 반영했습니다. 예를 들어 라이브러리 문서용 Context7 + 공개 GitHub 문서용 DeepWiki를 고르려면 다음을 실행하고 출력된 항목을 MCP 탭에 추가합니다.

python3 .cofa-kit/scripts/install.py --workspace . --mcp-json --mcp-preset context7 --mcp-preset deepwiki

--mcp-preset microsoft-learn 또는 --mcp-preset openai-docs도 사용할 수 있습니다. 원하는 서버 주소는 --remote-mcp 이름=https://서버주소/mcp, 기존 설정과 합치기는 --merge-mcp 기존설정.json으로 지원합니다. **외부 MCP·플러그인 바로 사용하기**에 후보별 용도·인증 조건·복사할 명령을 모았습니다. 기존 기본 두 서버 예제도 그대로 동작합니다.

플러그인으로 설치하려면

이제 키트 자체도 여섯 스킬을 묶은 플러그인입니다. doctor --check-plugins가 supported라면 다음을 실행합니다.

codex plugin marketplace add ./.cofa-kit
codex plugin add cofa-ready-kit@cofa-ready
codex plugin list --json

설치 목록과 새 대화의 스킬을 확인합니다. 스킬 복사 설치와 플러그인 설치 중 한 방식을 선택하세요. 개발 PC의 별도 임시 환경에서는 실제 설치를 확인했고, Cofa의 CLI가 이 명령을 지원하는지는 현재 환경에서 확인합니다. 미지원이면 스킬 직접 읽기·MCP 방식으로 사용할 수 있습니다. 다른 플러그인과 상세 절차

스킬·MCP가 준비됐는지 확인하기

설치본 차이·누락이나 연결 문제가 있을 때만 일반 터미널에서 실행합니다.

python3 .cofa-kit/scripts/cofa.py doctor --workspace . --check-mcp

스킬 파일 비교와 임시 예제 CSV를 이용한 로컬 MCP 실행을 점검합니다. 기존 파일·설정을 바꾸거나 원격 서버에 접속하지 않습니다. 스킬이 different이면 사용자 수정일 수 있으므로 보존하고 최신 키트의 SKILL.md를 직접 읽게 하세요. not_installed는 선택형 설치를 하지 않았다는 뜻이며 오류가 아닙니다. 로컬 검사 통과와 실제 Cofa 연결 성공은 별개입니다. 결과 해석

v1.6.2: 스킬 6개·로컬 MCP 도구 6개 + 외부 MCP 프리셋 4개·직접 주소·설정 합치기·키트 플러그인. 쉬운 완료 요약과 기존 CLI도 그대로 제공합니다. 모델 평가 스킬 사용 예

v1.6.0부터 11월 4일 새 PDF 3개를 반영한 화면별 사용법·복구 절차·시간표, 읽기 전용 **submission-check(용량·필수 파일 확인)**를 제공합니다. 명령과 결과 해석

v1.6.1에는 원하는 품질·개선 중단 시각을 기준으로 반복 수정·검증하는 지침, 마음에 들지 않는 결과의 피드백 요청, /goal 지원 확인과 일반 요청 대안을 보강했습니다. 반복 개선 지침

v1.6.2에서는 2번 통합 요청 하나로 Goal·스킬·MCP 설정 준비·지원되는 키트 플러그인 설치·연결 확인·반복 개선을 연결했습니다. 화면 저장과 실제 호출 성공은 별도로 확인합니다. 통합 준비 절차

SK하이닉스 AI 해커톤 2026 2차 예선용 비공식 준비 도구입니다. 개인 안내 기준 11월 4일(수) 19:00–23:00, 18:40까지 접속 준비, 과제 최대 180분·후속 서술형 6문항×5분이며 실제 공지·화면·과제 지시가 우선합니다. Proctor·신분 확인은 가이드와 화면 순서에 따릅니다. 실제 문제·정답·채점표는 포함하지 않습니다.

로컬 검증과 실제 Cofa 연결·과제 성공은 별개입니다. 실제 Cofa의 파일 작업·스킬 탐색·MCP 연결은 제공 환경에서 확인해야 합니다. 공개본은 MIT이며 개인 안내 원문·비밀키·시험 자료를 포함하지 않습니다. 시험 중에는 제공 Codex만 사용하고 문제·코드·결과물을 외부로 보내거나 Git Push하지 않습니다.