IronXLとCursorを使用する方法

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

Excel Interopを通じてワークブックを編集する予算ジョブは、Excelがインストールされている場所でのみ実行されます。 .NET 9サービスであるBudgetDeskは、本ガイドで説明されているように、1つの財務デスクPCでコストセンター予算を前進させ、月末にタスクスケジューラで起動されます。 Microsoftは無人コードからOfficeを自動化することを推奨しておらず、そのガイダンスでは、SYSTEMアカウントでのタスクスケジューラジョブがその一例として挙げられています。 ジョブをビルドエージェントに移すことはInteropを置き換えることを意味します。そのポートをAIエージェントに任せることは、InteropとIronXLがまだコンパイルされる詳細で意見が異なるため、静かなリスクを加えます。

CursorのエディターはVS Codeのコードベースに基づいており、その3つの機能がこのようなポートを正直に保ちます。プロジェクトルールはInteropとEPPlusの習慣を削除することを定め、プランモードはファイルの変更前にマッピングを確立し、各プロンプトのドキュメントリンクがエージェントにIronXLの実際のAPIを提供します。 各BudgetDeskロールは行と列を挿入し、値と数式を編集し、変動で行をソートし、上位の行を別のシートにコピーし、月シートを追加および削除します。 IronXLはOfficeのないマシン上で.xlsxファイルに対してこれらすべてを行います。

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

PM > Install-Package IronXL.Excel

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

CursorでBudgetDeskを開いた状態で、これをAgentに貼り付けてください。 2つの言及は、Interopクラスとそのクラスが編集するワークブックを引き渡します。

@src/BudgetDesk/Workbooks/BudgetBook.cs @TestData/budget-2026.xlsx

BudgetBook drives Excel over COM. I want to see what IronXL makes of the same workbook.
Fetch https://ironsoftware.com/excel/csharp/llms.txt before you write anything.

1. Run dotnet test once and tell me what the failures have in common.
2. Add IronXL.Excel 2026.10.1 to src/BudgetDesk.
3. Add an "inspect <file>" command to Program.cs that loads the workbook with IronXL.
4. Have it print the sheet names in tab order first.
5. Then have it print every Lines cell that holds a formula, with its address, formula text and value.
6. Run inspect on TestData/budget-2026.xlsx and show me the output.

The program takes the key from IRONXL_LICENSE_KEY and assigns it to License.LicenseKey.
Don't print the key's value or list any environment variables.
Leave BudgetBook.cs as it is for now.
Text

Excelのないマシンでは、6つのテストのうち5つがnew Excel.Application()でCOMException 0x80040154、クラスが登録されていないところで停止します。 6番目のテストは通過します、なぜならWatchlistエクスポートはEPPlus 4.5.3.3を使用しているからです。同じマシンで、inspectコマンドが15のシートをリストしています。Summary、Lines、Templateの後に10月2025年から2026年9月までの月別シートが続きます。出力されたLinesの数式は、E2-D2からE9-D9までの行2から9までの変動で、行10に3つのSUM合計があります。

プロンプトからライセンスキーを除外してください。 Cursorのエージェントはファイルを編集し、シェルコマンドを実行するため、会話内に入力されたキーはコードまたはコミットメッセージに含まれる可能性があります。 代わりにIRONXL_LICENSE_KEY環境変数を設定してください。 IronXLは単独でその変数を読み取らないため、プロンプトでコードがそれをLicense.LicenseKeyに割り当てる必要があります。 ライセンスキーガイドは、キーが欠落している場合にスローされる例外とIronXLが自分自身で読み込む設定ファイルについて説明しています。



IronXL作業に適したCursorモデルはどれですか?

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

ポートを計画することは、すべてのInterop呼び出しとすべてのテストを読み、それぞれが何になるかを決定することであり、それはより長い間考慮するモデルに報酬を与えます。 それを構築することは主に機械的な編集とテストの再実行であり、迅速なモデルが各ループを短く保ちます。 どちらを選んでも、プロンプトでファイル、テスト、および期待される数を名前で示してください。なぜなら、2つのモデルが1つのリクエストを異なって解釈する可能性があるからです。

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

