KDI국제정책대학원 2026 고위정책전략과정 — 고급: Codex 온보딩

첨부파일

데이터 분석 입문 ZIP

데이터 출처 가이드·샘플 CSV·출처 기록 양식·분석 요청문. 압축을 풀고 kdi-data-starter 폴더를 엽니다.

kdi-data-starter.zip

첨부파일

Codex 온보딩 발표자료 · HTML 22장

설치·로그인 다음 발표에서 사용합니다. 내려받은 HTML을 브라우저로 엽니다.

codex-kdi-workshop-deck.html

공식 다운로드·앱 시작 · ChatGPT 인증 안내

완료 기준

공식 앱이 열리고 수업용 Google 이메일 및 비밀번호 확인 위치를 안다.

막히면

설치 권한·네트워크 문제는 강사에게 알리고 짝 실습으로 전환한다. 비밀번호 카드가 안 보이면 본인 Learn 계정의 KDI 고급 수강 등록을 확인한다.

강사 진행 메모

사전 10분은 필수 실습 115분 밖이다. 계정 안내는 active 수강 등록이 있는 사용자에게만 API로 제공한다. 공개 발표자료나 교안에 비밀번호를 넣지 않는다. 설치 파일 다운로드에 Google 비밀번호를 입력하지 않는다.

다운로드·로그인 안내

수업용 Google 이메일은 ustudiopd@gmail.com입니다. 비밀번호는 로그인한 KDI 고급 수강생의 계정 카드에서 확인합니다. Learn 가입에는 본인 계정을 사용합니다. Google 추가 인증이 나오면 강사에게 확인해 주세요.

Step 2

2. Google 계정으로 Codex 로그인·첫 프로젝트 열기

published

Step 2

2. Google 계정으로 Codex 로그인·첫 프로젝트 열기

사전 준비 · 5분 · 사전 준비 · Codex 다운로드와 Google 로그인

목표

지정 Google 계정으로 ChatGPT 인증을 완료하고 Codex에서 실습 폴더를 연다.

이 단계 5분 · 선택 모듈 10분

따라 하기

1. 앱 로그인에서 ChatGPT로 로그인(Sign in with ChatGPT 또는 Continue)을 선택한다. API 키는 입력하지 않는다.

2. 브라우저의 인증 화면에서 Google로 계속하기(Continue with Google)를 선택한다. 개인 Google 계정이 선택되어 있으면 다른 계정 사용을 누른다.

3. ustudiopd@gmail.com을 입력하고 계정 안내 카드에서 확인한 비밀번호를 Google 로그인 화면에 입력한다. 별도의 ChatGPT 이메일·비밀번호 로그인 방식으로 입력하지 않는다.

4. 추가 인증·보안 확인이 나오면 강사에게 확인한다. 인증 후 앱으로 돌아와 프로필의 수업용 계정과 Codex 사용 가능 여부를 확인한다.

5. 통합 앱에서는 제품 선택에서 Codex를 선택한다. 실습 ZIP을 풀고 codex-kdi-lab 폴더를 프로젝트로 연 다음 새 채팅을 시작한다.

6. 설치 다음00 발표자료와 데이터 입문을 진행한 뒤01 공식 통계 실습을 시작한다. 실습을 마치면 공유 계정으로 로그인한 앱과 브라우저에서 로그아웃한다.

완료 기준

지정 계정으로 Codex가 열리고 codex-kdi-lab에서 새 채팅을 시작할 수 있다.

막히면

잘못된 계정은 로그아웃 후 Google로 계속하기→다른 계정 사용으로 다시 시도한다. 추가 인증이나 사용 제한은 강사에게 알리고, 임의로 복구 정보·비밀번호·구독을 변경하지 않는다.

강사 진행 메모

Google 비밀번호는 Google 인증 페이지에 입력한다. 계정 제공만으로 추가 인증 통과나 이용 한도를 보장하지 않는다. 실제 로그인은 수강생 환경에서 확인하며 강사 승인 없이 계정 설정을 변경하지 않는다.

다운로드·로그인 안내

공식 다운로드·앱 시작 · ChatGPT 인증 안내

다음 모듈: 발표자료 · Codex로 업무 보고서 만들기 (22장) →

Module 00lesson

발표자료 · Codex로 업무 보고서 만들기 (22장)

선택 · 40분 · 프로젝트에서 자료를 읽고 작성·검수하는 흐름을 이해한다.

5 steps

Step 1

Codex 작업 방식과 결과물 (슬라이드 1–6)

published

Step 1

Codex 작업 방식과 결과물 (슬라이드 1–6)

별도 발표 · 8분 · 발표자료 · Codex로 업무 보고서 만들기 (22장)

목표

프로젝트에서 자료를 읽고 작성·검수하는 흐름을 이해한다.

이 단계 8분 · 선택 모듈 40분

따라 하기

1. 아래 Codex 발표자료 HTML을 내려받아 브라우저로 연다. F는 전체화면, N은 발표 메모다.

2. 3번 슬라이드를 세 번 클릭해 자료 전달·프로젝트 작업·결과 확인을 비교한다.

3. 5번의 읽기→계획→실행→확인 흐름에서 변경 범위 합의와 검수 지점을 찾는다.

완료 기준

오늘 만들 HTML 보고서와 원고 경로, 숫자·출처 검수 기준을 설명한다.

막히면

발표 HTML이 열리지 않으면 강사 화면으로 보고 슬라이드 번호를 따라간다. N은 발표 메모, 좌우 화살표는 이동이다.

강사 진행 메모

발표 40분은 필수 115분과 별도다. 이 모듈은 선택이며 필수 완료율과 다음 필수 단계에서 제외한다. 기존 준비·실습·심화 순서를 유지하기 위해 교안 뒤에 자료 모듈로 연결했다. 강의는 실습 전에 진행할 수 있다.

첨부파일

Codex 온보딩 발표자료 · HTML 22장

별도 발표 40분. 내려받아 브라우저에서 열면 좌우 이동·F 전체화면·N 발표 메모를 사용할 수 있습니다.

codex-kdi-workshop-deck.html

다음 모듈: 입문 · 데이터를 한 폴더에 모아 Codex로 분석하기 →

공식 사용법

앱 시작 · AGENTS.md · Build skills

발표는 필수 115분과 선택 심화 200분에서 별도로 운영합니다. 실습은 과정 시작에서 공식 통계 실습으로 들어갑니다.

Step 2

설치·프로젝트·권한 확인 (슬라이드 7–10)

published

Step 2

설치·프로젝트·권한 확인 (슬라이드 7–10)

별도 발표 · 10분 · 발표자료 · Codex로 업무 보고서 만들기 (22장)

목표

Codex 프로젝트와 실제 앱 권한, 계획 합의의 역할을 구분한다.

이 단계 10분 · 선택 모듈 40분

따라 하기

1. 공식 앱 안내에서 설치·ChatGPT 로그인·계정의 Codex 사용 가능 여부를 확인한다.

2. codex-kdi-lab을 열고 새 채팅에서 적용되는 AGENTS.md와 CSV를 읽기만 하도록 요청한다.

3. 10번에서 읽기 요청·계획 합의·앱 권한·변경 검수를 각각 클릭한다.

완료 기준

PLAN/ACT 문구가 앱 모드나 도구 권한을 자동으로 전환하지 않음을 설명한다.

막히면

발표 HTML이 열리지 않으면 강사 화면으로 보고 슬라이드 번호를 따라간다. N은 발표 메모, 좌우 화살표는 이동이다.

강사 진행 메모

설치·로그인은 사전 준비한다. 화면 구성은 예시다. 앱 버전·계정마다 도구와 배치가 다를 수 있다. API 키나 추가 결제를 필수로 요구하지 않는다.

Step 3

요청문과 AGENTS.md (슬라이드 11–12)

published

Step 3

요청문과 AGENTS.md (슬라이드 11–12)

별도 발표 · 6분 · 발표자료 · Codex로 업무 보고서 만들기 (22장)

목표

입력·목적·제약·완료 기준과 적용 범위의 프로젝트 규칙을 확인한다.

이 단계 6분 · 선택 모듈 40분

따라 하기

1. 11번의 요청문에서 입력 파일·목적·제약·멈출 지점을 찾는다.

2. 내 업무 요청 하나를 같은 네 요소로 말해 본다.

3. 12번에서 AGENTS.md, 원본 inbox, 중간 work, 결과 output의 역할을 구분한다.

완료 기준

AGENTS.md와 원본·결과 폴더를 구분하고 실제 적용 규칙 경로를 확인할 수 있다.

막히면

발표 HTML이 열리지 않으면 강사 화면으로 보고 슬라이드 번호를 따라간다. N은 발표 메모, 좌우 화살표는 이동이다.

강사 진행 메모

AGENTS.md는 적용 범위의 지침이다. 전역·프로젝트·하위 폴더의 규칙이 있을 수 있으므로 실제 로드 경로를 확인한다.

Step 4

스킬 설치·호출·도입 점검 (슬라이드 13–16)

published

Step 4

스킬 설치·호출·도입 점검 (슬라이드 13–16)

별도 발표 · 10분 · 발표자료 · Codex로 업무 보고서 만들기 (22장)

목표

SKILL.md의 name·description과 Codex 설치·호출 방식을 익힌다.

이 단계 10분 · 선택 모듈 40분

따라 하기

1. 13번의 name과 description을 확인한다.

2. 프로젝트 .agents/skills/stat-brief/SKILL.md 설치 위치와 $stat-brief 명시 호출을 확인한다.

3. stat-brief와 선택 report-audit의 역할을 비교하고 외부 스킬의 원본·스크립트·라이선스·의존성을 확인한다.

완료 기준

AGENTS.md·스킬·MCP의 역할과 설치 전 점검 항목을 설명한다.

막히면

발표 HTML이 열리지 않으면 강사 화면으로 보고 슬라이드 번호를 따라간다. N은 발표 메모, 좌우 화살표는 이동이다.

강사 진행 메모

개인 위치는 $HOME/.agents/skills다. 수업에서는 프로젝트만 수정한다. SKILL.md의 name을 확인하고 스킬이 보이지 않으면 Codex를 다시 시작한다. $stat-brief는 채팅 요청이며 터미널 명령이 아니다.

Step 5

보고서 검수·선택 심화·실습 진입 (슬라이드 17–22)

published

Step 5

보고서 검수·선택 심화·실습 진입 (슬라이드 17–22)

별도 발표 · 6분 · 발표자료 · Codex로 업무 보고서 만들기 (22장)

목표

통계의 분모·출처를 검수하고 필수 실습으로 이동한다.

이 단계 6분 · 선택 모듈 40분

따라 하기

1. 17번에서 단일 HTML의 오프라인·모바일·인쇄 검수를 확인한다.

2. 18–19번에서 전국 36.1%·서울 39.9%·울산 31.6%의 지역 내 분모와 근거 없는 원인 문장을 대조한다.

3. 20번의 선택 심화 6모듈/200분과 rhwp 사본 검수를 확인한다. 과정 시작에서 01 공식 통계 실습으로 이동한다.

완료 기준

오늘의 산출물과 검수 기준을 설명하고 공식 통계 실습을 시작할 수 있다.

막히면

발표 HTML이 열리지 않으면 강사 화면으로 보고 슬라이드 번호를 따라간다. N은 발표 메모, 좌우 화살표는 이동이다.

강사 진행 메모

memory_bank는 수업 기록 폴더로 경로를 지정해 읽는다. rhwp는 별도 MCP 준비와 HWPX 사본 확인 실습이다. 문서 자동 변환 성공을 보장하지 않는다.

Module 입문practice

입문 · 데이터를 한 폴더에 모아 Codex로 분석하기

선택 · 30분 · 업무 질문 하나에 맞는 공식 데이터 출처와 검색어를 고른다.

5 steps

Step 1

1. 분석 질문과 데이터 출처 고르기

published

Step 1

1. 분석 질문과 데이터 출처 고르기

데이터 입문 · 6분 · 입문 · 데이터를 한 폴더에 모아 Codex로 분석하기

목표

업무 질문 하나에 맞는 공식 데이터 출처와 검색어를 고른다.

이 단계 6분 · 선택 모듈 30분

따라 하기

1. 질문을 대상·지역·기간·지표로 좁힌다. 예: “2024년 어느 시도의 1인가구 비율이 높고 낮은가?”

2. 아래 데이터 출처 가이드8곳을 비교한다. 국내 인구·가구는 KOSIS, 경제는 ECOS, 시설은 공공데이터포털, 국제 비교는 World Bank/OECD에서 시작한다.

3. 처음에는 CSV/XLSX 집계표 하나를 고른다. 같은 지역·기간의 보조자료는 다음 단계에서 하나만 추가한다. API 키·크롤링·대용량 원시자료는 필수 준비가 아니다.

완료 기준

분석 질문 한 문장과 출처·검색어를 정했다.

막히면

주제가 정해지지 않으면 제공된 2024년 시도별 1인가구 교육용 CSV로 시작한다.

강사 진행 메모

입문30분은 필수115분과 별도다.8개 사이트 전체에서 다운로드하지 않고 하나를 선택한다.

첨부파일

데이터 출처8곳·폴더 구성·분석 요청문 가이드

공식 출처별 검색어·다운로드 방법과 복사용 요청문입니다.

data-folder-guide.md

첨부파일

데이터 한 폴더 분석 스타터 ZIP

교육용 CSV·출처 기록·원본 보존 규칙·복사용 요청문. 압축을 풀고 kdi-data-starter를 프로젝트로 연결합니다.

kdi-data-starter.zip

데이터는 어디서 받을까

