GitHub Copilotを使用したIronXLの使い方

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

.NETのレポートソリューションは、すでに正しい数値をプレーンなワークブックに記入することができ、その上で外観に関するリクエストを受け取ることができます。 財務部門はヘッダー色、千位単位の区切り、ハイライトされたマージン、スクロール時に固定されるヘッダー行、他のシートが指し示せる名前を求めています。

IronXLはフォント、塗りつぶし、数値形式、条件付き規則、ウィンドウ枠の固定、列幅、テーブル、名前付き範囲のスタイリングコールを提供します。 リポジトリにコミットされた2つの指示ファイルが、これらのコールの振る舞いを記録します。

このガイドは、既存の月次売上レポートの出力をスタイリングし、ワークブックを保存し再度開いてすべての設定を読み取るテストで各スタイルを証明します。 セルフォーマットガイドと条件付きフォーマットガイドがコール自体を文書化しています。

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

PM > Install-Package IronXL.Excel

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

ソリューションルートで端末を開き、copilotを開始し、このプロンプトを送信します。 Visual Studioチャットは同じ2つのファイルを#report-style.mdと#ReportStyler.csとして扱います。

Read @docs/report-style.md, then fill in @src/FinanceReports/Styling/ReportStyler.cs.
Give it a public static ApplyHouseStyle(WorkBook workbook) method.
It styles the workbook that MonthlySalesReport.Build returns.
IronXL is the IronXL.Excel package.
Styling types are in IronXL.Styles and number formats in IronXL.Formatting.

Keep this first pass to the header row, the data rows and the Total row of the Sales sheet.
Set their fonts, fills, borders, alignment and number formats. The other sections come later.
Find the Total row by the word Total in column A. Don't count on a fixed row number.

1. Call ApplyHouseStyle from Program.cs just before SaveAs.
2. Run the job.
3. Load out/monthly-sales-2026-09.xlsx again.
4. Print the fill and font color of A1 and the FormatString of E2, exactly as IronXL gives them.
Text

プロンプトはIronXLがリロード後に色とフォーマットをどのように報告するかについて何も言及しません。パス固有の指示ファイルがこれらの規則を引き受けるからです。

環境にCopilotを開始するIRONXL_LICENSE_KEYを設定し、キーを保持する他の場所についてはライセンスキーガイドを参照してください。 プロンプトやコミットに含めないようにしてください。 ここでのすべてのテストはワークブックを読み込むため、テストが実行される場所にはキーが存在する必要があります。



Visual Studioですでに進行中のプロジェクトにCopilotをどのように組み込むのですか?

ターミナルからCopilot CLIを使用するか、Visual StudioまたはVS Codeでエージェントモードを使用し、視覚化したいスタイリング変更を観察できます。これによりソリューションを構築し、レポートジョブを自分で実行できます。 インラインチャットは1ファイルの変更で十分です。 GitHubのクラウドエージェントは、割り当てられた業務を受け取り、プルリクエストを返します。

Copilot用のIronXL規則をどのように設定しますか?

IronXL規則を.github/copilot-instructions.mdとしてコミットしてください。 Copilot CLI、Visual StudioとVS Codeでのチャット、クラウドエージェント、Copilotのコードレビューがすべてそれを読み込みますので、パッケージ、ライセンスルール、テストルールをそこに置いてください。

# Copilot instructions

## Workbooks

- Excel work uses IronXL from the IronXL.Excel NuGet package. Styling types
  live in IronXL.Styles, number formats in IronXL.Formatting, and comparison
  operators in IronXL.Formatting.Enums. Add no other spreadsheet package and
  no Office Interop.
- The IronXL version is pinned in Directory.Packages.props. Leave it alone
  unless the task is an upgrade.
- The license key comes from the IRONXL_LICENSE_KEY environment variable,
  and the program reads it there. Never put a key in code, settings files,
  tests or console output, and don't list environment variables.
- docs/report-style.md is the source for every color, border, format and
  name in the monthly sales workbook.
- IronXL documentation is at https://ironsoftware.com/excel/csharp/llms.txt
  and https://ironsoftware.com/excel/csharp/skill.md
- Say so whenever you depart from docs/report-style.md, and before you use
  an IronXL member you cannot find in IronXL.xml in the NuGet cache.

## Tests

- Build the workbook into a temporary folder, save it, load it again with
  WorkBook.Load and assert on what the loaded file reports.
- Never compare workbook bytes and never edit files under TestData.
Markdown

スタイリングコードに独自のルールをどのように設定しますか?

スタイルを設定またはチェックするコードにのみ重要なルールは.github/instructions/workbook-styling.instructions.mdに入力してください。 そのapplyTo値は2つのフォルダーをコンマで区切って名前を付けます。これにより、ルールがスタイラーとそのテストに到達し、CSVインポートに関するリクエストから外されます。 GitHubのドキュメントによれば、CLIはCopilotがグロブに一致するファイルで作業しているときにのみファイルを含めます。 私たちの実行中、Copilot CLIはすべてのセッションでファイルのパターンとパスを一覧表示し、エージェントにコードを変更する前にそれを読むよう指示しました。 エージェントは、コードを変更したすべてのプロンプトで最初の編集の前にそれを開き、セッションですでにコピーされているものを除いて、コピーを利用していました。

---
applyTo: "src/FinanceReports/Styling/**,tests/FinanceReports.Tests/**"
---

- IronXL returns colors as lowercase hex. A fill set with "#1F4E78" reads
  back as "#1f4e78", so compare colors ignoring case.
- A cell with no fill still reports BackgroundColor "#ffffff". Use
  FillPattern (NoFill or SolidForeground) to tell the two apart.
- FormatString only changes how numbers and dates display. A number written
  as a string keeps its raw text, its DecimalValue is 0, and SUM skips it.
- Font.Height is the size in points, the number Excel shows.
- Call AutoSizeColumn last. It measures the formatted text in the cell's
  font, and on a machine without that font it measures in Arial.
- AddNamedTable and AddNamedRange throw ArgumentException when the name
  already exists, and AddConditionalFormatting adds another copy of a rule
  on every call. Guard each one so restyling a styled workbook changes nothing.
- IronXL has no getter for freeze panes. Check one by reading the pane
  element in the sheet XML.
Markdown

長いプロンプトの前にどちらのファイルがアクティブか確認するために、CLIセッションで/instructionsを実行します。

IronXLはリロード後にセルスタイルをどのように読み取りますか?

IronXLがWorkBook.Load後に返す一部の値は、コードが渡したものと異なります。 IronXL 2026.10.1では、フォントが"#FFFFFF"で設定されると#ffffffとして読み取られ、境界が"#BFBFBF"で設定されると#bfbfbfとして読み取られます。 私たちのリファレンスワークブックに対するAssert.Equal("#1F4E78", cell.Style.BackgroundColor)は失敗し、大文字と小文字の違いを無視する比較が成功しました。 レポートは日付値を書き出し、IronXLはそれらのセルにm/d/yy h:mm形式を与え、スタイラーがyyyy-mm-ddを設定するまで。 #,##0.00を使用したFormattedCellValueが176,366.84を返しましたが、Textはまだ176366.8415714288を返しました、これはその下にある数値です。 文字列"-0.075"として書かれたマージンは、そのテキストを0.00%の下で保持し、IsTextはtrueでした。 テキストとして書かれた収益額は、フォーマット文字列#,##0.00を保持していたため、FormatStringのみをチェックするテストはその壊れたセルで合格します。 パッケージと一緒に配布されたXMLドキュメントは、Font.Heightをピクセルで説明していますが、12の高さはサイズ12として保存されました。

条件付きフォーマット、窓枠の固定、列幅をどのように追加しますか?

マージンルールはCreateConditionalFormattingRuleから得られます。これはComparisonOperatorと数式を取り、AddConditionalFormattingがそのルールを範囲に添付します。 固定ヘッダーは1回のコール、CreateFreezePane(0, 1)です。最初の引数は固定列を数え、2番目は固定行を数えるため、CreateFreezePane(1, 4)が列Aと行1から4を固定しました。列の幅はAutoSizeColumnから得られます。

Add three more parts of @docs/report-style.md to ApplyHouseStyle.
It lives in @src/FinanceReports/Styling/ReportStyler.cs.

- The margin highlighting. Both rules go on the data rows of column F and stay off the Total row.
- The frozen header row.
- The column widths. Size them as the very last step, after every font, fill and number format.

Run the job and reload the output. Then print:

- the range, operator and formula of each rule, as IronXL reads them
- the pane element in the Sales sheet's XML
- the width of columns A to F
Text

リファレンススタイラーは最後に列を調整し、列AからFに対して2,790、6,988、3,660、1,740、3,430、1,792の幅を得ました。GetColumn(i).Widthが私たちの実行で返した1/256文字の単位で。 フォーマットより前に先にサイズ調整すると、ユニットが1,587、収益が3,123になり、千位単位の区切りが表示されると狭く、日付列が3,635になりました。これは長いデフォルトの日付と時刻フォーマットに対して測定されました。

フォントも数字を変更します。 私たちのWindowsマシンでは、インストールされていない4つのフォントが正確にArialの幅を生成し、それらはCalibriよりも6〜9パーセント広くなりました。 そのため、正確な幅を固定するテストは、報告のフォントが欠けている走者では失敗します。

ウィンドウ枠はシートのXML内で<pane ySplit="1" topLeftCell="A2" activePane="bottomLeft" state="frozen"/>として書かれており、IronXLを介してロードおよび保存の後も維持されました。

IronXLは各ルールの塗りをxl/styles.xml内のカスタムインデックスパレットにエントリとして保存し、私たちのファイルには正しい色、FFC7CEとC6EFCEが含まれていました。 PatternFormatting.BackgroundColorを通して読み取ると、両方のルールが#ffc7ceを報告しました。 各ルールの範囲、演算子、数式、フォント色は正しく読み取られました。 塗りだけがファイルを必要としますが、両方の色をそれから読み取ることが1つのテストヘルパーでカバーすることを可能にします。

名前付きテーブルと名前付き範囲をどのように追加しますか?

スタイルドキュメント内の名前は2つのコールから得られます。 AddNamedTable("SalesData", range, true, TableStyle.TableStyleLight9, true)はヘッダーとデータ行をフィルターボタン付きのテーブルに変えます。 AddNamedRange("TotalRevenue", range, true)はトータル行の収益セルに、Summary数式が=TotalRevenueとして使用できるワークブック全体の名前を与えます。 EvaluateAllの後、その数式はそれが名前付けたセルと同じ合計を返しました。 FindNamedRange("TotalRevenue")は参照をテキスト'Sales'!$E$38:$E$38として返しRangeとしては返しません。 SaveAsNamedTableとSaveAsNamedRangeがRange上で同じ作業を行います。

4つのコールのいずれも既存の名前をチェックしません。 すでにスタイリング済みのワークブックでスタイラーを再度実行すると、AddNamedTableがArgumentExceptionをスローし、メッセージは"ワークブックにはすでに名前: SalesDataを持つテーブルが含まれています"と言われます。 AddNamedRangeはTotalRevenueについて同様の動作をし、2つのSaveAsコールが同じ2つの例外をスローします。 AddConditionalFormattingはスローしませんでした。私たちのテストでは2度目の実行が2つのマージンルールから4つになりました。 IronXLはまたSales Tableというテーブル名を拒否しました。ArgumentExceptionは名前がスペースを含んではならないと言っています。

Finish @src/FinanceReports/Styling/ReportStyler.cs with what's left in @docs/report-style.md.
That's the SalesData table, the TotalRevenue name and the Summary sheet rules.
Column sizing stays the final step.

Finance fixes figures directly in a saved workbook and sends it back for the house style.
So add a restyle <path> command to Program.cs.
It loads the file, calls ApplyHouseStyle and saves the file over itself.
Restyling a file twice has to leave exactly one table, one TotalRevenue name and two margin rules.

Show me that it holds:

1. Run the job once.
2. Make a copy of the output in out/ and restyle that copy twice.
3. After each pass, print the table names, named ranges, rule count and the value of Summary!B2.
Text

新しいものを追加する前にRemoveConditionalFormattingで古いマージンルールを削除するか、シートにすでにあるルールをスキップすることで、ルールの数を2に保ち、各追加の前にGetNamedTableNamesとGetNamedRangesを確認することで、2度目のパスがスローされるのを防ぎます。

リロード後にExcelスタイルをどのようにテストしますか?

スイートにはいくつかのヘルパーが必要です。シートXMLを読み取りルールの色を解決するものが1つあるので、このプロンプトは/planから始まります。 計画モードではCopilot CLIがプロジェクトファイルへの編集を計画を承認するまでブロックします。

/plan an xUnit suite in tests/FinanceReports.Tests that checks the house style after a reload.

Build the September report into a temp folder, save it and open it again with WorkBook.Load.
Then check each rule in docs/report-style.md against what the reopened file holds.

- Check FillPattern beside every fill color.
- Read the frozen pane from the Sales sheet XML with ZipArchive.
- For the margin rules, read each rule's range, operator and formula through IronXL.
- Resolve each rule's fill and font color from its dxf entry in xl/styles.xml.
- An indexed color there points into the indexedColors list, so follow it.
- Check FormattedCellValue for a sample of cells in every numeric column.
- Add a test that restyles a saved copy twice.
- For the widths, autosize a reloaded copy again and confirm no column moves.
- Never assert an exact column width.

Implement the plan, then run dotnet test.
Text

書式設定されたセル値が文化によって依存するのはなぜですか?

IronXLは現在の.NET文化でFormattedCellValueをフォーマットします。 いずれの場合もワークブックは同じファイルであり、すべての文化でフォーマット文字列は#,##0.00として読み取られました。

  • en-CA: 収益セルは176,366.84を表示しました。
  • de-DE: 同じセルは176.366,84を表示しました。
  • fr-FR: 同じセルは176 366,84を表示し、ギャップはナロースペース(U+202F)です。

-0.075のマージンが0.00%としてフォーマットされ、de-DEとfr-FRの両方で-7,50%として戻ってきました。 Textも変わりますが、DecimalValueは変わりません。

スイートCopilotは、/planプロンプトから書かれたものは直接それらの文字列と比較し、たとえば最初の収益セルのAssert.Equal("47,999.33", ...)などです。 私たちはそれをde-DEとfr-FRの下でもう一度実行しました。 ホームスタイルテストは両方とも失敗し、47.999,33と47 999,33が実際の値であり、他の3つのテストは合格しました。

そのテストの最上部でCultureInfo.CurrentCultureをen-USに設定すると、de-DEとfr-FRのテストに再び合格しました。 de-DEで読み込まれ、en-USに切り替えた後に読み取られたワークブックは、176,366.84を示しました。テストがセルを読むときに有効な設定が最も重要です。 表示文字列を比較するテストでは文化を固定するか、DecimalValueとFormatStringを比較して下さい。 同僚のノートPCやクラウドエージェントの環境は、予期していた文字列を生成したマシンと異なる文化で動作する場合があります。

クラウドエージェントが行動できる問題を作成するにはどうすれば良いですか?

クラウドエージェントは、問題のタイトル、説明、既存のコメント、割り当て時に追加された指示を受け取ります。 GitHubは後から掲載されたコメントを見ないと述べているので、すべての要件とジョブを閉じるテストが問題の本文に含まれている必要があります。

Title: Add an XLS copy of the monthly sales workbook for the ERP import

**Files:** src/FinanceReports/Program.cs, src/FinanceReports/Styling/ReportStyler.cs
**IronXL version:** as pinned in Directory.Packages.props
**Framework:** .NET 9

**Expected:** Each run writes out/monthly-sales-2026-09.xls next to the XLSX,
with the same values and the house style in docs/report-style.md, except the
SalesData table. The TotalRevenue name and Summary!B2 stay.

**Actual:** The ERP import accepts only .xls, and finance converts the file by
hand every month.

**Constraints:** Leave the XLSX output unchanged. Build the XLS workbook with
WorkBook.Create(ExcelFileFormat.XLS) rather than saving the XLSX under a new
extension. In XLS, set every fill before any font color. No new packages.

**Acceptance:** dotnet test passes, plus tests that reopen the .xls and check
the header fill and white header text, the four number formats, the
TotalRevenue name and the operator and formula of both margin rules.
Markdown

問題中のXLSルールは、測定から生じます。

  • 名前付きテーブル: XLSワークブックでのAddNamedTableとSaveAsNamedTableは"名前付きテーブルをサポートするのはXLSXのみです。"というNotSupportedExceptionをスローします。
  • .xlsパスでのSaveAs: スタイリングされたXLSXワークブックでのSaveAsはFormulaParseExceptionをスローし、そのメッセージは、名前付き範囲TotalRevenueが現在のワークブックに存在しないと言いました。
  • 塗りの順序: XLSは色を共有パレットに保存し、1つのプローブで、3つの塗りが追加される前に白に設定されたヘッダーフォントは#ddebf7として戻り、それは2番目の塗りでしたが、まずは塗りを設定すると#ffffffのままでした。
  • ルール塗り: リロードされたXLSファイルからのマージンルールの塗りを読み取るとNullReferenceExceptionがスローされるため、受け入れラインでは各ルールの演算子と数式が要求され、その色は要求されません。

IronXLプロジェクトでクラウドエージェントのテストが失敗する理由は何ですか?

デフォルトではエージェントの環境はUbuntu Linuxを実行します。 スタイリングテストがエージェントがプッシュしたブランチで一緒に失敗するとき、差分の前に最初の例外を読みます。 LicensingExceptionはライセンスキーを指します。

クラウドエージェントはアクション、コードスペース、Dependabotの秘密を読み取れないため、キーはエージェントの秘密が必要です。 設定の下にIRONXL_LICENSE_KEYを追加し、次に秘密と変数、次にエージェントを追加すると、エージェントは環境変数としてそれを受け取ります。 エージェントのプルリクエストは実際のリポジトリに着地するため、ブランチ保護と人間の承認をオンにしておいてください。

他のライブラリからのワークブックでスタイリングが失敗する理由は何ですか?

EMEAオフィスからのワークブックは、openpyxlで開発されたPythonジョブによって、そのレポートと同じレイアウトで書かれ、最初にスタイルセッターで呼び出されたときInvalidOperationExceptionで"Nullable object must have a value"がスローされました。太字テキストを設定した場合でも、数値形式を設定した場合でも。 ApplyHouseStyleは私たちが書くすべての自分のジョブで動作し、それがスタイラーのバグのように見えますが、原因がファイルにあるわけでないことです。

A colleague added tests/FinanceReports.Tests/PartnerWorkbookTests.cs and it fails.
It covers the workbooks the EMEA office sends, which a Python job writes with openpyxl.
It throws InvalidOperationException "Nullable object must have a value".
The exception comes from deep inside the first style setter.
ApplyHouseStyle still passes on our own output.

Before you edit anything, find out what causes it and tell me:

1. Open TestData/partner/emea-2026-09.xlsx and one workbook our job writes with ZipArchive.
2. Compare the fill entries in xl/styles.xml.
3. Try a single style setter on each workbook.

Then fix it at the point where the restyle command and this test load a workbook.
Leave the partner file untouched on disk and add no package.
Run dotnet test when you're done.
Text

パートナーファイルの最初の塗りは<patternFill />で、patternType属性がなく、openpyxl 3.1.5でそのデフォルトの塗りのために書かれたものです。 私たちの仕事のファイルには同じ場所に<patternFill patternType="none"/>があります。 IronXLはパートナーファイルを読み込み、その値をエラーなしで読み取りました。 それを読み込み、IronXL経由で保存してもう一度読み込むと、裸の要素が保持され、それでもスローされました。 メモリ内のその要素に欠けている属性を追加し、プローブでWorkBook.Load(Stream)を介して、または仮のコピーから修正されたパッケージを読み込むと、完全なホームスタイルが適用され、ディスク上のファイルはパートナーが送った通りに残りました。

