Update wiki page 'Step 04'

2026-03-09 14:21:35 +09:00
parent 6c33b2feec
commit 161818d475

@@ -1,43 +1,26 @@
# Step 04. 블록 해체 및 분류 (Block Decomposition) # Step 04. 블록 해체 및 분류 (Block Decomposition)
## 1. 목적 (Objective) ## 1. 목적 (Objective)
파일 전체가 아닌 블록 단위로 해체하여 Judge-Standard 기준으로 각 블록의 성격을 판단한다. 하나의 파일에서 프롬프트, 도메인, 코드도메인, 제외가 동시에 나올 수 있다. 파일 전체가 아닌 블록 단위로 해체하여 Judge-Standard 기준으로 각 블록의 성격을 판단.
## 2. 판단 전 반드시 숙지 (Pre-requisites) ## 2. 파일 유형별 해체 방식 (Methodology)
분류 기준은 Judge-Standard 위키를 봰른다. 아래는 오판을 방지하기 위한 핵심 주의사항이다.
### 프롬프트 판단 시 주의
- .txt / .md 파일 전체가 프롬프트일 수 있다 → 파일 전체 내용을 읽고 판단한다.
- \"당신은 ~입니다\", \"You are ~\", \"Act as ~\" 로 시작하는 섹션 → 프롬프트 후보일 수 있으나, Judge-Standard 3요소(행동 지시, 가변 블록 포함)를 모두 충족하는지 반드시 추가 확인한다. 해당 문구만으로 프롬프트로 단정하지 않는다.
- API 호출 코드(openai.ChatCompletion.create(), client.chat.completions.create() 등)는 프롬프트가 아니다 → 제외.
- 한 줄짜리 인라인 f-string( \"다음을 번역해줘:\n{text}\")은 프롬프트가 아니다 → 제외.
- messages 리스트 내부의 content 값만 추출하여 판단한다.
### 도메인 판단 시 주의
- 도메인의 범위는 Judge-Standard를 따른다. 미리 한정하지 않는다.
- CSS/HTML/JS도 재사용 가능하면 도메인이다.
- .txt / .md 파일 안의 CSS 블록, HTML 구조, JS 함수도 도메인이 될 수 있다.
### 코드도메인 판단 시 주의
- Python def / class 단위로 독립 완결되는 것만 해당한다.
- 경로 설정, API 키, import 문만 있는 블록은 제외.
- if __name__ == \"__main__\" 블록은 제외.
## 3. 파일 유형별 해체 방식 (Extraction Methodology)
### .txt / .md 파일 ### .txt / .md 파일
- 파일 전체 내용을 읽고, 섹션(##) 단위로 분리하여 각각 판단한다. - 전체 내용을 읽고 섹션(##) 단위로 분리하여 개별 판단.
- 파일 안에 CSS/HTML/JS 블록이 섞여있으면 해당 블록도 별도 추출한다. - CSS/HTML/JS 블록이 섞여있으면 별도 추출.
### .py 파일 ### .py 파일
- 멀티라인 문자열 변수(\"\"\"...\"\"\") 및 PROMPT_, SYSTEM_, system_prompt 등 관련 변수값 추출. - 멀티라인 문자열 변수(\"\"\"...\"\"\") 및 PROMPT_ 등 관련 변수값 추출.
- def / class 단위로 분리하여 코드도메인 여부 판단. - def/class 단위로 분리하여 코드도메인 여부 판단.
### .json / .yaml 파일 ### .json / .yaml 파일
- system, prompt, messages 키의 값을 프롬프트 후보로 추출. - system, prompt, messages 키의 값을 프롬프트 후보로 추출.
## 4. [보완: 정확도 9 원칙] ## 3. 판단 시 주의사항 (Precautions)
- **의도 지향 분석**: 말투가 아닌 '수혜자'가 누구인지 분석하여 기사/예절 등은 즉시 Exclude 처리. - AI 지시멸 여부: Judge-Standard 3요소(행동 지시, 가변 블록 등) 충족 확인.
- **분류 근거 제시**: 모든 분류 결과에 대해 Standard 대조표 작성을 의무화함. - 제외 대상: API 호출 코드, 한 줄짜리 인라인 문자열 등은 제외.
## 4. 결과 및 분기 (Success/Failure)
- **성공 시**: 분류 근거가 담긴 [표준 대조표] 작성 후 이슈 #46에 승인 요청.
- **실패 시**: 오판 발견 시 즉시 분류 로직 수정 후 Step 04 재실행.
## 5. 통과 기준 (Success Criteria) ## 5. 통과 기준 (Success Criteria)
- 파일 전체 복사 0건 (반드시 블록 단위 추출). - 파일 전체 복사 0건 (반드시 블록 추출).
- API 호출 코드 및 인라인 문자열 혼입 0건. - API 코드 등 불필요 데이터 혼입 0건.
- .txt / .md 파일 내 실제 프롬프트 누락 0건.