KOSIS 국가통계포털: 인구·가구·고용·지역경제. 검색 예: 시도별 1인가구, 고령인구, 고용률. 통계표 검색 → 항목·지역·시점 선택 → 조회 → 다운로드에서 CSV 또는 XLSX 선택. 표명·표ID·단위·주석도 기록. 같은 연도·지역 단위로 시작. 표 머리글 병합을 해제할 수 있으면 해제. 공식 안내
공공데이터포털: 시설·사업·행정 현황. 검색 예: 지역명 공공도서관, 무인민원발급기, 공공시설. 검색 결과에서 파일데이터 선택 → 상세의 파일 형식·갱신일 확인 → 다운로드 또는 제공기관 원문 링크 이용. API 전용 자료는 다음 실습으로 미룬다. 로그인·신청·이용조건은 자료별로 확인. 공식 안내
한국은행 ECOS: 물가·금리·환율·GDP. 검색 예: 소비자물가지수, 기준금리, 원/달러 환율. 통계검색에서 지표·주기·기간을 고르고 조회 결과의 다운로드 기능 확인. 보조 경로는 한국은행 금융·경제 스냅샷의 데이터 다운로드. 월/분기/연, 명목/실질, 계절조정, 기준연도와 단위를 구분. 공식 안내
지표누리 e-나라지표: 정책 성과지표·지표 해설. 검색 예: 청년고용률, 합계출산율, 사회복지 지표. 지표 검색 → 통계표·지표 해설 확인 → 제공되는 표 다운로드 또는 원자료 기관 링크 이용. 파일이 없으면 원자료 기관으로 이동. 해설과 수치의 기준시점을 따로 기록. 공식 안내
서울 열린데이터광장: 생활인구·교통·시설·자치구. 검색 예: 자치구별 인구, 공공시설, 따릉이. 데이터 검색 → 파일 제공 여부·용량·기간 확인 → 내려받을 수 있는 파일 선택. API만 있는 자료는 대체 파일 선택. 대용량 이동자료보다 자치구 집계표로 시작. API 인증키는 이번 입문에서 사용하지 않음. 공식 안내
지방재정365: 지자체 예산·결산·재정공시. 검색 예: 지자체명 세출결산, 재정자립도. 재정통계·재정공시에서 연도·지자체·회계 범위를 조회하고 다운로드 가능한 표/첨부자료 선택. 예산과 결산, 당초와 최종, 일반회계와 통합회계를 혼합하지 않음. PDF만 있으면 표 파일이 있는 자료로 변경. 공식 안내
World Bank Open Data: 국가별 인구·경제·개발. 검색 예: Population total, GDP per capita, urban population. 지표 선택 → 국가·기간 확인 → CSV/Excel 다운로드. ZIP이면 압축을 풀고 데이터와 메타데이터를 함께 보관. 국가코드·지표코드와 통화·현재가격/불변가격·PPP 여부를 확인. 공식 안내
OECD Data Explorer: 국제 고용·교육·복지 비교. 검색 예: Employment rate, education, social expenditure. 데이터셋 선택 → 국가·지표·기간 필터 → Download의 CSV/Excel 옵션 확인. 현재 다운로드 제한은 플랫폼 상태 안내 확인. 연령 범위·분모·국가별 정의를 맞춘다. 다운로드가 막히면 범위를 줄이거나 World Bank 자료로 대체. 공식 안내

참고

입문30분은 필수115분과 별도입니다. 제공 CSV는2024년 공식 보고서 수치를 교육용으로 전사한 가공본입니다.

Step 2

2. 데이터 내려받고 출처·단위 기록하기

published

Step 2

2. 데이터 내려받고 출처·단위 기록하기

데이터 입문 · 7분 · 입문 · 데이터를 한 폴더에 모아 Codex로 분석하기

목표

공식 표 파일과 설명자료를 함께 확보하고 출처를 남긴다.

이 단계 7분 · 선택 모듈 30분

따라 하기

1. 가이드의 KOSIS 다운로드 예시대로 표를 검색하고 지역·항목·기간을 먼저 선택한다. 화면 캡처보다 CSV/XLSX 표 파일을 받는다.

2. 다운로드 폴더에서 파일을 확인한다. ZIP이면 풀고 실제 CSV/XLSX와 메타데이터를 구분한다. HTML 로그인 페이지를 CSV로 잘못 저장하지 않았는지 확인한다.

3. sources.csv에 파일명·기관·표명/표ID·원문URL·다운로드일·기준기간·지역단위·측정단위·분모·이용조건을 기록한다. 내려받은 날짜와 수치 기준연도는 별개다.

4. 사이트 접속이 막히면 스타터 ZIP의 교육용 CSV를 사용한다. 이 CSV는 공식2025 보고서의 2024 수치를 전사한 가공본이며 KOSIS 원본 다운로드로 표시하지 않는다.

완료 기준

표 파일 하나와 설명자료, 출처 기록 한 행이 있다.

막히면

파일다운로드에 로그인/신청이 필요하면 강사에게 확인하거나 제공된 샘플로 진행한다. 파일마다 형식·이용조건이 다르다.

강사 진행 메모

새 파일을 고르면 자료의 실제 기간과 표ID를 기록한다. 비공개/개인정보가 포함된 기관 자료는 이 공개 수업 폴더에 넣지 않는다.

참고

입문30분은 필수115분과 별도입니다. 제공 CSV는2024년 공식 보고서 수치를 교육용으로 전사한 가공본입니다.

Step 3

3. 한 프로젝트 폴더로 모으고 Codex 연결하기

published

Step 3

3. 한 프로젝트 폴더로 모으고 Codex 연결하기

데이터 입문 · 5분 · 입문 · 데이터를 한 폴더에 모아 Codex로 분석하기

목표

원본·설명·작업·결과를 한 최상위 폴더 안에서 구분한다.

이 단계 5분 · 선택 모듈 30분

따라 하기

1. kdi-data-starter.zip을 풀고 kdi-data-starter 폴더를 연다. raw/는 원본 표, references/는 설명·주석, work/는 정리·계산, output/은 제출용 결과다. sources.csv는 루트에 둔다.

2. 내려받은 표는 raw/, 관련 설명은 references/에 넣는다. 파일명은 기관_주제_기준기간_지역.확장자처럼 정하고 출처 기록과 맞춘다. 원본은 엑셀로 열어 다시 저장하지 않는다.

3. Codex에서 로컬 프로젝트에 kdi-data-starter를 폴더로 연결한다. 현재 작업 경로를 확인한다. ChatGPT 프로젝트에 파일을 업로드하는 방식과 로컬 폴더 연결을 구분한다.

4. 한 폴더로 모은다는 것은 모든 파일을 같은 위치에 섞는다는 뜻이 아니다. 수업의 codex-kdi-lab과는 별도 프로젝트로 열어 해당 폴더의 규칙을 확인한다.

Codex 채팅에 붙여넣기

현재 프로젝트의 절대 경로와 AGENTS.md를 확인하고 raw/, references/, work/, output/, sources.csv의 역할을 요약해 주세요. 파일은 수정하지 마세요.

완료 기준

Codex의 작업 경로가 kdi-data-starter이고 원본과 결과의 위치를 설명할 수 있다.

막히면

파일이 보이지 않으면 다운로드 ZIP이 아니라 압축을 푼 폴더가 프로젝트에 연결되어 있는지 확인한다.

강사 진행 메모

로컬 폴더 연결은 공식 Projects 문서를 따른다. 폴더 규칙은 지침이며 읽기 전용 권한을 강제하는 보안 설정은 아니다.

참고

입문30분은 필수115분과 별도입니다. 제공 CSV는2024년 공식 보고서 수치를 교육용으로 전사한 가공본입니다.

Step 4

4. 파일 목록·품질 점검과 분석 계획

published

Step 4

4. 파일 목록·품질 점검과 분석 계획

데이터 입문 · 6분 · 입문 · 데이터를 한 폴더에 모아 Codex로 분석하기

목표

분석 전에 열·단위·결측·중복과 합계 행을 확인한다.

이 단계 6분 · 선택 모듈 30분

따라 하기

1. 아래 읽기 점검 요청을 실행한다. 샘플은18행(전국+17시도),4열,2024년,천 가구와%다.

2. 가이드의 분석 계획 요청문을 붙여넣는다. 전국은 비교 기준으로 분리하고17시도만 순위를 낸다.

3. 여러 표를 결합하려면 지역코드·기준기간·집계단위를 맞춘다. 시도와 시군구, 월과 연, 비율과 건수를 그대로 합치지 않는다. 키 중복으로 행이 늘면 결합을 멈춘다.

4. 아직 표를 읽지 않았거나 도구가 없는 상태에서 분석 결과를 만드는 답변은 다시 확인한다. 계획의 입력·출력·검수 기준을 읽고 실행 여부를 정한다.

Codex 채팅에 붙여넣기

현재 프로젝트 kdi-data-starter의 AGENTS.md, sources.csv, raw/, references/를 읽어 주세요. 지금은 읽기만 하고 파일을 만들거나 수정하지 마세요.
파일별 경로·형식·크기·행 수·열 이름·기준연도·지역 범위·단위·분모·출처·결측·중복을 표로 정리하세요. XLSX는 시트와 표 머리글을 확인하고 CSV는 인코딩을 확인하세요. 전국 합계와 지역 행이 섞였는지 확인하세요.
직접 확인할 수 없는 파일은 이유를 밝히고, 필요한 도구가 없으면 설치하지 말고 CSV 대안을 제안하세요. 수치나 출처를 추측하지 마세요.

완료 기준

파일별 점검표와 원본 보존·전국 분리·출력 경로가 포함된 계획을 확인했다.

막히면

CSV가 깨지면 인코딩을 확인한다. XLSX를 읽을 도구가 없으면 설치를 강제하지 않고 원사이트에서 CSV로 다시 내려받는다. PDF 스캔은 표 파일로 대체한다.

강사 진행 메모

여러 파일이 있다는 이유로 자동 결합하지 않는다. 첫 분석은 한 표로 끝내고 보조표 결합은 선택 과제다.

점검 후 계획 요청 · Codex 채팅에 붙여넣기

아직 파일을 수정하지 말고 분석 계획을 제안하세요.
질문: 2024년 어느 시도의 1인가구 비율이 높고 낮은가?
입력: raw/2024-regional-households.csv, references/source-notes.md, sources.csv.
전국은 비교 기준으로 분리하고 17개 시도만 정렬하세요. 공표 비율을 사용하고 반올림된 천 가구 값으로 다시 계산한 비율과 구분하세요. 전국 비율을 지역 비율의 단순평균으로 구하지 마세요.
제안할 산출물: work/analysis-method.md, output/regional-summary.csv, output/first-analysis.md.
결측·중복·분모 점검, 정렬·상하위 검산, 원본 보존 방법과 실제 생성할 파일을 설명하고 실행 승인을 기다리세요.

참고

입문30분은 필수115분과 별도입니다. 제공 CSV는2024년 공식 보고서 수치를 교육용으로 전사한 가공본입니다.

Step 5

5. 첫 분석 실행·검산·다음 실습 연결

published

Step 5

5. 첫 분석 실행·검산·다음 실습 연결

데이터 입문 · 6분 · 입문 · 데이터를 한 폴더에 모아 Codex로 분석하기

목표

출처가 있는 지역 비교표와 짧은 분석 메모를 만들고 검산한다.

이 단계 6분 · 선택 모듈 30분

따라 하기

1. 검토한 계획에 맞으면 아래 실행 요청을 붙여넣는다. raw/ 원본은 유지하고 work/와 output/만 생성한다.

2. 샘플 검산: 전국36.1%, 상위 서울39.9·대전39.8·강원39.4%, 하위 울산31.6·경기31.7·인천32.5%. 실제 원본과 대조한다.

3. output/regional-summary.csv가17시도이고 전국이 순위에서 빠졌는지 확인한다. 반올림된 가구 수를 나눈 값과 공표 비율의 차이를 오류로 단정하지 않는다.

4. 분석 메모에서 기준연도·단위·분모·출처 URL과 해석의 한계를 확인한다. “왜 높은가”와 “어떤 정책이 효과적인가”는 추가 근거가 필요한 별도 질문이다.

5. 완료 후 codex-kdi-lab 프로젝트로 돌아가 01 공식 통계 실습부터 이어간다. 이후 HTML 보고서 모듈에서 같은 출처 확인과 검수 절차를 적용한다.

Codex 채팅에 붙여넣기

위 분석 계획대로 실행해 주세요. raw/, references/, sources.csv와 AGENTS.md는 변경하지 마세요.
work/analysis-method.md에 사용한 입력·계산·제외 기준을 기록하세요. output/regional-summary.csv에는 17개 시도의 원본 열과 비율 내림차순 순위를 저장하세요. 전국은 지역 순위에서 제외하세요.
output/first-analysis.md에는 질문, 기준연도, 단위·분모, 전국 비교값, 상위3/하위3 지역, 확인된 사실3개, 해석의 한계, 출처 URL을 쓰세요. 인과관계나 정책 효과를 추정하지 마세요.
실제 입력·출력 행 수, 결측/중복 여부, 상하위3 수치 대조, 원본 변경 여부를 검사하고 결과와 미확인 사항을 보고하세요. 파일 생성 실패를 성공으로 보고하지 마세요. 패키지 설치·추가 다운로드가 필요하면 먼저 알려주세요.

완료 기준

work/analysis-method.md와 output의CSV·분석메모를 열어 행 수·상하위3·원본 보존·출처를 확인했다.

막히면

계획 검토 전이면 이전 단계로 돌아간다. 생성이 실패하면 실패 원인을 확인하고 읽기 점검표까지를 산출물로 남긴다.

강사 진행 메모

코드 실행·검산 성공은 실제 파일로 확인한다. 라이브 최신 수치가 아니라 제공된2024년 교육용 스냅샷 실습이다.

참고

다음 모듈: 왜 HTML인가 · 실제 통계자료와 결과물 이해 →

입문30분은 필수115분과 별도입니다. 제공 CSV는2024년 공식 보고서 수치를 교육용으로 전사한 가공본입니다.

Module 01practice필수

왜 HTML인가 · 실제 통계자료와 결과물 이해

필수 · 10분 · 오늘 만들 2024년 1인가구 지역 비교 HTML 보고서의 범위를 안다.

3 steps

Step 1

완성 보고서와 원문 보기

published

Step 1

완성 보고서와 원문 보기

필수 · 3분 · 왜 HTML인가 · 실제 통계자료와 결과물 이해

목표

오늘 만들 2024년 1인가구 지역 비교 HTML 보고서의 범위를 안다.

이 단계 3분 · 전체 수업 0–10분 구간

따라 하기

1. examples/report-complete.html을 열어 요약·지도·차트·표·출처를 찾는다.

2. 국가데이터처 원문 PDF의 인쇄 10쪽과 같은 수치인지 비교한다.

3. 원문 전체 77쪽을 복제하지 않고 핵심 질문 한 개에 맞춰 재구성한다.

완료 기준

한 HTML 파일에 출처와 2024년 기준이 표시된다고 말한다.

막히면

원문 PDF가 열리지 않으면 inbox/source-notes.md와 준비된 10쪽 화면을 본다.

강사 진행 메모

완성 예시는 강사가 먼저 보여주고 새 실습은 아직 시작하지 않는다.

첨부파일

Codex KDI 실습 자료 ZIP

압축을 풀고 codex-kdi-lab 폴더를 프로젝트로 엽니다.

codex-kdi-lab.zip

첨부파일

inbox/source-notes.md

ZIP에 포함된 개별 실습 파일입니다.

source-notes.md

첨부파일

inbox/2024-regional-households.csv

ZIP에 포함된 개별 실습 파일입니다.

2024-regional-households.csv

첨부파일

examples/report-complete.html

ZIP에 포함된 개별 실습 파일입니다.

report-complete.html

다음 모듈: Codex 첫 실행과 자료 정리 →

Step 2

숫자의 분모 확인

published

Step 2

숫자의 분모 확인

필수 · 4분 · 왜 HTML인가 · 실제 통계자료와 결과물 이해

목표

비율과 분포를 구분한다.

이 단계 4분 · 전체 수업 0–10분 구간

따라 하기

1. inbox/2024-regional-households.csv의 단위가 천 가구와 %임을 찾는다.

2. 서울 39.9%는 서울 가구 중 1인가구의 비율임을 읽는다.

3. 서울 20.6%는 전국 1인가구 중 서울에 있는 가구의 몫으로 다른 지표임을 확인한다.

완료 기준

비교표에는 39.9%와 같은 지역 내 비율만 사용한다.

막히면

숫자가 혼동되면 PDF 10쪽 표 제목과 9쪽 분포 차트를 나란히 본다.

강사 진행 메모

2025는 보도자료 제목·발표연도, 실습 통계는 2024년 기준이다.

Step 3

자료 기반 요청 만들기

published

Step 3

자료 기반 요청 만들기

필수 · 3분 · 왜 HTML인가 · 실제 통계자료와 결과물 이해

목표

대상·목적·제약·완료 기준이 있는 요청을 구성한다.

이 단계 3분 · 전체 수업 0–10분 구간

따라 하기

1. 아래 계획 요청을 읽는다.

2. 원본 보존과 출처 표시 조건을 표시한다.

3. 새 파일은 다음 모듈에서 만든다.

Codex 채팅에 붙여넣기

inbox/source-notes.md와 inbox/2024-regional-households.csv를 읽고 전국과 시도별 1인가구 비율을 비교하는 HTML 보고서 계획을 제안해 주세요. 2024년 수치만 사용하고, 비율과 분포를 혼동하지 마세요. 출처가 없는 원인·정책 효과는 추정하지 말고 아직 파일을 만들지 마세요.

완료 기준

요청에 입력 파일, 독자, 기준연도, 금지할 추론이 있다.

막히면

길면 강사 요청문을 그대로 복사한다.

강사 진행 메모

본문 작성보다 원본 자료를 구분하는 습관이 핵심이다.

Module 02practice필수

Codex 첫 실행과 자료 정리

필수 · 20분 · Codex가 접근하는 폴더와 AGENTS.md 규칙을 실제 파일로 확인한다.

3 steps

Step 1

실습 폴더 열고 자료 목록 확인

published

Step 1

실습 폴더 열고 자료 목록 확인

필수 · 6분 · Codex 첫 실행과 자료 정리

목표

Codex가 접근하는 폴더와 AGENTS.md 규칙을 실제 파일로 확인한다.

이 단계 6분 · 전체 수업 10–30분 구간

따라 하기

1. Codex 앱에서 codex-kdi-lab을 작업 프로젝트로 열고 새 채팅을 시작한다.

2. AGENTS.md·inbox·assets·work·output을 확인한다. 원본은 보존하고 결과만 work·output에 저장한다.

3. 아래 읽기 요청을 실행하고 읽은 규칙 파일, CSV 열 4개, 데이터 18행을 확인한다.

Codex 채팅에 붙여넣기

현재 작업 폴더와 적용되는 AGENTS.md 경로를 확인하고 핵심 규칙을 요약해 주세요. inbox/source-notes.md와 inbox/2024-regional-households.csv를 읽고 기준연도, 열 이름, 데이터 행 수, 단위와 분모를 알려주세요. 지금은 읽기만 하고 파일을 만들거나 수정하지 마세요.

완료 기준

codex-kdi-lab과 AGENTS.md를 확인했고, 전국+17개 시도 18행·열 4개·2024년 기준을 설명한다.

막히면

로그인 문제가 3분 넘으면 강사 화면/짝 실습으로 전환한다.

강사 진행 메모

사전 설치·로그인 완료 전제. 승인 화면은 실제 변경 대상과 명령을 읽는다.

첨부파일

Codex KDI 실습 자료 ZIP

압축을 풀고 codex-kdi-lab 폴더를 프로젝트로 엽니다.

codex-kdi-lab.zip

첨부파일

AGENTS.md

ZIP에 포함된 개별 실습 파일입니다.

AGENTS.md

Codex 공식 사용법

프로젝트 스킬은 .agents/skills/<이름>/SKILL.md, 명시 호출은 $skill-name입니다. PLAN/ACT는 수업의 협업 규약이며 실제 앱 권한 설정과 구분합니다.

Step 2

출처가 있는 첫 요약 파일

published

Step 2

출처가 있는 첫 요약 파일

필수 · 8분 · Codex 첫 실행과 자료 정리

목표

원자료를 읽고 근거가 남는 작업 파일을 만든다.

이 단계 8분 · 전체 수업 10–30분 구간

따라 하기

1. 계획 요청을 실행한다.

2. 아래 요청으로 work/first-summary.md를 만든다.

3. 전국 36.1%, 서울 39.9%, 대전 39.8%, 울산 31.6%를 원문과 대조한다.

Codex 채팅에 붙여넣기

inbox/source-notes.md와 inbox/2024-regional-households.csv를 읽어 work/first-summary.md를 만들어 주세요. 2024년 전국 비율, 상위 3개 지역, 낮은 2개 지역, 수치의 단위·분모·원문 10쪽을 적으세요. CSV에 없는 변화율·원인·정책 제안은 쓰지 마세요. inbox 원본은 수정하지 마세요.

완료 기준

요약 파일에 수치와 원문 링크가 있고 비율/분포가 구분된다.

막히면

파일이 없으면 현재 폴더와 저장 경로를 확인한다.

강사 진행 메모

첫 파일 생성 승인과 결과 확인을 각각 경험하게 한다.

Step 3

잘못된 해석 한 문장 고치기

published

Step 3

잘못된 해석 한 문장 고치기

필수 · 6분 · Codex 첫 실행과 자료 정리

목표

같은 파일의 일부만 수정하고 근거를 유지한다.

이 단계 6분 · 전체 수업 10–30분 구간

따라 하기

1. 요약에서 서울 비율 문장을 찾는다.

2. 전국 대비 분포처럼 읽히지 않도록 한 문장만 고친다.

3. 숫자 4개가 바뀌지 않았는지 비교한다.

Codex 채팅에 붙여넣기

work/first-summary.md에서 서울 39.9%의 분모를 서울의 전체 일반가구라고 분명하게 고쳐 주세요. 다른 수치와 출처는 바꾸지 마세요. 수정 전후 문장만 알려주세요.

완료 기준

서울 39.9%의 의미가 정확하고 다른 수치는 유지된다.

막히면

다른 값이 바뀌면 CSV와 원문 10쪽으로 복원한다.

강사 진행 메모

후속 요청은 재작성보다 제한된 수정으로 연습한다.

다음 모듈: 통계 원고 스킬 설치·실행 →

Module 03practice필수

통계 원고 스킬 설치·실행

필수 · 20분 · 자료 재구성 절차를 담은 SKILL.md를 이해한다.

3 steps

Step 1

스킬 지침 읽기

published

Step 1

스킬 지침 읽기

필수 · 5분 · 통계 원고 스킬 설치·실행

목표

자료 재구성 절차를 담은 SKILL.md를 이해한다.

이 단계 5분 · 전체 수업 30–50분 구간

따라 하기

1. skill-kit/stat-brief/SKILL.md를 연다.

2. 입력·출력·수치 검증·금지할 해석을 찾는다.

3. 스킬은 자체 제작 교육 자료임을 확인한다.

Codex 채팅에 붙여넣기

skill-kit/stat-brief/SKILL.md를 읽고 입력, 출력, 수치 검수 규칙을 세 문장으로 설명해 주세요. 아직 설치하거나 실행하지 마세요.

완료 기준

스킬이 work/content.md를 만들고 숫자에 출처를 붙인다고 설명한다.

막히면

길면 입력·출력·금지사항만 확인한다.

강사 진행 메모

공식 내장 스킬로 소개하지 않는다.

첨부파일

Codex KDI 실습 자료 ZIP

압축을 풀고 codex-kdi-lab 폴더를 프로젝트로 엽니다.

codex-kdi-lab.zip

첨부파일

skill-kit/stat-brief/SKILL.md

ZIP에 포함된 개별 실습 파일입니다.

SKILL.md

Codex 공식 사용법

다음 모듈: 왜 보고서를 HTML로 만드는가 →

프로젝트 스킬은 .agents/skills/<이름>/SKILL.md, 명시 호출은 $skill-name입니다. PLAN/ACT는 수업의 협업 규약이며 실제 앱 권한 설정과 구분합니다.

Step 2

프로젝트 범위에 설치

published

Step 2

프로젝트 범위에 설치

필수 · 7분 · 통계 원고 스킬 설치·실행

목표

스킬을 현재 실습 폴더에만 배치한다.

이 단계 7분 · 전체 수업 30–50분 구간

따라 하기

1. 아래 요청으로 .agents/skills/stat-brief/SKILL.md에 프로젝트 스킬을 설치한다.

2. 기존 파일이 있으면 차이를 검토하고 승인한 내용만 반영한다.

3. 스킬 선택 UI에서 stat-brief를 찾는다. 갱신이 보이지 않으면 같은 폴더에서 Codex를 다시 시작한다.

Codex 채팅에 붙여넣기

skill-kit/stat-brief/SKILL.md를 읽고 현재 프로젝트의 .agents/skills/stat-brief/SKILL.md에 설치해 주세요. 대상이 이미 있으면 덮어쓰지 말고 차이를 설명한 뒤 기다리세요. 전역 설정·다른 프로젝트·패키지는 변경하지 마세요. 파일 경로와 frontmatter name을 확인해 주세요.

완료 기준

프로젝트 스킬 파일이 존재하며 name이 stat-brief다.

막히면

스킬 목록에 없으면 경로를 확인하고 세션을 다시 연다.

강사 진행 메모

프로젝트 스킬은 .agents/skills에 배치하고 $stat-brief로 명시 호출한다. 최신 설치·발견 방식은 공식 Build skills 문서를 대조한다. 파일 배치 외에 Git·Python·MCP를 추가하지 않는다.

Step 3

원고 생성과 출처 대조

published

Step 3

원고 생성과 출처 대조

필수 · 8분 · 통계 원고 스킬 설치·실행

목표

같은 통계로 HTML용 원고를 만든다.

이 단계 8분 · 전체 수업 30–50분 구간

따라 하기

1. $stat-brief를 명시적으로 호출한다.

2. Codex가 읽은 SKILL.md와 생성한 work/content.md를 확인한다.

3. 수치·분모·출처를 CSV와 대조하고 확인되지 않은 원인은 남기지 않는다.

Codex 채팅에 붙여넣기

$stat-brief inbox/2024-regional-households.csv inbox/source-notes.md

완료 기준

work/content.md에 보고서 제목, 핵심 발견, 비교표, 해석 한계, 출처가 있다.

막히면

호출이 안 되면 SKILL.md를 직접 읽고 같은 절차로 실행하도록 요청한다.

강사 진행 메모

55–60분은 휴식. 원고는 2부의 단일 입력이다.

Module 04practice필수

왜 보고서를 HTML로 만드는가

필수 · 10분 · 내용과 표현을 나눠 생각한다.

3 steps

Step 1

원고·표·이미지의 역할

published

Step 1

원고·표·이미지의 역할

필수 · 4분 · 왜 보고서를 HTML로 만드는가

목표

내용과 표현을 나눠 생각한다.

이 단계 4분 · 전체 수업 55–65분 구간

따라 하기

1. work/content.md와 완성 예시를 나란히 본다.

2. 핵심 수치, 비교표, 지도·차트 PNG, 출처가 HTML 어디에 놓였는지 찾는다.

3. 브라우저에서 읽고 인쇄 미리보기도 확인한다.

완료 기준

HTML이 내용·표·이미지·스타일을 한 문서로 묶는다고 설명한다.

막히면

태그 문법 강의는 생략한다.

강사 진행 메모

원문 PDF의 디자인을 복제하는 과제가 아니다.

첨부파일

Codex KDI 실습 자료 ZIP

압축을 풀고 codex-kdi-lab 폴더를 프로젝트로 엽니다.

codex-kdi-lab.zip

첨부파일

examples/report-starter.html

ZIP에 포함된 개별 실습 파일입니다.

report-starter.html

다음 모듈: 실제 통계 HTML 보고서 만들기 →

Step 2

출력 형식별 쓰임

published

Step 2

출력 형식별 쓰임

필수 · 3분 · 왜 보고서를 HTML로 만드는가

목표

HTML을 기준 원고로 활용하는 경로를 안다.

이 단계 3분 · 전체 수업 55–65분 구간

따라 하기

1. 브라우저 인쇄→PDF를 확인한다.

2. PPT·DOCX는 목적별 재구성이라고 구분한다.

3. HWPX는 기관 양식에 핵심 내용을 다시 넣는 확장 예라고 이해한다.

완료 기준

HTML→PDF와 PPT/DOCX/HWPX 재구성의 차이를 설명한다.

막히면

실습 도구 설치나 변환은 후반 시연으로 넘긴다.

강사 진행 메모

모든 서식이 손실 없이 보존된다고 말하지 않는다.

Step 3

제작 범위 확정

published

Step 3

제작 범위 확정

필수 · 3분 · 왜 보고서를 HTML로 만드는가

목표

20분 안에 만들 보고서 구성 요소를 고정한다.

이 단계 3분 · 전체 수업 55–65분 구간

따라 하기

1. 제목·기준연도·3개 핵심 수치·지역 표·지도·차트·해석·출처만 남긴다.

2. 원인 분석, 지역 정책 처방, 실시간 데이터 갱신은 제외한다.

3. 지도와 차트는 먼저 상대경로로 연결한다.

Codex 채팅에 붙여넣기

work/content.md와 inbox/2024-regional-households.csv를 기준으로 output/one-person-report.html 제작 계획을 제안해 주세요. 기준은 2024년, 지역 내 1인가구 비율만 비교합니다. 제목·요약·지역 표·assets/region-chart.png와 assets/korea-one-person-map.png 이미지·출처를 넣고 CSS는 HTML 안에 두세요. 아직 파일은 만들지 마세요.

완료 기준

고정된 데이터/디자인 범위의 계획이 나온다.

막히면

계획이 크면 1열·정적 문서로 축소한다.

강사 진행 메모

2부는 같은 파일 한 개를 계속 개선한다.

Module 05practice필수

실제 통계 HTML 보고서 만들기

필수 · 20분 · 출처가 표시된 보고서 파일을 만든다.

3 steps

Step 1

첫 보고서 HTML 생성

published

Step 1

첫 보고서 HTML 생성

필수 · 9분 · 실제 통계 HTML 보고서 만들기

목표

출처가 표시된 보고서 파일을 만든다.

이 단계 9분 · 전체 수업 65–85분 구간

따라 하기

1. 아래 요청으로 output/one-person-report.html을 만든다.

2. 브라우저에서 열어 요약·표·지도·차트·출처를 확인한다.

3. 원문 수치 36.1·39.9·39.8·31.6을 대조한다.

Codex 채팅에 붙여넣기

work/content.md와 inbox/2024-regional-households.csv로 output/one-person-report.html을 만드세요. 제목은 2024년 1인가구 지역 비교 보고서입니다. 전국 36.1%, 서울 39.9%, 대전 39.8%, 울산 31.6%를 포함하고 17개 시도 표를 만드세요. ../assets/region-chart.png와 ../assets/korea-one-person-map.png를 각각 alt 설명과 함께 넣으세요. CSS는 style에 넣고 모바일과 인쇄를 고려하세요. 수치의 분모·단위·국가데이터처 원문 링크·인쇄 10쪽을 적으세요. 근거 없는 원인은 쓰지 마세요. 다른 파일은 수정하지 마세요.

