excel-synclisted
Install: claude install-skill procpalee/kr-accounting-skills
# excel-sync - 엑셀에서 고친 것을 코드로
도구: `python -X utf8 ~/.claude/skills/excel-sync/xlsync.py <명령>` (openpyxl·olefile, 엑셀 재저장 비교는 pywin32 + 엑셀 필요)
결과물은 엑셀 파일 옆 `_xlsync/<파일이름>/` 에만 남는다(base.json·원본 사본·prov.json·diff_시각.md/.json·history/).
snap 은 새 기준본을 임시 파일로 다 만든 뒤에만 옛 것을 history/ 로 보낸다 - 도중에 실패해도 기존 기준본은 그대로다.
## 원칙
- **찾기는 도구가, 고치기는 Claude 가, 확인은 다시 도구가.** 바뀐 점 목록·코드 위치·남은 차이는 도구 출력을 그대로 쓰고 추측하지 않는다.
- 사용자가 고친 엑셀은 **절대 덮어쓰지 않는다.** 코드로 다시 만든 파일은 임시 경로에 쓰고 `verify` 로만 비교한다.
- `verify` 가 차이 0 을 내기 전에는 "반영 완료"라고 말하지 않는다. 남은 차이는 목록 그대로 보고하고 이유를 붙인다.
- `--ignore` 를 쓰면 무엇을 왜 뺐는지 보고에 적는다.
## 1. 기준본 남기기 - Claude 가 엑셀을 만들거나 고친 직후 (매번)
- 생성 스크립트가 있으면 기록을 켜고 실행: `xlsync.py record --prov <임시>/build.prov.json -- <빌드.py> [인자]`
(COM 후처리·체크박스 부착 같은 단계는 그다음 평소대로)
- 최종 파일로 기준본: `xlsync.py snap <최종 엑셀> --prov <임시>/build.prov.json --label "<차수·설명>"`
- 생성 스크립트가 없는 파일(사람이 만든 템플릿 등): `xlsync.py snap <엑셀> --label ...`
- 생성 코드가 출력 경로를 고정해 두었으면 임시 경로를 받을 수 있게(인자·환경변수) 먼저 고친다 - 검증용 재생성이 사용자가 고친 파일을 덮어쓰면 안 된다.
- 기준본은 파일 옆 `_xlsync/` 에 남으므로 고객 자료 폴더 밖(깃 저장소 등)으로 옮기지 않는다.
- 사용자에게 "엑셀에서 고치고 저장한 뒤 알려 주면 바뀐 부분을 찾아 코드에 반영한다"고 한 줄 안내.
## 2. 사용자가 고쳤다고 할 때
1. `xlsync.py status <엑셀>` → 바뀌지 않았으면 그렇게 답하고 끝.
2. `xlsync.py diff <엑셀> --code <코드 폴더>` → 표를 읽는다(문구 검색은 코드·설정 파일만 - .md·.txt·.csv·한 줄짜리 덤프 제외, 생성 기록이 있으면 --code 생략 시 그 스크립트 폴더). 열마다: 종류 · 위치(현재 주소) · 기준 위치 · 전→후 · 코드(쓴 곳 = 생성 기록의 파일:줄, 문구 = 코드에 같은 문자열이 적힌 줄).
3. 변경마다 반영 방법을 정한다.
- **코드 수정**: 쓴 곳/문구 위치가 상수·문구 표·서식 헬퍼·열너비 설정이면 그 줄을 고친다(같은 패턴이 여러 칸에 쓰이는지 확인