Update wiki page 'Step 06'
73
Step-06.md
73
Step-06.md
@@ -1,63 +1,10 @@
|
|||||||
# Step 06. 정제 (Clean Assignment)
|
# Step 06. 수술적 정제 (Surgical Purification)
|
||||||
|
## 1. 목적 (Objective)
|
||||||
## 목적
|
한 파일 내에 혼재된 지시문(Prompt)과 데이터(Domain)를 물리적으로 분리하여 로직의 자산화 달성.
|
||||||
분류된 블록에서 불순물을 제거하여 실제로 사용 가능한 순수 재료로 정제한다.
|
## 2. 수행방법 (Methodology)
|
||||||
|
- Surgical Splitting: 파일 내의 방대한 데이터 덩어리(JSON 리스트, 긴 텍스트 등)를 적출하여 별도 Domain 파일로 생성.
|
||||||
## 실행
|
- 지시문 파일에는 오직 가이드라인과 참조 링크({{Domain: ...}})만 남김.
|
||||||
|
## 3. 주의사항 (Precautions)
|
||||||
### 프롬프트 정제
|
- 원본의 의도는 100% 보존하되, 물리적인 객체 분리에 집중할 것.
|
||||||
1. 코드 블록(def, class, const, import, API 호출 등) 완전 제거
|
## 4. 통과 기준 (Success Criteria)
|
||||||
2. 자연어 지시문만 남긴다
|
- 모든 Prompt 파일 내에서 데이터가 차지하는 비중이 10% 미만일 것.
|
||||||
3. 원래 파일이 .txt/.md인 경우 CSS/HTML/JS 블록은 별도 도메인 파일로 분리한다
|
|
||||||
4. 정제 후 실제로 AI에 입력했을 때 의도한 동작이 나오는지 가상 실행으로 확인한다
|
|
||||||
|
|
||||||
### 도메인 정제
|
|
||||||
1. 원본 내용 그대로 보존한다
|
|
||||||
2. 프롬프트 지시문이 섞인 경우 해당 부분만 제거한다
|
|
||||||
3. 코드 주석 중 내용 이해에 필요한 것은 보존한다
|
|
||||||
4. 단순 import문, 경로 설정은 제거한다
|
|
||||||
|
|
||||||
### 코드도메인 정제
|
|
||||||
1. def / class 단위로 독립 완결되도록 정리한다
|
|
||||||
2. 필요한 import문은 함수 상단에 포함시킨다
|
|
||||||
3. if __name__ == "__main__" 블록 제거
|
|
||||||
4. API 키, 경로 설정 변수 제거
|
|
||||||
5. 함수 단독으로 복사해서 다른 프로젝트에 붙여넣어도 동작해야 한다
|
|
||||||
|
|
||||||
## 통과 기준
|
|
||||||
- 프롬프트 파일 내 코드 블록 0개
|
|
||||||
- 도메인 파일 내 프롬프트 지시문 혼입 0건
|
|
||||||
- 코드도메인 파일 단독 동작 가능 여부 확인 완료
|
|
||||||
|
|
||||||
## 다음 단계
|
|
||||||
- 통과 → Step-07로 이동
|
|
||||||
- 정제 실패 항목 → _검토필요로 격리 후 계속
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 진행현황 이슈 코멘트 템플릿
|
|
||||||
```
|
|
||||||
### [Step-06] 정제 - YYYY-MM-DD
|
|
||||||
|
|
||||||
[완료] 정제 완료 프롬프트 수:
|
|
||||||
[완료] 정제 완료 도메인 수:
|
|
||||||
[완료] 정제 완료 코드도메인 수:
|
|
||||||
[격리] 정제 실패 → _검토필요 이동 항목:
|
|
||||||
[MANUAL: Review Required] 판단 불가 항목:
|
|
||||||
|
|
||||||
→ 결과: 통과 / 재실행
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Gitea 등록 (MCP 호출)
|
|
||||||
1. "진행현황" 이슈 번호 확인
|
|
||||||
2. 코멘트 템플릿을 채운다
|
|
||||||
3. create_issue_comment 호출
|
|
||||||
|
|
||||||
문제 발생 시:
|
|
||||||
1. create_issue 호출 → 제목: [Step-06] 문제 요약
|
|
||||||
2. 해당 이슈에 create_issue_comment 3회 호출
|
|
||||||
- 코멘트 1: 원인 분석
|
|
||||||
- 코멘트 2: 변경 대상 및 이유
|
|
||||||
- 코멘트 3: 해결 방향 및 임시 조치
|
|
||||||
Reference in New Issue
Block a user