완료 기준

HTML이 열리고 17개 지역 표, 지도, 차트, 원문 링크가 보인다.

막히면

생성이 지연되면 examples/report-starter.html을 복사해 이어간다.

강사 진행 메모

AI의 완료 보고만 믿지 않고 브라우저를 수강생이 직접 연다.

첨부파일

Codex KDI 실습 자료 ZIP

압축을 풀고 codex-kdi-lab 폴더를 프로젝트로 엽니다.

codex-kdi-lab.zip

첨부파일

assets/region-chart.png

ZIP에 포함된 개별 실습 파일입니다.

region-chart.png

다음 모듈: Base64 이미지 내장과 단일 HTML →

Step 2

표와 문장 디자인 수정

published

Step 2

표와 문장 디자인 수정

필수 · 7분 · 실제 통계 HTML 보고서 만들기

목표

같은 파일에서 읽기 어려운 부분만 개선한다.

이 단계 7분 · 전체 수업 65–85분 구간

따라 하기

1. 표의 단위와 모바일 너비를 확인한다.

2. 숫자 정렬, 글자 크기, 인쇄 여백만 수정한다.

3. 수치와 출처가 변하지 않았는지 확인한다.

Codex 채팅에 붙여넣기

output/one-person-report.html의 디자인만 수정해 주세요. 제목과 핵심 수치를 먼저 읽게 하고 표는 좁은 화면에서 가로 스크롤되게 하세요. 본문은 16px 이상, 표 숫자는 오른쪽 정렬하세요. 2024년 수치, 이미지 경로, 출처·해석 문장은 바꾸지 마세요.

완료 기준

디자인이 나아지고 사실 정보는 그대로다.

막히면

차이가 안 보이면 저장한 파일과 브라우저 주소를 확인한다.

강사 진행 메모

개인별 디자인 수정은 한 번만 한다.

Step 3

원문과 대조해 검수

published

Step 3

원문과 대조해 검수

필수 · 4분 · 실제 통계 HTML 보고서 만들기

목표

표의 숫자와 해석을 원자료로 검수한다.

이 단계 4분 · 전체 수업 65–85분 구간

따라 하기

1. 전국·서울·대전·경기·울산의 수치를 CSV와 대조한다.

2. 전국 36.1%의 분모와 지역별 비율의 분모를 확인한다.

3. KOSIS 화면의 최신 연도 숫자를 가져오지 않았는지 찾는다.

Codex 채팅에 붙여넣기

output/one-person-report.html의 모든 수치를 inbox/2024-regional-households.csv와 비교해 주세요. 불일치가 있으면 파일·행·원값·보고서값을 표로 제시하고, 근거 없는 인과 표현을 찾아주세요. 원본 CSV는 수정하지 마세요.

완료 기준

불일치 0건 또는 위치가 적힌 수정 목록이 나온다.

막히면

교차 검수가 오래 걸리면 5개 주요 행과 출처만 확인한다.

강사 진행 메모

CSV는 보고서 원문 10쪽에서 전사한 교육용 가공본임을 명시한다.

Module 06practice필수

Base64 이미지 내장과 단일 HTML

필수 · 15분 · 상대경로 이미지가 폴더 이동 시 끊길 수 있음을 안다.

3 steps

Step 1

이미지 경로의 한계 확인

published

Step 1

이미지 경로의 한계 확인

필수 · 4분 · Base64 이미지 내장과 단일 HTML

목표

상대경로 이미지가 폴더 이동 시 끊길 수 있음을 안다.

이 단계 4분 · 전체 수업 85–100분 구간

따라 하기

1. HTML을 이미지 파일 없이 다른 폴더로 복사해 지도와 차트가 보이는지 확인한다.

2. ../assets/region-chart.png와 ../assets/korea-one-person-map.png 경로를 찾는다.

3. Base64가 이미지 바이트를 HTML 안에 넣는 방식임을 이해한다.

완료 기준

이동한 HTML에서 두 이미지가 안 보일 수 있는 이유를 설명한다.

막히면

브라우저 캐시가 남으면 새 탭이나 다른 폴더에서 확인한다.

강사 진행 메모

지도와 차트는 원본 PDF 그림 복사가 아닌 공개 수치로 새로 만든 PNG다.

첨부파일

Codex KDI 실습 자료 ZIP

압축을 풀고 codex-kdi-lab 폴더를 프로젝트로 엽니다.

codex-kdi-lab.zip

첨부파일

assets/region-chart.png

ZIP에 포함된 개별 실습 파일입니다.

region-chart.png

첨부파일

assets/korea-one-person-map.png

ZIP에 포함된 개별 실습 파일입니다.

korea-one-person-map.png

다음 모듈: PDF·PPT·DOCX·HWPX·Figma 활용 →

Step 2

지도·차트 PNG를 Base64로 내장

published

Step 2

지도·차트 PNG를 Base64로 내장

필수 · 7분 · Base64 이미지 내장과 단일 HTML

목표

두 PNG를 data URI로 같은 HTML에 넣는다.

이 단계 7분 · 전체 수업 85–100분 구간

따라 하기

1. 아래 요청으로 img src만 바꾼다.

2. HTML의 data:image/png;base64, 접두부를 확인한다.

3. 지도·차트와 수치가 원래와 동일한지 확인한다.

Codex 채팅에 붙여넣기

assets/region-chart.png와 assets/korea-one-person-map.png를 Base64로 인코딩해 output/one-person-report.html의 각 img src에 data:image/png;base64,... 형태로 직접 넣어 주세요. 이미지 alt, 표, 수치, 출처, CSS는 변경하지 마세요. 원본 PNG와 CSV는 그대로 두세요. 인코딩 후 이미지 표시를 확인하고 파일 크기도 알려주세요.

완료 기준

두 img src가 data URI이고 지도와 차트가 표시된다.

막히면

수정에 실패하면 examples/report-complete.html에서 data URI 형식을 확인한다.

강사 진행 메모

Base64는 파일 크기가 늘어날 수 있음을 함께 설명한다.

Step 3

진짜 단일 파일인지 확인

published

Step 3

진짜 단일 파일인지 확인

필수 · 4분 · Base64 이미지 내장과 단일 HTML

목표

이미지 폴더 없이 HTML만 옮겨 검증한다.

이 단계 4분 · 전체 수업 85–100분 구간

따라 하기

1. 완성 HTML을 빈 폴더에 복사해 연다.

2. 지도·차트·표·한글·출처가 보이는지 확인한다.

3. 네트워크를 꺼도 화면이 구성되는지 점검한다.

Codex 채팅에 붙여넣기

output/one-person-report.html에 외부 이미지·CSS·글꼴·스크립트 참조가 남았는지 검사해 주세요. 지도와 차트 두 img 모두 data:image/png;base64로 시작해야 합니다. HTML만 복사해도 보이는지 확인 방법을 안내하고, 파일은 더 수정하지 마세요.

완료 기준

HTML 파일 하나만으로 지도·차트와 본문이 표시된다.

막히면

이미지가 깨지면 인코딩 범위와 data URI 접두부를 확인한다.

강사 진행 메모

원문 하이퍼링크는 참고 링크로 남아도 표시 자산의 외부 의존은 없다.

Module 07practice필수

PDF·PPT·DOCX·HWPX·Figma 활용

필수 · 10분 · 브라우저 인쇄로 보이는 결과를 PDF로 저장한다.

3 steps

Step 1

HTML에서 PDF로

published

Step 1

HTML에서 PDF로

필수 · 3분 · PDF·PPT·DOCX·HWPX·Figma 활용

목표

브라우저 인쇄로 보이는 결과를 PDF로 저장한다.

이 단계 3분 · 전체 수업 100–110분 구간

따라 하기

1. 완성 HTML에서 인쇄 미리보기를 연다.

2. 지도·차트와 표가 페이지 경계에서 잘리지 않는지 확인한다.

3. PDF 저장은 선택 시연으로 마친다.

완료 기준

인쇄 미리보기에서 출처와 지도·차트가 보인다.

막히면

페이지가 길면 가로 표와 여백을 줄인다.

강사 진행 메모

PDF 수치도 원문을 다시 확인한다.

첨부파일

Codex KDI 실습 자료 ZIP

압축을 풀고 codex-kdi-lab 폴더를 프로젝트로 엽니다.

codex-kdi-lab.zip

첨부파일

examples/report-complete.html

ZIP에 포함된 개별 실습 파일입니다.

report-complete.html

Step 2

PPT·DOCX·HWPX 재구성

published

Step 2

PPT·DOCX·HWPX 재구성

필수 · 4분 · PDF·PPT·DOCX·HWPX·Figma 활용

목표

같은 원고를 출력 목적별로 다시 설계한다.

이 단계 4분 · 전체 수업 100–110분 구간

따라 하기

1. PPT: 핵심 발견 3장, DOCX: 제목·본문·표 구조를 설명한다.

2. HWPX: 기존 기관 양식에 검증된 수치와 출처를 넣는 흐름을 본다.

3. 변환 후 제목·표·출처·폰트를 재검수한다.

Codex 채팅에 붙여넣기

work/content.md와 output/one-person-report.html을 기준으로 이 내용을 3장 발표자료, Word 보고서, 기관 HWPX 양식에 각각 어떻게 재구성할지 목차와 검수표만 제안해 주세요. 실제 파일은 만들지 마세요. 2024년 수치와 출처를 유지하세요.

완료 기준

형식별 재구성안과 확인 항목이 있다.

막히면

도구가 없으면 완성 화면과 비교표로 시연한다.

강사 진행 메모

RHWP·관련 스킬은 도구 연결 시연 후보이며 무손실 변환은 보장하지 않는다.

Step 3

Figma 연결 범위

published

Step 3

Figma 연결 범위

필수 · 3분 · PDF·PPT·DOCX·HWPX·Figma 활용

목표

디자인 협업으로 확장할 때 파일과 레이어를 구분한다.

이 단계 3분 · 전체 수업 100–110분 구간

따라 하기

1. 완성 HTML 화면을 시안 참고 자료로 공유하는 흐름을 설명한다.

2. Figma의 디자인 컨텍스트로 새 HTML을 구현하는 반대 방향도 설명한다.

3. 자동 동기화라고 소개하지 않는다.

완료 기준

Figma 연동은 별도 도구·계정 조건과 검수가 필요하다고 말한다.

막히면

연결 환경이 없으면 흐름도만 사용한다.

강사 진행 메모

이 수업 필수 결과물은 HTML 한 파일이다.

다음 모듈: 검수·공유 준비와 업무 적용 →

Module 08practice필수

검수·공유 준비와 업무 적용

필수 · 5분 · 제출 전 핵심 수치를 확인한다.

3 steps

Step 1

수치 최종 체크

published

Step 1

수치 최종 체크

필수 · 2분 · 검수·공유 준비와 업무 적용

목표

제출 전 핵심 수치를 확인한다.

이 단계 2분 · 전체 수업 110–115분 구간

따라 하기

1. 전국 36.1, 서울 39.9, 대전 39.8, 울산 31.6을 확인한다.

2. 2024 기준·천 가구·출처 링크를 확인한다.

완료 기준

근거 없는 원인 문장이 없다.

막히면

해석이 의심되면 관찰 사실만 남긴다.

강사 진행 메모

결과물을 공식 통계 간행물로 오해받지 않게 교육용 재구성을 표시한다.

첨부파일

Codex KDI 실습 자료 ZIP

압축을 풀고 codex-kdi-lab 폴더를 프로젝트로 엽니다.

codex-kdi-lab.zip

첨부파일

README.md

ZIP에 포함된 개별 실습 파일입니다.

README.md

다음 모듈: 심화 · 클릭하면 움직이는 한국 지도 만들기 →

Step 2

파일 하나 검증

published

Step 2

파일 하나 검증

필수 · 2분 · 검수·공유 준비와 업무 적용

목표

단일 HTML의 이식성을 확인한다.

이 단계 2분 · 전체 수업 110–115분 구간

따라 하기

1. 지도·차트 img의 Base64 여부를 확인한다.

2. 파일을 빈 폴더에서 열어 본다.

3. 브라우저 인쇄 미리보기를 확인한다.

완료 기준

별도 이미지 파일 없이 보고서를 볼 수 있다.

막히면

파일이 너무 크면 이미지 해상도를 점검한다.

강사 진행 메모

ZIP은 원자료·연습용이고 최종 제출물은 HTML이다.

Step 3

내 업무에 적용

published

Step 3

내 업무에 적용

필수 · 1분 · 검수·공유 준비와 업무 적용

목표

다음 적용 자료를 고른다.

이 단계 1분 · 전체 수업 110–115분 구간

따라 하기

1. 회사 자료 하나를 고른다.

2. 민감 정보 여부와 공개 가능 범위를 확인한다.

3. HTML 결과물과 출처 검수 기준을 한 줄로 적는다.

완료 기준

본인 업무 자료와 검수 기준이 하나씩 정해진다.

막히면

개인 자료를 오늘 업로드할 필요는 없다.

강사 진행 메모

질문은 수업 후 보충 학습으로 연결한다.

Module 09practice

심화 · 클릭하면 움직이는 한국 지도 만들기

선택 · 60분 · 눌러 보고 기능을 부품 단위로 나눈다.

7 steps

Step 1

완성된 인터랙티브 지도 뜯어보기

published

Step 1

완성된 인터랙티브 지도 뜯어보기

선택 심화 · 6분 · 심화 · 클릭하면 움직이는 한국 지도 만들기

목표

눌러 보고 기능을 부품 단위로 나눈다.

이 단계 6분 · 선택 모듈 60분

따라 하기

1. examples/report-complete.html을 열고 지도의 여러 지역과 순위 목록을 눌러 본다.

2. 눌렀을 때 바뀌는 것을 5가지 이상 적는다. (강조, 순위, 숫자, 게이지, 막대 등)

3. 화면을 지도·상세 패널·순위 목록 세 부품으로 나누고, 지금 선택된 지역을 기억하는 곳이 한 군데임을 확인한다.

Codex 채팅에 붙여넣기

examples/report-complete.html을 읽고 한국 지도 인포그래픽 부분만 분석해 주세요. 지도, 상세 패널, 순위 목록이 각각 어떤 데이터를 쓰는지, 지역을 클릭하면 어떤 순서로 화면이 바뀌는지 표로 정리해 주세요. 파일은 수정하지 마세요.

완료 기준

부품 3개와 클릭 후 변화 5개 이상을 말할 수 있다.

막히면

화면이 열리지 않으면 강사 화면을 보며 같은 표를 채운다.

강사 진행 메모

이 단계는 만들지 않고 읽기만 한다. "클릭 → 상태 변경 → 화면 갱신"이라는 흐름 한 줄을 판서한다.

