Repository navigation
Releases
v2.9.1 — 배제 논문 시트 처리 버그 패치 + 코드6 과거지표
2026-06-15 회의 결정 반영 (패치). 열 구조 불변(48열), sample_v2.8.xlsx 유지.
수정 (버그 패치)
- 배제(exclude=Y) 논문 아웃컴·한의중재_한약 시트 자동 삭제 (Decision Log §9.7): 배제 논문은 기본정보 행만 보존하고 두 시트는 보존하지 않도록 교정. 최근 업그레이드 이후 배제 논문에도 두 시트가 남던 회귀 수정.
- cpg-data-extraction v2.9.1: 핵심원칙14 + §2A J열 명문화
- merge-skill v2.7.1: 머지 시 exclude=Y 논문의 두 시트 행 제거
- upgrade-skill v1.5: 기존 마스터 배제 논문 두 시트 소급 삭제(v2.9.1_changes.md, LATEST 2.9.1)
변경 (회의 결정)
- comorbidity_code 6(고혈전 색전) 과거 평가지표 인정 (§1.U-04): 과거 CHADS2 등도 발표 당시 기준 점수(예: ≥2점) 충족 시 코드 6 부여, 지표명·점수는 V열 보존.
- 중복 논문 2케이스 처리 (§1.0-10): 완전 동일은 하나만 추출·나머지 삭제 / 번호만 다르면 후순위 exclude=Y(카운트는 study_id 기준).
v2.9 — TER 4종 통일·냉동소작 코드8 + SKILL 경량화
2026-06-08 회의 결정 반영 + SKILL 문서 경량화. 열 구조 변경 없음(48열 유지).
회의 결정
- TER(총유효율) 4종 통일 (§2.C-10): outcome_std를
TER(판정기준 불명)·TER-Holter(动态心电图)·TER-ECG(체표 心电图)·TER-TCM(中医证候) 4종으로 정리, 전부 importance=Important. 기준 불명확 시 단순TER. 한 논문에 TER 2건 이상이면 각각 추출(D열 원문 보존)하되 메타분석 합산 시 한 연구 중복 투입 방지. - comorbidity_code 8(냉동소작/cryoablation) 신설 (§1.U-03): 冷冻球囊导管消融 등 RF가 아닌 카테터소작은 RFCA(코드 1)와 별개 코드 8, 시술명 원문 V열 보존.
문서 경량화 (규칙 불변 — 독립 verifier PASS)
- frontmatter changelog 제거(→ CHANGELOG 참조), 인라인 버전태그 31곳 제거(설명문 보존), 한약 §3A 중복을
references/korean-medicine-intervention.md로 단일화, lost-update 중복 통합, v2.2 폐지열 메모 삭제. SKILL.md 622→592줄.
동반
- upgrade-skill v1.4:
v2.9_changes.md신설(TER 4종 재코딩·importance 일괄 Important·냉동소작 코드 8 검출),LATEST_VERSION→ 2.9. 작업자는 "업그레이드 해줘"로 기존 마스터 소급 반영. - README·CHANGELOG·매뉴얼 v2.9 동기화. sample 구조 불변(
sample_v2.8.xlsx유지), MIGRATION_NOTICE 생략.
미반영 (작업자 결정 — 스킬 미반영, 규칙은 Decision Log·선정배제 기준에 존재)
- 베이스라인 누락→최종값만 / 치료기간 미명시 NR / 측정시점 해석 / 추적 중 MACE 이분형 / 무작위+후향적→non-RCT (수동 적용).
v2.8.1 — 6C 채팅 출력 RoB 근거(AJ~AT 11열) 블록 누락 버그 수정
버그 수정(회의 결정 무관). 6C 출력 구조에 RoB 근거 블록 신설(불확실·NR→⑥), 매뉴얼 동기화. 추출 규칙·열 구조·코드값 변경 없음(48열). (태그 v2.8.1에서 후행 생성한 Release)
v2.8 — SF-36 통일명·Study ID a/b·다군 1쌍·양약 용량차 제외
2026-06-01 회의 결정 반영. 열 구조 변경 없음(48열 유지) — 값·명명·선정 규칙 보강 + 소급 재분류.
cpg-data-extraction v2.8
- QoL SF-36 통일명
QOL(SF-36 cited)— 표준(PCS·MCS 각 100점 환산)만 메타분석 MD, 800점 만점 등 비표준은 별도 분리 후 SMD; 점수체계는 notes 기재 (미네소타QOL(Minnesota cited)선례와 평행). - Study ID 중복 a/b 접미사 — 추출 시 임시
_a/_b, 마스터 머지 시 merge-skill가 논문 번호 순서대로 a부터 재부여. - 다군(3·4·5arm) 가장 적합한 1쌍만 — 양약을 가장 많이 쓴 군을 대조군으로(보수적).
- 양약 종류·용량차 제외 —
KM+WM_vs_WM라도 양군 양약 종류가 다르거나(항응고제 종류 상이 등) 종류 같고 용량만 다르면 제외 (§1.AD-01 보류→확정, 2032 등 소급). - RCT 표현 충돌 우선순위 — 무작위 표현과 순서 배정 표현이 동시에 있으면 순서 배정 우선 → non-RCT(제외).
동반 스킬
- upgrade-skill v1.3 —
v2.7_changes.md(따라잡기) +v2.8_changes.md신설,LATEST_VERSION→ 2.8."업그레이드 해줘"한 마디로 마스터 소급 적용. - merge-skill v2.7 — study_id 번호순 a/b 재부여 + 중복 두 경우(같은 번호=overwrite / 다른 번호=a/b) 구분.
매뉴얼 v2.8 · sample_v2.8.xlsx 포함.
v2.7 — comorbidity 코드7(노인)·코드2(심부전) 명문화 + M열 NR + Median/IQR 제외 + 한약 다중처방 + KM+WM_vs_KM 제외
2026-05-27 회의 결정 반영. 열 구조 v2.6 이후 동일(48열). 동반 upgrade-skill v1.3·merge-skill v2.7. (태그 v2.7에서 후행 생성한 Release)
v2.6.1 — 추출 규칙 보강 + upgrade-skill 신설
핵심 변경 (2026-05-19·05-20 회의 합의 반영)
1. 추출 규칙 보강
- 논문 선정 기준 명문화 — KM vs WM 단독비교 제외 (표준치료 add-on 연구만 대상), 3arm은 해당 2arm만 추출. KM·WM·KM+WM 3군은 WM vs KM+WM만 추출
- S열
af_type_other코드 5 케이스 세분화 — (RVR 명시 ∧ HR≥110) ∨ (RVR 미언급 ∧ HR≥110 명시)만 코드 5. 그 외는 T열에 원문 표현만 기록 - T열
af_type_text자유 텍스트 규칙 신설 — paroxysmal/persistent/RVR/permanent 등 AF 유형 원문 표현 보존 - AN/AU 분석집단 보수적 판정 — method에 명시된 것만 인정, 결과 표 분모로 추정 금지. FAS 정식 코드 추가 (analysis_set: ITT/PP/FAS/NR 4종)
- QoL 미네소타 통일 명칭 =
QOL(Minnesota cited)— 점수 방향이 표준 MLHFQ와 모순되는 케이스에 적용 - 6B 모호 케이스 체크리스트 확장 (T열·Z열·AN/AU)
2. upgrade-skill v1.2 신설
- 단일 트리거
"업그레이드 해줘"로 마스터 자동 업그레이드 _meta시트 도입 (spec_version,last_upgrade,last_actor)- 8단계 인터랙티브 처치 모드 — 사람 확인 항목을 채팅창에서 카테고리별로 표시, 작업자 응답대로 마스터 즉시 수정 (6B 추출 출력과 동일 UX)
- 기존
schema_version키 자동 마이그레이션 →spec_version(하위 호환 1단계)
3. 열 구조
- v2.6과 동일 (48열). v2.6.1은 의미·기재 규칙 보강만
작업자 업그레이드 절차
MIGRATION_NOTICE_v2.6.1.md 참조. 핵심은 "업그레이드 해줘" 한 마디로 셀프 처리.
호환성
- v2.6 마스터 → v2.6.1:
_meta키 마이그 + spec_version 갱신만 자동. 나머지 v2.6.1 사람 확인 항목은 8단계 인터랙티브로 작업자 응답 받음 - v2.5.x 마스터 → v2.6.1: 47→48열 마이그 + v2.6 소급 + v2.6.1 보강 순차 적용
- merge-skill 본체 알고리즘 변경 없음
v2.6 — study_design 개정 + analysis_set 신열 + AF/RVR 엄격화 + HRV 제외 + SAE 통합
연구팀 회의(2026-05-18) 결정사항 6건을 단일 릴리스로 통합. 마이너 수정 누적이 임계 도달하여 v2.5.x 라인을 닫고 v2.6으로 마이너 메이저 bump.
주요 변경
1) study_design (N열) 분류 기준 개정
随机/随机分为/randomized표현만 있어도 RCT로 분류 (배정 방법의 적절성은 RoB 2.0 Domain 1에서 평가)- 입원 순서·환자 번호·요일·교대 배정 등 systematic non-random allocation은 non-RCT
- quasi-RCT 카테고리는 유지하되 실제 사용 빈도 낮을 것으로 예상
2) 기본정보 신규 AU열 `analysis_set` (47열 → 48열)
- 메타분석 합산 기준 분석집단 코드 (`ITT` / `PP` / `NR`, mITT는 ITT로 통합)
- AN(`rob_d2_analysis`)은 원문 서술용으로 분리 유지, AU는 메타분석 분류 코드
3) af_type_other 코드 5 (AF with RVR) 기준 엄격화
- Methods 또는 Inclusion criteria에 "치료 전 안정시 HR ≥ 110" 명시 시만 코드 5
- VR/HR을 outcome으로 측정한 케이스는 코드 5 불인정
4) HRV 및 파생 지표 아웃컴 완전 제외
- 시간영역(SDNN/SDANN/RMSSD/pNN50), 주파수영역(VLF/LF/HF/LF·HF/TP), 비선형(DC/AC/Poincaré/DFA/sample entropy) 전부 추출 금지
- 사유: 측정 기준·시점·기기 상이로 합산 불가, 임상 유용성 낮음
5) SAE 통합 추출
- outcome_std = `SAE` 1행 통합 (AE total과 동일 방식)
- 논문이 SAE/Serious Adverse Events/严重不良反应 등으로 묶어 보고한 경우에만 통합. AI가 임의로 SAE 정의 적용 금지.
- AE total과 SAE 둘 다 보고된 경우 두 행 동시 추출
6) 분류 모호 케이스 처리 원칙 명문화
- 6B 채팅 출력에 7번 항목 신설 — study_design / af_type_other 코드 5 / analysis_set 판정 모호 시 ⑤ 불확실 항목에 의무 명시
호환성 알림
v2.5.x 추출 파일(47열)을 v2.6 마스터(48열)에 직접 머지하면 merge-skill 4B 헤더 검증에서 거부됩니다.
해결: 사전에 마이그레이션 스크립트로 추출 파일을 48열로 변환 후 머지.
```bash
python 00_skills/cpg-data-extraction/migrate_master_v2.6.py 90_Output/
python 00_skills/cpg-data-extraction/migrate_master_v2.6.py "90_Output/extracts/*.xlsx"
```
스크립트는 멱등성·자동 백업(`.v2.5.1.bak`)·사후 검증을 제공합니다.
신규/갱신 파일
- `00_skills/cpg-data-extraction/SKILL.md` — v2.6 frontmatter 및 6개 변경사항
- `00_skills/cpg-data-extraction/CHANGELOG.md` — v2.6 항목 추가
- `00_skills/cpg-data-extraction/references/af-outcomes.md` — §4 제외 아웃컴(HRV) 신설
- `00_skills/cpg-data-extraction/references/rob-extraction-fields.md` — AN/AU 역할 분리
- `00_skills/cpg-data-extraction/sample_v2.6.xlsx` — 신설 (48열)
- `00_skills/cpg-data-extraction/migrate_master_v2.6.py` — 마이그레이션 스크립트
- `00_skills/merge-skill/SKILL.md` — v2.6 + 호환성 메모
- `01_매뉴얼/AF_CPG_데이터추출_매뉴얼_v2.6.docx` — 매뉴얼 v2.6
- `90_Output/AF_CPG_data_extraction_*.xlsx` — 48열 마이그레이션
- `README.md` — 버전 이력
v2.5.1 — 토의목록 + merge-skill 서식 보존 통합
병행 작업 라인을 통합한 릴리스입니다.
주요 변경
- cpg-data-extraction: 토의목록 append 기능 추가 (트리거: '토의목록에 추가해줘')
- merge-skill v1.1 → v2.5.1: 데이터 행 셀 서식 손실 결함 해결
- delete_rows + 재기입 → insert_rows(ASCENDING) + 템플릿 스타일 복사
- row 2 셀 스타일을 col별 템플릿으로 추출해 신규 셀에 적용
- 사후 검증에 서식 spot check 추가
- 매뉴얼 v2.5 → v2.5.1 갱신 (header + 버전표)
- README 버전 이력 갱신 + Releases 링크 수정
본 릴리스에 포함된 v2.5 변경 (이전 release 누락분)
- comorbidity_code(U열) 코드 6 신설 — 高栓塞·高出血 위험(CHA2DS2-VASc·HAS-BLED 점수 기준)
- sample_v2.5.xlsx 추가
v2.5 — 현재 버전
v2.4 대비 변경사항:
- 스킬 SKILL.md / CHANGELOG 업데이트
- 매뉴얼 v2.5 반영
- 토의목록 템플릿 추가
v2.4 — 최초 실배포 버전
심방세동 CPG 데이터 추출 스킬의 첫 실배포 버전입니다.