IronWord と Cursor の使用方法

Curtis Chau
Curtis Chau
更新日: 2026年10月19日

このガイドのサンプルリポジトリは、OpenXML SDK コードを用いてサプライヤーフォームを読み込み、ボディ要素を反復処理して InnerText を読み取ります。 抽出されたテキストのブロックから正規表現でラベル付きの値を解析して IronWord に移行することは失敗します。 校正では、そのバージョンは12のフォームのうち3つを正しく読み取り、5つの登録番号を次のラベルに結び付け、4つのテーブル形式には登録番号を返しませんでした。

Cursor は VS Code コードベースの上に構築され、エージェントをエディタと一緒に提供します。 その特徴の2つは、エージェントが読むドキュメントリンクと .cursor/rules でコミットされたプロジェクトルールであり、IronWord コードを生成するか、OpenXML リーダーパターンに従うコードを生成するかを決定します。 これらの機能は、サプライヤーから返された DOCX フォームを読むサプライヤーオンボーディングサービスで以下に示されます。 このサービスはサプライヤー名、登録番号、価格表、埋め込みロゴおよび署名画像を抽出し、そのリーダーは OpenXML SDK から IronWord に移行します。

IronWord の読み取りメソッドに関しては、テキスト抽出ガイドと画像抽出ガイドをご覧ください。

クイックスタート
NuGetNuGet でインストール

PM > Install-Package IronWord

NuGetパッケージマネージャーコンソールで上記のコマンドを実行するか、NuGetパッケージマネージャーでパッケージを検索して、IronWordをインストールします。

サプライヤー受付リポジトリを開いた状態で、このプロンプトをエージェントチャットの新しい部屋に貼り付けます。

@src/SupplierIntake/ @TestData/forms/

Don't write anything until you've fetched https://ironsoftware.com/word/csharp/llms.txt.
Read the extract text and extract images pages it links as well.

Then give Program.cs a dump command that opens one form with IronWord:
`dotnet run --project src/SupplierIntake -- dump <file.docx>`

Have the dump print what IronWord returns for that form:
- The ExtractText result, in quotes.
- Every entry of Paragraphs, with its index.
- Every table cell, with its table, row and column numbers.
- Each extracted image's Width and Height, and the pixel size of the AnyBitmap behind it.

The program should read IRONWORD_LICENSE_KEY itself when it's set.
At startup, assign the key to License.LicenseKey.
Never print the key, and keep environment variables out of the output.
Leave Forms/FormReader.cs and its DocumentFormat.OpenXml reference as they are.

Run the dump on TestData/forms/form-03.docx and show me the output.
Text

ライセンスキーをチャットに入力しないでください。 エージェントはファイルを編集し、シェルコマンドを実行するため、貼り付けたキーはそれが書き込むすべてのファイル、コミットメッセージおよびビルドログに露出されます。 私たちのテストでは、IronWord はキーなしですべてのフォームを開き読み取り、ドキュメントを保存する時にのみ LicensingException をスローしました。 ライセンスキーガイドは、コード内、Web.config および appsettings.json でキーを設定する方法を示しています。



IronWord 作業にどの Cursor モデルを使用すべきですか?

ComposerはCursor独自のエージェントモデルです。 モデルピッカーは、Cursorが共同開発したSpaceXAIのGrokモデルやOpenAI、Anthropic、Google、その他の研究所のモデルも提供します。 以下のテスト実行ではGrok 4.7を使用しました。

Cursor に IronWord のドキュメントをどのように提供しますか?

リクエストに IronWord のドキュメントリンクを含めるか、チーム全体で共有されるルール内にそれを格納します。 IronWord のllms.txtは、各ガイドと API リファレンスを一覧しており、llms-full.txtでは46のドキュメントページを1つのファイルに凝縮しています。2026年10月時点で、Cursor の @ メニューでは、ファイル、フォルダ、ターミナル、チャット、Git の差分、ブラウザを付けるので、IronWord のドキュメントはリンクとしてエージェントに送られます。

クイックスタートダンプには、テキスト抽出ガイドに記載されていない2つの動作が示されています。 フォーム-03に対して、ExtractTextは本文段落のテキストを1つの文字列に結合して返し、フォームの2つのテーブル内のすべてのテキストを省略しました。

@src/SupplierIntake/Forms/RegistrationCheck.cs

Answer five questions about IronWord, without editing any files:
1. Does WordDocument.ExtractText include text from table cells?
2. What does it put between paragraphs?
3. Does the Paragraphs collection list the paragraphs inside table cells?
4. What does ExtractImages return, and what element type does the list hold?
5. What unit do the Width and Height of each result use?

Use the documentation at https://ironsoftware.com/word/csharp/llms.txt as your source.
The project rule doesn't count as one.
Check your answers against the form-03 dump from the last turn, where it shows them.
Cite the page each answer comes from.
Where no page states it, say the answer is measured, not documented.
Text

