create-map

create-map은(는) 무엇을 하나요?

학습자의 현재 위치에서 목표까지 가장 짧은 가르칠 수 있는 노드 경로를 구축합니다.

기반: Gagné의 학습 위계(1968), 인지 과제 분석(Clark et al. 2008; Tofel-Grehl & Feldon 2013), 4C/ID 전체 과제 순서(van Merriënboer & Kirschner 2018), 수정된 Bloom의 분류학(Anderson & Krathwohl 2001), 지식 공간 이론의 외부 프린지, 지식 구성 요소(Koedinger et al. 2012).

데이터베이스: 학습자의 프로젝트 루트(채팅이 시작된 폴더)에서 번들 스크립트를 실행합니다. 데이터는 ./.learn/learn.db에 저장됩니다. ${CLAUDE_SKILL_DIR}은 이 스킬의 폴더입니다. Claude Code가 자동으로 채워주며, 다른 에이전트는 이 SKILL.md가 포함된 폴더의 경로를 사용해야 합니다.

입력

• 명확히-me에서 확인된 목표
• 확인-me에서 나온 기준선 요약(고정 / 흔들림 / 아직 / 오개념)

절차

1. 루트. 목표를 전체 과제로 맨 위에 둡니다.

2. 역방향으로 분해. 목표에서 시작하여 각 새 노드에 대해 묻습니다: "학습자가 이것을 수행하려면 무엇을 이미 할 수 있어야 하는가?" 또한 사람들이 잊어버리는 전문가 질문을 하세요:

   • "전문가는 여기서 어떤 결정, 단서 및 확인을 사용하는가?"
   • "초보자는 여기서 흔히 어떤 오류를 범하는가?"

   숨겨진 결정을 노드로 바꾸거나 노드 제목에 포함시킵니다.

3. 분해 중단 확인-me에서 고정으로 표시된 항목에 도달하면 분기를 중단합니다. 고정된 항목을 지도에 넣지 마세요.

4. 각 노드 크기 조정. 노드는:

   • 하나의 명확한 능력을 가지며, "~할 수 있다 [동사] ..." 형태로 표시
   • 한 번의 짧은 수업(약 5~20분 대화)으로 가르칠 수 있음
   • 최대 3개의 결과물 필요, 그 이상이면 분할; 자체적으로 확인할 수 없으면 병합

5. 격차 포함. 흔들림 항목은 짧은 노드가 됩니다. 오개념은 자체 노드를 가지거나, 이를 수정하는 노드의 제목에 명시됩니다.

6. 순서 정렬. 모든 노드가 사전 조건 뒤에 오도록 정렬합니다. "작동 원리" 노드는 이를 의존하는 절차 바로 앞에 둡니다. 몇 개의 노드마다 이전 노드를 결합하는 작은 전체 과제 노드를 포함시켜 지도가 단순한 조각 모음이 되지 않도록 합니다. 마지막 노드는 목표 자체입니다.

7. 작게 유지: 약 5~15개 노드. 더 필요하면 목표가 너무 먼 것입니다. 명확히-me로 돌아가서 목표를 낮추세요.

8. 지도 표시 짧은 번호가 매겨진 경로로 표시한 후, "이 경로가 맞나요? 아니면 이미 알고 있거나 건너뛰고 싶은 것이 있나요?"라고 묻습니다. 한 번 조정합니다.

9. 저장 학습자가 동의한 후:

   python3 "${CLAUDE_SKILL_DIR}/scripts/db.py" new-map '{"goal": "<목표 설명>", "baseline": "<확인-me 요약>"}'
   

   그런 다음 모든 노드를 한 번의 호출로 추가합니다. key는 선택한 짧은 레이블이며, requires는 이번 호출에서 사전 조건 노드의 키(또는 기존 노드의 ID)를 나열합니다:

   python3 "${CLAUDE_SKILL_DIR}/scripts/db.py" add-nodes '{"map_id": 1, "nodes": [
     {"key": "a", "title": "~할 수 있다 ...", "requires": []},
     {"key": "b", "title": "~할 수 있다 ...", "requires": ["a"]}
   ]}'
   

   각 노드는 생성 날짜가 자동으로 할당됩니다. 인용 부호가 포함되어 이스케이프하기 어려운 경우 heredoc을 사용하여 JSON을 stdin으로 전달하세요.

나중에 지도 변경하기

가르치는 과정에서 누락된 사전 조건이 발견되면 add-nodes로 추가하고(해당되는 경우 기존 노드의 ID를 requires에 사용), 학습자에게 그 이유를 간략히 설명합니다.

함정

• 목표에 필요한 것이 아닌 교과서 순서를 따르는 것.
• 너무 큰 노드("미적분 배우기") 또는 너무 작은 노드(하나의 정의).
• 학습자가 이미 고정이라고 보여준 것을 다시 가르치는 것.
• 학습자를 압도하는 거대한 지도.