@simplysm/sd-claude 14.0.79 → 14.0.81

package/claude/skills/sd-spec/references/example-spec.md

@@ -75,8 +75,7 @@ flowchart LR
 
 ### 2.2 출고 [OPEN: 2026-04-01]
 
-- 자료 위치: 회의록.md L40-50
-- 대화 발췌: 사용자 — "출고 부분은 입고 끝나고 다음 단계에서 보자"
+분석 방법: 회의록.md L40-50 재독 (입고 분석 끝난 후). 사용자 보류 발언 — "출고 부분은 입고 끝나고 다음 단계에서 보자".
 
 ## 3. 기타 요구사항
 
@@ -112,7 +111,7 @@ Actor: 창고 관리자
 
 - 품목 마스터 CRUD (등록 / 편집 / 삭제·복구 / 엑셀 업·다운로드)
 
-와이어프레임:
+#### 와이어프레임
 
 ```
 ┌──────────────────────────────────────────────────────────────────────────┐
@@ -126,7 +125,7 @@ Actor: 창고 관리자
 └──────────────────────────────────────────────────────────────────────────┘
 ```
 
-항목:
+#### 항목
 
 **필터**
 
@@ -143,7 +142,7 @@ Actor: 창고 관리자
 | 코드  | 문자             | -    | [모델.품목.코드] |                               |
 | 명칭  | 문자             | -    | [모델.품목.명칭] |                               |
 
-동작:
+#### 동작
 
 - `[조회]` 클릭: 검색 필터 조건으로 목록 갱신
 - `[등록]` 클릭: [화면.품목 등록·편집] 을 빈 폼으로 모달 띄움
@@ -152,15 +151,15 @@ Actor: 창고 관리자
 - `[선택 복구]` 클릭: 선택된 행들의 활성 여부 true 전환
 - `[엑셀 업로드]` 클릭: 엑셀 파일 선택 → 코드 기준 일괄 등록/수정
 - `[엑셀 다운로드]` 클릭: 현재 검색 필터 적용된 목록을 엑셀로 내보내기
-- `[화주 자료 업로드]` 클릭: [공통 정의.화주 품목 자료] 파일 선택 → 아래 양식 매핑 적용 후 코드 기준 일괄 등록/수정
+- `[화주 자료 업로드]` 클릭: [공통 정의.화주 품목 자료] 파일 선택 → 아래 업로드 양식 적용 후 코드 기준 일괄 등록/수정
 
-시각 규칙:
+#### 시각 규칙
 
 - 비활성 행: 전체 취소선 + 회색
 
-양식 매핑:
+#### 업로드 양식
 
-**업로드 양식** ([공통 정의.화주 품목 자료] → [모델.품목])
+[공통 정의.화주 품목 자료] → [모델.품목]
 
 | 파일 컬럼          | 도메인 모델      | 변환·규칙                        |
 | ------------------ | ---------------- | -------------------------------- |
@@ -176,7 +175,7 @@ Actor: 창고 관리자
 
 - 품목 신규 등록 또는 기존 품목 편집 (호출하는 쪽에서 빈 폼/기존 데이터로 모달 띄움)
 
-와이어프레임:
+#### 와이어프레임
 
 ```
 ┌──────────────────────────────────────┐
@@ -188,7 +187,7 @@ Actor: 창고 관리자
 └──────────────────────────────────────┘
 ```
 
-항목:
+#### 항목
 
 **입력 폼**
 
@@ -197,7 +196,7 @@ Actor: 창고 관리자
 | 코드 | 텍스트 입력 | O    | [모델.품목.코드] |      |
 | 명칭 | 텍스트 입력 | O    | [모델.품목.명칭] |      |
 
-동작:
+#### 동작
 
 - `[저장]` 클릭: 활성 품목 내 코드·명칭 유일성 검증 → 저장 → 모달 닫음
 - `[취소]` 클릭: 변경 사항 폐기 → 모달 닫음
@@ -212,7 +211,7 @@ Actor: 창고 관리자
 - Location 마스터 CRUD (등록 / 편집 / 삭제·복구 / 엑셀 업·다운로드)
 - 두 가지 바코드 출력: A4 다중 + 라벨프린터 1매씩
 
-와이어프레임:
+#### 와이어프레임
 
 ```
 ┌────────────────────────────────────────────────────────────────────────────────────┐
@@ -225,7 +224,7 @@ Actor: 창고 관리자
 └────────────────────────────────────────────────────────────────────────────────────┘
 ```
 
-항목:
+#### 항목
 
 **필터**
 
@@ -241,7 +240,7 @@ Actor: 창고 관리자
 | ID    | 숫자 + 편집 버튼 | -    | [모델.Location.ID]   | 클릭 시 편집 모달             |
 | 코드  | 문자             | -    | [모델.Location.코드] |                               |
 
-동작:
+#### 동작
 
 - `[조회]` 클릭: 검색 필터 조건으로 목록 갱신
 - `[등록]` 클릭: [화면.Location 등록·편집] 을 빈 폼으로 모달 띄움
@@ -261,7 +260,7 @@ Actor: 창고 관리자
     1. 선택된 Location 을 [공통 정의.Location 라벨] 규격으로 라벨프린터 1매씩 출력
     2. 다중 선택 시 선택 수만큼 연속 출력
 
-시각 규칙:
+#### 시각 규칙
 
 - 비활성 행: 전체 취소선 + 회색
 
@@ -274,7 +273,7 @@ Actor: 창고 관리자
 
 - Location 신규 등록 또는 기존 Location 편집 (호출하는 쪽에서 빈 폼/기존 데이터로 모달 띄움)
 
-와이어프레임:
+#### 와이어프레임
 
 ```
 ┌──────────────────────────────────────┐
@@ -286,7 +285,7 @@ Actor: 창고 관리자
 └──────────────────────────────────────┘
 ```
 
-항목:
+#### 항목
 
 **입력 폼**
 
@@ -294,7 +293,7 @@ Actor: 창고 관리자
 | ---- | ----------- | ---- | -------------------- | ----------------------- |
 | 코드 | 텍스트 입력 | O    | [모델.Location.코드] | 영문 대문자/숫자/하이픈 |
 
-동작:
+#### 동작
 
 - `[저장]` 클릭: 활성 Location 내 코드 유일성 검증 → 저장 → 모달 닫음
 - `[취소]` 클릭: 변경 사항 폐기 → 모달 닫음
@@ -308,7 +307,7 @@ Actor: 창고 작업자
 
 - 박스 → Location 순서로 스캔하여 재고 등록
 
-와이어프레임:
+#### 와이어프레임
 
 ```
 ┌────────────────────────┐
@@ -321,7 +320,7 @@ Actor: 창고 작업자
        (360 × 568)
 ```
 
-항목:
+#### 항목
 
 **스캔 입력 폼**
 
@@ -330,7 +329,7 @@ Actor: 창고 작업자
 | 박스 바코드 | 텍스트 입력 | O    | -                    | PDA 스캐너 입력. 파싱 = 품목코드 + 수량 + 박스번호 |
 | Location    | 텍스트 입력 | O    | [모델.Location.코드] | PDA 스캐너 입력                                    |
 
-동작:
+#### 동작
 
 - `[등록]` 클릭:
   - 절차:
@@ -349,7 +348,7 @@ Actor: 창고 관리자
 - 현재 재고: Location 별 적치된 박스 + 품목·수량 조회
 - 과거 시점 재고: 특정 날짜의 스냅샷 조회
 
-와이어프레임:
+#### 와이어프레임
 
 ```
 ┌──────────────────────────────────────────────────────────────────────────┐
@@ -362,7 +361,7 @@ Actor: 창고 관리자
 └──────────────────────────────────────────────────────────────────────────┘
 ```
 
-항목:
+#### 항목
 
 **필터**
 
@@ -381,7 +380,7 @@ Actor: 창고 관리자
 | 품목     | 문자 | -    | [모델.재고.박스.품목.코드] | 품목 코드 표시 |
 | 수량     | 숫자 | -    | [모델.재고.박스.수량]      |                |
 
-동작:
+#### 동작
 
 - `[조회]` 클릭:
   - 기준일 비어있음: 현재 [모델.재고] 조회
@@ -393,68 +392,49 @@ Actor: 창고 관리자
 
 ### 5.1 재고 스냅샷 [확정: 2026-04-01]
 
-```mermaid
-flowchart LR
-    S([매일 0시]) --> T1[현재 재고 전체 조회]
-    T1 --> T2[스냅샷 테이블에 날짜별 저장]
-    T2 --> E1([완료])
-```
+목적: 과거 시점 재고 조회 지원
 
-목적:
+트리거: 매일 0시 정각
 
-- 과거 시점 재고 조회 지원
-
-트리거:
-
-- 매일 0시 정각
+관련 섹션: [기타.과거 재고 조회], [화면.재고 확인]
 
-처리:
+#### 처리
 
 - [모델.재고] 전체를 [모델.재고 스냅샷] 에 날짜별로 저장
 
-예외 처리:
+#### 예외 처리
 
 - 스냅샷 생성 실패 시:
   - 위험: 당일 분 누락 시 해당 날짜의 과거 시점 조회 불가
   - 대처: 관리자 알림. 동일 일자 재실행 시 (날짜, 박스) 유일성 검증으로 중복 생성 방지
   - 재시도 한계: 별도 재시도 없음 (다음 날 0시 정상 동작)
 
-관련 섹션: [기타.과거 재고 조회], [화면.재고 확인]
-
 ## 6. 횡단 처리
 
 ### 6.1 마스터 데이터 변경 이력 [확정: 2026-04-01]
 
-```mermaid
-flowchart LR
-    S([마스터 엔티티 insert/update/delete]) --> T1[변경 전·후 값 캡처]
-    T1 --> T2[DataLog 테이블에 한 행 적재]
-    T2 --> E1([완료])
-```
-
-목적:
-
-- 마스터 변경 추적·감사 (누가 언제 무엇을 어떻게 바꿨는지)
+목적: 마스터 변경 추적·감사 (누가 언제 무엇을 어떻게 바꿨는지)
 
 트리거 (부수효과 발동 조건):
-
 - 마스터 엔티티의 insert / update / delete 트랜잭션 commit 시
 - 적용 범위: [모델.품목], [모델.Location]
 - 적용 제외: 트랜잭션 모델 ([모델.재고], [모델.재고 스냅샷])
 
-처리:
+관련 섹션: [기타.마스터 데이터 변경 이력], [모델.품목], [모델.Location], [모델.DataLog]
+
+#### 처리
 
 - 변경 전 값과 변경 후 값 캡처 (insert 시 변경 전 = null, delete 시 변경 후 = null)
 - [모델.DataLog] 에 한 행 적재 (테이블·키·전·후·작업자·시각)
 
-예외 처리:
+#### 예외 처리
 
 - DataLog 적재 실패 시:
   - 위험: 변경 추적 누락
   - 대처: 본 트랜잭션은 정상 commit 유지, DataLog 적재 실패만 별도 큐로 적재 후 관리자 알림
   - 재시도 한계: 큐에서 5회 지수 백오프 후 운영팀 알림
 
-모델 매핑:
+#### 모델 매핑
 
 | 필드 ([모델.DataLog]) | 용도                            |
 | --------------------- | ------------------------------- |
@@ -465,8 +445,6 @@ flowchart LR
 | [모델.DataLog.작업자]   | 세션 사용자                   |
 | [모델.DataLog.시각]     | 변경 commit 시각              |
 