読み込みのステップで修正を保持することで、スタイラー内で例外をキャッチして問題を隠し、パートナーワークブックを無題のままにすることを防ぎます。

マージする前に何を確認すべきですか?

GitHubのドキュメントは/reviewがcopilot -pプロンプトとして送信されていることを示しており、このレビューはマージする前にスクリプトから実行できます。

/review the commits on this branch after the first one.
Check them against docs/report-style.md and both instruction files under .github.

Flag any of these:

- a color compared with case-sensitive equality
- an AutoSizeColumn call that runs before a later format or font change
- an AddNamedTable, AddNamedRange or AddConditionalFormatting call with no guard for a second run
- a test that pins an exact column width or compares workbook bytes
- an IronXL member that isn't in IronXL.xml in the NuGet cache

Give each finding its file and line. Don't edit anything.
Text

プロンプトは両方の指示ファイルを名前付けするので、スタイリングルールはレビュー全体に適用され、グロブと一致するファイルだけではありません。 GitHub上のCopilotコードレビューはパス固有のファイルもサポートしています。

差分はまだ、レビューとテストが見逃すことができる1つのことを人間が読む必要があります。つまり、値が変更されたかどうかです。 スタイリングは、レポートで書かれた各数値と日付、およびSummary!B2以外の各式をそのままにしておく必要があります。これをスタイルドキュメントでTotalRevenue名に移動します。 総計はCSVフィードと一致する必要があります。

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

Copilot CLIはキーボードに誰もいない状態で6つのプロンプトを順番に受信しました。 最初の5つは1つのセッションを共有し、/planプロンプトが計画モードと自動操縦で実行され、/reviewが独自のcopilot -pコールとして実行されました。 目標は、このガイドのために.NET 9上で構築されたレポートソリューションで、スタイルを変更していない9月のワークブックをCSVフィードから書き込み、まだテストのないxUnitプロジェクトとスタイルドキュメントです。 パートナープロンプトの1つ先行してコミットし、EMEAワークブックと同僚の失敗テストを追加しました。以下のすべての数字は、ソリューションを再構築し、ジョブを再実行し、Copilotが終了した後にテストを実行したことから得られました。 AIコーディングアシスタントガイドは、この種のチェックを繰り返し可能なテストに変えます。

  • 最初のプロンプトの後、私たちのスタイルチェックは30のチェックのうち23を通過し、その中にはすべてのヘッダー、データ、合計のチェックが含まれています。 ルール、ウィンドウ枠と幅の後、30のうち25を通過し、名前と再スタイルコマンドの後に31のうち31を通過し、すべての値はまだCSVフィードと一致しています。
  • 2番目のプロンプトの後、列幅は基準スタイラーと正確に一致し、両方のマージンルールがF2:F37にありました。
  • コピーを2回再スタイルすると、1つのテーブル、1つのTotalRevenue名、2つのマージンルールが残り、Summary!B2はまだ10,977,073.68を返しました。
  • 計画されたスイートは、3つのテストのうち3つを通過しました。 最終コードのコピー内でフォーマット前に列のサイズ調整を移動すると、その幅テストが失敗しました。
  • パートナープロンプトの後、4つのテストすべてに合格し、EMEAワークブックの再スタイルされたコピーが32のチェックすべてに合格しました。
  • /reviewコールは、5つのリストされた問題のどれも見つけませんでした。
  • 一部のステップはページと異なる方法で実行されました。 最初のプロンプトは2つのマージンルールも追加しましたが、ページはそれを2番目に任せます。 前回の実行では幅テストは幅が存在することのみをチェックし、最初にカラムがサイズ調整された状態で合格したため、/planプロンプトは現在、2度目のオートサイズパスを要求しています。 問題、クラウドエージェント、エージェントシークレット、プルリクエストレビューにはホスティングされたリポジトリが必要ですので、どれも実行されませんでした。

Copilot CLIのバージョン、モデルAutoが選択されたもの、ランタイム、テストマシンは、ランレコードの中で各ガイドに対して1回記録されます。


トラブルシューティング


質問ありますか?

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

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

もっと読む

準備はできましたか?

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