Show HN: Docx-CLI: 에이전트가 1/2의 시간과 토큰으로 Word 문서를 읽고 편집할 수 있게 함
·2026.07.08 03:19
AI 에이전트가 서식 파괴 없이 Word 문서를 효율적으로 편집할 수 있도록 돕는 CLI 도구입니다.
AI 에이전트가 .docx 파일을 직접 수정할 때 발생하는 XML 구조 파괴 및 토큰 과다 소모 문제를 해결하기 위한 docx-cli가 공개되었습니다.
기존 방식은 에이전트가 OOXML을 직접 작성해야 하므로 모델의 성능에 의존적이며, 결과 파일이 손상될 확률이 높았습니다. 반면 docx-cli는 에이전트에게 **안정적인 위치 지정자(stable locators)**와 주석이 달린 Markdown 뷰를 제공하여, 에이전트가 복잡한 XML 구조를 이해할 필요 없이 텍스트 명령만으로 편집할 수 있게 합니다.
주요 벤치마크 결과:
- 정확도: Claude 3.5 Sonnet 기준, 기존 방식(4/6) 대비 6/6의 완벽한 성공률을 기록했습니다.
- 비용 및 속도: 기존 방식 대비 토큰 사용량은 약 2.2~2.6배 절감되었으며, 실행 속도는 약 1.7~2배 향상되었습니다.
- 안정성: 기존 방식은 생성된 파일이 Word에서 열리지 않는 경우가 빈번했으나, docx-cli는 모든 결과물이 정상적으로 열림을 확인했습니다.
이 도구는 커스텀 스타일, 테마 색상, 삽입된 개체 등 Word의 기존 서식을 그대로 유지하면서 텍스트를 수정하거나 메모를 남기는 기능을 지원합니다.
이 요약은 원문 이해를 돕기 위한 큐레이션입니다. 저작권은 원저작자에게 있으며, 정확한 내용과 맥락은 원문을 확인하세요.
요약 오류, 출처 표기 문제, 삭제 요청은 문의 · 건의로 알려주세요.