Skip to content

feat(korean-law-search): 신・구조문대비표 작성(amendment_table) 추가 - #751

Merged
vkehfdl1 merged 1 commit into
devfrom
feat/korean-law-amendment-table
Nov 1, 2026
Merged

vkehfdl1 merged 1 commit into
devfrom
feat/korean-law-amendment-table

Conversation

@vkehfdl1

@vkehfdl1 vkehfdl1 commented Nov 1, 2026

Copy link
Copy Markdown
Member

무엇을 하나

korean-law-search 스킬에 신・구조문대비표 작성을 추가한다. 개정 후 조문 전문만 주면 현행 조문을 가져와 대조한 대비표 초안을 만들고, --output 이면 한글(.hwpx)로 저장한다.

  • 바뀐 곳 밑줄(채팅 표는 굵은 글씨), 개정안 칸의 같은 곳 ----, 안 바뀐 항 (생 략) / (현행과 같음), <신 설> · <삭 제> · <단서 신설>
  • 실행: npx -y @nomadamas/k-skill@0 exec korean-law-search scripts/amendment_table.js -- --input amendment.json --output ~/Desktop/x.hwpx

구현

  • 엔진(korean-law-search/scripts/amendment/): chrisryugj/korean-law-mcp(MIT, dcb866b)의 amendment_table 이식. 라이선스 전문은 scripts/amendment/LICENSE-korean-law-mcp, docs/sources.md 에 출처 기록.
  • 현행 조문 조회는 기존 proxy /v1/korean-law/search·/detail 만 사용 → 새 proxy route·사용자 LAW_OC 불필요.
  • upstream 과 다른 점
    • 법령명은 정확히 같은 현행 법령만 채택(upstream 은 부분 일치 첫 결과로 폴백). 「민법」→「난민법」 오대조 방지, 불일치 시 [NOT_FOUND] + 후보 표시.
    • jszip 의존성 없이 node:zlib 로 ZIP 작성(mimetype 첫 항목·무압축).
    • 서버 디스크 쓰기 게이트(enableAmendmentFileOutput) 제거 — 로컬 CLI 전용이므로.
  • profile 은 lookup 유지(docs/runtime-action-audit.md 가 스킬당 모드 1개를 강제).

검증

  • TDD: 테스트 먼저 작성(모듈 부재로 실패 확인) → 구현. scripts/test_korean_law_amendment_table.js 50개 (upstream 대비표 엔진 36개 이식 + 신규: ZIP 독립 리더로 CRC/순서/압축 검증, proxy 클라이언트(가짜 proxy 서버), CLI 종단 실행, 입력 검증, 정확일치 가드).
  • npm run ci 통과 (노드 테스트 274, 스냅샷 갱신 포함).
  • 라이브 e2e(운영 proxy): 건축법 제22조·제79조(현행 조회→대조→.hwpx), 민법 제750조(현행과 동일 → [NO_CHANGE], 난민법 미선택), 건축법 시행령 신설 조, 도로교통법 가지번호 조(제5조의2), 존재하지 않는 법령명([NOT_FOUND], exit 1). 패키지된 k-skill exec 경로로도 실행 확인.
  • 수동 QA: 생성한 .hwpx 를 kordoc 으로 파싱(성공, <u> 밑줄 유지)하고 rhwp export-svg 로 렌더링해 표 머리행·2열·밑줄·줄표 확인. 한컴 뷰어 GUI 에서의 열림은 확인하지 못함.

한계

  • 결과는 초안(instruction 에 검수 필요 명시). 공식 대비표와 완전 일치율은 upstream 의 주장이며 이 PR 에서 재현하지 않았다.
  • 개정 후 조문 전문은 사용자(LLM)가 써야 한다. 적지 않은 현행 항은 삭제로 간주(확인할 점에 경고).

개정 후 조문 전문만 받아 현행 조문을 k-skill-proxy(/v1/korean-law/search·detail)로 가져와
밑줄·----·(생  략)·<신  설> 표기의 대비표 초안을 만들고 --output 이면 한글(.hwpx)로 저장한다.
엔진은 chrisryugj/korean-law-mcp(MIT, dcb866b)에서 이식했고, 현행 조회는 proxy 호출로 바꿨다.
법령명은 정확히 같은 현행 법령만 받는다(부분 일치로 민법→난민법을 고르지 않음). jszip 없이 node:zlib ZIP 작성기 사용.
@vkehfdl1
vkehfdl1 merged commit 1d37584 into dev Nov 1, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant