@simplysm/sd-claude 14.0.82 → 14.0.84

package/claude/skills/sd-unpack/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: sd-unpack
-description: 메일·문서(eml/msg/pdf/docx/pptx/xlsx/xlsb, 레거시 doc/ppt/xls)를 첨부 포함 재귀적으로 풀어 평문 트리로 펼치기. Use when 위 형식 파일의 본문·첨부 전반을 훑어야 할 때 (분석·요약·정리·검토 등). 단순 단답 조회(특정 값/셀 확인)나 옆에 이미 펼친 `<basename>_<ext>/` 폴더가 있으면 호출 X.
+description: 메일·문서(eml/msg/pdf/docx/pptx/xlsx/xlsb, 레거시 doc/ppt/xls)를 첨부 포함 재귀적으로 풀어 평문 트리로 펼치기. Use when 위 형식 파일의 본문·첨부 전반을 훑어야 할 때 (분석·요약·정리·검토 등). 단순 단답 조회(특정 값/셀 확인)나 옆에 이미 펼친 `<basename>_<ext>/` 폴더가 있으면 호출 금지.
 
 ---
 
@@ -12,21 +12,21 @@ description: 메일·문서(eml/msg/pdf/docx/pptx/xlsx/xlsb, 레거시 doc/ppt/x
 python .claude/skills/sd-unpack/scripts/unpack.py <입력파일 절대경로>
 ```
 
-스크립트가 형식 분기·재귀 풀이·README 생성까지 알아서 처리함. stdout 으로 결과 폴더 절대경로가 출력됨.
+스크립트가 형식 분기·재귀 풀이·README 생성까지 처리. stdout 으로 결과 폴더 절대경로 출력.
 
-여러 파일을 풀어달라는 요청이 오면 단일 파일 단위로 반복 호출함.
+여러 파일을 풀어달라는 요청이 오면 단일 파일 단위로 반복 호출.
 
 ## 환경
 
-Windows + MS Office 필요 (docx/pptx/xlsx 변환). Python 패키지 의존은 `ensure_pip` 가 자동 처리. COM 의존 미충족 시 해당 형식 핸들러는 throw.
+Windows + MS Office 필요 (docx/pptx/xlsx 변환용). Python 패키지 의존은 `ensure_pip` 가 자동 처리. COM(Component Object Model) 의존 미충족 시 해당 형식 핸들러는 throw.
 
 ## 결과 폴더
 
-입력 파일 옆에 `<basename>_<ext>/` 가 생김. 컨테이너 첨부는 같은 패턴으로 재귀적으로 풀림. 폴더 안 `_source.<ext>` + `README.md` 가 풀린 폴더의 식별 마커.
+입력 파일 옆에 `<basename>_<ext>/` 폴더 생성. 컨테이너 첨부는 같은 패턴으로 재귀적으로 풀림. 폴더 안 `_source.<ext>` + `README.md` 가 풀린 폴더의 식별 마커.
 
-동일 입력 재호출 시 기존 결과 폴더는 사전 삭제 후 재생성 (이전 산출 잔존물 섞이지 않게).
+동일 입력 재호출 시 기존 결과 폴더는 사전 삭제 후 재생성 (이전 산출 잔존물이 섞이지 않게).
 
-시각은 PNG, 텍스트/구조는 JSONL/JSON/MD 로 분리해 출력함.
+시각은 PNG, 텍스트·구조는 JSONL/JSON/MD 로 분리 출력.
 
 ```
 meeting_eml/
@@ -65,23 +65,23 @@ meeting_eml/
 | pdf | `pages/<NNN>.png` | `pages/<NNN>.jsonl` (블록 bbox + 표 셀 단위) | `images/p<NNN>_b<bid>.<ext>`, `attachments/` (PDF 임베드) |
 | eml/msg | — | `body.md` (평문 본문), `headers.json`, `images.rels.json` | `body.html` (원본), `attachments/` (컨테이너면 재귀) |
 
-`attachments/` 안 컨테이너 첨부는 같은 패턴으로 `<basename>_<ext>/` 폴더로 재귀 풀이.
+`attachments/` 안 컨테이너 첨부는 같은 패턴의 `<basename>_<ext>/` 폴더로 재귀 풀이.
 
 ## JSONL 공통 규약
 
 모든 jsonl 출력은 **한 줄 = 한 노드 (또는 한 행/셀)**. 빈 키 생략. JSON 네이티브 타입 보존. datetime → ISO 8601 문자열.
 
 조회 패턴:
-- 좌표·인덱스 직격 grep (`"r":11`·`"slide":5`·`"node":42`).
+- 좌표·인덱스로 직접 grep (`"r":11`·`"slide":5`·`"node":42`).
 - 키 grep (`"type":"heading"`·`"_f"` 수식 행만).
 - Read offset = 행/노드 인덱스 1:1 (빈 노드도 한 줄 유지).
 
 ## xlsx jsonl 규약
 
-시트별 `.jsonl` — 분석 핵심 (값·number_format·수식·merges·hyperlinks·comments). 시각 표시 (바탕색·border·폰트)·frozen·dims 는 미보존 (PNG 가 시각 보조, 필요 시 `_source.xlsx` 직접 추출).
+시트별 `.jsonl` — 분석 핵심 (값·number_format·수식·merges·hyperlinks·comments) 보존. 시각 표시 (바탕색·border·폰트)·frozen·dims 는 미보존 (PNG 가 시각 보조 역할, 필요 시 `_source.xlsx` 직접 추출).
 
 - 첫 줄: `{"_meta":{"merges":["A1:C1",...], "number_formats":{"E1":"yyyy-mm-dd",...}, "hyperlinks":{"D5":"http://..."}, "comments":{"E3":"메모"}}}`.
-  - `merges`: 머지된 셀 영역 (셀 좌표 해석에 필수 — 머지 영역 안 빈 셀 오해 차단).
+  - `merges`: 머지된 셀 영역 (셀 좌표 해석에 필수 — 머지 영역 안 빈 셀 오해 방지).
   - `number_formats`: General(기본) 외 셀 표시 형식 — Date·통화·% 등 셀 값 의미 단서.
   - `hyperlinks`: 셀 URL (URL 자체가 셀 정보).
   - `comments`: 셀 메모.
@@ -90,17 +90,17 @@ meeting_eml/
   - `r`: 1-based 행번호 (Excel 동일).
   - 열문자 키 (`A`·`B`·...·`AA`·...): 셀 값. 빈 셀은 키 생략.
   - `_f`: 같은 행 수식 맵 `{열문자: 수식문자열}`. 수식 없는 행은 키 생략.
-- 빈 행도 `{"r":N}` 한 줄 유지 → Read offset = 행번호 (오프바이원 차단).
+- 빈 행도 `{"r":N}` 한 줄 유지 → Read offset = 행번호 (오프바이원 방지).
 - 값 타입: JSON 네이티브 (`int`·`float`·`bool`·`str`), datetime 은 ISO 8601 문자열.
 
 ### Chartsheet (시트 자체가 차트)
 
-xlsx 안 시트는 일반 Worksheet 외에 **Chartsheet** (셀 없이 차트 1개) 도 있을 수 있음.
+xlsx 안 시트는 일반 Worksheet 외에 **Chartsheet** (셀 없이 차트 1개만 있는 시트) 도 있을 수 있음.
 
 - Chartsheet 는 `sheets/<idx>_<name>.jsonl` 미생성 (셀 없음).
 - Chartsheet 의 차트 데이터: `charts/sheet<idx>_chart.data.json`.
-- README sheet_summaries 에 `(chart sheet — "...")` 명시.
-- 일반 시트·Chartsheet 통합 시트 순서 (idx) 대로 보존.
+- README 의 sheet_summaries 항목에 `(chart sheet — "...")` 명시.
+- 일반 시트·Chartsheet 를 통합한 시트 순서 (idx) 대로 보존.
 
 ### 워크북 단위 `workbook.meta.json`
 
@@ -112,7 +112,7 @@ xlsx 안 시트는 일반 Worksheet 외에 **Chartsheet** (셀 없이 차트 1
 
 ## pptx jsonl 규약
 
-슬라이드별 `slides/<idx>_<title>.jsonl`. 원본 XML 순서 (shape_idx 순) 그대로. 시각 순서는 `pos` 좌표 기반으로 Claude 가 필요시 정렬.
+슬라이드별 `slides/<idx>_<title>.jsonl` 생성. 원본 XML 순서 (shape_idx 순) 그대로 유지. 시각 순서는 `pos` 좌표 기반으로 Claude 가 필요시 정렬.
 
 - 첫 줄: `{"_meta":{"slide":N, "title":"슬라이드 제목 또는 빈 문자열", "size":[w,h], "shapes":S}}`.
   - `size`: 슬라이드 폭/높이 (EMU 단위, python-pptx 원본).
@@ -139,14 +139,14 @@ paragraph 안 hyperlink 가 있으면 `hyperlinks`: `[{"text":"...", "url":"..."
 
 ## docx jsonl 규약
 
-문서 단일 시퀀스 `content.jsonl`. 페이지 단위 폐기 (Word 렌더 산물). 원본 = python-docx 의 문단/표/이미지 시퀀스.
+문서 단일 시퀀스 `content.jsonl` 생성. 페이지 단위는 폐기 (Word 렌더 산물이라 원본 구조와 무관). 원본 시퀀스는 python-docx 의 문단·표·이미지 시퀀스를 따름.
 
 - 첫 줄: `{"_meta":{"paragraphs":P, "tables":T, "images":I}}`.
 - 노드 줄: `{"node":N, "type":"<type>", ...추가 키}`.
   - `node`: 0-based 시퀀스 인덱스 (Read offset = node).
 
 노드 type:
-- `heading`: 키 `text`·`level` (1·2·3·...) — docx Heading 스타일 기반만 (휴리스틱 추정 X).
+- `heading`: 키 `text`·`level` (1·2·3·...) — docx Heading 스타일 기반만 (휴리스틱 추정 금지).
 - `para`: 키 `text` (빈 paragraph 도 노드로 보존, text="").
 - `bullet`: 키 `text`·`level` (0-based ilvl).
 - `table_cell`: 키 `table_idx`·`row`·`col` (1-based)·`text`. 머지 시 `colspan` 추가 (gridSpan>1 일 때만). vMerge='continue' cell 은 skip (origin 만).
@@ -157,11 +157,11 @@ paragraph 안 hyperlink 가 있으면 `hyperlinks`: `[{"text":"...", "url":"..."
 페이지 매핑 별도 `pages.meta.json`:
 - `{"001":{"text":"<페이지 평문>"}, "002":{...}, ...}` (PNG 페이지 ↔ fitz 추출 raw text).
 - PNG 는 fitz 페이지 분할 그대로 (시각 검증용).
-- 노드 인덱스 자동 매핑은 미적용 (fitz·python-docx 텍스트 분할 차이로 오매핑 위험) — Claude 가 페이지 text 와 content.jsonl 노드 text 를 직접 grep 비교.
+- 노드 인덱스 자동 매핑은 미적용 (fitz·python-docx 의 텍스트 분할 차이로 오매핑 위험) — Claude 가 페이지 text 와 content.jsonl 의 노드 text 를 직접 grep 비교.
 
 ## pdf jsonl 규약
 
-페이지별 `pages/<NNN>.jsonl`. PDF 페이지는 원본 단위.
+페이지별 `pages/<NNN>.jsonl` 생성. PDF 페이지는 원본 단위.
 
 - 첫 줄: `{"_meta":{"page":N, "size":[w,h], "blocks":B, "tables":T, "table_cells":C, "form_fields":F, "annotations":A}}`.
 - 노드 줄:
@@ -170,7 +170,7 @@ paragraph 안 hyperlink 가 있으면 `hyperlinks`: `[{"text":"...", "url":"..."
   - `table_cell`: `{"page":N, "type":"table_cell", "table_idx":T, "table_bbox":[...], "row":R, "col":C, "text":"..."}`.
   - `form_field`: `{"page":N, "type":"form_field", "name":"...", "field_type":"text", "value":"...", "bbox":[...]}` (PDF 양식 입력란).
   - `annotation`: `{"page":N, "type":"annotation", "subtype":"Highlight", "bbox":[...], "content":"...", "author":"..."}` (주석·highlight·sticky note).
-- 모든 블록 보존 (표 영역과 겹쳐도 skip 안 함) — find_tables 정확도 100% 가정 시 정보 손실 위험 회피. text_block·image_block·table_cell 노드가 동일 영역에 중복 출력될 수 있음. Claude 가 양쪽 비교 판단.
+- 모든 블록 보존 (표 영역과 겹쳐도 skip 안 함) — find_tables 정확도 100% 가정 시 정보 손실 위험을 회피. text_block·image_block·table_cell 노드가 동일 영역에 중복 출력될 수 있음. Claude 가 양쪽을 비교하여 판단.
 - bbox 는 PDF 기준 좌표 (left-top, pt 단위, raw float).
 
 heading 추출은 미적용 (PDF 는 style 정보 없음). OCR 미적용 (스캔 PDF 는 image_block 만 추출).
@@ -179,41 +179,41 @@ heading 추출은 미적용 (PDF 는 style 정보 없음). OCR 미적용 (스캔
 
 본문 안 `<img cid:...>` 가 첨부의 어느 파일인지 추적.
 
-- `images.rels.json`: `{"<cid>":"attachments/image001.png", ...}` (HTML 본문 안 cid → 첨부 파일명).
-- HTML→평문 변환본 안 원래 `<img>` 위치에 `![image001.png](attachments/image001.png)` placeholder 삽입.
+- `images.rels.json`: `{"<cid>":"attachments/image001.png", ...}` (HTML 본문 안 cid → 첨부 파일명 매핑).
+- HTML→평문 변환본의 원래 `<img>` 위치에 `![image001.png](attachments/image001.png)` placeholder 삽입.
   - text/plain 만 있을 때 → `body.md` 자체가 변환본 → placeholder 포함.
   - text/plain·HTML 둘 다 있을 때 → `body.md` 는 plain (placeholder 없음), `body.from_html.md` 가 변환본 (placeholder 포함).
 - 인라인 이미지 없으면 `images.rels.json` 미생성.
 
 ## TNEF (winmail.dat) 풀이
 
-Outlook RTF 메일이 첨부를 `winmail.dat` 단일 binary (TNEF 형식) 로 패키징한 경우, `tnefparse` 로 내부 첨부 추출하여 `attachments/` 에 같이 풀어 둠. 원본 `winmail.dat` 도 유지 (원본 보존).
+Outlook RTF 메일이 첨부를 `winmail.dat` 단일 binary (TNEF, Transport Neutral Encapsulation Format) 로 패키징한 경우, `tnefparse` 로 내부 첨부를 추출하여 `attachments/` 에 풀어 둠. 원본 `winmail.dat` 도 유지 (원본 보존).
 
-내부 첨부도 컨테이너 (xlsx·pptx 등) 면 재귀 풀이 (다른 첨부와 동일).
+내부 첨부가 컨테이너 (xlsx·pptx 등) 면 재귀 풀이 (다른 첨부와 동일).
 
 ## eml/msg 본문 규약
 
-본문 흐름 정확성(text/plain 우선) + 인라인 이미지 위치 단서(HTML→평문 변환본) 둘 다 보존:
+본문 흐름 정확성 (text/plain 우선) 과 인라인 이미지 위치 단서 (HTML→평문 변환본) 를 둘 다 보존:
 
 - `body.md`: 항상 별도 파일 (인라인 cutoff 폐기).
   - text/plain 있으면 우선 — 발신자가 의도한 평문, 변환 잡음 없음.
   - 없으면 text/html → 평문 추출.
 - `body.from_html.md`: text/plain·HTML 둘 다 있을 때만 별도 생성.
-  - HTML→평문 변환 (이미지 위치 placeholder 포함).
-  - body.md 가 plain 이라 잃은 위치 정보를 보완.
+  - HTML→평문 변환본 (이미지 위치 placeholder 포함).
+  - `body.md` 가 plain 이라 누락된 위치 정보를 보완.
 - `body.html`: 원본 HTML (있을 때).
-- `headers.json`: 모든 메일 헤더 원본 보존 (envelope + `X-Mailer`·`Authentication-Results` 등 모두). 동일 키 다수면 list 누적.
-  - README 헤더 섹션에는 표준 envelope 키만 표기 (전체는 headers.json 직접 조회).
+- `headers.json`: 모든 메일 헤더를 원본 그대로 보존 (envelope + `X-Mailer`·`Authentication-Results` 등 모두). 동일 키 다수면 list 로 누적.
+  - `README.md` 헤더 섹션에는 표준 envelope 키만 표기 (전체는 `headers.json` 직접 조회).
 
 ## xlsb 클린업
 
-- legacy → xlsx 변환 시 `_converted.xlsx` 는 임시 폴더에서만 처리 (산출 폴더에 미잔존).
-- VBA 매크로는 원본 코드 그대로 `macros/<모듈명>.vba` 저장 (변형 X).
-- VBA 시트 객체명↔raw 시트명 매핑은 `workbook.meta.json` 의 `sheet_code_map` 키 (예: `{"Sheet1":"BOA","Sheet3":"Mapping"}`).
+- legacy → xlsx 변환 시 `_converted.xlsx` 는 임시 폴더에서만 처리 (산출 폴더에 잔존시키지 않음).
+- VBA(Visual Basic for Applications) 매크로는 원본 코드 그대로 `macros/<모듈명>.vba` 에 저장 (변형 금지).
+- VBA 시트 객체명 ↔ raw 시트명 매핑은 `workbook.meta.json` 의 `sheet_code_map` 키에 저장 (예: `{"Sheet1":"BOA","Sheet3":"Mapping"}`).
 
 ## 산출물 사용
 
-후속 스킬(sd-spec 등)은 결과 폴더의 `README.md` 한 번 Read 로 본문 위치·헤더·첨부 목록·손실 영역을 모두 파악할 수 있음. 컨테이너 첨부는 자체 `README.md` 를 가지므로 재귀적으로 같은 방식으로 들어감.
+후속 스킬 (sd-spec 등) 은 결과 폴더의 `README.md` 를 한 번 Read 하여 본문 위치·헤더·첨부 목록·손실 영역을 모두 파악 가능. 컨테이너 첨부는 자체 `README.md` 를 가지므로 같은 방식으로 재귀 진입.
 
 각 형식별 jsonl 의 grep 패턴:
 - xlsx: `"r":<행>` · `"_f"` (수식 행) · 열문자 키.

package/claude/skills/sd-unpack/scripts/handlers/office_com.py

@@ -702,6 +702,70 @@ def _pptx_save_picture(
 # XLSX
 # ====================================================================
 
+def _xlsx_clean_nonfinite(src: Path, dst: Path) -> None:
+    """xlsx 시트 XML 안 `<v>NaN</v>`/`<v>Infinity</v>`/`<v>-Infinity</v>` 를 제거한 사본을 dst 에 생성.
+
+    원인: 일부 third-party 라이브러리가 만든 xlsx 가 비유한 부동소수점(NaN/Inf) 을 numeric 셀에
+    문자열 그대로 기록 → openpyxl 의 `_cast_number → int('NaN')` 에서 ValueError.
+    대응: 시트 XML 의 해당 `<v>` 요소만 제거(해당 셀은 빈 셀 처리). 다른 part(images·drawings·
+    styles·shared strings) 는 그대로 복사.
+    """
+    pat = re.compile(rb"<v>(?:NaN|Infinity|-Infinity|INF|-INF)</v>")
+    with zipfile.ZipFile(_common.long_str(src), "r") as zin, \
+            zipfile.ZipFile(_common.long_str(dst), "w", zipfile.ZIP_DEFLATED) as zout:
+        for item in zin.infolist():
+            data = zin.read(item.filename)
+            if item.filename.startswith("xl/worksheets/") and item.filename.endswith(".xml"):
+                data = pat.sub(b"", data)
+            zout.writestr(item, data)
+
+
+def _safe_load_xlsx_workbooks(
+    input_path: Path,
+    cleanup_paths: list[Path],
+) -> tuple[Any, Any, Path]:
+    """openpyxl 로 wb_values(data_only=True) + wb_formulas(data_only=False) 둘 다 로드.
+
+    비표준 셀값(NaN/Infinity 문자열을 numeric 셀에 담은 xlsx) 은 openpyxl 의 strict int cast 로
+    ValueError throw. 이 경우 시트 XML 의 비유한값만 제거한 정제본을 임시 파일로 만들어 재시도.
+    정제 발생시 임시 파일을 `cleanup_paths` 에 등록(호출자가 finally 에서 unlink).
+
+    반환: (wb_values, wb_formulas, openpyxl_input_path). openpyxl_input_path 는 후속 openpyxl
+    호출(이미지 추출 등) 이 같은 정제본을 재사용하도록 path 노출. 정제 불필요시 input_path 그대로.
+    """
+    import tempfile
+    from openpyxl import load_workbook
+
+    def _is_nonfinite_error(e: BaseException) -> bool:
+        cur: Optional[BaseException] = e
+        while cur is not None:
+            msg = str(cur)
+            if "NaN" in msg or "Infinity" in msg:
+                return True
+            cur = cur.__cause__
+        return False
+
+    src_str = _common.long_str(input_path)
+    try:
+        wb_values = load_workbook(src_str, data_only=True)
+        wb_formulas = load_workbook(src_str, data_only=False)
+        return wb_values, wb_formulas, input_path
+    except ValueError as e:
+        if not _is_nonfinite_error(e):
+            raise
+
+    base = _common._ensure_tmp_base()
+    fd, tmp_str = tempfile.mkstemp(prefix="sd-unpack-xlsx-clean-", suffix=".xlsx", dir=str(base))
+    os.close(fd)
+    cleaned = Path(tmp_str)
+    # 등록을 정제·로드 전에 수행 → 도중 throw 해도 호출자 finally 가 unlink.
+    cleanup_paths.append(cleaned)
+    _xlsx_clean_nonfinite(input_path, cleaned)
+    wb_values = load_workbook(_common.long_str(cleaned), data_only=True)
+    wb_formulas = load_workbook(_common.long_str(cleaned), data_only=False)
+    return wb_values, wb_formulas, cleaned
+
+
 def _run_xlsx(
     input_path: Path,
     out_dir: Path,
@@ -722,174 +786,185 @@ def _run_xlsx(
     sheet_formula_count: dict[str, int] = {}
     sheet_dims: dict[str, tuple[int, int]] = {}
 
-    wb_values = load_workbook(_common.long_str(input_path), data_only=True)
-    wb_formulas = load_workbook(_common.long_str(input_path), data_only=False)
+    # 비표준 셀값(NaN/Infinity) 사전 정제 + openpyxl 로드. 정제본 임시파일은 마지막에 unlink.
+    _xlsx_cleanups: list[Path] = []
     try:
-        _common.mkdir(sheets_dir)
-        # openpyxl 의 sheetnames 는 일반 Worksheet 와 Chartsheet 둘 다 포함.
-        # 시트 순서 그대로 idx 통합 부여 (사용자 워크북 순서 보존).
-        # 일반 Worksheet 만 COM Excel PNG export 대상, Chartsheet 는 차트 데이터만 추출.
-        idx_counter = 0
-        for name in wb_values.sheetnames:
-            obj = wb_values[name]
-            idx_counter += 1
-            idx = f"{idx_counter:02d}"
-            safe_name = _common.slugify_filename(name, max_len=40)
-            if isinstance(obj, Worksheet):
-                sheet_names.append((idx, safe_name, name))
-            else:
-                # Chartsheet 등 비-worksheet
-                chart_sheet_names.append((idx, safe_name, name))
-
-        # COM Excel 호출: 데이터 영역 → ChartObject + Range.CopyPicture → 시트별 PNG.
-        # 시트별 (last_row, last_col) 도 같이 반환되어 .jsonl 이 같은 데이터 영역으로 통일됨.
-        # PNG export 실패한 시트는 sheet_png_skipped 에 사유 (silent skip 금지).
-        with _common.com_lock():
-            sheet_ranges, sheet_png_skipped = _excel_export_sheet_pngs(input_path, sheets_dir, sheet_names)
-
-        for idx, safe_name, raw_name in sheet_names:
-            ws_v = wb_values[raw_name]
-            ws_f = wb_formulas[raw_name]
-
-            # COM Find 결과가 있으면 그 범위, 없으면 openpyxl max_row/max_column fallback.
-            last_row, last_col = sheet_ranges.get(raw_name, (ws_v.max_row, ws_v.max_column))
-            sheet_dims[idx] = (last_row, last_col)
-
-            jsonl_lines, formula_n = _sheet_to_jsonl(ws_v, ws_f, last_row, last_col)
-            _common.write_text(sheets_dir / f"{idx}_{safe_name}.jsonl", "\n".join(jsonl_lines))
-            sheet_formula_count[idx] = formula_n
-
-            for chart_idx, chart in enumerate(getattr(ws_f, "_charts", []), start=1):
-                data = _extract_openpyxl_chart_data(chart)
-                _common.mkdir(charts_dir)
-                chart_filename = f"sheet{idx}_chart{chart_idx:02d}.data.json"
-                _common.write_text(
-                    charts_dir / chart_filename,
-                    json.dumps(data, ensure_ascii=False, indent=2),
-                )
-                sheet_charts.setdefault(idx, []).append(chart_filename)
-
-        # Chartsheet 처리: 차트 데이터를 charts/sheet<idx>_chart.data.json 으로 저장
-        chart_sheet_chart_files: dict[str, str] = {}  # idx -> chart filename
-        for idx, safe_name, raw_name in chart_sheet_names:
-            cs = wb_formulas[raw_name]
-            chart = None
-            # Chartsheet.charts 또는 _charts 속성 (openpyxl 버전 따라 다름)
-            for attr in ("charts", "_charts"):
-                v = getattr(cs, attr, None)
-                if v:
-                    if hasattr(v, "__iter__"):
-                        try:
-                            chart = next(iter(v), None)
-                        except Exception:
-                            chart = None
-                    else:
-                        chart = v
-                    if chart is not None:
-                        break
-            if chart is None:
-                # 단일 chart 속성 fallback
-                chart = getattr(cs, "chart", None)
-            if chart is not None:
-                try:
+        wb_values, wb_formulas, openpyxl_input = _safe_load_xlsx_workbooks(input_path, _xlsx_cleanups)
+        try:
+            _common.mkdir(sheets_dir)
+            # openpyxl 의 sheetnames 는 일반 Worksheet 와 Chartsheet 둘 다 포함.
+            # 시트 순서 그대로 idx 통합 부여 (사용자 워크북 순서 보존).
+            # 일반 Worksheet 만 COM Excel PNG export 대상, Chartsheet 는 차트 데이터만 추출.
+            idx_counter = 0
+            for name in wb_values.sheetnames:
+                obj = wb_values[name]
+                idx_counter += 1
+                idx = f"{idx_counter:02d}"
+                safe_name = _common.slugify_filename(name, max_len=40)
+                if isinstance(obj, Worksheet):
+                    sheet_names.append((idx, safe_name, name))
+                else:
+                    # Chartsheet 등 비-worksheet
+                    chart_sheet_names.append((idx, safe_name, name))
+
+            # COM Excel 호출: 데이터 영역 → ChartObject + Range.CopyPicture → 시트별 PNG.
+            # 시트별 (last_row, last_col) 도 같이 반환되어 .jsonl 이 같은 데이터 영역으로 통일됨.
+            # PNG export 실패한 시트는 sheet_png_skipped 에 사유 (silent skip 금지).
+            with _common.com_lock():
+                # openpyxl_input 사용: 정제본(NaN 제거) 이 있으면 COM Excel 도 정제본을 열어야 함
+                # (Excel 역시 `<v>NaN</v>` 가 있는 xlsx 의 Open 에 실패).
+                sheet_ranges, sheet_png_skipped = _excel_export_sheet_pngs(openpyxl_input, sheets_dir, sheet_names)
+
+            for idx, safe_name, raw_name in sheet_names:
+                ws_v = wb_values[raw_name]
+                ws_f = wb_formulas[raw_name]
+
+                # COM Find 결과가 있으면 그 범위, 없으면 openpyxl max_row/max_column fallback.
+                last_row, last_col = sheet_ranges.get(raw_name, (ws_v.max_row, ws_v.max_column))
+                sheet_dims[idx] = (last_row, last_col)
+
+                jsonl_lines, formula_n = _sheet_to_jsonl(ws_v, ws_f, last_row, last_col)
+                _common.write_text(sheets_dir / f"{idx}_{safe_name}.jsonl", "\n".join(jsonl_lines))
+                sheet_formula_count[idx] = formula_n
+
+                for chart_idx, chart in enumerate(getattr(ws_f, "_charts", []), start=1):
                     data = _extract_openpyxl_chart_data(chart)
-                except Exception:
-                    data = None
-                if data is not None:
                     _common.mkdir(charts_dir)
-                    chart_filename = f"sheet{idx}_chart.data.json"
+                    chart_filename = f"sheet{idx}_chart{chart_idx:02d}.data.json"
                     _common.write_text(
                         charts_dir / chart_filename,
                         json.dumps(data, ensure_ascii=False, indent=2),
                     )
-                    chart_sheet_chart_files[idx] = chart_filename
-
-        # 워크북 단위 메타 (defined names·pivots·sheet codeName 등) — 시트 jsonl 외부 분리.
-        wb_meta = _workbook_meta(wb_formulas, input_path)
-        # VBA 시트 객체명 ↔ raw 시트명 매핑 (시트 codeName 기반)
-        sheet_code_map: dict[str, str] = {}
-        for ws in wb_formulas.worksheets:
-            code = getattr(ws.sheet_properties, "codeName", None)
-            if code:
-                sheet_code_map[code] = ws.title
-        if sheet_code_map:
-            wb_meta["sheet_code_map"] = sheet_code_map
-        if wb_meta:
-            _common.write_text(
-                out_dir / "workbook.meta.json",
-                json.dumps(wb_meta, ensure_ascii=False, indent=2),
-            )
-    finally:
-        wb_values.close()
-        wb_formulas.close()
-
-    # 시트 PNG 는 데이터 영역(Find 범위) 만 캡처 → 데이터 영역 밖 이미지는 누락될 수 있음 →
-    # raw 이미지를 시트+셀 위치 정보 포함해서 별도 보존.
-    sheet_images = _extract_xlsx_images_with_position(input_path, out_dir, sheet_names)
-    attachment_links = _extract_zip_media(
-        input_path,
-        out_dir,
-        media_zip_prefix="xl/media/",
-        embed_zip_prefix="xl/embeddings/",
-    )
-
-    # 시트별 산출물 풀목록 — 일반 시트 + chart sheet 통합, 시트 순서 (idx) 대로
-    sheet_summary_map: dict[str, str] = {}
-    for idx, safe_name, raw_name in sheet_names:
-        last_row, last_col = sheet_dims.get(idx, (0, 0))
-        formula_n = sheet_formula_count.get(idx, 0)
-        png_path = sheets_dir / f"{idx}_{safe_name}.png"
-        if png_path.exists():
-            parts = [f"`sheets/{idx}_{safe_name}.png`", "`.jsonl`"]
-        else:
-            # PNG 미생성 — worker 가 사유 전달 (16-bit cap / COM 실패 등)
-            reason = sheet_png_skipped.get(raw_name, "사유 미상")
-            parts = [f"`sheets/{idx}_{safe_name}.jsonl`", f"(PNG 미생성 — {reason})"]
-        chart_refs = sheet_charts.get(idx, [])
-        if chart_refs:
-            parts.append("(차트: " + ", ".join(f"`charts/{c}`" for c in chart_refs) + ")")
-        img_refs = sheet_images.get(raw_name, [])
-        if img_refs:
-            parts.append("(이미지: " + ", ".join(f"`images/{n}`" for n in img_refs) + ")")
-        meta = f"({last_row}행×{last_col}열"
-        if formula_n:
-            meta += f", 수식 {formula_n}개"
-        meta += ")"
-        sheet_summary_map[idx] = " ".join(parts) + " " + meta
-
-    for idx, safe_name, raw_name in chart_sheet_names:
-        chart_filename = chart_sheet_chart_files.get(idx)
-        if chart_filename:
-            sheet_summary_map[idx] = f"`charts/{chart_filename}` (chart sheet — \"{raw_name}\")"
-        else:
-            sheet_summary_map[idx] = f"(chart sheet — \"{raw_name}\", 차트 데이터 추출 실패)"
-
-    # idx 순서대로 통합
-    for idx in sorted(sheet_summary_map.keys()):
-        sheet_summaries.append(sheet_summary_map[idx])
-
-    source_name, source_size = _source_meta(input_path, out_dir, source_name_override)
-    macro_modules = _extract_macros(_source_path(out_dir, source_name), out_dir)
+                    sheet_charts.setdefault(idx, []).append(chart_filename)
+
+            # Chartsheet 처리: 차트 데이터를 charts/sheet<idx>_chart.data.json 으로 저장
+            chart_sheet_chart_files: dict[str, str] = {}  # idx -> chart filename
+            for idx, safe_name, raw_name in chart_sheet_names:
+                cs = wb_formulas[raw_name]
+                chart = None
+                # Chartsheet.charts 또는 _charts 속성 (openpyxl 버전 따라 다름)
+                for attr in ("charts", "_charts"):
+                    v = getattr(cs, attr, None)
+                    if v:
+                        if hasattr(v, "__iter__"):
+                            try:
+                                chart = next(iter(v), None)
+                            except Exception:
+                                chart = None
+                        else:
+                            chart = v
+                        if chart is not None:
+                            break
+                if chart is None:
+                    # 단일 chart 속성 fallback
+                    chart = getattr(cs, "chart", None)
+                if chart is not None:
+                    try:
+                        data = _extract_openpyxl_chart_data(chart)
+                    except Exception:
+                        data = None
+                    if data is not None:
+                        _common.mkdir(charts_dir)
+                        chart_filename = f"sheet{idx}_chart.data.json"
+                        _common.write_text(
+                            charts_dir / chart_filename,
+                            json.dumps(data, ensure_ascii=False, indent=2),
+                        )
+                        chart_sheet_chart_files[idx] = chart_filename
+
+            # 워크북 단위 메타 (defined names·pivots·sheet codeName 등) — 시트 jsonl 외부 분리.
+            wb_meta = _workbook_meta(wb_formulas, input_path)
+            # VBA 시트 객체명 ↔ raw 시트명 매핑 (시트 codeName 기반)
+            sheet_code_map: dict[str, str] = {}
+            for ws in wb_formulas.worksheets:
+                code = getattr(ws.sheet_properties, "codeName", None)
+                if code:
+                    sheet_code_map[code] = ws.title
+            if sheet_code_map:
+                wb_meta["sheet_code_map"] = sheet_code_map
+            if wb_meta:
+                _common.write_text(
+                    out_dir / "workbook.meta.json",
+                    json.dumps(wb_meta, ensure_ascii=False, indent=2),
+                )
+        finally:
+            wb_values.close()
+            wb_formulas.close()
+
+        # 시트 PNG 는 데이터 영역(Find 범위) 만 캡처 → 데이터 영역 밖 이미지는 누락될 수 있음 →
+        # raw 이미지를 시트+셀 위치 정보 포함해서 별도 보존.
+        # openpyxl_input 사용: 정제본이 있으면 같은 정제본으로 로드(원본은 openpyxl 가 못 읽음).
+        sheet_images = _extract_xlsx_images_with_position(openpyxl_input, out_dir, sheet_names)
+        attachment_links = _extract_zip_media(
+            input_path,
+            out_dir,
+            media_zip_prefix="xl/media/",
+            embed_zip_prefix="xl/embeddings/",
+        )
 
-    sections: dict[str, list[str]] = {}
-    if sheet_summaries:
-        sections[f"시트 (총 {len(sheet_summaries)}개)"] = sheet_summaries
-    if macro_modules:
-        sections[f"VBA 매크로 (총 {len(macro_modules)}개)"] = [f"`macros/{m}`" for m in macro_modules]
+        # 시트별 산출물 풀목록 — 일반 시트 + chart sheet 통합, 시트 순서 (idx) 대로
+        sheet_summary_map: dict[str, str] = {}
+        for idx, safe_name, raw_name in sheet_names:
+            last_row, last_col = sheet_dims.get(idx, (0, 0))
+            formula_n = sheet_formula_count.get(idx, 0)
+            png_path = sheets_dir / f"{idx}_{safe_name}.png"
+            if png_path.exists():
+                parts = [f"`sheets/{idx}_{safe_name}.png`", "`.jsonl`"]
+            else:
+                # PNG 미생성 — worker 가 사유 전달 (16-bit cap / COM 실패 등)
+                reason = sheet_png_skipped.get(raw_name, "사유 미상")
+                parts = [f"`sheets/{idx}_{safe_name}.jsonl`", f"(PNG 미생성 — {reason})"]
+            chart_refs = sheet_charts.get(idx, [])
+            if chart_refs:
+                parts.append("(차트: " + ", ".join(f"`charts/{c}`" for c in chart_refs) + ")")
+            img_refs = sheet_images.get(raw_name, [])
+            if img_refs:
+                parts.append("(이미지: " + ", ".join(f"`images/{n}`" for n in img_refs) + ")")
+            meta = f"({last_row}행×{last_col}열"
+            if formula_n:
+                meta += f", 수식 {formula_n}개"
+            meta += ")"
+            sheet_summary_map[idx] = " ".join(parts) + " " + meta
 
-    _common.write_readme(
-        out_dir,
-        source_name=source_name,
-        source_size=source_size,
-        tool=("openpyxl + COM Excel + ZIP " + tool_extra).strip(),
-        loss_notes=(
-            "셀 서식(바탕색·border·폰트)·frozen·dims 미보존 (필요 시 _source.xlsx 직접 추출). "
-            "시각은 시트별 PNG, 분석 데이터(셀값·number_format·수식·merges·hyperlinks·comments) 는 "
-            "시트별 .jsonl 한 줄=한 행(좌표 명시), 워크북 단위 메타(defined names 등) 는 workbook.meta.json."
-        ),
-        sections=sections or None,
-        attachments=attachment_links,
-    )
+        for idx, safe_name, raw_name in chart_sheet_names:
+            chart_filename = chart_sheet_chart_files.get(idx)
+            if chart_filename:
+                sheet_summary_map[idx] = f"`charts/{chart_filename}` (chart sheet — \"{raw_name}\")"
+            else:
+                sheet_summary_map[idx] = f"(chart sheet — \"{raw_name}\", 차트 데이터 추출 실패)"
+
+        # idx 순서대로 통합
+        for idx in sorted(sheet_summary_map.keys()):
+            sheet_summaries.append(sheet_summary_map[idx])
+
+        source_name, source_size = _source_meta(input_path, out_dir, source_name_override)
+        macro_modules = _extract_macros(_source_path(out_dir, source_name), out_dir)
+
+        sections: dict[str, list[str]] = {}
+        if sheet_summaries:
+            sections[f"시트 (총 {len(sheet_summaries)}개)"] = sheet_summaries
+        if macro_modules:
+            sections[f"VBA 매크로 (총 {len(macro_modules)}개)"] = [f"`macros/{m}`" for m in macro_modules]
+
+        _common.write_readme(
+            out_dir,
+            source_name=source_name,
+            source_size=source_size,
+            tool=("openpyxl + COM Excel + ZIP " + tool_extra).strip(),
+            loss_notes=(
+                "셀 서식(바탕색·border·폰트)·frozen·dims 미보존 (필요 시 _source.xlsx 직접 추출). "
+                "시각은 시트별 PNG, 분석 데이터(셀값·number_format·수식·merges·hyperlinks·comments) 는 "
+                "시트별 .jsonl 한 줄=한 행(좌표 명시), 워크북 단위 메타(defined names 등) 는 workbook.meta.json."
+            ),
+            sections=sections or None,
+            attachments=attachment_links,
+        )
+    finally:
+        for _p in _xlsx_cleanups:
+            try:
+                _p.unlink()
+            except Exception:
+                pass
 
 
 # ====================================================================

package/claude/skills/sd-use/SKILL.md

@@ -3,7 +3,7 @@ name: sd-use
 description: 사용자 요청을 분석해 워크스페이스의 sd-* 스킬 중 가장 적합한 스킬을 추천하는 스킬. Use when 어떤 sd-* 스킬을 써야 할지 모를 때.
 ---
 
-`/sd-use <요청>` 의 `<요청>` 에 적합한 sd-* 스킬을 추천만 하고 종료. 자동 실행·산출물 생성 금지.
-- 시스템 프롬프트내 sd-* 스킬의 프론트매터를 활용함.
-- 추천 후보에서 sd-use 자신은 제외 (회귀 방지).
-- 추천할 여러 스킬이 있다면, 추천순대로 나열하고 각각의 추천 이유를 출력함.
+`/sd-use <요청>` 의 `<요청>` 에 적합한 sd-* 스킬을 추천만 출력하고 종료. 추천 대상 스킬의 자동 실행·산출물 생성 금지.
+- 시스템 프롬프트 내 sd-* 스킬의 프론트매터(name·description)를 매칭 근거로 사용.
+- 추천 후보에서 sd-use 자신은 제외 (자기 추천 방지).
+- 적합한 스킬이 여러 개면, 적합도 높은 순으로 나열하고 각 스킬마다 추천 이유를 함께 출력.