docx skill: Word 문서 읽기·쓰기·편집

누구에게 맞나

에이전트에서 Word 문서(.docx / .dotx)를 만들거나 읽고 편집·처리해야 하는 사람에게 맞다. 보고서, 메모, 편지, 템플릿, 기존 Word에서 추출·재배치·이미지 교체·찾아 바꾸기·변경 내용과 댓글이다. 증거는 사용자가 Word 문서, .docx, .dotx를 말하거나 목차·제목·쪽 번호·레터헤드가 있는 공식 문서를 요청할 때 이 skill을 쓰라고 한다.

PDF, 스프레드시트, Google Docs, 문서 생성과 무관한 일반 코딩에는 맞지 않는다. 증거는 Do NOT use로 이 경계를 고정한다. 다른 형식으로 넓히지 마라.

의존성을 먼저 인정하라: docx(npm, 사전 설치), pandoc, LibreOffice(soffice), pdftoppm(Poppler). 읽기 경로에 필요한 pandoc이 없으면 첫 읽기가 진행되지 않는다. 어떤 에이전트 마켓에 설치해야 하는지는 증거에 없으니 스토어나 원클릭 설치를 추론하지 마라.

3분 만에 첫 시도

전제: 현재 에이전트가 docx라는 skill을 로드했고, 이 머신 또는 그 skill 디렉터리에서 pandoc을 호출할 수 있다. 공식 설명상 docx는 사전 설치이므로 처음에 npm install을 하지 마라. require('docx')가 실패할 때만 npm install docx다.

권장 주 경로는 읽기 전용 확인이지 즉시 수정이 아니다. 해당 skill이 로드된 대화에서, 당신이 소유한 .docx에 공식 읽기 명령을 실행한다.

pandoc -t markdown file.docx

file.docx를 실제 파일 이름으로 바꾼다. 파일을 읽고 Markdown을 낸다. 읽기이며 무손실 보장은 아니다. 경로를 먼저 확인해 노출하면 안 되는 문서를 변환하지 마라. 실행 취소는 증거에 없다. 성공 신호는 명령이 끝나고 Markdown 텍스트가 나오는 것이다. 에이전트 UI에서 skill을 고르는 방법은 증거에 없고, Word 작업이 필요할 때 쓰라는 말만 있다.

기존 문서를 이어서 고치려면 먼저 멈춰라. 공식 경로는 unzip → word/document.xml 편집 → zip이며, docx-js는 기존 파일을 열 수 없다고 적혀 있다. 쓰기이며 압축 내용을 바꾼다. 사본이 있는지 확인하라. 첫 시도는 쓰기 경로로 시작하지 마라.

사용 사례

사례 1: 읽기. pandoc -t markdown file.docx로 기존 Word를 Markdown으로 바꾸고 제목과 본문이 나오는지 본다. 증거는 이 읽기 명령만 다루며 다른 변환기는 다루지 않는다.

사례 2: 기존 문서 편집. 공식 세 단계로 압축을 다루고 word/document.xml을 바꾼 뒤 다시 zip한다. docx-js는 기존 파일을 열 수 없으니 “docx-js로 옛 파일을 바로 연다”는 하지 마라. 부작용이 명시된 경로이므로 먼저 백업한다. 전체 스크립트는 증거에 없고 빠진 매개변수는 미확인으로 둔다.

사용 경계

읽기는 pandoc에 의존한다. 쓰기는 압축 해제/XML 수정/다시 묶기에 의존하고, 나중에 LibreOffice와 pdftoppm 검증이 있을 수 있으나 그 검증 명령은 이 첫 시도에 넣지 않는다. PDF, 표, Google Docs에는 쓰지 마라. 사전 설치된 docx가 require('docx') 실패 시 설치를 건너뛰게 하지는 않는다. 지원 에이전트 UI, 실행 취소, 권한 모델은 증거에 없다. 빈칸은 미확인으로 두고 “위험 없음”이라고 쓰지 마라.