IronXLのドキュメントリンクをリクエストに入れるか、コミットされたルールに保持して、誰もそれをコピー&ペーストする必要がないようにします。 llms.txtインデックスにはガイドと例がリンクされています。 2026年10月時点で、Cursorの@メニューにはファイル、フォルダー、ターミナル、チャット、Git差分、ブラウザを添付するため、IronXLのドキュメンテーションはリンクとしてエージェントに届きます。

ポートは2つの質問で始まります。 IronXLの引数はゼロから始まるものと、Interopが要求されずに提供していた動作がどうなったかです。

@src/BudgetDesk/Workbooks/BudgetBook.cs

These are questions, so don't change any files.
Answer from https://ironsoftware.com/excel/csharp/llms.txt and the how-to pages it links.
Cite the page URL for every answer.

1. List each Interop call in BudgetBook in one column and the IronXL member that replaces it in a second.
2. Mark every IronXL argument that counts rows, columns or sheets from 0.
3. Which IronXL method replaces Sort with Header set to xlYes?
4. Does any page describe a header option for that method?
Text

IronXLのページはインデックスの質問に直接答えています。 行と列ガイドでは、InsertRow引数がゼロベースインデックスとして説明され、ワークシートガイドではその位置がゼロベースで記述されています。 ソートガイドやSortByColumnのAPIリファレンスにはヘッダ行に関する言及がありません。

ヒント: ページの裏付けがない回答は、APIリファレンスでメンバーを見つけるまでは未確認と見なしてください。
注意してください: IronXLはまた、ironxlという名前のスキルファイルを公開しています。 .cursor/skills/ironxl/SKILL.mdとして保存され、Cursorが開始されると発見され、/ironxlをエージェントに入力すると、それを1つのメッセージに添付します。

IronXLの規約をエンコードするプロジェクトルールを書きますか?

プロジェクトルールは.mdcファイルが.cursor/rulesにあります。 これらはコードと一緒にコミットされるため、すべてのクローンが同じルールを取得します。 そのフォルダー内のプレーンな.mdファイルは無視されます、なぜなら、いつ適用されるかを示すヘッダがないからです。 description、globs、およびalwaysApplyのフィールドがリクエストにルールが参加するかを決定します。

このルールはglobsを設定し、alwaysApplyをオフにするため、サービスまたはそのテストがコンテキストにあるときに添付され、ワークブックに一度も触れないリクエストには添付されません。 @ironxl-portは名前でそれを添付します。 複数のパターンは1行にカンマで区切って入力されます。 それを.cursor/rules/ironxl-port.mdcとして保存します。

---
description: Port Excel Interop and EPPlus workbook code in BudgetDesk to IronXL
globs: src/BudgetDesk/**/*.cs, tests/BudgetDesk.Tests/**/*.cs
alwaysApply: false
---

# BudgetDesk edits workbooks with IronXL

- Use IronXL only. The NuGet package is IronXL.Excel and the namespace is IronXL.
  Remove Microsoft.Office.Interop.Excel and EPPlus.
  Don't add ClosedXML, NPOI or another spreadsheet package.
- Documentation: https://ironsoftware.com/excel/csharp/llms.txt
- Delete the COM cleanup along with the Interop calls.
  IronXL code has no Marshal.ReleaseComObject, Application.Quit, GC.Collect or DisplayAlerts.
- Set License.LicenseKey from the IRONXL_LICENSE_KEY environment variable.
  Never write a key into code, tests or logs.
- A1 addresses such as "D10" mean the same in both libraries.
  IronXL index arguments start at 0, where Interop and EPPlus Cells[row, col] start at 1.
  Zero-based: InsertRow, InsertColumn, GetRow, GetColumn, GetCellAt, SetActiveTab, RemoveWorkSheet.
- Write dates as a DateTime plus a FormatString.
  IronXL stores a string that reads as a date, such as Oct-2026, as a date.
- Call EvaluateAll before SaveAs.
- Don't invent IronXL members. When unsure, say so and cite the page.
Markdown

インデックスの箇条書きは、オフバイワン行が合計行の下に新しい行を書き込むためにあります。

ルールはエージェントリクエストに適用されます。 Cursorのドキュメンテーションによると、それらはTabに影響を与えず、ユーザールールはインライン編集には適用されません。 それらの機能からの提案をルールに対して自分で確認してください。

Excel InteropとEPPlus呼び出しをIronXLにマップする方法は?

「IronXLを使用してください」とだけ言うルールは、モデルが各呼び出しが何になるかを計算します。 各IronXLの結果はIronXL 2026.10.1でBudgetDeskワークブックで測定されました。このLinesシートは、行10に合計行の上に行2から9に8つのコストセンターを保持しています。

InteropまたはEPPlusの呼び出し期待されるものIronXL
Rows[10].Insert()、Cells[row, col]1からのカウントInsertRow(9)は行10の上に挿入され、GetCellAt(0, 0)はA1。合計は行11に移動し、SUM(D2:D9)は変更されず、Summary!B2はLines!D11となりました
前の行のRange.Copy新しい行に数式に従うF10はE9-D9を維持した
EPPlus CopyのA1:F4がWatchlist A3へ数式はWatchlist行に従うWatchlist F4はE2-D2を取得し、0を読みました
Range["F2:F9"].Formula = "=E2/Summary!$B$5*12"行ごとに1つの数式全8セルがF2数式を取得し、128,666.67を読みました
SortがHeaderにxlYesを設定し、A1:F9を介してヘッダは残り、行は変動で並び替えヘッダオプションなし。 数値はテキストとして並び替えられ、11,200が4番目に来た
同じ並び替えがA2:F9に対して行われた数式は行とともに移動する正しい順序、数式は数値になった。 E2が0に設定されるとF2は11,200のままでした
FindSheetのループをWorksheets上で欠落している月はスキップされるGetWorkSheetがnullを返し、RemoveWorkSheetがArgumentException "Index -1は範囲外です"をスローした
Template.Copy(After: lastSheet)新しいシートが最後に配置されるCopySheetはそれを16番目の16に配置し、重複した名前がArgumentExceptionをスローした

挿入自体が持ちこたえました。InsertColumn(5)は変動をG列に移し、その合計をSUM(G2:G9)として書き直し、Summary!B4をLines!G10に移動しました。 テーブルの2行は他の行よりも大きな損害を与えます、なぜならそれらがセルが何を意味するかを変更するからです。 古い参照とともにコピーされた数式は別のコストセンターの数値を報告します。 数式を数値に変換する並び替えは、実際に従わない変動列を残し、次の月の実際はそれに到達しなくなります。 どちらも合計を一眼で確認したときにsurviveします。 SortAscendingもショートカットにはなりません、なぜなら列のブロックに関してそれは各列を独自に並び替え、そして私たちのテストで行2は施設でCC-110としてBergによって所有されて戻ってきたからです。

翻訳をルールに3つの箇条書きとして追加します。

- Range.Copy keeps formula references unchanged.
  After copying cells that hold formulas, write each formula again for the row it landed on.
- Setting Formula on a multi-cell Range puts the same text in every cell.
  Write per-row formulas in a loop.
- SortByColumn has no header option and leaves values where the sorted formulas were.
  Sort from row 2 down, then write each row's formulas again.
Markdown

なぜIronXLでGetCellAtがnullを返すのですか?