IronWord の規約をエンコードするようにプロジェクトルールを書く方法は?

プロジェクトルールは .cursor/rules に格納され、リポジトリとともにバージョン管理される.mdcファイルです。そのため各クローンにそれが含まれます。 Cursor はそのフォルダ内のプレーンな.mdファイルを無視します。なぜならフロントマターがないときにそれをロードするタイミングを判断できないからです。

下記のルールでは globs を定義して、alwaysApply を false に設定します。 Cursor はフォームリーダーまたはテストファイルを含むリクエストがあるたびにそれをロードし、それ以外の場合はそれを省略します。これを .cursor/rules/ironword-forms.mdc として保存してください。

---
description: IronWord conventions for reading supplier forms
globs: src/SupplierIntake/Forms/**/*.cs, tests/**/*.cs
alwaysApply: false
---

Read and write DOCX files with IronWord only, under these package rules:
- The NuGet package is IronWord.
- Its types come from two namespaces, IronWord and IronWord.Models.
- AnyBitmap comes from IronSoftware.Drawing.
- Don't add DocX, NPOI or any other DOCX package.
- Add no new DocumentFormat.OpenXml code.
- The documentation index is https://ironsoftware.com/word/csharp/llms.txt

Keep license keys out of the code, and handle the key this way:
- Read it at run time from an environment variable named IRONWORD_LICENSE_KEY.
- Never print it.

WordDocument.ExtractText leaves out table cells and runs paragraphs together with no separator.
Use the paragraph and table collections instead:
- Read labeled values one paragraph at a time from doc.Paragraphs.
- Read tables through doc.Tables, Rows and Cells.
- doc.Paragraphs also returns the paragraphs inside table cells.

Table.Rows returns ITableRow, and a row's Cells returns ITableCell.
Two casts are needed:
- Cast a row to TableRow before you pass it to a method that takes a TableRow.
- Cast a cell to TableCell before you call ExtractText on it.

Don't invent IronWord members.
When you're unsure of one, say so and name the page you checked.
Markdown
注意してください: Cursor は、ルートまたは任意のサブフォルダ内にある AGENTS.md も読み取ります。 そのファイルには frontmatter やファイルパターンがないため、グロブに依存する IronWord のルールは .cursor/rules に属します。

Cursor のルールページにはルールが Tab に影響せず、ユーザールールはインライン編集には適用されないと記されているため、Tab とインライン編集の提案はルールに対して手動でチェックする必要があります。

OpenXML SDK 呼び出しを IronWord にマッピングする方法は?

モデルに IronWord を使用するように指示することは、どの IronWord 呼び出しが各 OpenXML SDK 呼び出しを置き換えるかを示しません。 等価の対応表がそのマッピングを提供します。

OpenXML SDKIronWord
WordprocessingDocument.OpenWordDocument コンストラクタ、パス、バイトまたはストリームから
本文段落とその内側のテキストParagraphs、ExtractTextをそれぞれに適用
本文テーブル、行、セルTables、Rows、Cells
Blip要素と画像パートストリームExtractImages、AnyBitmapを通じて保存

2つの行が、置き換えたSDKコードとすこし違って動作します。 段落リストは、テーブルセル内の段落と本文段落の両方を保持しているため、フォーム-03はOpenXML SDKリーダーが5つの本文段落を反復処理したところ15のエントリーを返します。セルは ITableCell として返され、テキストメソッドは持たないため、キャストなしの呼び出しでは、CS1061 と共にビルドに失敗します。

IronWord は DocumentFormat.OpenXml パッケージを参照せず、IronWord 2026.10.4 および DocumentFormat.OpenXml 3.5.1 の両方を参照するプロジェクトはビルドし実行します。 したがって、1回に1つのリーダーの移行を進めることができます。OpenXML競合ページは2025.7.13より古いIronWordビルドをカバーしています。

ルールの末尾にこれらの行を追加すると、ルールをロードするすべてのリクエストにテーブルが含まれます。

Translate OpenXML SDK code instead of porting it, with these equivalents:
- WordprocessingDocument.Open becomes new WordDocument(path).
- Body.Elements<Table>() becomes doc.Tables.
- Counting Blip elements becomes doc.ExtractImages().Count.

Save extracted images with ((AnyBitmap)image.Image).SaveAs(path).
Markdown

IronWord への移行を計画し実行する方法は?

チャット入力でShift+Tabを押して計画モードが選択されるまで押し、次に下記のリクエストを送信します。 Cursor は計画を編集可能なファイルに書き込みます。

@src/SupplierIntake/Forms/ @TestData/forms/expected.csv