첨부파일

Codex KDI 실습 자료 ZIP

압축을 풀고 codex-kdi-lab 폴더를 프로젝트로 엽니다.

codex-kdi-lab.zip

첨부파일

assets/korea-sido-paths.json

ZIP에 포함된 개별 실습 파일입니다.

korea-sido-paths.json

첨부파일

inbox/2024-regional-households.csv

ZIP에 포함된 개별 실습 파일입니다.

2024-regional-households.csv

다음 모듈: 선택 · 스킬을 찾고 설치해 보고서 검수에 쓰기 →

Step 2

지도 데이터 이해: SVG 경로와 통계 연결

published

Step 2

지도 데이터 이해: SVG 경로와 통계 연결

선택 심화 · 8분 · 심화 · 클릭하면 움직이는 한국 지도 만들기

목표

지도가 그림이 아니라 지역별 도형 데이터임을 이해한다.

이 단계 8분 · 선택 모듈 60분

따라 하기

1. assets/korea-sido-paths.json을 열어 regions의 name, d, lx, ly를 확인한다.

2. d는 SVG path 좌표이고 lx, ly는 지역 이름 글자 위치임을 알아둔다.

3. JSON의 17개 지역 이름이 inbox/2024-regional-households.csv의 지역 열과 같은지 대조한다.

Codex 채팅에 붙여넣기

assets/korea-sido-paths.json과 inbox/2024-regional-households.csv를 읽어 주세요. 1) viewBox와 각 항목(name, d, lx, ly)의 뜻을 초보자 말로 설명하고 2) 두 파일의 지역 이름 17개가 정확히 일치하는지 확인해 주세요. 3) 지도 경계는 2023년, 통계는 2024년이라는 점을 주의 문구로 제안해 주세요. 파일은 바꾸지 마세요.

완료 기준

지역 이름 17개가 두 파일에서 일치하고 경계 연도와 통계 연도의 차이를 설명한다.

막히면

이름이 하나라도 다르면 CSV 이름(서울, 부산 등)을 기준으로 JSON을 고치지 말고 Codex에게 불일치 목록만 요청한다.

강사 진행 메모

GeoJSON 원본(약 1.8MB)은 사용하지 않는다. 좌표를 단순화해 만든 경로 파일만 준다. 좌표 변환 원리는 "위도·경도를 화면 좌표로 옮긴 그림" 정도로 설명한다.

Step 3

지도 그리기와 비율별 색상

published

Step 3

지도 그리기와 비율별 색상

선택 심화 · 10분 · 심화 · 클릭하면 움직이는 한국 지도 만들기

목표

17개 시도가 색으로 구분되는 정적 지도를 만든다.

이 단계 10분 · 선택 모듈 60분

따라 하기

1. work/map-lab.html 한 파일에 SVG 지도를 만든다.

2. 비율을 4구간(34% 미만, 34–36, 36–38, 38 이상)으로 나눠 진할수록 높게 칠한다.

3. 범례와 지역 이름 글자를 넣고 서울과 울산의 색이 다른지 확인한다.

Codex 채팅에 붙여넣기

assets/korea-sido-paths.json과 inbox/2024-regional-households.csv를 사용해 work/map-lab.html 파일 하나를 만들어 주세요. 조건: 1) 각 지역을 SVG path로 그리고 지역 이름을 표시 2) 1인가구 비율을 34% 미만, 34–36%, 36–38%, 38% 이상 4구간의 파란색으로 칠하기 3) 범례 표시 4) 데이터는 스크립트 안의 객체 한 곳에 두기 5) 외부 라이브러리와 외부 이미지 없이 만들기. 아직 클릭 기능은 넣지 마세요.

완료 기준

17개 지역이 4가지 색으로 칠해지고 서울이 진한색, 울산이 연한색이다.

막히면

색이 모두 같으면 데이터 객체의 키와 path의 지역 이름이 일치하는지 Codex에게 확인시킨다.

강사 진행 메모

색 구간 기준을 수강생이 직접 바꿔 보게 하면 지도 색이 즉시 달라져 이해가 빠르다.

Step 4

클릭하면 상세 패널이 바뀌게

published

Step 4

클릭하면 상세 패널이 바뀌게

선택 심화 · 10분 · 심화 · 클릭하면 움직이는 한국 지도 만들기

목표

선택 상태 하나로 지도와 패널을 함께 바꾼다.

이 단계 10분 · 선택 모듈 60분

따라 하기

1. 지도 옆에 상세 패널을 추가한다. (지역명, 순위, 비율, 1인가구 수, 전체 가구 수)

2. 지역을 클릭하면 selected 상태가 바뀌고 패널과 지도 강조가 함께 바뀌게 한다.

3. "전국으로" 버튼으로 전국 평균 화면으로 돌아오게 한다.

Codex 채팅에 붙여넣기

work/map-lab.html을 이어서 수정해 주세요. 지도에서 지역을 클릭하면 오른쪽 패널이 그 지역의 순위, 1인가구 비율, 1인가구 수(천 가구), 전체 일반가구 수(천 가구)를 보여주게 해 주세요. 선택된 지역은 굵은 테두리로 강조하고, "전국으로" 버튼을 누르면 전국 36.1% 화면으로 돌아가게 해 주세요. 선택 처리는 select(name) 함수 하나로 만들고 애니메이션은 아직 넣지 마세요.

완료 기준

서울을 누르면 39.9%·1위, 울산을 누르면 31.6%·17위가 표시되고 "전국으로" 버튼이 동작한다.

막히면

클릭해도 안 바뀌면 브라우저 콘솔의 오류 문구를 그대로 Codex에게 붙여 넣는다.

강사 진행 메모

선택 상태를 여러 곳에 흩뿌려 저장하면 나중에 화면이 어긋난다. select 함수 한 곳에서 모두 갱신하는 구조를 강조한다.

Step 5

숫자·게이지·막대에 움직임 넣기

published

Step 5

숫자·게이지·막대에 움직임 넣기

선택 심화 · 12분 · 심화 · 클릭하면 움직이는 한국 지도 만들기

목표

값이 부드럽게 변하는 애니메이션을 추가한다.

이 단계 12분 · 선택 모듈 60분

따라 하기

1. 비율과 가구 수가 이전 값에서 새 값으로 올라가거나 내려가는 카운트업을 넣는다.

2. 도넛 게이지와 전체·1인가구 막대가 CSS transition으로 늘어나게 한다.

3. 전국 평균 대비 차이를 좌우 막대로 보여주고, 시스템에서 모션 줄이기를 켠 경우 애니메이션을 끈다.

Codex 채팅에 붙여넣기

work/map-lab.html에 움직임을 추가해 주세요. 1) 숫자가 이전 값에서 새 값으로 약 0.8초 동안 올라가는 카운트업 2) 비율만큼 채워지는 도넛 게이지 3) 전체 가구 대비 1인가구 막대가 늘어나는 효과 4) 선택한 지역이 살짝 커졌다 돌아오는 효과 5) 전국 평균 대비 차이(예: 서울 +3.8%p)를 좌우 막대로 표시. 시스템에서 모션 줄이기를 켠 사용자는 애니메이션 없이 바로 값이 바뀌게 해 주세요. 라이브러리 없이 CSS transition과 requestAnimationFrame만 사용하세요.

완료 기준

서울에서 울산으로 바꿀 때 숫자·게이지·막대가 함께 움직이고 서울은 전국보다 3.8%p 높다고 나온다.

막히면

움직임이 어색하면 "0.8초, 처음 빠르고 끝에서 느려지게"처럼 시간과 느낌을 말로 지정해 다시 요청한다.

강사 진행 메모

애니메이션은 이해를 돕는 정도로만 쓴다. 지속시간을 1초 이내로 유지하고 모션 줄이기 설정을 꼭 확인시킨다.

Step 6

순위 목록·툴팁·키보드 접근

published

Step 6

순위 목록·툴팁·키보드 접근

선택 심화 · 9분 · 심화 · 클릭하면 움직이는 한국 지도 만들기

목표

작은 지역도 고를 수 있고 마우스 없이도 쓰게 만든다.

이 단계 9분 · 선택 모듈 60분

따라 하기

1. 17개 시도를 높은 순으로 정렬한 순위 목록을 만들고 눌러서 지역을 선택하게 한다.

2. 지도 위에 마우스를 올리면 지역명과 비율이 툴팁으로 나오게 한다.

3. Tab과 Enter로 지역을 선택하게 하고 화면 폭이 좁으면 1열로 바꾼다.

Codex 채팅에 붙여넣기

work/map-lab.html에 다음을 추가해 주세요. 1) 1인가구 비율이 높은 순서로 17개 시도 순위 목록. 항목을 누르면 지도와 같은 select 함수로 지역이 선택되고 막대 길이가 비율을 나타냄 2) 마우스를 올리면 지역명과 비율 툴팁 3) 지도의 각 지역을 Tab으로 이동하고 Enter나 Space로 선택하며 aria-label에 지역명과 비율 표시 4) 화면 폭 760px 이하에서는 지도와 패널을 세로 1열로 배치.

완료 기준

서울처럼 작은 지역도 순위 목록으로 선택할 수 있고 Tab+Enter로 선택할 수 있다.

막히면

모바일 배치가 깨지면 개발자 도구의 모바일 화면(폭 375px)을 보며 어떤 부분이 넘치는지 말해 준다.

강사 진행 메모

서울·인천·세종처럼 작은 지역은 지도에서 누르기 어렵다는 점이 순위 목록이 필요한 이유임을 짚는다.

Step 7

보고서에 합치고 단일 HTML로 검증

published

Step 7

보고서에 합치고 단일 HTML로 검증

선택 심화 · 5분 · 심화 · 클릭하면 움직이는 한국 지도 만들기

목표

만든 지도를 보고서에 넣어 파일 하나로 완성한다.

이 단계 5분 · 선택 모듈 60분

따라 하기

1. output/one-person-report.html의 PNG 지도 부분을 work/map-lab.html의 지도로 바꿔 output/one-person-report-interactive.html로 저장한다.

2. 지도의 CSS와 스크립트가 보고서 안에 함께 들어갔는지 확인한다.

3. 빈 폴더에 파일 하나만 복사해 열고, 서울 39.9·대전 39.8·울산 31.6·전국 36.1을 눌러 확인한다.

Codex 채팅에 붙여넣기

work/map-lab.html의 지도 기능을 output/one-person-report.html의 기존 PNG 지도 자리에 넣어 output/one-person-report-interactive.html로 새로 저장해 주세요. 원래 보고서 파일은 수정하지 마세요. 지도 CSS와 스크립트는 같은 HTML 안에 두고 외부 파일과 인터넷 주소에 의존하지 않게 해 주세요. 끝나면 서울·대전·울산·전국의 화면 수치를 CSV와 대조해 알려 주세요.

완료 기준

파일 하나만 다른 폴더에서 열어도 지도 클릭과 애니메이션이 동작하고 대표 수치 4개가 CSV와 일치한다.

막히면

합치다 깨지면 examples/report-complete.html을 기준으로 삼아 차이만 Codex에게 비교시킨다.

강사 진행 메모

완성본은 지도를 이미지가 아닌 SVG로 넣었기 때문에 Base64 이미지가 필요 없다는 점을 설명한다. 인쇄 미리보기까지 확인하면 마무리다.

Module 10practice

선택 · 스킬을 찾고 설치해 보고서 검수에 쓰기

선택 · 45분 · 스킬을 반복 업무용 절차로 설명하고 프롬프트·AGENTS.md·MCP와 구분한다.

5 steps

Step 1

스킬은 어떤 문제를 푸는가

published

Step 1

스킬은 어떤 문제를 푸는가

선택 심화 · 6분 · 선택 · 스킬을 찾고 설치해 보고서 검수에 쓰기

목표

스킬을 반복 업무용 절차로 설명하고 프롬프트·AGENTS.md·MCP와 구분한다.

이 단계 6분 · 선택 모듈 45분

따라 하기

1. skill-kit/stat-brief/SKILL.md를 열어 이름, 호출 조건(description), 작업 순서, 완료 기준을 찾는다.

2. 한 번만 할 일은 요청문, 이 프로젝트의 상시 규칙은 AGENTS.md, 반복 절차는 스킬로 나눠 본다.

3. 스킬이 외부 데이터나 도구 연결 자체를 제공하는 것은 아님을 확인한다.

Codex 채팅에 붙여넣기

skill-kit/stat-brief/SKILL.md와 AGENTS.md를 읽고 이 실습에서 일회성 요청문, 상시 프로젝트 규칙, 스킬, 외부 도구 연결이 각각 맡을 일을 4행 표로 설명해 주세요. 파일은 수정하지 마세요.

완료 기준

스킬은 필요할 때 불러 쓰는 SKILL.md 기반 절차이며, 데이터 접근 권한 자체가 아니라는 점을 설명한다.

막히면

용어가 어렵다면 “매번 설명할 절차를 저장한 사용 설명서”로 다시 말한다.

강사 진행 메모

스킬은 반복 업무 지침, AGENTS.md는 프로젝트 규칙이다. 설치 경로·호출 방식은 OpenAI 공식 Build skills 문서와 현재 앱에서 확인한다.

첨부파일

Codex KDI 실습 자료 ZIP

압축을 풀고 codex-kdi-lab 폴더를 프로젝트로 엽니다.

codex-kdi-lab.zip

첨부파일

skill-kit/report-audit/SKILL.md

ZIP에 포함된 개별 실습 파일입니다.

SKILL.md

Codex 공식 사용법

다음 모듈: 추가 · PLAN/ACT와 AGENTS.md 프로젝트 규칙 설정 →

프로젝트 스킬은 .agents/skills/<이름>/SKILL.md, 명시 호출은 $skill-name입니다. PLAN/ACT는 수업의 협업 규약이며 실제 앱 권한 설정과 구분합니다.

Step 2

목록에서 내 업무에 맞는 스킬 고르기

published

Step 2

목록에서 내 업무에 맞는 스킬 고르기

선택 심화 · 9분 · 선택 · 스킬을 찾고 설치해 보고서 검수에 쓰기

목표

Codex 공식 문서와 스킬 원본을 기준으로 내 업무에 필요한 후보를 고른다.

이 단계 9분 · 선택 모듈 45분

따라 하기

1. 공식 Build skills 문서에서 SKILL.md, description, 프로젝트 설치 위치를 확인한다.

2. 수업용 stat-brief·report-audit·grill-me와 Codex에서 실제 사용할 수 있는 skill-creator·PDF 관련 스킬을 비교한다.

3. 이름만으로 설치 여부를 추측하지 않고 현재 스킬 목록과 원본 파일을 확인한다.

Codex 채팅에 붙여넣기

현재 Codex에서 사용할 수 있는 스킬과 skill-kit 폴더를 확인해 주세요. 2024년 1인가구 HTML 보고서의 원고 작성·수치 검수·요구사항 질문에 맞는 후보 두 개를 골라 입력, 산출물, 필요한 도구, 검수 항목을 비교해 주세요. 설치하지 마세요. 실제로 없는 스킬은 사용 가능하다고 쓰지 마세요.