-관련 섹션: [기타.마스터 데이터 변경 이력], [모델.품목], [모델.Location], [모델.DataLog]
-
 ## 7. 공통 정의
 
 ### 7.1 용어 사전 [확정: 2026-04-01]
@@ -478,8 +456,7 @@ flowchart LR
 
 ### 7.2 박스 바코드 형식 [OPEN: 2026-04-01]
 
-- 자료 위치: 첨부B.pdf p.5 "박스 코드 체계" — 외부 송장 시스템 규격 명세
-- 자료 연결 메모: 박스 코드는 외부 규격이지만 [모델.박스] 식별 키 구조와 직결 — §8 박스 확정과 함께 검토
+분석 방법: 첨부B.pdf p.5 "박스 코드 체계" (외부 송장 시스템 규격) 분석. [모델.박스] 식별 키 구조와 직결 — §8 박스 확정과 함께 검토.
 
 ### 7.3 Location 라벨 [확정: 2026-04-01]
 
@@ -621,7 +598,9 @@ flowchart LR
 - 방향: WMS → ERP
 - 전송 방식: REST API (POST)
 
-자료 매핑:
+관련 섹션: [화면.입고 스캔]
+
+#### 자료 매핑
 
 | ERP 필드 | WMS 출처              |
 | -------- | --------------------- |
@@ -630,7 +609,7 @@ flowchart LR
 | 박스번호 | [모델.박스.박스번호]  |
 | 발생시각 | 입고 등록 시각        |
 
-예외 처리:
+#### 예외 처리
 
 - 호출 실패 (네트워크 오류, ERP 서버 일시 다운 등):
   - 위험: 단순 재시도 시 ERP 에 같은 박스가 2번 입고 등록될 수 있음 (첫 호출이 실제로는 ERP 에 도달했는데 응답만 못 받은 경우 등)
@@ -638,9 +617,7 @@ flowchart LR
   - 대처: 위 전제 하에 지수 백오프로 재시도, 최대 5회
   - 재시도 한계 초과: 관리자 알림 (이후 수동 확인 필요)
 
-관련 섹션: [화면.입고 스캔]
-
-## 10. 본문 외 결정사항
+## 10. 본문 외 확정 사항
 
 - 2026-04-01 [제외]: 직원 관리 사원번호 컬럼 추가
   - 근거: 본 spec 범위 밖 — 인사 마스터 영역

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>/` 폴더가 있으면 호출 X.
 
 ---
 
@@ -12,9 +12,9 @@ description: 메일·문서(eml/msg/pdf/docx/pptx/xlsx/xlsb, 레거시 doc/ppt/x
 python .claude/skills/sd-unpack/scripts/unpack.py <입력파일 절대경로>
 ```
 
-스크립트가 형식 분기·재귀 풀이·README 생성까지 알아서 처리한다. stdout 으로 결과 폴더 절대경로가 출력된다.
+스크립트가 형식 분기·재귀 풀이·README 생성까지 알아서 처리함. stdout 으로 결과 폴더 절대경로가 출력됨.
 
-여러 파일을 풀어달라는 요청이 오면 단일 파일 단위로 반복 호출한다.
+여러 파일을 풀어달라는 요청이 오면 단일 파일 단위로 반복 호출함.
 
 ## 환경
 