Plan the move of FormReader to IronWord so the project can drop DocumentFormat.OpenXml.
Write no code until I approve.
FormReader still reads supplier forms with the OpenXML SDK.
RegistrationCheck already uses IronWord, and the team wants a single DOCX library.

The plan has to cover these points:
- Every OpenXML SDK call, with its IronWord replacement and the file where the call lives.
- How the reader will find the price table.
- How it will find a registration number inside a table.

Keep SupplierForm and the public Read and SaveImages signatures unchanged.
Where something is unclear, state your assumption instead of asking.
Show me the plan when it's ready.
Text

計画の誤りを修正してください。 その後、ビルドをクリックするか、エージェントに戻ってこのリクエストを送信します。

@ironword-forms

Carry out the approved plan.
Check the forms output against TestData/forms/expected.csv before and after the move.
A printed row counts as a match when its supplier, registration, items and images columns agree.

Work through it in this order:
1. Run `dotnet run --project src/SupplierIntake -- forms TestData/forms` and count the matches.
2. Migrate FormReader to IronWord.
3. Remove the DocumentFormat.OpenXml package reference.
4. Run dotnet build, then run the forms command again.

Tell me the match count for the OpenXML version and for the IronWord version.
Then show me the diff.
Text

@ironword-forms メンションは、Cursor がすでにそのグローブを通じてアタッチしているかどうかに関係なく、ルールを名前で適用します。

どのCursor機能が各変更に適していますか?

Tab はすでにエディタに表示されている編集を完了し、インライン編集 (Ctrl+K) は1つの文の指示から選択を再書き換えします。 複数のファイルにまたがる変更、またはビルドが必要な変更はエージェントに送信されます。 不正確な変更を元に戻すのに計画を書いておくよりも費用がかかるときは、プランモードを使用します。クラウドエージェントは無人作業に適しています。

新しいサプライヤーはフォーム-13を返し、その価格表は2つの価格階層にわたって1つの商品セルを結合しています。 FormReaderで価格行を反復処理するループをハイライトし、Ctrl+Shift+L(macOSではCmd+Shift+L)を押してハイライトされたコードをチャット入力に追加し、エージェントでこのリクエストを送信します。

Make FormReader.Read handle merged cells in the price rows:
- An Item cell that Word merged with the cell above comes back empty.
- For that row, reuse the item name from the previous row.
- Before you read a cell by its column position, check that the row has that many cells.

Then rerun the forms command over TestData/forms.
Tell me how many rows agree with expected.csv, which now lists 13 forms.
Text

行の長さのチェックが反対方向の結合を考慮しています。 別のプローブファイルでは、列を超えてマージされたセルが1つのセルとして返され、そのためその行は他の行より短かったです。

抽出されたテキストから欠落している値をデバッグする方法は?

リポジトリの事前チェックは、ExtractText の結果の上で正規表現を用いて登録番号を読み取ります。

@src/SupplierIntake/Forms/RegistrationCheck.cs @TestData/forms/

Find out why the pre-check flags 9 of the 13 forms as missing a registration number.
FormReader finds one in all 13, and every number is visible in Word.

Before you edit anything, do these three things:
1. Run the check command on TestData/forms and on TestData/edge, and note what it flags.
2. Run the dump command on one flagged form.
3. Explain what the check reads that FormReader doesn't.

Then fix RegistrationCheck and keep it on IronWord.
Rerun the check on both folders.
Tell me how many forms it flags in TestData/forms and in TestData/edge, before and after the fix.
Text

9つの失敗に2つの原因があります。 5つのフォームでは、連絡用メールの段落が番号の後に続き、表現がGB-0012345Contactをキャプチャし、フォーマットチェックがそれを拒否します。 他の4つは番号を会社の詳細テーブル内に格納し、ラベルセルが登録番号をコロンなしで読み取り、値が次のセルにあるのです。 段落を個別に読み、ラベルの隣のセルから値を取ることで両方の問題が解決します。

IronWord が省略する DOCX の部分はどれですか?

IronWord 2026.10.4 に対するプローブでフォームリーダーに返されないライブラリのコンテンツを特定しました。

  • ヘッダー:読み取りはヘッダーテキストを返さず、ExtractImages はヘッダー画像を省略します。 ページ設定はヘッダーの高さを示しますが、その内容を示しません。
  • コンテンツコントロールとテキストボックス:それらのテキストは段落と抽出されたテキストのいずれにも存在しません。
  • 変更履歴:変更履歴が有効になっている間に挿入されたテキストを読み取りから省略します。
  • **レガシーファイル:**Word 97-2003 .doc ファイルは読み込み時に"File contains corrupted data"をスローします。
  • 間隔属性なしのインライン画像:インライン画像がdistT、distB、distL、distRを省略したDOCXは、InvalidOperationExceptionで読み込みに失敗します。 python-docx はこれらの属性を省略します。