완료 기준

후보 두 개를 이유와 함께 고르고 HTML 보고서에 바로 적용 가능한지 구분한다.

막히면

목록이 길면 HTML 디자인과 발표자료 두 항목만 비교한다.

강사 진행 메모

다른 에이전트 전용 설치 명령을 복사하지 않는다. 외부 후보는 원본 SKILL.md·의존성·라이선스를 확인한 경우에만 실습한다.

Step 3

프로젝트 스킬 설치와 호출 확인

published

Step 3

프로젝트 스킬 설치와 호출 확인

선택 심화 · 10분 · 선택 · 스킬을 찾고 설치해 보고서 검수에 쓰기

목표

검토된 자체 스킬을 Windows PowerShell에서 프로젝트 범위로 설치한다.

이 단계 10분 · 선택 모듈 45분

따라 하기

1. skill-kit/report-audit/SKILL.md를 읽고 입력·출력·검수 범위를 확인한다.

2. 아래 Codex 요청으로 .agents/skills/report-audit에 설치한다. 기존 파일은 덮어쓰지 않는다.

3. 스킬 선택 UI에서 report-audit를 확인한다. 반영되지 않으면 Codex를 다시 시작한다.

Codex 채팅에 붙여넣기

skill-kit/report-audit/SKILL.md를 읽고 현재 프로젝트의 .agents/skills/report-audit/SKILL.md에 설치해 주세요. 대상이 이미 있으면 덮어쓰지 말고 차이를 설명한 뒤 기다리세요. 전역 설정·다른 프로젝트·패키지는 변경하지 마세요. 파일 경로와 frontmatter name을 확인해 주세요.

완료 기준

.agents/skills/report-audit/SKILL.md의 name이 report-audit이며 $report-audit 명시 호출을 인식한다.

막히면

선택 UI에서 보이지 않으면 작업 폴더와 name을 확인하고 재시작한다. 여전히 안 되면 원본 SKILL.md를 직접 읽고 같은 절차로 검수하도록 요청한다.

강사 진행 메모

저장 위치는 프로젝트 .agents/skills다. 개인·전역 스킬은 변경하지 않는다. 설치 요청은 Codex 채팅에 붙여넣으며 터미널 명령이 아니다.

Step 4

같은 보고서를 스킬 없이, 스킬로 검수

published

Step 4

같은 보고서를 스킬 없이, 스킬로 검수

선택 심화 · 13분 · 선택 · 스킬을 찾고 설치해 보고서 검수에 쓰기

목표

스킬을 쓰는 이유를 결과의 재현성과 누락 항목으로 확인한다.

이 단계 13분 · 선택 모듈 45분

따라 하기

1. 먼저 일반 요청으로 output/one-person-report.html의 오류를 찾아 보되 파일을 고치지 않는다.

2. 다음으로 $report-audit를 명시 호출해 work/report-audit.md를 만든다.

3. 두 결과에서 2024 기준, 지역 내 비율의 분모, 출처, 17개 지역, 외부 표시 자산 여부가 모두 확인됐는지 비교한다.

Codex 채팅에 붙여넣기

먼저 일반 요청: output/one-person-report.html의 오류를 확인해 주세요. 수정하지 마세요.
다음은 별도 메시지로 실행: $report-audit output/one-person-report.html
두 결과를 비교해 기준연도·지역 내 비율의 분모·공식 출처·17개 시도·단일 HTML 표시 자산 중 빠진 항목을 알려주세요.

완료 기준

work/report-audit.md에 확인 항목, 근거 파일, 통과/확인 필요, 수정 제안이 있고 원본 HTML·CSV는 그대로다.

막히면

스킬 호출이 안 되면 SKILL.md를 직접 읽어 같은 검수 항목으로 요청한다.

강사 진행 메모

정답은 “스킬이 항상 더 좋다”가 아니라, 동일 기준을 다음 보고서에도 재사용할 수 있다는 점이다. 오류가 없으면 없는 대로 기록한다.

Step 5

외부 스킬을 들일 때의 결정

published

Step 5

외부 스킬을 들일 때의 결정

선택 심화 · 7분 · 선택 · 스킬을 찾고 설치해 보고서 검수에 쓰기

목표

관심 있는 외부 스킬 하나의 설치 방식과 검수 계획을 만든다.

이 단계 7분 · 선택 모듈 45분

따라 하기

1. 관심 스킬 원본 저장소의 SKILL.md·scripts·라이선스·필수 도구를 확인한다.

2. 지원하는 에이전트와 운영체제, Codex에서의 설치·호출 방식을 확인한다.

3. 공개 샘플로 설치 전후 출력·수치·출처·파일 변경 범위를 비교하는 계획을 만든다.

Codex 채팅에 붙여넣기

내가 고른 외부 스킬의 원본 저장소 링크를 읽고 설치 전 점검표를 만들어 주세요. SKILL.md, 동봉 스크립트, 외부 전송, 의존성, 라이선스, 프로젝트/개인 설치 위치, 시험할 작은 작업을 포함하세요. 검토 단계에서는 설치나 실행을 하지 마세요.

완료 기준

선택한 스킬의 “쓸 일/안 쓸 일/설치 조건/시험 과제”를 한 장으로 설명한다.

막히면

외부 저장소가 없거나 라이선스·필수 파일이 불명확하면 소개만 하고 설치 후보에서 제외한다.

강사 진행 메모

외부 스킬 설치는 선택 과제다. 원본이 불명확하거나 필수 도구가 없으면 설치하지 않고 수업용 report-audit를 사용한다.

Module 11practice

추가 · PLAN/ACT와 AGENTS.md 프로젝트 규칙 설정

선택 · 25분 · 앱 권한 모드와 Markdown 협업 규약을 구분한다.

5 steps

Step 1

실제 Plan 모드와 PLAN/ACT 규약 구분

published

Step 1

실제 Plan 모드와 PLAN/ACT 규약 구분

선택 심화 · 4분 · 추가 · PLAN/ACT와 AGENTS.md 프로젝트 규칙 설정

목표

앱 권한 모드와 Markdown 협업 규약을 구분한다.

이 단계 4분 · 선택 모듈 25분

따라 하기

1. codex-kdi-lab 프로젝트와 현재 앱의 계획 모드 제공 여부를 확인한다.

2. 계획 전용 모드가 있으면 선택하고, 없으면 읽기와 설계만 허용하는 요청을 명확히 한다.

3. PLAN/ACT는 이 수업의 협업 규약이며 글자 입력만으로 권한·샌드박스·앱 모드가 바뀌지 않음을 확인한다.

Codex 채팅에 붙여넣기

현재 폴더의 AGENTS.md를 읽고 이 프로젝트의 계획·승인·실행 규칙을 설명해 주세요. 지금은 Plan 모드에서 검토만 합니다. 파일을 만들거나 수정하지 마세요.

완료 기준

계획·실행 합의, 실제 앱 모드, 도구 실행 권한이 각각 다른 역할임을 설명한다.

막히면

Plan 선택 메뉴가 다르면 공식 문서와 현재 앱 메뉴를 대조한다. 텍스트로 PLAN만 쓰고 실제 모드가 바뀌었다고 판단하지 않는다.

강사 진행 메모

Codex의 실제 모드·승인 UI는 앱 버전과 계정 설정을 따른다. AGENTS.md는 지침이며 권한 설정을 강제로 전환하지 않는다.

첨부파일

Codex KDI 실습 자료 ZIP

압축을 풀고 codex-kdi-lab 폴더를 프로젝트로 엽니다.

codex-kdi-lab.zip

첨부파일

templates/AGENTS-plan-act.md

ZIP에 포함된 개별 실습 파일입니다.

AGENTS-plan-act.md

Codex 공식 사용법

다음 모듈: 추가 · grill-me 스킬 설치와 질문으로 판단 기준 정하기 →

프로젝트 스킬은 .agents/skills/<이름>/SKILL.md, 명시 호출은 $skill-name입니다. PLAN/ACT는 수업의 협업 규약이며 실제 앱 권한 설정과 구분합니다.

Step 2

기존 AGENTS.md를 읽고 규칙 변경 계획

published

Step 2

기존 AGENTS.md를 읽고 규칙 변경 계획

선택 심화 · 5분 · 추가 · PLAN/ACT와 AGENTS.md 프로젝트 규칙 설정

목표

규칙 원본을 보존하며 프로젝트 목적·입력·출력·검증 조건을 정한다.

이 단계 5분 · 선택 모듈 25분

따라 하기

1. templates/AGENTS-plan-act.md와 현재 AGENTS.md를 나란히 읽는다.

2. inbox·assets 원본 보존, work·output 저장, 숫자·출처 검수 조건을 찾는다.

3. 규칙 파일 전체 교체가 아니라 기존 내용에 합칠 변경안을 요청한다.

Codex 채팅에 붙여넣기

AGENTS.md와 templates/AGENTS-plan-act.md를 읽어 기존 규칙을 보존하는 병합안을 제안해 주세요. 입력·목적·제약·완료 기준과 PLAN→승인→ACT→검증 절차를 포함하세요. 기존 규칙과 충돌하는 부분은 표시하고 아직 파일은 수정하지 마세요.

완료 기준

변경할 AGENTS.md 문장, 유지할 기존 규칙, 승인할 범위가 표시된다.

막히면

AGENTS.md가 없으면 현재 앱에서 프로젝트 지침이 어떻게 로드되는지 확인하고 프로젝트 루트의 AGENTS.md 생성안을 먼저 검토한다.

강사 진행 메모

Codex는 적용 범위의 AGENTS.md를 읽는다. 전역에서 하위 폴더까지 규칙이 합쳐질 수 있으므로 실제 적용 파일을 확인한다. 파일 기록은 경로를 지정해 읽도록 요청한다.

Step 3

승인 후 규칙 저장하고 새 세션에서 확인

published

Step 3

승인 후 규칙 저장하고 새 세션에서 확인

선택 심화 · 6분 · 추가 · PLAN/ACT와 AGENTS.md 프로젝트 규칙 설정

목표

검토한 범위만 저장하고 규칙이 다음 세션에도 인식되는지 확인한다.

이 단계 6분 · 선택 모듈 25분

따라 하기

1. 앞 단계 병합안의 변경 파일과 내용을 읽고 승인할 항목을 정한다.

2. 계획을 승인한 뒤 실제 앱 모드를 실행 가능한 앱 모드로 전환하고 저장 요청을 실행한다. 도구 승인 화면도 읽는다.

3. 새 세션에서도 같은 폴더를 열고 실제 파일을 읽어 규칙을 확인한다.

Codex 채팅에 붙여넣기

검토한 AGENTS.md 병합 계획을 승인합니다. 해당 파일의 승인한 규칙만 반영해 주세요. 기존 규칙과 원본 자료는 보존하고 다른 파일은 수정하지 마세요. 변경 전후의 차이와 적용한 경로를 알려주세요.

완료 기준

실제 AGENTS.md에 규칙이 저장됐고 새 세션에서 원본 보존·승인 범위를 설명한다.

막히면

규칙을 못 찾으면 작업 폴더와 파일 이름을 확인한다. 메모장 저장 시 AGENTS.md.txt가 되지 않았는지도 확인한다.

강사 진행 메모

승인 문장만으로 Plan 모드가 해제된다고 설명하지 않는다. 규칙을 이해했다고 답하는 것과 실제 저장한 파일을 확인하는 것을 구분한다.

Step 4

보고서 한 문단으로 PLAN→ACT 검증

published

Step 4

보고서 한 문단으로 PLAN→ACT 검증

선택 심화 · 6분 · 추가 · PLAN/ACT와 AGENTS.md 프로젝트 규칙 설정

목표

변경 범위를 작게 제한해 계획·승인·실행·검수를 경험한다.

이 단계 6분 · 선택 모듈 25분

따라 하기

1. output/one-person-report.html이 없으면 examples/report-complete.html을 읽고 새 output 파일을 만드는 계획으로 바꾼다.

2. 실제 Plan 모드에서 “읽을 때 주의할 점” 한 문단만 고치는 계획을 요청한다.

3. 계획을 검토하고 실행 가능한 앱 모드로 전환해 승인한 범위만 실행한 뒤 수치·출처를 대조한다.

Codex 채팅에 붙여넣기

output/one-person-report.html의 “읽을 때 주의할 점” 문단만 비개발자가 읽기 쉽게 바꾸는 계획을 제안해 주세요. 2024년, 36.1%, 39.9%, 31.6%, 17개 시도 표, 이미지와 출처는 유지하세요. 먼저 대상 문장·수정 범위·검증 방법·멈출 조건을 설명하고 승인 전에는 HTML을 수정하지 마세요.

완료 기준

계획 때는 HTML이 그대로이며 승인 후 한 문단만 바뀐다. 숫자·표·이미지·출처가 유지된다.

막히면

여러 영역을 바꾸는 계획이면 문단 한 개로 줄인다. 수치가 달라졌으면 변경을 완료로 처리하지 않고 원자료와 다시 대조한다.

강사 진행 메모

계획 문서 생성까지 허용하려면 그 경로를 따로 승인한다. 이 단계의 초기 요청은 검토만 하며 작업 파일을 만들지 않는다.

Step 5

진행 기록을 남기고 다음 세션으로 이어가기

published

Step 5

진행 기록을 남기고 다음 세션으로 이어가기

선택 심화 · 4분 · 추가 · PLAN/ACT와 AGENTS.md 프로젝트 규칙 설정

목표

파일 기반 기록으로 승인 범위와 다음 행동을 이어받는다.

이 단계 4분 · 선택 모듈 25분

따라 하기

1. 승인한 계획, 바뀐 파일, 검증 결과, 미확인 사항을 확인한다.

2. 기록 파일 두 개만 저장하도록 요청한다.

3. 새 세션에서 기록을 읽고 다음 작업의 계획만 요청한다.

Codex 채팅에 붙여넣기

지금 승인한 계획과 실제 변경 파일·검증 결과를 work/plan.md에 정리하고, 미확인 사항과 다음 행동은 work/next-actions.md에 저장해 주세요. 이 두 기록 파일의 작성만 승인합니다. HTML과 원본 자료는 더 수정하지 마세요.

완료 기준

새 세션이 두 기록 파일을 읽고 다음 계획을 제안하며 이전 승인 범위를 자동 확대하지 않는다.

막히면

기록이 장문이면 완료·미완료·다음 작업 3개 항목으로 줄인다. 기록 파일은 필요한 때 직접 읽어야 한다.

강사 진행 메모

work/plan.md와 memory_bank 폴더가 자동으로 모두 로드된다고 설명하지 않는다. 경로를 명시해 읽도록 요청한다.

Module 12practice

추가 · grill-me 스킬 설치와 질문으로 판단 기준 정하기

선택 · 20분 · 답을 대신 쓰는 요청과 판단 기준을 좁히는 질문 인터뷰를 구분한다.

