kacem-tender 사용 가이드

군인공제회 모집공고 첨부 파일(hwp·hwpx·pdf)에서 사업개요와 사업비를 추출해 표·JSON으로 정리합니다. Claude에게 말로 부탁하면 됩니다 — /kacem-tender 이 공고 사업비 정리해줘, /kacem-tender 발주처랑 공급가액 뽑아줘처럼요.

자주 쓰는 요청

하고 싶은 것	이렇게 말하세요
공고 파일 전체 정리	`/kacem-tender 이 hwpx에서 사업개요랑 사업비 표로 뽑아줘`
특정 항목만 추출	`/kacem-tender 이 공고에서 발주처랑 공급가액만 뽑아줘`
여러 파일 한 번에	`/kacem-tender 이 폴더 안에 있는 공고 파일 전부 정리해줘`
CSV도 함께 저장	`/kacem-tender 표 정리하고 CSV 파일도 같이 만들어줘`
요약만 확인	`/kacem-tender 공고 요약을 표로 보여줘`

어떻게 동작하나요

세 단계를 순서대로 진행합니다.

1단계 — 텍스트 추출: hwp·hwpx·pdf 파일에서 텍스트를 결정론적으로(일관되게) 뽑아냅니다. 단일 파일도, 폴더 전체도 처리합니다.

2단계 — 항목 구조화: Claude가 추출된 텍스트를 읽고 사업명·발주처·사업기간·공급가액·부가세·합계 등을 정리합니다. 정리가 끝나면 저장 방식을 확인합니다.

그대로 저장(권장): 요약 표(Markdown)와 구조화 데이터(JSON)를 저장합니다.
CSV 추가: 위 두 파일에 CSV 파일도 함께 만듭니다.
종료: 저장하지 않습니다.

3단계 — 최종 저장: 확인한 내용대로 파일을 지정 폴더에 저장합니다.

저장 결과물

공고 하나를 처리하면 아래 구조로 파일이 생깁니다.

{저장폴더}/{글번호}_{제목}/
├── summary.md      # Markdown 표 (사업개요 + 사업비)
├── summary.json    # 구조화 데이터
└── summary.csv     # (CSV 추가를 선택한 경우)

kacem-tender fetch 서브커맨드와 함께 쓰기

kacem-tender fetch 서브커맨드 스킬로 군인공제회 게시판에서 공고 파일을 먼저 받아두면, 이 스킬이 그 파일을 바로 읽어 처리합니다. /kacem-tender 공고 받아서 사업비 정리까지 해줘처럼 말하면 두 스킬이 이어서 동작합니다.

안 될 때

증상	원인 / 해결
hwpx 파일을 읽지 못한다는 안내 (`HwpxNotFoundError`)	hwpx 변환 도구가 없습니다. `itda-work/skills/hwpx` 스킬 설치를 확인하거나 Claude에게 "hwpx 설치해줘"라고 말하세요
PDF에서 텍스트가 안 나온다는 안내 (`PdfExtractError`)	PDF 추출 도구가 없습니다. 필요한 패키지는 실행 환경이 준비합니다 — Claude에게 안내를 받으세요
스키마 오류 안내 (`SchemaValidationError`)	생성된 JSON 구조에 문제가 있습니다. 해당 필드 오류 내용을 Claude에게 그대로 전달하면 수정해드립니다
텍스트가 비어 있다는 안내	스캔 이미지 PDF거나 보호된 파일일 수 있습니다. 다른 파일로 시도하거나 Claude에게 파일 상태를 알려주세요

파일 형식 자동 인식

hwpx·hwp·pdf 파일은 확장자와 파일 내부 정보를 모두 보고 자동으로 형식을 판별합니다. 따로 파일 종류를 지정하지 않아도 됩니다.