Safe DOCX Suite

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

safe-docx by UseJunior — コーディングエージェントを事務作業にも活用しましょう。

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名規模の地域事務所 — 2200万トークン以上の契約書マークアップを処理

• 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などのパッケージを使用してください。

文書ファミリー

このリポジトリ内の自動フィクスチャカバレッジ

• Common 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

よくある質問

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 Developer Tools — インストールオプションとツールカタログを備えた製品ページ

プライバシー

Safe Docxは完全にローカルマシン上で実行されます。文書の内容が外部サーバーに送信されることはありません。詳細はプライバシーポリシーを参照してください。

ガバナンス

• 貢献ガイド

• 行動規範

• セキュリティポリシー

• 変更履歴