ルールはGetCellAtをゼロベースのメンバーの中にリストし、これがCells[row, col]の行ごとのポートを誘発します。 Interopは、満たされているかどうかにかかわらず、任意のアドレスに対してRangeを返すため、AddLineは挿入された行に新しいコストセンターを書き込みます。 IronXLのGetCellAtはAPIリファレンスが述べているように、「セルが満たされていない場合はnull」を返します。 InsertRow(9)の後、新しい行10の6つのポジションすべてがnullを返し、GetCellAt(9, 0).Value = "CC-190"がNullReferenceExceptionをスローしました。

ここで満たされていないということは、シートのXMLから欠如していることを意味します。 出荷されたワークブックでは、B10とC10は値を持たないが、合計行でスタイルを保持しており、GetCellAtによって空セルとして返されました。 変動列を通過した1列後のG2と、合計の1行下のA11がnullでした。

アドレスによるインデックスは常に1つのセルを返します。 ws["A10"]は新しい行でCC-190をとり、GetCellAt(9, 0)その後見つかった。 数値インデックスを保持するポートは、GetCellAtが何も見つけないときにアドレスに戻ることができます。

static Cell At(WorkSheet sheet, int row, int column) =>
    sheet.GetCellAt(row, column) ?? sheet[$"{(char)('A' + column)}{row + 1}"].First();
C#

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

ポートはすべてのメソッドに触れ、間違ったものを元に戻すのにかかるコストは、書くのにかかるコストよりも大きいです。 次のプロンプトを送信する前にShift+Tabでチャットを計画モードに切り替えます。 計画モードでエージェントはコードを読み、明確にする質問をする場合があり、編集の代わりにプランを書きます。

@src/BudgetDesk/ @tests/BudgetDesk.Tests/ @ironxl-port

Plan the move to IronXL. Don't write code yet.

Here's the scope:
- BudgetBook moves off Excel Interop.
- WatchlistExport moves off EPPlus.
- The tests stop reading workbooks with EPPlus.
- BudgetBook keeps its public methods, and the six tests keep their names.

Put this in the plan:
1. List each Interop or EPPlus call with its IronXL replacement and the file it's in.
2. Flag every place where a row, column or sheet number changes base.
3. Explain how copied cells, the Forecast column and the sort keep each formula pointing at its own row.
Text

その計画は編集可能なMarkdownファイルであるため、間違ったマッピングを計画自体で修正できます。 計画が正しく読めるときは、Buildをクリックするか、Agentに戻って次のプロンプトを送信します。

@ironxl-port

Build the approved plan.

- Remove the Interop and EPPlus package references and the EmbedExcelInteropTypes target.
- In the tests, change only how workbooks are opened and read.
- Leave every assertion in BudgetBookTests as it is.
- If IronXL can't read what an assertion checks, read the saved file's XML and keep the assertion.

When the port is done:
1. Build the solution and run the tests.
2. Run "dotnet run --project src/BudgetDesk -- roll Oct-2026".
3. Print each Lines row of out/budget-Oct-2026.xlsx with its formulas.
4. Tell me how many tests passed before the port and how many pass now.
Text

私たちのキャリブレーションでは、各呼び出しを最も近いIronXLメンバーに置き換えたストレートな翻訳がクリーンにコンパイルされ、6つのテストのうち2つを通過しました。 4つの失敗は、予測数式、並び替え、Watchlistのコピー、そして新しい行の変動で、上のテーブルと同じ行でした。 ルールに従ったポートは6つすべてを合格しました。

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

変更の到達範囲に基づいて1つを選びます。 Tabは予測可能な次の編集を処理し、インライン編集は1つの選択を処理し、1つの文がそれをカバーします。 エージェントは、複数のファイルまたはビルドループが必要な変更を取ります。

費用負担の終了が始まり、BudgetBookには行を削除する方法が必要です。AddLineメソッド全体をBudgetBook.csでハイライトし、Ctrl+Shift+Lを押してそれを開いているチャットに追加し、Agentモードでリクエストを送信します。

Add RemoveLine(string code) directly below the AddLine method I highlighted.
It finds a line by its code and deletes that row from Lines.
If the code isn't there, throw KeyNotFoundException, the same way SetActual does.
Text

