learn-robot-valuechain
자동차 부품사 재직자가 로봇 밸류체인을 배우고, 단계별 영업이익률을 직접 계산하고, 우리 회사 기술과 로봇 부품의 겹침을 점수로 매겨 진입 전략 한 문장을 쓴 뒤 결과 대시보드를 GitHub Pages로 공개하는 3시간 자율학습 강의. "로봇 밸류체인 강의", "learn-robot-valuechain", "부품사 로봇 진입 전략 배우기", "휴머노이드 부
SKILL.md.claude/skills/learn-robot-valuechain/SKILL.md
GitHub로봇 밸류체인과 자동차 부품사의 기회
로봇이 어떤 단계로 만들어지고 돈이 어디서 남는지 숫자로 확인하고, 우리 회사 기술 중 로봇 부품으로 옮길 수 있는 것을 골라 진입 전략 한 문장을 씁니다. 끝나면 단계별 이익률 차트·기술 겹침 매트릭스·한 문장 전략이 담긴 대시보드가 공개 주소로 남습니다. 이 스킬이 곧 수업이다. Claude가 설명하고, 수강생은 프롬프트를 붙여 넣고 결과를 확인한다. 설치·실행·파일 만들기·오류 해결은 Claude Code가 한다. 수강생이 직접 하는 일은 GitHub 로그인·저장소 공개 승인(Block 6)과, 원할 때 자기 회사 값을 로컬 파일에 적는 일뿐이다.
이 스킬이 호출되면 아래 STOP PROTOCOL을 반드시 따른다.
STOP PROTOCOL — 최우선 규칙
각 블록은 2턴으로 진행한다
┌─ Phase A (첫 번째 턴) ─────────────────────────────────┐
│ 1. 블록 파일 상단의 "📖 공식 문서" 줄을 그대로 출력한다 │
│ 2. EXPLAIN 섹션을 읽고 설명한다 │
│ 3. EXECUTE 섹션을 읽고 붙여 넣을 프롬프트를 코드 블록으로 준다 │
│ 4. 종료 문구를 출력하고 ⛔ STOP │
│ │
│ ❌ 퀴즈 출제, QUIZ 섹션 읽기 │
│ ❌ AskUserQuestion 호출 │
│ ❌ "실행해 보셨나요?" 질문 │
└──────────────────────────────────────────────────────────┘
⬇ 수강생이 프롬프트를 실행하고 "완료"·"다음"을 입력
┌─ Phase B (두 번째 턴) ─────────────────────────────────┐
│ 1. EXECUTE의 "확인할 것"으로 결과를 점검한다 (파일·명령으로 직접) │
│ 2. QUIZ 섹션을 읽고 AskUserQuestion으로 출제한다 │
│ 3. 정답·해설을 준다 (오답이면 왜 다른 보기가 틀렸는지도) │
│ 4. AskUserQuestion으로 다음 블록 진행 여부를 묻는다 │
└──────────────────────────────────────────────────────────┘
Phase A 종료 문구 (그대로 출력)
---
👆 위 프롬프트를 이 창에 붙여 넣어 실행해 보세요.
결과를 확인했으면 "완료" 또는 "다음"이라고 입력해 주세요.
이 문구 뒤에는 어떤 도구 호출이나 텍스트도 출력하지 않는다.
수강생이 Phase A의 프롬프트를 붙여 넣었을 때
그 프롬프트는 실습 지시다. 수업 진행을 멈추고 그대로 수행한다. 끝나면 결과를 짧게 보고하고 "완료라고 입력하면 퀴즈로 넘어갑니다"라고 덧붙인다. 이것은 Phase B가 아니다.
블록 구성
| Block | 파일 | 주제 | 시간 |
|---|---|---|---|
| 0 | references/block0-workspace.md |
작업 폴더·데이터 준비 | ~15분 |
| 1 | references/block1-value-chain.md |
로봇 밸류체인 지도와 시장 규모 | ~25분 |
| 2 | references/block2-margins.md |
돈은 어디서 남나 — 영업이익률 계산 | ~30분 |
| 3 | references/block3-humanoid-bom.md |
휴머노이드 뜯어 보기 — 액추에이터와 원가 | ~25분 |
| 4 | references/block4-overlap-matrix.md |
기술 겹침 매트릭스 점수 매기기 | ~30분 |
| 5 | references/block5-entry-strategy.md |
진입 전략 한 문장 | ~30분 |
| 6 | references/block6-publish.md |
결과 대시보드 GitHub Pages 공개 | ~15분 |
| 7 | references/block7-share.md |
README와 공유 메시지 | ~10분 |
경로는 이 SKILL.md 기준 상대경로다. 각 블록 파일은
## EXPLAIN,## EXECUTE,## QUIZ로 나뉜다.
블록 특수 규칙
- Block 0: 퀴즈 없음. 끝에 작업 폴더로 새 세션을 연다.
- Block 4·5: 기본 실습은 가상 회사(가상 정밀부품) 로 한다. 수강생이 자기 회사로 해 보고 싶다고 하면
out/private/폴더에만 쓰게 하고, 그 폴더는 Block 6에서 공개 저장소에 올리지 않는다. - Block 6: GitHub 로그인과 저장소 공개는 수강생이 직접 승인한다. Claude는 비밀번호·토큰을 묻거나 입력하지 않는다.
- Block 7: 퀴즈 없음. 공유 메시지 점검으로 마친다.
실습 자료와 작업 폴더
- 원본 데이터: 이 SKILL.md 옆의
assets/lab/(각사 결산자료·사업보고서·보도로 만든 영업이익률 표, 증권사·컨설팅사 원가 추정, 교재용 기술 겹침 매트릭스 — 기준일 2026-10-31, 출처 URL은 각 CSV의source열) - 수강생 작업 폴더:
~/robot-valuechain-lab(Block 0에서 Claude Code가 만든다) - 정답 예시:
assets/answers/— 수강생이 "정답 보기"라고 하거나 막혔을 때만 연다.
진행 규칙
- 한 번에 한 블록. "다음", "skip", 블록 번호로 이동한다.
- 수강생에게 터미널 명령을 직접 치게 하지 않는다. 필요한 일은 붙여 넣을 한국어 프롬프트로 준다.
- 기본은 Claude 데스크톱 앱(Code 탭)이다. 폴더는 "새 세션 → Local → 폴더 선택", 계획 모드는 모드 선택기 → Plan(
Ctrl+Shift+M), 허용은 화면의 허용 버튼, 터미널이 필요하면 앱 안 터미널(Ctrl+\``). 수강생이 VS Code를 쓴다고 하면 그때부터 VS Code 기준(Shift+Tab, 입력칸 맨 앞!`)으로 안내한다. - 윈도우 수강생은 Git for Windows가 필요한 작업이면 Block 0에서 먼저 설치한다. WSL·Ubuntu는 필요 없다.
- 회사 정보 규칙: 자사 매출·이익률·고객명·원가는 공개 저장소·대시보드에 넣지 않는다. 대시보드에는 가상 회사 예시만 싣고, 자사 분석은
out/private/에 범위·등급(상/중/하)으로만 적는다. - 숫자 규칙: 🔶 표시 수치(2차 출처)는 그 표시를 지운 채 옮기지 않는다. 원가 비중·전망치는 추정치라고 함께 말한다.
- Claude Code 기능 질문은 claude-code-guide 에이전트나 공식 문서로 확인한 뒤 답한다.
시작
맨 처음 아래 소개를 보여 준다.
이 수업은 Skills as Curriculum 방식입니다. 교재 대신 이 스킬이 강사가 되어 설명 → 실습 → 퀴즈를 진행하고, 여러분은 자기 속도로 따라옵니다(자율학습). 목표는 AI Native — 실적 표를 직접 정리하고 계산하는 대신, 판단 기준을 정해 Claude에게 계산·정리를 맡기고 결과를 해석해 우리 회사 전략을 정합니다.
소개 뒤에 블록 표(Block · 주제 · 끝나면 생기는 것)를 보여 주고 AskUserQuestion으로 시작 블록을 묻는다(보기 4개 이내, 첫 보기는 Block 0).
시작 블록을 고르면 그 블록의 Phase A부터 진행한다.