4 steps

Step 1

grill-me의 역할과 수업용 스킬 읽기

published

Step 1

grill-me의 역할과 수업용 스킬 읽기

선택 심화 · 4분 · 추가 · grill-me 스킬 설치와 질문으로 판단 기준 정하기

목표

답을 대신 쓰는 요청과 판단 기준을 좁히는 질문 인터뷰를 구분한다.

이 단계 4분 · 선택 모듈 20분

따라 하기

1. skill-kit/grill-me/SKILL.md를 읽는다. 이 자료는 기존 USLab 질문 교안을 재구성한 수업용 스킬이다.

2. 한 번에 질문 하나, 사용자 답 대기, 사실·해석·제안 구분을 찾는다.

3. 현재 보고서의 독자·공유 목적 중 먼저 정할 한 가지를 고른다.

Codex 채팅에 붙여넣기

skill-kit/grill-me/SKILL.md를 읽고 일반 보고서 작성 요청과 무엇이 다른지 3개 항목으로 설명해 주세요. 아직 스킬을 설치하거나 보고서를 수정하지 마세요.

완료 기준

grill-me는 보고서 결론을 대신 정하지 않고 내 판단 기준을 하나씩 묻는다고 설명한다.

막히면

공격적인 표현이 부담되면 “판단 기준 인터뷰”라고 부르고 같은 절차를 따른다.

강사 진행 메모

기존 claude-code-onboarding-grill-me의 한 질문씩 진행·다음 액션 절차와 USLab 로컬 스킬 원문을 참고했다. 외부 저장소 설치나 공식 내장 기능으로 소개하지 않는다.

첨부파일

Codex KDI 실습 자료 ZIP

압축을 풀고 codex-kdi-lab 폴더를 프로젝트로 엽니다.

codex-kdi-lab.zip

첨부파일

skill-kit/grill-me/SKILL.md

ZIP에 포함된 개별 실습 파일입니다.

SKILL.md

다음 모듈: 추가 · memory_bank로 기록하고 새 세션에서 이어가기 →

Step 2

프로젝트에 설치하고 인식 확인

published

Step 2

프로젝트에 설치하고 인식 확인

선택 심화 · 6분 · 추가 · grill-me 스킬 설치와 질문으로 판단 기준 정하기

목표

현재 프로젝트 범위에서만 스킬을 설치한다.

이 단계 6분 · 선택 모듈 20분

따라 하기

1. skill-kit/grill-me/SKILL.md를 읽고 한 질문씩 진행하는 규칙을 확인한다.

2. 아래 설치 요청으로 프로젝트 .agents/skills/grill-me/SKILL.md에 배치한다.

3. 기존 스킬이 있으면 차이를 검토한다. 스킬 선택 UI에 없으면 Codex를 다시 시작한다.

Codex 채팅에 붙여넣기

skill-kit/grill-me/SKILL.md를 읽고 현재 프로젝트의 .agents/skills/grill-me/SKILL.md에 설치해 주세요. 대상이 이미 있으면 덮어쓰지 말고 차이를 설명한 뒤 기다리세요. 전역 설정·다른 프로젝트·패키지는 변경하지 마세요. 파일 경로와 frontmatter name을 확인해 주세요.

완료 기준

.agents/skills/grill-me/SKILL.md가 있고 $grill-me 명시 호출이 인식된다.

막히면

Codex 채팅 요청과 터미널 명령을 구분한다. 현재 작업 폴더와 skill-kit 존재 여부를 확인하고, 인식이 안 되면 같은 프로젝트에서 Codex를 재시작한다.

강사 진행 메모

프로젝트 범위의 자체 교육용 스킬이다. 내장 기능이나 외부 원본이라고 소개하지 않는다. 설치 요청은 Codex 채팅에서 실행한다.

Step 3

질문·답변 두 번과 사실/해석 구분

published

Step 3

질문·답변 두 번과 사실/해석 구분

선택 심화 · 6분 · 추가 · grill-me 스킬 설치와 질문으로 판단 기준 정하기

목표

두 차례 질문으로 독자와 보고서 범위를 좁힌다.

이 단계 6분 · 선택 모듈 20분

따라 하기

1. 첫 질문에 실제 독자와 공유 목적을 답한다.

2. 다음 질문에 확실한 수치와 이번 자료로 말할 수 없는 원인을 구분해 답한다.

3. 질문이 여러 개면 한 개로 줄이고, 추천 답은 검토한 뒤 선택한다.

Codex 채팅에 붙여넣기

$grill-me examples/report-complete.html과 inbox/source-notes.md를 읽어 보고서를 누구에게 어떤 목적으로 공유할지 먼저 질문 하나만 해 주세요. 질문 이유와 근거가 있는 추천 답을 짧게 쓰고 내 답을 기다리세요. 수치 검수와 판단 기준을 사실·해석·제안으로 구분하고 파일은 수정하지 마세요.

완료 기준

한 번에 질문 하나씩 두 차례 답하고, 지역 비율과 원인 추정이 서로 다르다고 설명한다.

막히면

답이 이미 정해져 있으면 스킬을 억지로 쓰지 않고 직접 작성 요청으로 돌아간다. 출처 없는 추천 답은 근거를 묻는다.

강사 진행 메모

“추천대로”는 해당 질문의 답이지 파일 수정·외부 공유 승인이라는 뜻이 아니다. 답변 대기 없이 결과물을 완성하면 다시 인터뷰 범위를 제한한다.

Step 4

질문 기록과 다음 행동 저장

published

Step 4

질문 기록과 다음 행동 저장

선택 심화 · 4분 · 추가 · grill-me 스킬 설치와 질문으로 판단 기준 정하기

목표

인터뷰에서 드러난 기준을 작업 기록으로 남긴다.

이 단계 4분 · 선택 모듈 20분

따라 하기

1. 질문 두 개와 내 답, 합의한 독자·범위를 확인한다.

2. 저장할 두 파일과 승인 범위를 명시한다.

3. 다음 세션에서 규칙과 질문 기록을 읽어 계획 단계로 이어간다.

Codex 채팅에 붙여넣기

방금 질문과 내 답을 work/grill-log.md에 정리하고, 확인된 판단 기준·미확인 사항·다음 행동 3개를 work/decision.md에 저장해 주세요. 이 두 파일의 작성만 승인합니다. 통계 원본과 HTML은 수정하지 말고 외부로 전송하지 마세요.

완료 기준

질문 로그·판단 기준 파일이 있으며 각 다음 행동에 확인할 자료 또는 완료 기준이 있다.

막히면

이름이 다른 파일에 자동 저장했다면 요청한 경로와 비교한다. 보고서 수정과 공유는 다음 계획에서 따로 검토한다.

강사 진행 메모

기존 보충 모듈의 decisions/next_actions.md 교안은 심화 업무 적용 참고로 보존한다. 이번 실습은 work/ 아래에 기록을 모은다.

Module 13practice

추가 · memory_bank로 기록하고 새 세션에서 이어가기

선택 · 25분 · 규칙, 내장 기억, 수업용 작업 기록의 역할을 구분한다.

5 steps

Step 1

AGENTS.md·제품의 메모리 기능·memory_bank 구분

published

Step 1

AGENTS.md·제품의 메모리 기능·memory_bank 구분

선택 심화 · 4분 · 추가 · memory_bank로 기록하고 새 세션에서 이어가기

목표

규칙, 내장 기억, 수업용 작업 기록의 역할을 구분한다.

이 단계 4분 · 선택 모듈 25분

따라 하기

1. AGENTS.md는 프로젝트 지침, memory_bank는 우리가 만든 기록 폴더로 구분한다.

2. projectbrief·activeContext·progress·decisionLog가 각각 목적·현재 상태·실제 작업·판단 근거를 기록하는지 확인한다.

3. 새 채팅에서 필요한 파일 경로를 지정해 읽도록 요청한다. 파일 전체의 자동 로드를 가정하지 않는다.

Codex 채팅에 붙여넣기

AGENTS.md와 templates/memory-bank/README.md를 읽고 규칙 파일과 작업 기록의 차이를 설명해 주세요. 이 폴더는 템플릿이며 현재 진행 상태로 취급하지 마세요. 아직 파일을 만들거나 수정하지 마세요.

완료 기준

규칙·현재 상태·작업 이력·결정 이유를 각각 어디에 남길지 말한다.

막히면

필요한 파일이 없으면 없다고 표시하고 템플릿과 현재 상태를 구분한다. 이 수업은 파일 경로를 명시해 읽는 방법으로 진행한다.

강사 진행 메모

memory_bank는 이 수업의 파일 기록 규약이다. 폴더 전체가 제품 메모리로 자동 저장·로드된다고 가정하지 않는다. AGENTS.md에 읽기 규칙을 두고 실제 파일 경로를 지정해 확인한다.

첨부파일

Codex KDI 실습 자료 ZIP

압축을 풀고 codex-kdi-lab 폴더를 프로젝트로 엽니다.

codex-kdi-lab.zip

첨부파일

templates/memory-bank/README.md

ZIP에 포함된 개별 실습 파일입니다.

README.md

첨부파일

templates/memory-bank/projectbrief.md

ZIP에 포함된 개별 실습 파일입니다.

projectbrief.md

첨부파일

templates/memory-bank/activeContext.md

ZIP에 포함된 개별 실습 파일입니다.

activeContext.md

첨부파일

templates/memory-bank/progress.md

ZIP에 포함된 개별 실습 파일입니다.

progress.md

첨부파일

templates/memory-bank/decisionLog.md

ZIP에 포함된 개별 실습 파일입니다.

decisionLog.md

Codex 공식 사용법

다음 모듈: rhwp로 한글 문서 읽고 수정하기 →

프로젝트 스킬은 .agents/skills/<이름>/SKILL.md, 명시 호출은 $skill-name입니다. PLAN/ACT는 수업의 협업 규약이며 실제 앱 권한 설정과 구분합니다.

Step 2

기존 기록을 확인하고 네 파일 작성 계획

published

Step 2

기존 기록을 확인하고 네 파일 작성 계획

선택 심화 · 5분 · 추가 · memory_bank로 기록하고 새 세션에서 이어가기

목표

확인한 정보만 짧은 기록으로 남길 계획을 세운다.

이 단계 5분 · 선택 모듈 25분

따라 하기

1. 실제 Plan 모드에서 기존 memory_bank와 템플릿을 비교한다.

2. projectbrief·activeContext·progress·decisionLog에 넣을 정보를 구분한다.

3. 기존 work/plan.md와 work/decision.md가 있다면 참고하되 원본 기록을 이동하거나 삭제하지 않는다.

Codex 채팅에 붙여넣기

현재 AGENTS.md, inbox/source-notes.md와 실제 존재하는 work/plan.md, work/next-actions.md, work/decision.md를 읽어 주세요. 없는 파일은 없다고 표시하세요. templates/memory-bank의 예시를 참고해 memory_bank/projectbrief.md, activeContext.md, progress.md, decisionLog.md의 작성 또는 병합 계획을 제안하세요. 확인한 내용만 쓰고 승인·검증 결과를 추측하지 마세요. 기존 파일은 보존하고 아직 수정하지 마세요.

완료 기준

네 파일의 작성 대상·근거·미확인 항목과 기존 파일 유지 범위가 표시된다.

막히면

기록이 없는 신규 프로젝트라면 목적·입력만 확인하고 진행과 결정은 아직 미확인이라고 적는 계획으로 바꾼다.

강사 진행 메모

전체 대화 복사 대신 다음 사람이 이어갈 정보만 남긴다. 빈 템플릿의 대괄호를 사실로 받아들이지 않게 한다.

Step 3

승인 후 기록 저장·AGENTS.md에 읽기 규칙 연결

published

Step 3

승인 후 기록 저장·AGENTS.md에 읽기 규칙 연결

선택 심화 · 6분 · 추가 · memory_bank로 기록하고 새 세션에서 이어가기

목표

기존 기록과 규칙을 보존하며 명시적인 읽기·갱신 절차를 만든다.

이 단계 6분 · 선택 모듈 25분

따라 하기

1. 작성·병합 계획을 읽고 승인할 범위를 고른다.

2. 실제 실행 가능한 앱 모드에서 네 기록 파일만 저장하도록 요청한다.

3. AGENTS.md에는 필요한 기록을 먼저 읽고 완료 후 갱신하는 짧은 지침을 따로 검토해 추가한다.

Codex 채팅에 붙여넣기

검토한 memory_bank 네 파일의 작성·병합 계획을 승인합니다. 승인한 기록 파일만 반영하고 기존 내용은 보존하세요. HTML과 원본 자료는 수정하지 마세요. 이어서 AGENTS.md에 “새 작업은 memory_bank/projectbrief.md와 memory_bank/activeContext.md를 먼저 읽고, 관련 progress.md와 decisionLog.md는 필요할 때 읽는다. 승인한 작업 후 실제 변경·검증·미완료·다음 행동을 갱신한다”라는 지침을 합칠 변경안을 보여 주세요. AGENTS.md는 추가 검토 전 수정하지 마세요.

완료 기준

네 실제 기록 파일이 있고, AGENTS.md 병합안을 별도 승인·저장한 뒤 실제 차이를 확인한다.

막히면

기존 지침과 충돌하면 합의가 필요한 문장을 표시하고 기록 파일만 저장한 상태에서 멈춘다.

강사 진행 메모

규칙 병합안 확인 후 “검토한 읽기·갱신 지침만 AGENTS.md에 반영해 주세요”라고 별도로 요청한다. 전체 템플릿을 강제로 덮어쓰지 않는다.

Step 4

새 세션에서 읽고 다음 계획만 제안

published

Step 4

새 세션에서 읽고 다음 계획만 제안

선택 심화 · 5분 · 추가 · memory_bank로 기록하고 새 세션에서 이어가기

목표

대화 이력이 없는 세션도 근거 파일로 현재 상태를 이어받는지 확인한다.

이 단계 5분 · 선택 모듈 25분

따라 하기

1. 새 세션에서 같은 codex-kdi-lab 프로젝트를 연다.

2. 기록 경로를 명시해 읽도록 하고 현재 목표·완료·미완료를 설명하게 한다.

3. 다음 행동 하나의 계획만 받고 이전 승인 범위를 자동 확대하지 않는지 확인한다.

Codex 채팅에 붙여넣기

AGENTS.md, memory_bank/projectbrief.md와 memory_bank/activeContext.md를 먼저 읽고 필요한 progress.md와 decisionLog.md를 확인해 주세요. 실제 읽은 파일 경로, 현재 목표, 완료·미완료, 미확인 사항, 다음 행동 하나를 요약하세요. 기록과 실제 output 파일이 충돌하면 충돌을 표시하세요. 지금은 다음 작업의 계획만 제안하며 파일은 수정하지 마세요.

완료 기준

실제 읽은 경로와 근거를 말하고, 없는 기록·실행하지 않은 검증·새 승인을 만들어내지 않는다.

막히면

