Safe DOCX 제품군

English | Español | 简体中文 | Português (Brasil | Deutsch

UseJunior의 safe-docx — 코딩 에이전을 활용해 서류 작업도 자동화하세요.

UseJunior 개발자 도구의 일부입니다.

Safe Docx는 기존 Microsoft Word .docx 파일을 정밀하게 편집하기 위한 오픈 소스 TypeScript 스택입니다. 에이전트가 변경 사항을 제안하고 사람이 신뢰할 수 있는 서식 유지 문서 편집이 필요한 워크플로우를 위해 구축되었습니다.

AI로 계약서를 검토할 때 가장 느린 단계는 Word에서 승인된 권장 사항을 적용하는 것입니다. Safe Docx는 이를 결정론적 도구 호출로 변환합니다.

이 도구가 존재하는 이유

AI 코딩 CLI는 코드 및 텍스트 파일에는 뛰어나지만 기존 .docx 편집에는 취약합니다. 비즈니스 및 법률 워크플로우는 여전히 Word 문서 기반으로 운영되므로, 다음과 같은 작업을 위한 네이티브 TypeScript 경로를 구축했습니다:

• 토큰 효율적인 형식으로 기존 문서 읽기 및 검색

• 서식을 파괴하지 않고 정밀하게 편집

• 깔끔한/추적된 출력물 및 수정 사항 추출 아티팩트 생성

목표: 코딩 에이전이 서류 작업도 수행할 수 있도록 지원합니다. Safe Docx는 서식과 검토 의미론이 자동화 과정에서도 유지되어야 하는 기존 Word 파일의 결정론적 편집에 중점을 둡니다.

포지셔닝

Safe Docx는 기존 .docx 파일에 대해 결정론적이고 로컬 우선 편집이 필요한 에이전트 워크플로우에 최적화되어 있습니다:

• 편집, 비교, 수정 사항 추출, 댓글, 각주 및 레이아웃을 위한 타입 지정된 MCP 도구

• 테스트 증거 및 추적성 아티팩트를 통한 감사 가능한 동작

• 지원되는 사용 사례에서 Python이나 LibreOffice를 요구하지 않는 TypeScript 런타임 배포

Safe Docx는 생성 우선 .docx 라이브러리를 대체하기 위한 것이 아닙니다.

신뢰하는 기업

• Am Law 상위 10대 로펌 — 다단계 계약서 번역 파이프라인

• 150명 규모의 지역 로펌 — 2,200만 개 이상의 계약서 마크업 토큰 처리

• Gemini CLI — 호환 가능한 Word 편집 MCP 확장

시작하기

npx -y @usejunior/safe-docx

자세한 설정 및 도구 참조는 packages/docx-mcp/README.md를 확인하세요.

예시: 에이전트의 계약서 편집

Safe Docx가 설치된 상태에서 코딩 에이전(Claude Code, Cursor, Gemini CLI)에 프롬프트를 입력하면, 에이전트는 다음과 같은 MCP 도구 호출을 수행합니다:

User: Edit the NDA at ~/docs/NDA.docx — change the governing law
      from "State of New York" to "State of Delaware" and save both
      a clean copy and a tracked-changes copy.

Agent calls:

  1. read_file(file_path="~/docs/NDA.docx", format="toon")
     → Returns paragraphs with stable IDs: _bk_1, _bk_2, ...

  2. grep(file_path="~/docs/NDA.docx", pattern="State of New York")
     → Match in paragraph _bk_47

  3. replace_text(
       file_path="~/docs/NDA.docx",
       target_paragraph_id="_bk_47",
       old_string="State of New York",
       new_string="State of Delaware",
       instruction="Change governing law to Delaware"
     )

  4. save(
       file_path="~/docs/NDA.docx",
       save_to_local_path="~/docs/NDA-clean.docx",
       tracked_save_to_local_path="~/docs/NDA-tracked.docx",
       save_format="both"
     )

에이전트가 도구 호출을 자동으로 처리합니다. 사용자는 사람이 검토할 수 있는 깔끔한 파일과 변경 사항이 추적된 파일을 얻게 됩니다.

MCP 퀵스타트

Claude Code

claude mcp add safe-docx -- npx -y @usejunior/safe-docx

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json(macOS) 또는 %APPDATA%\Claude\claude_desktop_config.json(Windows)에 추가하세요:

{
  "mcpServers": {
    "safe-docx": {
      "command": "npx",
      "args": ["-y", "@usejunior/safe-docx"]
    }
  }
}

Gemini CLI

{
  "mcpServers": {
    "safe-docx": {
      "command": "npx",
      "args": ["-y", "@usejunior/safe-docx"]
    }
  }
}

모든 MCP 클라이언트

• 명령어: npx

• 인자: ["-y", "@usejunior/safe-docx"]

• 전송: stdio

Safe Docx 최적화 대상

• 기존 .docx 파일의 브라운필드 편집

• 서식 유지 텍스트 교체 및 단락 삽입

• 댓글 및 각주 워크플로우

• 검토를 위한 변경 사항 추적 출력물(download, compare_documents)

• 구조화된 JSON으로 수정 사항 추출(extract_revisions)

Safe Docx 최적화 대상이 아닌 것

Safe Docx는 처음부터 문서를 생성하는 툴킷이 아닙니다.

템플릿/프로그래밍 방식 레이아웃에서 새로운 .docx 파일을 생성하는 것이 주 목적이라면 docx와 같은 패키지를 사용하세요.

문서 제품군

이 저장소의 자동화된 픽스처 커버리지

• 일반적인 Paper 스타일 상호 NDA 픽스처

• Bonterms 상호 NDA 픽스처

• 의향서(LOI) 픽스처

• ILPA 유한책임조합 계약서 레드라인 픽스처

복잡한 법률 및 비즈니스 .docx 클래스를 위해 설계됨

• NVCA 금융 양식

• YC SAFE

• 투자 설명서

• 주문서 및 서비스 계약서

• 유한책임조합 계약서

패키지

• @usejunior/docx-core: 기존 .docx 문서를 위한 기본 요소 + 비교 엔진

• @usejunior/docx-mcp: MCP 서버 구현 및 도구 인터페이스

• @usejunior/safe-docx: 표준 최종 사용자 설치 이름 (npx -y @usejunior/safe-docx)

• @usejunior/safedocx-mcpb: 비공개 MCP 번들 래퍼

신뢰성 및 신뢰 표면

• 도구 스키마는 packages/docx-mcp/src/tool_catalog.ts에서 생성됩니다.

• OpenSpec 추적성 매트릭스: packages/docx-mcp/src/testing/SAFE_DOCX_OPENSPEC_TRACEABILITY.md

• 가정 매트릭스: packages/docx-mcp/assumptions.md

• 준수 가이드: docs/safe-docx/sprint-3-conformance.md

FAQ

Safe Docx란 무엇인가요?

기존 Word 문서에 대해 결정론적이고 서식을 유지하는 편집이 필요한 코딩 에이전트 워크플로우를 위한 TypeScript 우선 DOCX 편집 스택입니다.

편집 중에 서식이 유지되나요?

그것이 핵심 설계 목표입니다. 도구 인터페이스는 문서 구조와 서식 의미론을 최대한 보존하는 정밀한 작업(replace_text, insert_paragraph, 레이아웃 제어)을 중심으로 구축되었습니다.

일반적인 런타임 사용 시 .NET, Python 또는 LibreOffice가 필요한가요?

아니요. 지원되는 런타임 사용 환경은 jszip + @xmldom/xmldom을 사용하는 JavaScript/TypeScript입니다.

처음부터 계약서를 생성할 수 있나요?

주요 목적이 아닙니다. 처음부터 생성하려면 docx와 같은 패키지를 사용하세요.

저장소 내 픽스처에서 어떤 문서 유형을 테스트했나요?

상호 NDA(Common Paper/Bonterms 스타일 픽스처 포함), 의향서, ILPA 유한책임조합 계약서 레드라인 픽스처를 테스트했습니다.

변호사만을 위한 도구인가요?

아니요. 동일한 브라운필드 .docx 편집 문제는 인사, 조달, 재무, 영업 운영 및 기타 서류 작업이 많은 워크플로우에서도 발생합니다.

MCP 사용자로서 어디서부터 시작해야 하나요?

npx를 통해 @usejunior/safe-docx를 사용하고 packages/docx-mcp/README.md의 설정 예시를 따르세요.

도구 스키마는 어디서 확인할 수 있나요?

packages/docx-mcp/docs/tool-reference.generated.md에서 생성된 참조를 확인하세요.

개발

npm ci
npm run build
npm run lint --workspaces --if-present
npm run test:run
npm run check:spec-coverage
npm run test:coverage:packages
npm run coverage:packages:check
npm run coverage:matrix

참고

• Open Agreements — 코딩 에이전트로 표준 법률 템플릿 채우기(NDA, SAFE, NVCA)

• UseJunior 개발자 도구 — 설치 옵션 및 도구 카탈로그가 포함된 제품 페이지

개인정보 보호

Safe Docx는 전적으로 로컬 컴퓨터에서 실행됩니다. 문서 콘텐츠는 외부 서버로 전송되지 않습니다. 자세한 내용은 개인정보 처리방침을 참조하세요.

거버넌스

• 기여 가이드

• 행동 강령

• 보안 정책

• 변경 로그