확장 이력서 → 행동 답변 뱅크은(는) 무엇을 하나요?
컴퓨터에 이미 있는 노트와 문서를 다음으로 변환합니다:
extended-resume.md: 수행한 작업, 결정, 고려 사항, 배운 점, 들은 피드백에 대한 깊이 있고 출처가 명시된 기록answers.md: 주요 행동 인터뷰 질문에 대한 답변, 모든 주장이 출처로 추적 가능
일반 이력서는 결과만 남기고 추론 과정은 생략합니다. 면접관은 추론 과정("다른 대안은 무엇을 고려했습니까?", "무엇을 다르게 하시겠습니까?")을 파고들며, 그 추론 과정은 보통 오래된 설계 문서, 회고, 1:1 노트, 자기 평가에 남아 있습니다. 이 스킬은 그 내용을 찾아내어 답변이 일반적이지 않고 구체적이며 진실되게 만듭니다.
SKILL_DIR은 이 파일이 포함된 폴더를 의미합니다. 모든 스크립트는 Python 3.8+이며 표준 라이브러리만 사용합니다. python3 SKILL_DIR/scripts/<name>.py 형식으로 실행합니다. 모든 것은 로컬에서 실행되며 네트워크를 사용하는 스크립트는 없습니다.
기본 규칙
- AI는 사용자의 원본 파일을 절대 열지 않습니다. 승인 전후 모두, 절대 열지 않습니다. 오직 스킬의 스크립트만 원본 파일을 읽으며,
extract.py는 사용자가 승인한 항목만 읽습니다. AI는 범위 지정 시 메타데이터 요약본을 읽고, 추출된 텍스트(OUT/.work/text/폴더, 배치 목록을 통해) 이후에 읽습니다. 소스 폴더나 노트 앱 데이터베이스 내부의 어떤 것도 (의심이 들더라도)cat,grep,head,open,preview하지 않습니다. 의심스러운 것은ASK로 표시합니다. 이것이 사용자가 신뢰하는 약속입니다. - 사용자는 어떤 파일을 읽을지 승인한 후에야 읽습니다. 무엇이 포함되고 제외되며 사용자의 결정이 필요한지 보여주고, 변경 사항을 적용한 후 사용자가 승인했을 때만 진행을 확정합니다.
- 경험을 절대 지어내지 않습니다. 이력서와 답변의 모든 사실은 증거 카드 또는 사용자 직접 전달에서 비롯됩니다. 누락된 숫자는
[ADD METRIC: latency before/after]와 같은 눈에 띄는 자리 표시자가 됩니다. 인터뷰에서 지어낸 지표는 공백보다 훨씬 나쁩니다. 면접관은 숫자를 집중적으로 파고들기 때문입니다. - 소유자의 경험만 포함됩니다. 다른 사람의 이력서, 저장된 기사, 팀원의 문서는 해당 사용자의 이야기가 아닙니다.
- 다른 사람을 보호합니다. 동료는 역할로만 언급하고 이름은 절대 사용하지 않습니다. 답변에서 기밀 정보(출시되지 않은 제품, 고객 이름)는 일반화합니다.
- 사용자 전용 파일은 읽지 않습니다.
hidden-by-safety.md와quarantine.md에는 사용자에게 민감한 파일 이름이 나열됩니다. AI는 스크립트가 출력하는 개수만 확인하면 됩니다.
출력 폴더
기본값 OUT = ~/extended-resume/ (다른 위치를 원하는지 물어보세요. git 저장소나 소스 폴더 내부는 절대 안 됩니다). 샌드박스에서 해당 위치에 쓸 수 없으면 사용자에게 쓰기 승인을 요청하거나 쓸 수 있는 폴더를 선택하도록 하세요. 기본값이 아닌 경우 모든 스크립트에 --out OUT을 전달하세요.
| 경로 | 설명 |
|---|---|
extended-resume.md | 심층 이력서 |
answers.md | 답변 뱅크 |
scope.md | 읽을 파일 목록 (사용자가 선택/해제 가능) |
custom-questions.md | 사용자가 추가한 질문, 실행 간 유지 |
user-notes.md | 사용자가 직접 말한 사실 (출처로 간주) |
sources.selected.json | 활성화된 소스 |
hidden-by-safety.md, quarantine.md | 사용자 전용 |
.work/ | 카탈로그, 결정, 추출된 텍스트, 증거. 사용자 문서의 추출 텍스트를 보관하며, 마지막에 삭제할지 제안 |
모드 선택
먼저 OUT 폴더를 확인하세요.
extended-resume.md가 없음 → 전체 빌드 (1~9단계).- 파일이 있고 사용자가 새로고침을 원함 → 업데이트:
scope.py catalog --refresh,scope.py digest --only-undecided, 새 폴더만 결정, 검토, 확정,extract.py --only-new, 새 배치만 마이닝, 병합, 이력서 및 영향받는 답변 수정. - 사용자가 더 많은 질문에 대한 답변만 원함 → 질문 추가 (새 질문에 대해서만 7~8단계 진행, 스캔 없음).
- 로컬 파일이 없음 (예: 채팅 앱에 업로드된 zip 파일): 폴더에 압축 풀고
sources.py select --add-folder PATH로 해당 폴더를 추가한 후 전체 빌드를 실행합니다. 이 설정에서는 보호 후크가 없지만 기본 규칙 1은 여전히 적용됩니다.
1단계: 소스 및 동의 (한 메시지)
python3 SKILL_DIR/scripts/sources.py detect
이 명령은 스킬이 알고 있는 위치의 번호가 매겨진 메뉴를 개수와 함께 출력합니다. 이름과 개수 외에는 아무것도 읽지 않습니다.
- 기본 활성화: Documents, Desktop, Downloads (모두 엄격: 경력 자료라는 확실한 증거가 있을 때만 파일을 읽음), Obsidian 볼트 (Obsidian 자체 볼트 목록에서), Logseq 그래프,
~/Notes. - 활성화할 때까지 꺼짐: Apple Notes (macOS가 권한 요청, 특정 폴더로 제한 가능), Notion 데스크탑 캐시, OneNote (Windows 데스크탑 앱), Bear, Joplin, iCloud Drive, 각 클라우드 드라이브 및 커넥터.
- Notion / Google Drive / Microsoft 365 커넥터 도구를 사용할 수 있다면 선택적 소스로 언급하세요.
- NO PERMISSION으로 표시된 소스는 macOS가 차단하고 있음을 의미합니다 (비어 있지 않음). macOS에서는 스크립트를 실행하는 앱에 접근 권한이 속합니다. Claude Code의 경우 사용자는 시스템 설정 > 개인정보 보호 및 보안 > 파일 및 폴더에서 claude 항목 (소문자, 명령줄 도구) 아래에서 폴더를 켜야 합니다 (Claude.app 아님). 그런 다음
detect를 다시 실행하세요.
한 메시지에 메뉴를 표시하고 사용자에게 다음을 요청하세요:
- 어떤 소스를 켤지 확인 또는 변경
- 문서에 나타나는 이름 확인 (힌트에서 미리 채움) 및 다른 철자
- 선택적으로 고용주와 대략적인 날짜 (
Acme Corp|2021-04|2023-11): 범위 지정을 크게 개선함 - 선택적으로 목표 역할 또는 직무 설명, 그리고 제외할 사항
다음에 일어날 일을 명확히 알려주세요: "먼저 이름, 폴더, 날짜 및 문서 속성(작성자, 제목, 회사)을 나열하고 내용은 절대 나열하지 않습니다. 정확히 어떤 파일이 범위에 포함될지 검토하고 변경할 수 있습니다. 승인 후에만 로컬 스크립트가 해당 파일을 읽고 은행, 신분증, 의료 또는 비밀번호 문서처럼 보이는 것을 걸러내고 비밀 정보를 제거합니다. AI는 그 정리된 텍스트만 봅니다."
또한 읽기 전(4단계)에 읽기 가드를 설치할 것이라고 알리세요: AI가 소스 폴더에 접근하지 못하도록 사전 도구 사용 훅을 설치합니다. 이는 에이전트의 사용자 설정을 편집하며 (백업이 유지됨) 9단계에서 제거됩니다. 선택 사항이 아닙니다. 사용자가 설정 변경을 원하지 않으면 범위 검토 후 빌드가 중단됩니다.
사용자의 선택을 저장하세요:
python3 SKILL_DIR/scripts/sources.py select --owner "Sam Okafor" --alias "Sam O" \
--employer "Acme Corp|2021-04|present" "Tidewater Health|2019-01|2021-03" \
--enable 7 --disable 3 [--add-folder ~/Work/notes] [--apple-notes-folders "Work,1:1s"]
사용자가 "그냥 실행하세요"라고 말하면 기본값을 유지하고, 그것을 명시한 후 2~3단계를 수행하세요 (검토는 건너뛸 수 없음).
2단계: 범위 제안 (메타데이터만)
python3 SKILL_DIR/scripts/scope.py catalog
python3 SKILL_DIR/scripts/scope.py digest
catalog는 이름, 날짜, 문서 속성 및 다운로드 출처와 함께 항목을 나열하며 내용은 절대 나열하지 않습니다. 또한 자격 증명/키 파일과 암호화된 파일을 즉시 제외합니다. digest는 폴더 요약을 .work/scope/digest/part-NNN.md에 씁니다.
**references/scoping-guide.md**를 읽고 모든 폴더 카드를 판단하세요: IN-ALL, OUT-ALL (카테고리 포함), ASK-ALL 또는 MIXED. MIXED 폴더의 경우 scope.py files F-xxxxxxxx ...를 실행하고 각 항목을 IN / OUT / ASK로 결정하세요. 결정 사항을 .work/scope/decisions/part-NNN.jsonl (다이제스트 파트당 하나의 파일)에 JSON 라인으로 작성하세요. 파트가 많고 병렬 워커 또는 하위 에이전트를 실행할 수 있다면 각 워커에게 하나의 파트와 스코핑 가이드를 제공하고 해당 파트의 결정 파일을 작성하게 하세요.
엄격한 소스의 경우 IN에는 긍정적인 증거가 필요합니다. 불확실한 것은 ASK입니다. 그런 다음:
python3 SKILL_DIR/scripts/scope.py status # 검토되지 않은 항목이 없습니까?
python3 SKILL_DIR/scripts/scope.py render # OUT/scope.md를 쓰고 짧은 요약 출력
3단계: 검토 루프 (승인될 때까지 반복)
출력된 요약 (소스별 개수, 가장 큰 범위 내 폴더, "사용자 결정 필요" 목록 (폴더별 그룹화), 제외 이유별 개수)을 보여주고 OUT/scope.md를 가리키며 사용자가 선택/해제할 수 있도록 안내하세요.
사용자의 말을 적용하세요:
python3 SKILL_DIR/scripts/scope.py set --exclude "~/Documents/Personal"
python3 SKILL_DIR/scripts/scope.py set --include F-1a2b3c4d f-0123456789ab
python3 SKILL_DIR/scripts/scope.py set --include-ask "folder:Work" # 해당 폴더의 모든 "사용자 결정 필요" 항목
python3 SKILL_DIR/scripts/scope.py set --before 2018-01-01 # 더 오래된 항목 제외
python3 SKILL_DIR/scripts/scope.py apply-md # 체크박스 편집 적용
python3 SKILL_DIR/scripts/sources.py select --add-folder ~/Work/notes && python3 SKILL_DIR/scripts/scope.py catalog
그런 다음 scope.py render를 다시 실행하고 새 요약을 보여주세요. 사용자가 명시적으로 승인할 때까지 계속하세요. 미결정 항목은 읽히지 않습니다. 그 사실을 알리세요.
그런 다음에만:
python3 SKILL_DIR/scripts/scope.py freeze --approved
4단계: 읽기 및 마이닝
매번 읽기 가드를 먼저 설치하세요. extract.py를 실행하거나 추출된 텍스트를 읽기 전에 절대 하지 마세요:
python3 SKILL_DIR/scripts/guard.py install --claude # Claude Code
python3 SKILL_DIR/scripts/guard.py install --codex # Codex (그런 다음 Codex에서 /hooks를 입력하고 신뢰)
python3 SKILL_DIR/scripts/guard.py install --claude --dry-run # 변경을 적용하지 않고 보여주기
설치되었음을 사용자에게 알리세요. 설치에 실패하거나 실행 중인 에이전트에 훅 지원이 없는 경우 (--claude/--codex가 적합하지 않음) 중단하고 사용자에게 알리세요. 사용자가 문제를 해결하거나 가드 없이 진행하도록 명시적으로 말할 때까지 추출하지 마세요. 유일한 예외는 보호할 원본 파일이 없는 위의 로컬 파일 없음 설정입니다.
python3 SKILL_DIR/scripts/extract.py
이 스크립트는 확정된 목록만 읽고, 승인 이후 변경된 파일은 거부하며, 은행/세금/급여, 신분증, 의료, 법률 또는 비밀번호 문서처럼 보이는 것은 격리합니다 (사용자는 quarantine.md에서 확인, AI는 개수 확인), 키, 토큰, 신분증 및 카드 번호, 이메일 및 전화번호를 삭제하고, .work/text/*.txt, .work/batches/*.txt 및 .work/extract_summary.md를 씁니다. 사용자가 격리된 항목이 오탐지라고 말하면 --allow ITEM_ID로 다시 실행하세요.
그런 다음 **references/mining-guide.md**를 사용하여 증거를 마이닝합니다:
- 스켈레톤 먼저: 가장 최근 이력서의 텍스트(
extract_summary.md에 표시됨)를 읽고 역할 카드를.work/evidence/batch-000.jsonl에 씁니다. - 배치: 각 배치 파일에 대해 나열된 텍스트 파일을 읽고
.work/evidence/<batch name>.jsonl을 씁니다. 병렬 워커를 사용하는 경우 각 워커에게 배치, 마이닝 가이드, 소유자 이름 및 스켈레톤 역할을 제공하고 개수만 응답하도록 요청하세요. 그렇지 않으면 배치별로 진행하고 각 배치의 카드를 다음 배치를 읽기 전에 써서 원시 텍스트가 쌓이지 않도록 하세요. 매우 큰 코퍼스의 경우 이후 (순위가 낮은) 배치가 새로운 이야기를 생성하지 않으면 중단하고 중단한 위치를 알리세요. python3 SKILL_DIR/scripts/evidence_tool.py merge→.work/evidence.jsonl및.work/evidence_index.md(커버리지 테이블 및 갭 포함). 보고된 잘못된 라인을 수정하고 다시 병합하세요.
5단계: 확장 이력서 작성
**references/extended-resume-template.md**를 따르세요. evidence_index.md에서 작업하고 evidence_tool.py show E-xxxxxx 또는 --type decision으로 전체 카드를 가져오세요. 결정 로그를 풍부하게 유지하고, Open questions 아래에 상충되는 사실을 기록하며, 추론된 항목을 표시하세요.
6단계: 갭 확인 (권장, 건너뛸 수 있음)
인덱스의 Gaps 섹션과 커버리지 테이블에서 한 메시지에 최대 ~7개의 짧은 질문을 사용자에게 하세요: 주요 프로젝트의 누락된 결과, 불분명한 개인 역할, 누락된 스토리 유형 (갈등이나 실패를 찾지 못함), 그리고 이직하려는 실제 이유. 답변을 날짜와 함께 OUT/user-notes.md에 추가하고, .work/evidence/user-notes.jsonl에 "item": "user-notes"로 카드를 추가한 후 다시 병합하세요. 건너뛰면 자리 표시자를 유지하세요.
7단계: 질문
python3 SKILL_DIR/scripts/questions.py list
내장 뱅크에는 30개의 일반적으로 묻는 프롬프트에서 중복을 제거한 23개의 질문이 있으며, 회사별 질문 (예: "왜 Google에서 일하고 싶습니까?")은 제거되었습니다. 각 질문이 평가하는 항목과 찾아야 할 증거는 assets/question_bank.json을 참조하세요.
질문을 추가하려면 (하나, 여러 개, 또는 지저분하게 붙여넣은 목록):
python3 SKILL_DIR/scripts/questions.py add "Tell me about a time you mentored someone."
python3 SKILL_DIR/scripts/questions.py add --from-file pasted.txt
python3 SKILL_DIR/scripts/questions.py add "How do you handle disagreement with a peer?" --variant-of conflict
python3 SKILL_DIR/scripts/questions.py skip why-not-hire
스크립트는 중복, 가능한 중복 및 회사별 표현을 플래그합니다. 모든 동일한 의미의 중복 ("동료와 의견 충돌" vs "동료와 갈등")을 잡을 수는 없으므로 새 질문을 목록과 직접 비교하고, 내장 질문과 동일한 답변을 받을 질문이라면 --variant-of로 다시 추가하세요. 회사별 질문은 사용자가 원할 경우 괜찮습니다: 그 회사에 끌리는 이유를 묻고 실제 경험을 연결하여 답변하며, 회사에 대한 사실을 절대 지어내지 마세요.
8단계: 스토리 맵, 그런 다음 답변
**references/answer-guide.md**를 따르세요: 스토리 맵을 구축하고 (8~14개의 스토리, 각 스토리는 최대 3개의 질문에 주로 사용됨), 그런 다음 거기에 제공된 형식으로 OUT/answers.md를 작성하세요. 후속 질문, 백업 스토리, 출처 및 모든 질문에 대한 "사용 전 확인" 목록을 포함하세요. 질문 추가 모드에서는 새 답변을 추가하고 스토리 맵을 업데이트하며 다른 것은 다시 작성하지 마세요.
마치기 전에 답변 가이드의 자체 점검을 실행하세요: 모든 숫자는 증거 또는 user-notes.md로 추적 가능하고, 이름이 없으며, 모든 자리 표시자가 "먼저 채우기" 아래에 나열되어 있는지 확인하세요.
9단계: 마무리
python3 SKILL_DIR/scripts/audit.py # AI 도구 호출이 원본 파일을 건드렸습니까?
python3 SKILL_DIR/scripts/guard.py uninstall --claude # 또는 --codex: 4단계에서 설치한 가드를 항상 제거
사용자에게 파일 위치, 사용된 소스, 카드 및 스토리 수, 그리고 다음 단계를 알리세요. 사용자가 .work/ 폴더를 삭제할지 묻고, 스킬을 다시 실행할 수 있음을 알리세요. 남겨진 미해결 질문이 있다면 언급하세요.
자산 및 참조
SKILL_DIR/assets/question_bank.json— 내장 질문SKILL_DIR/references/scoping-guide.md— 범위 결정 규칙SKILL_DIR/references/mining-guide.md— 증거 추출 규칙SKILL_DIR/references/extended-resume-template.md— 심층 이력서 형식SKILL_DIR/references/answer-guide.md— 답변 작성 규칙