いつIronXLが行を削除したときに合計を更新しますか?

RemoveLineはGetRow(index).RemoveRow()の周りに数行として出てきて、シートの中央に行があるときにIronXLは合計を正しく維持します。 行4からCC-130を削除すると、その下の行が1つ上にシフトし、合計のSUM(D2:D9)がSUM(D2:D8)に縮小され、Summary!B2がLines!D9に移動しました。

最後の行が例外です。 行9を削除すると、合計の直上の行9に合計が移動し、その数式はSUM(D2:D9)に留まりました、これは今合計セル自体を含みます。 IronXLはこれを〜CIRCULAR〜REF〜として評価しました。

このガイドの11月のクローズは、10月に並び替えされて合計の直上に配置された行CC-140を閉じます。

@TestData/closures/Nov-2026.csv @TestData/actuals/Nov-2026.csv @src/BudgetDesk/Program.cs

Finance closed CC-140 at the end of November.

Change roll so it calls RemoveLine for each code in TestData/closures/<month>.csv.
Have roll do that before it applies new lines and actuals.
A month with no closures file closes nothing.

Then check the numbers:
1. Run roll Oct-2026.
2. Run roll Nov-2026 with out/budget-Oct-2026.xlsx as its input.
3. Add up Budget, Actual and Variance from the remaining line cells yourself.
4. Compare your sums with the Lines Total row and Summary B2:B4.
5. If they disagree, find the cause in BudgetBook, fix it and roll November again.

Show me the Total row formulas either way.
Text

RemoveRowだけの状態で、私たちのキャリブレーションでの11月の出力は、行10に=SUM(D2:D10)を保持し、三つのSummaryセルが〜CIRCULAR〜REF〜を読み取り、予算を0と報告したロールを持ちました。削除後に4つの合計数式を再度書き込むことで、477,750の予算、606,600の実際の支出、そして128,850の変動が生み出され、これは8つの残りの行の合計と一致しました。 ルールに次の箇条書きを追加してください。

- After RemoveRow, write the Total row's SUM formulas again.
  Removing the line directly above Total leaves a range that includes the Total cell itself.
Markdown

移行されたIronXLコードをどうテストしますか?

クラウドエージェントは誰も見ていない状態で回帰スイートを書けます。 1つを開始する前にIRONXL_LICENSE_KEYをCloud Agentsのダッシュボードに秘密として追加します。

@tests/BudgetDesk.Tests/ @TestData/

Add five xUnit tests to BudgetDesk.Tests that pin down the port.
Write each one as a new test, even where an existing test already covers part of it.

1. Sorting keeps the header in row 1 and a formula in every Variance cell.
2. A line added above Total gets formulas that use its own row.
3. Removing the line just above Total leaves SUM formulas that end one row higher.
4. After the October roll, Oct-2026 is the active sheet.
5. The totals stored in the saved file equal the recalculated ones.

IronXL recalculates on load and has no getter for the active tab.
Read the stored totals and the active tab by unzipping the xlsx and parsing its XML.

Run dotnet test when they're written and tell me how many pass.
Text

ファイルを解凍する指示はIronXLがどのように保存するかから始まります。 SaveAsは最後に計算された各数式の結果を書き出します。 私たちの測定では、CC-110の実際の金額を104,900に上げて保存時にEvaluateAllを使用しないと、ストアされたLinesの実際の合計として527,300がファイルに残りSummaryでも同様です。一方、セルは535,700を追加していました。そのファイルをIronXLで再読み込みすると535,700が報告されました、なぜならIronXLは読み込み時に数式を計算するからです。 したがって、IronXLを通じて読むテストは、ストアされた数値が古くなっているファイルに合格しますが、ストアされた結果を読むopenpyxlは527,300を示しました。保存前に1つの合計を読み込むことでそのセルのみを更新し、保存前にEvaluateAllを呼び出すことでそれぞれを更新し、これがルールがそれを求める理由です。