@@ -22,11 +22,11 @@ Windows + MS Office 필요 (docx/pptx/xlsx 변환). Python 패키지 의존은 `
 
 ## 결과 폴더
 
-입력 파일 옆에 `<basename>_<ext>/` 가 생긴다. 컨테이너 첨부는 같은 패턴으로 재귀적으로 풀린다. 폴더 안 `_source.<ext>` + `README.md` 가 풀린 폴더의 식별 마커.
+입력 파일 옆에 `<basename>_<ext>/` 가 생김. 컨테이너 첨부는 같은 패턴으로 재귀적으로 풀림. 폴더 안 `_source.<ext>` + `README.md` 가 풀린 폴더의 식별 마커.
 
 동일 입력 재호출 시 기존 결과 폴더는 사전 삭제 후 재생성 (이전 산출 잔존물 섞이지 않게).
 
-시각은 PNG, 텍스트/구조는 JSONL/JSON/MD 로 분리해 출력한다.
+시각은 PNG, 텍스트/구조는 JSONL/JSON/MD 로 분리해 출력함.
 
 ```
 meeting_eml/
@@ -72,66 +72,66 @@ meeting_eml/
 모든 jsonl 출력은 **한 줄 = 한 노드 (또는 한 행/셀)**. 빈 키 생략. JSON 네이티브 타입 보존. datetime → ISO 8601 문자열.
 
 조회 패턴:
-- 좌표·인덱스 직격 grep (`"r":11`·`"slide":5`·`"node":42`)
-- 키 grep (`"type":"heading"`·`"_f"` 수식 행만)
-- Read offset = 행/노드 인덱스 1:1 (빈 노드도 한 줄 유지)
+- 좌표·인덱스 직격 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` 직접 추출).
 
-- 첫 줄: `{"_meta":{"merges":["A1:C1",...], "number_formats":{"E1":"yyyy-mm-dd",...}, "hyperlinks":{"D5":"http://..."}, "comments":{"E3":"메모"}}}`
-  - `merges`: 머지된 셀 영역 (셀 좌표 해석에 필수 — 머지 영역 안 빈 셀 오해 차단)
-  - `number_formats`: General(기본) 외 셀 표시 형식 — Date·통화·% 등 셀 값 의미 단서
-  - `hyperlinks`: 셀 URL (URL 자체가 셀 정보)
-  - `comments`: 셀 메모
-  - 비어있는 메타 키는 생략 (모두 비면 `{"_meta":{}}`)
-- 데이터 줄: `{"r":11, "A":"P001", "I":7800, "J":12.5, "_f":{"I":"=SUM(...)", "J":"=I11*1.5"}}`
-  - `r`: 1-based 행번호 (Excel 동일)
-  - 열문자 키 (`A`·`B`·...·`AA`·...): 셀 값. 빈 셀은 키 생략
-  - `_f`: 같은 행 수식 맵 `{열문자: 수식문자열}`. 수식 없는 행은 키 생략
-- 빈 행도 `{"r":N}` 한 줄 유지 → Read offset = 행번호 (오프바이원 차단)
-- 값 타입: JSON 네이티브 (`int`·`float`·`bool`·`str`), datetime 은 ISO 8601 문자열
+- 첫 줄: `{"_meta":{"merges":["A1:C1",...], "number_formats":{"E1":"yyyy-mm-dd",...}, "hyperlinks":{"D5":"http://..."}, "comments":{"E3":"메모"}}}`.
+  - `merges`: 머지된 셀 영역 (셀 좌표 해석에 필수 — 머지 영역 안 빈 셀 오해 차단).
+  - `number_formats`: General(기본) 외 셀 표시 형식 — Date·통화·% 등 셀 값 의미 단서.
+  - `hyperlinks`: 셀 URL (URL 자체가 셀 정보).
+  - `comments`: 셀 메모.
+  - 비어있는 메타 키는 생략 (모두 비면 `{"_meta":{}}`).
+- 데이터 줄: `{"r":11, "A":"P001", "I":7800, "J":12.5, "_f":{"I":"=SUM(...)", "J":"=I11*1.5"}}`.
+  - `r`: 1-based 행번호 (Excel 동일).
+  - 열문자 키 (`A`·`B`·...·`AA`·...): 셀 값. 빈 셀은 키 생략.
+  - `_f`: 같은 행 수식 맵 `{열문자: 수식문자열}`. 수식 없는 행은 키 생략.
+- 빈 행도 `{"r":N}` 한 줄 유지 → Read offset = 행번호 (오프바이원 차단).
+- 값 타입: JSON 네이티브 (`int`·`float`·`bool`·`str`), datetime 은 ISO 8601 문자열.
 
 ### Chartsheet (시트 자체가 차트)
 
 xlsx 안 시트는 일반 Worksheet 외에 **Chartsheet** (셀 없이 차트 1개) 도 있을 수 있음.
 
-- Chartsheet 는 `sheets/<idx>_<name>.jsonl` 미생성 (셀 없음)
-- Chartsheet 의 차트 데이터: `charts/sheet<idx>_chart.data.json`
-- README sheet_summaries 에 `(chart sheet — "...")` 명시
-- 일반 시트·Chartsheet 통합 시트 순서 (idx) 대로 보존
+- Chartsheet 는 `sheets/<idx>_<name>.jsonl` 미생성 (셀 없음).
+- Chartsheet 의 차트 데이터: `charts/sheet<idx>_chart.data.json`.
+- README sheet_summaries 에 `(chart sheet — "...")` 명시.
+- 일반 시트·Chartsheet 통합 시트 순서 (idx) 대로 보존.
 
 ### 워크북 단위 `workbook.meta.json`
 
 시트 외 워크북 공통 정보 (있을 때만 생성):
 
-- `defined_names`: `{"이름":["'Sheet1'!$A$1:$C$10", ...]}` (다중 destination 시 list 다수 항목)
-- `sheet_code_map`: `{"Sheet1":"BOA", ...}` (VBA codeName → raw 시트명. 매크로 모듈 파일명과 매칭용)
-- `pivots`: pivot table 정의 list. 각 항목 `{name, source, location, rowFields, colFields, pageFields, dataFields}`. 결과 셀은 시트별 jsonl 에 일반 셀로 들어감
+- `defined_names`: `{"이름":["'Sheet1'!$A$1:$C$10", ...]}` (다중 destination 시 list 다수 항목).
+- `sheet_code_map`: `{"Sheet1":"BOA", ...}` (VBA codeName → raw 시트명. 매크로 모듈 파일명과 매칭용).
+- `pivots`: pivot table 정의 list. 각 항목 `{name, source, location, rowFields, colFields, pageFields, dataFields}`. 결과 셀은 시트별 jsonl 에 일반 셀로 들어감.
 
 ## pptx jsonl 규약
 
 슬라이드별 `slides/<idx>_<title>.jsonl`. 원본 XML 순서 (shape_idx 순) 그대로. 시각 순서는 `pos` 좌표 기반으로 Claude 가 필요시 정렬.
 
-- 첫 줄: `{"_meta":{"slide":N, "title":"슬라이드 제목 또는 빈 문자열", "size":[w,h], "shapes":S}}`
-  - `size`: 슬라이드 폭/높이 (EMU 단위, python-pptx 원본)
-  - `shapes`: 노드 수
-- 노드 줄: `{"slide":N, "type":"<type>", "pos":[x,y,w,h], "shape_idx":S, ...추가 키}`
-  - `slide`: 1-based 슬라이드 번호
-  - `type`: 노드 종류 (아래)
-  - `pos`: [x,y,w,h] EMU 좌표 (914400 EMU = 1 inch)
-  - `shape_idx`: 원본 XML shape index (0-based)
+- 첫 줄: `{"_meta":{"slide":N, "title":"슬라이드 제목 또는 빈 문자열", "size":[w,h], "shapes":S}}`.
+  - `size`: 슬라이드 폭/높이 (EMU 단위, python-pptx 원본).
+  - `shapes`: 노드 수.
+- 노드 줄: `{"slide":N, "type":"<type>", "pos":[x,y,w,h], "shape_idx":S, ...추가 키}`.
+  - `slide`: 1-based 슬라이드 번호.
+  - `type`: 노드 종류 (아래).
+  - `pos`: [x,y,w,h] EMU 좌표 (914400 EMU = 1 inch).
+  - `shape_idx`: 원본 XML shape index (0-based).
 
 노드 type:
-- `title`: 슬라이드 제목 placeholder. 키 `text`·`para_idx`
-- `para`: 일반 문단. 키 `text`·`para_idx`
-- `bullet`: 글머리 항목 (paragraph.level > 0). 키 `text`·`para_idx`·`level`
-- `table_cell`: 표 셀. 키 `table_idx`·`row`·`col` (1-based)·`text`
-  - 셀 안 multi-paragraph 는 `\n` join
-- `image`: 그림. 키 `ref` (`images/...` 상대경로)
-- `chart`: 차트. 키 `ref` (`charts/...` 상대경로)
-- `shape`: 도형/SmartArt/그룹. 키 `subtype`
+- `title`: 슬라이드 제목 placeholder. 키 `text`·`para_idx`.
+- `para`: 일반 문단. 키 `text`·`para_idx`.
+- `bullet`: 글머리 항목 (paragraph.level > 0). 키 `text`·`para_idx`·`level`.
+- `table_cell`: 표 셀. 키 `table_idx`·`row`·`col` (1-based)·`text`.
+  - 셀 안 multi-paragraph 는 `\n` join.
+- `image`: 그림. 키 `ref` (`images/...` 상대경로).
+- `chart`: 차트. 키 `ref` (`charts/...` 상대경로).
+- `shape`: 도형/SmartArt/그룹. 키 `subtype`.
 
 paragraph 안 hyperlink 가 있으면 `hyperlinks`: `[{"text":"...", "url":"..."}, ...]` 추가 키 (run 단위).
 
@@ -141,37 +141,37 @@ paragraph 안 hyperlink 가 있으면 `hyperlinks`: `[{"text":"...", "url":"..."
 
 문서 단일 시퀀스 `content.jsonl`. 페이지 단위 폐기 (Word 렌더 산물). 원본 = python-docx 의 문단/표/이미지 시퀀스.
 
-- 첫 줄: `{"_meta":{"paragraphs":P, "tables":T, "images":I}}`
-- 노드 줄: `{"node":N, "type":"<type>", ...추가 키}`
-  - `node`: 0-based 시퀀스 인덱스 (Read offset = node)
+- 첫 줄: `{"_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)
-- `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 만)
-- `image`: 키 `ref` (`images/...` 상대경로)
+- `heading`: 키 `text`·`level` (1·2·3·...) — docx Heading 스타일 기반만 (휴리스틱 추정 X).
+- `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 만).
+- `image`: 키 `ref` (`images/...` 상대경로).
 
 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 비교
+- `{"001":{"text":"<페이지 평문>"}, "002":{...}, ...}` (PNG 페이지 ↔ fitz 추출 raw text).
+- PNG 는 fitz 페이지 분할 그대로 (시각 검증용).
+- 노드 인덱스 자동 매핑은 미적용 (fitz·python-docx 텍스트 분할 차이로 오매핑 위험) — Claude 가 페이지 text 와 content.jsonl 노드 text 를 직접 grep 비교.
 
 ## pdf jsonl 규약
 
 페이지별 `pages/<NNN>.jsonl`. PDF 페이지는 원본 단위.
 
-- 첫 줄: `{"_meta":{"page":N, "size":[w,h], "blocks":B, "tables":T, "table_cells":C, "form_fields":F, "annotations":A}}`
+- 첫 줄: `{"_meta":{"page":N, "size":[w,h], "blocks":B, "tables":T, "table_cells":C, "form_fields":F, "annotations":A}}`.
 - 노드 줄:
-  - `text_block`: `{"page":N, "block":B, "type":"text_block", "bbox":[x0,y0,x1,y1], "text":"..."}`
-  - `image_block`: `{"page":N, "block":B, "type":"image_block", "bbox":[...], "ref":"images/p001_b03.png"}`
-  - `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 가 양쪽 비교 판단
-- bbox 는 PDF 기준 좌표 (left-top, pt 단위, raw float)
+  - `text_block`: `{"page":N, "block":B, "type":"text_block", "bbox":[x0,y0,x1,y1], "text":"..."}`.
+  - `image_block`: `{"page":N, "block":B, "type":"image_block", "bbox":[...], "ref":"images/p001_b03.png"}`.
+  - `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 가 양쪽 비교 판단.
+- bbox 는 PDF 기준 좌표 (left-top, pt 단위, raw float).
 
 heading 추출은 미적용 (PDF 는 style 정보 없음). OCR 미적용 (스캔 PDF 는 image_block 만 추출).
 
@@ -179,11 +179,11 @@ heading 추출은 미적용 (PDF 는 style 정보 없음). OCR 미적용 (스캔
 
 본문 안 `<img cid:...>` 가 첨부의 어느 파일인지 추적.
 
-- `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` 미생성
+- `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) 풀이
 
