1

Wiki 3 3 Stage 1B Concept Refinement

kyeongmin edited this page 2026-04-01 16:16:50 +09:00

Table of Contents

• 목적
• 입력
• 처리 내용
• 출력
• 검증 포인트
• 현재 구현과 목표 구조
• 관련 코드
• 실패 시 처리

# Stage 1B Concept Refinement

목적

Stage 1A의 초안 구조를 실제 생성에 사용할 수 있도록 더 명확한 개념 단위로 정제한다.

이 stage 역시 현재 구현에서는 Kei API 의존이 크지만, 목표 구조에서는 사람이 검토 가능한 중간 산출물을 남기는 단계가 되어야 한다.

입력

• topic extraction 결과
• 정규화된 MDX
• Step 2의 Kei 기준 해석 결과

처리 내용

• concept를 더 명확히 정리한다.
• 핵심과 보조 메시지를 구분한다.
• relation과 expression_hint를 현실적으로 다듬는다.
• source_data를 보강한다.

출력

• refined concepts
• 정제된 relation 정보
• 정제된 expression_hint
• 보강된 source_data
• 후속 stage에서 읽을 수 있는 구조화 결과 파일

검증 포인트

• 핵심과 보조가 충분히 분리되었는가
• 생성 단계에 바로 넘길 수 있을 정도로 명확한가
• 원문 의미 보존 기준을 위반하지 않는가

현재 구현과 목표 구조

• 현재 구현: src/kei_client.py의 refine_concepts 호출 의존
• 목표 구조: Stage 1A 결과와 위키 기준을 바탕으로 refined concept를 문서와 산출물 파일로 직접 남김

관련 코드

• src/kei_client.py
• src/pipeline.py
• src/html_generator.py

실패 시 처리

• 정제 기준을 다시 세운다.
• 모호한 concept를 분할하거나 병합한다.
• 필요 시 Stage 1A 결과를 다시 검토한다.