IronXLもまた、スイートにどのシートがアクティブかを伝えることはできません、なぜならSetActiveTabが値を書き、プロパティがそれを読み返さないからです。 SetActiveTab(14)、保存、再ロードの後で、DefaultWorkSheetはSummaryを返し続けるため、10月のテストはワークブックXMLからactiveTab属性を取ります。

Interop移行後、IronXLはWindowsを必要としますか?

ポートが完成したら必要ありません。 BudgetDeskのInteropビルドはCA1416警告を3つ上げました。それぞれMarshal.ReleaseComObject呼び出しに対して1つずつで、Windowsのみでサポートされていますと言っています。 IronXLのLinuxガイドは、IronXLをLinux上で実行するためにコードの変更は必要ないと述べており、Dockerガイドはコンテナについて説明しています。 このガイドのキャリブレーションはWindows上で実行されたので、デスクPCを退役させる前にLinuxイメージでテストを1度実行します。

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

7つのプロンプトはそれぞれ、1つのチャットでCursorに送信され、このガイド用にコピーされたBudgetDeskリポジトリ内で実行されました。コピーにはInterop BudgetBook、EPPlus Watchlistエクスポート、EPPlusで結果を読む6つのxUnitテスト、10月の実績と1つの新しい行を含む予算ワークブックが含まれました。ルールファイルと11月のクローズファイルはそれを使用するプロンプトの直前に追加され、ライセンスキーは環境変数としてのみ設定されました。

  • ポート前は6つのテストのうち1つを合格し、ポート後は6つすべてを合格し、31本の元のアサーション行のすべてがそのまま残りました。
  • ポート後、リリースビルドには警告がなく、IronXL.Excel 2026.10.1はアプリとそのテストに残る唯一のスプレッドシートパッケージでした。
  • 11月の修正前、ロールはSummaryバジェットセルから〜CIRCULAR〜REF〜を読み取りFormatExceptionで停止しました。 合計数式が再度書き直されると、ストアされた11月の合計は修正されたキャリブレーション値に等しく、ファイル内には循環参照が残りませんでした。
  • 10月のロールは予算として511,500を保存し、実際の支出として590,950を保存し、差異は79,450となり、私たちのワークブックチェック19項目すべてが合格しました。 これらは、行1のヘッダー、変動で並べ替えられた9つの行、ForecastとVarianceの各行の数式、Oct-2026がアクティブなシートとしてチェックされ、 WatchlistのCC-120、CC-130、CC-110の数式がそれぞれの行を使用していることを含みました。
  • 承認されたプランではアクティブシートがDefaultWorkSheetにマップされた。 ポート後の初回のテスト実行でそれがキャッチされ、Cursorは保存されたワークブックXMLからアクティブタブを読むテストに修正されました。
  • 5つの新しいテストによりスイートは11分の11となりました。最終コードのコピーから1つの動作を1度に削除する私たちのミューテーションの実行が行われました。 5つは、合計の書き直し、並び替え後と新しい行での数式の書き直し、保存前の評価、アクティブタブ呼び出しでした。 各コピーはそれ用に書かれたテストに失敗しました。
  • 各リリースビルドには0エラーがあり、手動の編集は必要ありませんでした。
  • 一部のステップはページと異なる方法で実行されました。 デスクトップアプリでプロンプトは手動で送信され、@の言及はテキストとして貼り付けました。 次のプロンプトを送信することで計画が承認され、Buildはクリックされずに、クラウドエージェントプロンプトはローカルでエージェントモードで実行され、ダッシュボードシークレットは設定されませんでした。 これは2回目の試みでした、最初の試みでは11月のクローズプロンプトがチャットに届かなかったためです。

IronXLパッケージ、Cursorバージョン、タイミングテスト、マシンの詳細については、実行記録を参照してください。


トラブルシューティング


質問ありますか?

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

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

もっと読む

準備はできましたか?

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