@@ -195,27 +195,27 @@ Outlook RTF 메일이 첨부를 `winmail.dat` 단일 binary (TNEF 형식) 로
 
 본문 흐름 정확성(text/plain 우선) + 인라인 이미지 위치 단서(HTML→평문 변환본) 둘 다 보존:
 
-- `body.md`: 항상 별도 파일 (인라인 cutoff 폐기)
-  - text/plain 있으면 우선 — 발신자가 의도한 평문, 변환 잡음 없음
-  - 없으면 text/html → 평문 추출
-- `body.from_html.md`: text/plain·HTML 둘 다 있을 때만 별도 생성
-  - HTML→평문 변환 (이미지 위치 placeholder 포함)
-  - body.md 가 plain 이라 잃은 위치 정보를 보완
-- `body.html`: 원본 HTML (있을 때)
-- `headers.json`: 모든 메일 헤더 원본 보존 (envelope + `X-Mailer`·`Authentication-Results` 등 모두). 동일 키 다수면 list 누적
-  - README 헤더 섹션에는 표준 envelope 키만 표기 (전체는 headers.json 직접 조회)
+- `body.md`: 항상 별도 파일 (인라인 cutoff 폐기).
+  - text/plain 있으면 우선 — 발신자가 의도한 평문, 변환 잡음 없음.
+  - 없으면 text/html → 평문 추출.
+- `body.from_html.md`: text/plain·HTML 둘 다 있을 때만 별도 생성.
+  - HTML→평문 변환 (이미지 위치 placeholder 포함).
+  - body.md 가 plain 이라 잃은 위치 정보를 보완.
+- `body.html`: 원본 HTML (있을 때).
+- `headers.json`: 모든 메일 헤더 원본 보존 (envelope + `X-Mailer`·`Authentication-Results` 등 모두). 동일 키 다수면 list 누적.
+  - README 헤더 섹션에는 표준 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 매크로는 원본 코드 그대로 `macros/<모듈명>.vba` 저장 (변형 X).
+- 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"` (수식 행) · 열문자 키
-- pptx: `"slide":<N>` · `"type":"<type>"` · `"shape_idx":<S>`
-- docx: `"node":<N>` · `"type":"heading"` · `"table_idx":<T>`
+- xlsx: `"r":<행>` · `"_f"` (수식 행) · 열문자 키.
+- pptx: `"slide":<N>` · `"type":"<type>"` · `"shape_idx":<S>`.
+- docx: `"node":<N>` · `"type":"heading"` · `"table_idx":<T>`.

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simplysm/sd-claude",
-  "version": "14.0.79",
+  "version": "14.0.81",
   "description": "심플리즘 패키지 - Claude Code 셋업",
   "author": "심플리즘",
   "license": "Apache-2.0",