Skip to content

Releases

v2.9.1 — 배제 논문 시트 처리 버그 패치 + 코드6 과거지표

Choose a tag to compare

@trisss1011 trisss1011 released this 15 Jun 03:48

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 경량화

Choose a tag to compare

@trisss1011 trisss1011 released this 08 Jun 07:10

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열) 블록 누락 버그 수정

Choose a tag to compare

@trisss1011 trisss1011 released this 15 Jun 04:15

버그 수정(회의 결정 무관). 6C 출력 구조에 RoB 근거 블록 신설(불확실·NR→⑥), 매뉴얼 동기화. 추출 규칙·열 구조·코드값 변경 없음(48열). (태그 v2.8.1에서 후행 생성한 Release)

v2.8 — SF-36 통일명·Study ID a/b·다군 1쌍·양약 용량차 제외

Choose a tag to compare

@trisss1011 trisss1011 released this 01 Jun 15:54

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 제외

Choose a tag to compare

@trisss1011 trisss1011 released this 15 Jun 04:15

2026-05-27 회의 결정 반영. 열 구조 v2.6 이후 동일(48열). 동반 upgrade-skill v1.3·merge-skill v2.7. (태그 v2.7에서 후행 생성한 Release)

v2.6.1 — 추출 규칙 보강 + upgrade-skill 신설

Choose a tag to compare

@trisss1011 trisss1011 released this 20 May 20:17

핵심 변경 (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 통합

Choose a tag to compare

@trisss1011 trisss1011 released this 19 May 06:23

연구팀 회의(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 서식 보존 통합

Choose a tag to compare

@trisss1011 trisss1011 released this 07 May 02:48

병행 작업 라인을 통합한 릴리스입니다.

주요 변경

  • 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 — 현재 버전

Choose a tag to compare

@trisss1011 trisss1011 released this 04 May 02:47

v2.4 대비 변경사항:

  • 스킬 SKILL.md / CHANGELOG 업데이트
  • 매뉴얼 v2.5 반영
  • 토의목록 템플릿 추가

v2.4 — 최초 실배포 버전

Choose a tag to compare

@trisss1011 trisss1011 released this 04 May 02:47

심방세동 CPG 데이터 추출 스킬의 첫 실배포 버전입니다.