office-guardlisted
Install: claude install-skill procpalee/kr-accounting-skills
# office-guard - 사람이 고친 문서를 코드가 덮어쓰지 못하게
설치: 폴더를 넣은 뒤 `settings.json` 에 `PYTHONPATH` 와 훅을 넣어야 작동한다 - [references/install.md](references/install.md).
## 어떻게 지키나
| 층 | 파일 | 맡는 일 |
|---|---|---|
| 파이썬 안 | `runtime/sitecustomize.py` (settings.json `env.PYTHONPATH`) | openpyxl·python-docx·python-pptx·xlsxwriter·dsdxlsx·pandas 저장, `shutil.copy*`·`shutil.move`·`os.replace`·`os.rename`, pywin32 COM 의 `Save`·`SaveAs`·`SaveAs2`·`SaveCopyAs`·`Close(SaveChanges=True)` |
| 도구 호출 | `hooks/office_guard_hook.py` (settings.json PreToolUse·PostToolUse) | Write·Edit, cp·mv·copy·Copy-Item·Move-Item, 리다이렉트, Set-Content·Out-File·tee, COM `.SaveAs("경로")`, 판 이름 사본 |
| 판단 | `office_guard.py` | 위 둘이 함께 쓰는 판단(`judge`)·장부·백업·CLI |
저장해도 되는 경우: 파일이 없음, 임시 폴더·`_backup`·`_xlsync`·`_docsync` 안, 코드가 저장한 내용 그대로, 기준본과 같음, git 에 커밋된 그대로.
같은 파일을 불러와 고쳐 같은 경로에 저장하는 부분 편집은 백업 뒤 허용하되 코드 소유로 치지 않는다 - 그 뒤 빌더로 새로 만들면 여전히 거부된다.
그 밖은 거부한다. 기록이 없는 기존 파일도 사람이 고친 것으로 본다.
파이썬에서 COM 으로 저장할 때도 덮어쓰기 전에 판단한다 - 사람 파일 위 `SaveAs`·`SaveCopyAs` 는 엑셀이 쓰기 전에 거부되고, 연 파일의 `Save` 는 부분 편집으로 백업 뒤 통과한다.
## 복사·이동은 내용의 주인을 바꾸지 않는다
- 코드가 만든 파일을 복사·이동하면 사본도 코드 소유다.
- 사람 파일을 **복사**하면 사본은 그 경로에서만 코드 소유다(장부 키 `<내용>@<경로>`). 사본은 빌더가 덮어쓸 수 있고, 내용이 같은 원본은 계속 사람 파일이다.
- 사람 파일을 **이동**하면(원본이 사라짐) 옮긴 파일은 계속 사람 파일이다.
- `_backup` 에 남기는 백업은 장부에 올리지 않는다.
- 셸 명령의 원천이 변수·와일드카드라 이름을 알 수 없으면 문서로 보고 같은 규칙을 적용한다.
## "[저장 거부]"가 떴을 때
1. 임시 폴더나 다른 이름으로 출력해 결과를 보여 준다. 빌더의 출력 경로를 인자로 받게 고친다.
2. 사람이 고친 내용을 코드에 옮길 때는 `excel-sync` 흐름(diff → 코드 반영 → 임시 재생성 → verify → sn