기억한다고 답하기만 하면 파일별 근거를 요청한다. 최신 기록과 실제 파일이 다르면 확인이 필요한 상태로 남긴다.

강사 진행 메모

다음 세션에서 바로 이어지는 것이 완료 기준이다. memory_bank를 만들었다는 사실만으로 실습을 끝내지 않는다.

Step 5

작업 뒤 갱신·오래된 기록 정리

published

Step 5

작업 뒤 갱신·오래된 기록 정리

선택 심화 · 5분 · 추가 · memory_bank로 기록하고 새 세션에서 이어가기

목표

현재 상태를 짧게 유지하고 실제 작업·결정 이력을 누적한다.

이 단계 5분 · 선택 모듈 25분

따라 하기

1. 앞선 PLAN/ACT 실습에서 실제 변경한 한 문단과 검증 결과를 확인한다.

2. activeContext는 현재 상태로 갱신하고 progress는 날짜별 이력으로 추가한다.

3. 독자·범위 결정이 실제로 바뀐 경우에만 decisionLog에 이유를 추가한다.

Codex 채팅에 붙여넣기

기록과 실제 output/one-person-report.html을 비교해 이미 완료한 작업·실행한 검증·미완료를 구분해 주세요. memory_bank/activeContext.md의 현재 상태와 다음 행동을 갱신하고 progress.md에 날짜·변경 파일·실제 검증·미완료를 추가하세요. 사용자 답으로 확인된 새 결정이 있을 때만 decisionLog.md에 근거를 추가하세요. 이 기록 파일의 갱신만 승인하며 HTML·통계 원본·기존 이력은 변경하지 마세요. 실제 보고서가 없으면 없다고 기록하세요.

완료 기준

현재 기록과 이력의 역할이 구분되고 다음 행동에 확인할 자료·완료 기준이 있다.

막히면

진행하지 않은 작업이 완료로 적혔으면 근거를 대조해 바로잡는다. 개인정보·비밀키·대화 전체를 복사하지 않는다.

강사 진행 메모

도입은 네 파일이면 충분하다. 제품 맥락·기술 맥락 등 별도 파일은 기록이 커질 때 확장한다.

Module 14practice

rhwp로 한글 문서 읽고 수정하기

선택 · 25분 · 브라우저에서 교육용 HWPX의 본문과 표를 확인한다.

5 steps

Step 1

rhwp 웹 편집기로 HWPX 열기

published

Step 1

rhwp 웹 편집기로 HWPX 열기

선택 심화 · 5분 · rhwp로 한글 문서 읽고 수정하기

목표

브라우저에서 교육용 HWPX의 본문과 표를 확인한다.

이 단계 5분 · 선택 모듈 25분

따라 하기

1. 실습 ZIP의 inbox/rhwp-practice.hwpx와 rhwp-guide.md를 확인한다. 교육용 가상 문서이며 실제 정책자료가 아니다.

2. rhwp 웹 편집기를 Codex 인앱 브라우저에서 연다. 사용할 수 없으면 일반 브라우저를 이용한다.

3. 파일 메뉴에서 inbox/rhwp-practice.hwpx를 열고 제목, 검토 전 문구, 담당·상태 표를 확인한다.

Codex 채팅에 붙여넣기

Codex 인앱 브라우저에서 https://edwardkim.github.io/rhwp/ 를 열어 주세요. 제가 inbox/rhwp-practice.hwpx를 선택해 열겠습니다. 현재 보이는 문서의 제목과 표를 확인하고 내용은 수정하지 마세요. 브라우저 조작 도구가 없으면 직접 열고 확인할 순서를 안내해 주세요.

완료 기준

웹 편집기에서 KDI 문서 실습 안내, 검토 전, 표의 검토 예정 문구를 확인한다.

막히면

빈 화면이면 파일 확장자와 선택한 파일을 확인한다. 웹 편집기 오류가 나면 원본을 보존하고 강사 화면으로 비교한다.

강사 진행 메모

rhwp는 Rust/WASM 기반 웹 뷰어·편집기다. 한컴과 조판이 항상 같다고 설명하지 않는다. 비공개 업무자료 대신 제공한 가상 HWPX를 사용한다.

첨부파일

Codex KDI 실습 자료 ZIP

압축을 풀고 codex-kdi-lab 폴더를 프로젝트로 엽니다.

codex-kdi-lab.zip

첨부파일

rhwp-guide.md

ZIP에 포함된 개별 실습 파일입니다.

rhwp-guide.md

첨부파일

inbox/rhwp-practice.hwpx

ZIP에 포함된 개별 실습 파일입니다.

rhwp-practice.hwpx

다음 모듈: 마지막 선택 실습 · K-Skill을 Codex에서 활용하기 →

Step 2

Codex에 hwp-mcp 연결하기

published

Step 2

Codex에 hwp-mcp 연결하기

선택 심화 · 5분 · rhwp로 한글 문서 읽고 수정하기

목표

웹 편집기와 파일 수정용 MCP를 구분하고 연결 상태를 확인한다.

이 단계 5분 · 선택 모듈 25분

따라 하기

1. rhwp-guide.md에서 연결 설정을 읽는다. 브라우저는 화면 확인, hwp-mcp는 로컬 파일 읽기·수정을 맡는다.

2. 아래 요청으로 hwp-mcp 0.3.0을 연결한다. Node.js와 npm/npx가 없다면 강사 사전 준비 또는 짝 실습으로 전환한다.

3. Codex 설정에서 hwp-mcp가 활성화됐는지 확인한다. 도구가 안 보이면 새 채팅을 열고 필요하면 앱을 다시 시작한다.

Codex 채팅에 붙여넣기

https://github.com/treesoop/hwp-mcp 의 README와 현재 Codex MCP 설정을 확인하고 hwp-mcp@0.3.0을 연결해 주세요. 기존 서버 설정은 보존하세요. Node.js와 npm/npx 사용 가능 여부를 먼저 확인하고, 없으면 추가 설치 전에 필요한 준비를 설명해 주세요. 연결 후 read_hwp, replace_hwp_text, set_hwp_cell_text 도구가 실제로 보이는지 확인해 주세요. 문서 내용은 아직 수정하지 마세요.

완료 기준

hwp-mcp 연결과 읽기·치환·셀 수정 도구를 확인한다. 설정 등록만으로 호출 성공이라고 판단하지 않는다.

막히면

npx를 찾지 못하면 Node.js LTS 설치 상태와 실행 경로를 강사와 확인한다. 현재 채팅에 도구가 없으면 새 채팅/재시작 후 다시 확인한다.

강사 진행 메모

사전 설치를 권장한다. API 키나 한컴 설치는 이 MCP의 필수 조건이 아니다. 학생 PC의 기존 Codex 설정을 통째로 덮어쓰지 않는다. 수업 검증 버전은 0.3.0이다.

Step 3

MCP로 본문과 표 읽기

published

Step 3

MCP로 본문과 표 읽기

선택 심화 · 5분 · rhwp로 한글 문서 읽고 수정하기

목표

수정할 문구와 표의 위치를 실제 파일에서 찾는다.

이 단계 5분 · 선택 모듈 25분

따라 하기

1. MCP에 전달할 inbox/rhwp-practice.hwpx의 절대경로를 확인한다.

2. read_hwp로 본문과 표를 읽고 검토 전 문구와 담당·상태 표를 확인한다.

3. 표 인덱스 0, 행 1, 열 1이 검토 예정 셀인지 읽기 결과와 대조한다. 인덱스는 0부터 센다.

Codex 채팅에 붙여넣기

hwp-mcp의 read_hwp로 inbox/rhwp-practice.hwpx를 읽어 주세요. 실제 절대경로를 사용하고 본문과 표를 함께 확인하세요. 검토 전 문구가 있는지, 표 인덱스 0의 행 1·열 1 값이 검토 예정인지 알려 주세요. 지금은 읽기만 하고 파일을 수정하지 마세요.

완료 기준

본문의 검토 전과 표 셀의 검토 예정을 읽기 결과에서 확인한다.

막히면

본문 전용 추출에서 표가 안 보이면 read_hwp 또는 read_hwp_tables를 사용한다. 도구가 호출되지 않았으면 결과를 추측하지 않는다.

강사 진행 메모

파일 경로·수정 대상·현재 값을 먼저 확인한다. 이미지 안의 글씨는 본문 텍스트와 다르며, MCP가 모든 내장 이미지를 읽는다고 가정하지 않는다.

Step 4

본문과 표를 수정본에 저장하기

published

Step 4

본문과 표를 수정본에 저장하기

선택 심화 · 5분 · rhwp로 한글 문서 읽고 수정하기

목표

원본을 유지하면서 본문 문구와 기존 표 셀 한 곳을 수정한다.

이 단계 5분 · 선택 모듈 25분

따라 하기

1. replace_hwp_text로 검토 전을 검토 완료로 바꾸고 output/rhwp-text-edited.hwpx에 저장한다.

2. 그 수정본에 set_hwp_cell_text를 호출해 표 0·행 1·열 1의 검토 예정을 확인 완료로 바꾸고 output/rhwp-edited.hwpx에 저장한다.

3. 두 번째 작업의 입력이 첫 수정본인지 확인한다. 원본과 최종본의 경로를 구분한다.

Codex 채팅에 붙여넣기

hwp-mcp로 다음 두 작업을 순서대로 실행해 주세요. 1) inbox/rhwp-practice.hwpx의 검토 전을 검토 완료로 치환해 output/rhwp-text-edited.hwpx에 저장하세요. 2) 방금 저장한 수정본을 입력으로 사용해 표 인덱스 0, 행 1, 열 1의 텍스트를 확인 완료로 바꾸고 output/rhwp-edited.hwpx에 저장하세요. 모든 도구에 실제 절대경로와 output_path를 지정하세요. 원본은 덮어쓰지 마세요. 요청한 두 곳 외에 서식이나 다른 내용을 바꾸지 마세요.

완료 기준

최종 수정본이 생성됐고 첫 수정 결과를 두 번째 입력으로 사용했다. 원본 경로에 저장하지 않았다.

막히면

변경 0건이거나 대상 셀에 기존 텍스트가 없으면 멈추고 다시 읽는다. 저장 성공 메시지만으로 수정 성공이라고 판단하지 않는다.

강사 진행 메모

0.3.0은 빈 셀·그림만 있는 셀 수정과 글자 서식에 제한이 있다. 이 단계는 검증한 본문 치환과 기존 텍스트 셀만 사용한다.

Step 5

수정본 다시 읽고 브라우저에서 비교하기

published

Step 5

수정본 다시 읽고 브라우저에서 비교하기

선택 심화 · 5분 · rhwp로 한글 문서 읽고 수정하기

목표

저장 파일의 내용과 실제 화면이 함께 바뀌었는지 확인한다.

이 단계 5분 · 선택 모듈 25분

따라 하기

1. MCP로 최종 수정본을 다시 읽어 검토 완료와 확인 완료를 확인한다. 원본은 검토 전과 검토 예정이 유지돼야 한다.

2. rhwp 웹 편집기에서 파일 열기로 output/rhwp-edited.hwpx를 새로 선택한다. 이미 열린 원본 화면은 자동 갱신되지 않는다.

3. 두 변경 문구와 표 모양을 비교한다. 웹에서 추가 편집했다면 HWPX로 다운로드한 파일을 다시 MCP로 읽어 확인한다.

Codex 채팅에 붙여넣기

hwp-mcp로 inbox/rhwp-practice.hwpx와 output/rhwp-edited.hwpx를 각각 다시 읽어 주세요. 원본의 검토 전·검토 예정이 유지되고 최종본에 검토 완료·확인 완료가 들어갔는지 대조하세요. 원본 SHA-256도 수정 전 기록과 비교할 수 있으면 확인하세요. 이어서 rhwp 웹 편집기에서 최종 수정본을 열어 볼 순서를 안내해 주세요. 브라우저에 열려 있는 원본이 자동으로 바뀌었다고 가정하지 마세요.

완료 기준

원본 보존과 최종본의 두 변경을 재읽기로 확인하고, 브라우저에서 최종본을 직접 열어 본문·표를 확인한다.

막히면

웹 화면에 옛 문구가 남아 있으면 현재 파일명을 확인하고 최종본을 다시 연다. 이미지 누락·줄바꿈·표 깨짐이 보이면 검증 미완료로 기록한다.

강사 진행 메모

완료물은 output/rhwp-edited.hwpx와 변경 확인이다. HTML 왕복변환·복잡한 표/서식 변경은 이 모듈 범위에 넣지 않는다.

Module 15practice

마지막 선택 실습 · K-Skill을 Codex에서 활용하기

선택 · 30분 · K-Skill의 공식 저장소와 스킬 원본을 확인하고 수업용 후보 하나를 고른다.

5 steps

Step 1

1. K-Skill에서 내 업무에 맞는 스킬 찾기

published

Step 1

1. K-Skill에서 내 업무에 맞는 스킬 찾기

선택 심화 · 5분 · 마지막 선택 실습 · K-Skill을 Codex에서 활용하기

목표

K-Skill의 공식 저장소와 스킬 원본을 확인하고 수업용 후보 하나를 고른다.

이 단계 5분 · 선택 모듈 30분

따라 하기

1. 공식 저장소 https://github.com/NomaDamas/k-skill 에서 기능 목록과 설치 안내를 확인한다. K-Skill은 외부 커뮤니티 스킬 모음이며 Codex 기본 내장 목록과 구분한다.

2. 수업 후보는 kosis-stats(공식 통계 조회)다. bok-ecos-stats, korean-law-search, gov-overseas-trip-report 등은 관심 후보로만 비교한다. 기능별 입력·도구·인증 조건은 원본에서 확인한다.

3. 기존 수업용 stat-brief는 받은 CSV의 분석·원고 작성, kosis-stats는 통계 검색·조회다. 스킬 설치만으로 모든 기관 자료 접근이나 정확한 해석이 보장되지는 않는다.

Codex 채팅에 붙여넣기

공식 저장소 https://github.com/NomaDamas/k-skill 의 README와 kosis-stats/SKILL.md, docs/features/kosis-stats.md를 읽어 주세요. kosis-stats와 현재 프로젝트의 stat-brief를 입력, 수행 범위, 도구, 산출물로 비교해 주세요. 아직 설치·명령 실행·파일 변경은 하지 마세요.

완료 기준

공식 저장소와 kosis-stats 원본을 찾고 조회와 분석의 역할을 구분했다.

막히면

네트워크로 원문을 읽을 수 없으면 다운로드 가이드와 기존 수업용 stat-brief를 비교하고 미확인 항목을 표시한다.

강사 진행 메모

수업은 kosis-stats 한 개로 진행한다. 변동되는 스킬 개수나 외부 서비스의 상시 이용을 확정하지 않는다. 실제 등록한 후보 이름을 원본 name과 대조한다.

첨부파일

K-Skill Codex 선택 설치·호출 가이드

마지막 선택30분. 원본 확인·프로젝트 설치·kosis-stats 호출·출처 검수 안내.

k-skill-codex-guide.md