浮動する画像とテーブルセル内の画像は、文書の順序で抽出されます。 サプライヤーがコンテンツコントロールで作成されたフォームを完了したり、登録番号をヘッダーに配置した場合は、リーダーに依存する前にそれらのフォームをテストします。

ドキュメント読み取りのための回帰テストを書く方法は?

抽出された値を既知のリストと比較するテストは、リーダーの内部実装に関係なく受付サービスの出力を確認します。 クラウドエージェントは独自の分離されたVMでそれを書けます。 まず、Cloud Agents ダッシュボードのシークレットの下に IRONWORD_LICENSE_KEY を格納します。

@tests/SupplierIntake.Tests/ @TestData/

Write xUnit tests for FormReader and RegistrationCheck.

Each of these needs a test:
- Every row of TestData/forms/expected.csv matches.
- In form-13, both price tiers keep the item name.
- SaveImages writes one PNG per picture, with the pixel sizes listed in the image_sizes column.
- RegistrationCheck passes every form and flags TestData/edge/no-registration.docx.
- Reading TestData/edge/legacy.doc throws a FormatException or a type derived from it.

Copy TestData into the test output and run dotnet test.
Tell me the passed and failed counts.
Text

レガシーファイルのアサーションは IronWordの 例外タイプを参照できません。なぜならそれは内部だからです。 それは FormatException から派生しているので、Assert.ThrowsAny<FormatException> のような派生型を受け付けるアサーションは コンパイルされ、異なるエラーがスローされた時に依然として失敗します。

AI コーディングアシスタントガイド には、最初から最後まで IronWord タスクを運行し、記述された合格基準に対するものが含まれています。

プロンプトが実運用で生成したものは何ですか?

7つのプロンプトは1つのチャットで順に Cursor に送信されました。 サンプルリポジトリは、OpenXML SDK リーダー、IronWord 事前チェック、空の xUnit プロジェクト、既知の値を持つ12のフォーム、および2つのエッジファイルを保持しました。

  • OpenXML SDK リーダーとそれに置き換えられた IronWord リーダーは、それぞれ12のフォームを一致させました。
  • IronWord はアプリおよびそのテストに残った唯一の DOCX パッケージでした。
  • フォーム-13を追加して、リーダーは13のうち12を一致させ、セカンドプライステアの項目名を除外しました。
  • 結合セルの変更後、リーダーは13の13を一致させました。
  • 修正前に9つのうち13つのフォームがフラグ付けされ、修正後は何もフラグ付けされませんでした。 フラグが付けられたエッジフォームは2回とも登録番号がありませんでした。
  • 保存された21の画像すべてがリストされたピクセルサイズを持っていました。
  • フォーム-03 のダンプは、2つのテーブル内の10つのセルおよび108 x 36ポイントと144 x 48ピクセルの1つの画像をリストしました。
  • ドキュメントには何が述べられているかを尋ねると、Cursor はどのファイルも変更せずに答えました。
  • ライセンスキーの有無にかかわらず、6つのテストメソッドすべての42のケースが合格しました。
  • 最終コードコピーで、結合セルの処理を削除すると2つのケースが失敗しました。 旧事前チェックを復元すると9つが失敗し、各フォームごとに1つの画像をスキップすると13が失敗しました。
  • レガシーファイルテストは任意の例外を受け入れ、ファイル削除で合格しました。 FormatException に限定すると、実際のファイルでは合格し、ないと失敗しました。
  • Cursor の最初の IronWord リーダーは行キャストが欠けており、CS1503でビルドに失敗しました。Cursor は次のビルドの前にキャストを追加しました。
  • すべてのリリースビルドは、警告0件、エラー0件で、手動の編集はありませんでした。
  • 一部のステップはページと異なる方法で実行されました。 ルールは行キャストが欠けていました。結合セルプロンプトは行長さのチェックを要求せず、Cursor はそれを追加しませんでした。 テストプロンプトは例外をスローすることだけを求めました。 プロンプト、@メンションを含むものは、デスクトップアプリにテキストとして貼り付けられました。 プランは、ビルドボタンではなくエージェントで承認されました。 クラウドエージェントプロンプトはエージェントモードでローカルに実行され、VM なしで使用されました。

Claude Code ガイドは、生成されたコード内のすべての IronWord メンバーを IronWord.xml と照合する読み取り専用サブエージェントを追加します。 ChatGPT Codex ガイドは、ライティングサイドをカバーし、テキスト置換がどの部分を変更するかを測定します。

実行記録は、これらの結果のための IronWord パッケージ、モデル、タイミング、テストマシンをリストします。


トラブルシューティング


質問ありますか?

質問がある場合は、support@ironsoftware.com にお問い合わせください。

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

もっと読む

準備はできましたか?

NuGetダウンロード数 62,392バージョン:2026.11ちょうどリリースされました