IronZIP を Cursor による操作する方法

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

.NET 9 サービスである ClientDrop は、各クライアントのドキュメントフォルダをクライアントがダウンロードする ZIP に詰めこみます。 それらのバンドルは System.IO.Compression で構築され、パスワードの設定方法がなく、コンプライアンスは現在すべてのバンドルを AES-256 で保護することを望んでいます。バンドルコードは IronZIP に移行する必要があり、AI エージェントによって行われた移行は、見えにくいリスクがあります。 IronZIP と System.IO.Compression は、まだコンパイルされる詳細で異なっています。System.IO.Compression はそれがパッキングする各ファイルのフォルダパスを保持し、IronZIP の Add はファイル名のみを保持します。したがって、異なる月の 2 つのステートメントは同じエントリ名を受け取ることがあります。

ポートは 3 つの Cursor 機能を使用しています。 コミットされているプロジェクトルールは System.IO.Compression の習慣を捨てるように名前付けされています。Plan Mode ではエージェントが変更前にマッピングをプランとして書き込んでおり、プロンプトの中のドキュメントリンクやルールがエージェントを IronZIP のページに誘導します。 各 ClientDrop バンドルは ビルド時に暗号化され、そのパスワードで抽出されてすべてのファイルがまだ保持されていることを証明し、テストでエントリ数を数える際に再度そのパスワードで開かれます。

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

PM > Install-Package IronZip

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

Cursor で ClientDrop を開いた状態で、以下の内容をエージェントに貼り付けます。 その 2 つのメンションはバンドルクラスと 1 つのクライアントのフォルダを添付します。

@src/ClientDrop/Bundles/BundleBuilder.cs @TestData/clients/C-1042/

Fetch https://ironsoftware.com/zip/csharp/llms.txt first and read it before any edit.
BundleBuilder packs a client folder with System.IO.Compression.
Run dotnet test once and report the result.

Then make these changes:
1. Add the IronZIP package, version 2026.10.2, to src/ClientDrop.
2. Give Program.cs an "inspect <zip> [password]" command that opens a bundle with IronZIP.
3. Have inspect print each entry's name, size and whether it is encrypted.
4. Assign License.LicenseKey the value of IRONZIP_LICENSE_KEY.
5. Keep the key out of all output, and don't list the environment variables.
6. Keep BundleBuilder.cs unchanged.

Bundle C-1042 with the current code, run inspect on out/C-1042.zip and show me the output.
Text

インスペクションコマンドは古いバンドルを読み、7 つのエントリとそのフォルダパスをリストにし、ルートの contract.pdf から statements/2026-05/statement.pdf までのすべてを暗号化なしで表示します。

プロンプトからライセンスキーを除外してください。 Agent モードでは、Cursor がコードを書き、端末コマンドを実行しますので、会話でタイプされたキーがコードやコミットメッセージにコピーできます。 代わりに IRONZIP_LICENSE_KEY 環境変数を設定します。 IronZIP はその変数を自身では読みません。これが、プロンプトがコードに License.LicenseKey を割り当てる理由です。 変数を設定して割り当てを行わないプローブでは、ライセンスエラー「本番ライセンスが必要です」が発生しました。 ライセンスキーガイドは、Git が無視できる appsettings.json ファイルのように IronZIP が独自に見る場所を扱っています。



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

ComposerはCursor独自のエージェントモデルです。 モデルピッカーは、Cursorが共同開発したSpaceXAIのGrokモデルやOpenAI、Anthropic、Google、その他の研究所のモデルも提供します。 このガイドの実行では Grok 4.7 を使用しました。どのモデルを選択するにしても、プロンプトでファイル、テスト、期待される数を名前で指定してください。

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

IronZIP の llms.txt は、それぞれの簡単な要約とともにその例とチュートリアルをリストした単一ページです。 2026年10月時点で、Cursor の @ メニューはブラウザ、Git 差分、端末、過去のチャット、ファイルおよびフォルダを提供していますが、ドキュメントのエントリがないため、プロンプトでは IronZIP のドキュメントをリンクとして提供します。

ポートはフォルダパスがどこに行くのか、IronZIP がパスワードをいつ確認するのかに依存します。 次のプロンプトでは、Cursor にページからの回答と、どのページにもポイントがカバーされていない場合の回答を求めます。

@src/ClientDrop/Bundles/BundleBuilder.cs

Your only source is https://ironsoftware.com/zip/csharp/llms.txt plus the example pages it links.
Do not edit files.
List each System.IO.Compression call in BundleBuilder.
Next to each call, name the IronZIP member that would replace it.

Then answer three questions:
1. Does Add keep the folder path of the file it is given?
2. Which call encrypts a new archive with AES-256?
3. For an existing protected archive, is the password checked at the constructor or at extraction?

Cite the page URL behind every answer, and say plainly when no page covers a point.
Text

ページは暗号化関係の質問に 2 つの半分で回答します。 パスワードの例は Encrypt を EncryptionMethods.Traditional で呼び出し、アクセスの例は同じ呼び出しを AES-256 に切り替えます。フォルダパスを Add がどう処理するかを示すページはありません。 2 つのページが誤解を招いています。 アクセスの例は、間違ったパスワードが操作を失敗させると言っていますが、これは抽出にのみ当てはまり、ファイルを追加する例は FromFile で既存の ZIP を開き、1 つのエントリーとしてその ZIP を保持する新しいアーカイブを構築します。 IronZipArchive リファレンスは、例ページに表示されていない SetPassword や RemoveEncryption などのメンバーを文書化しています。

注意してください: IronZIP では、スキルファイルも提供しており、そのfrontmatterにはironzipという名前が付けられています。 .cursor/skills/ironzip/SKILL.mdとして保存され、Cursorが起動するときに発見され、/ironzipをエージェントで入力すると1つのメッセージに添付されます。

IronZIP の規則を符号化するプロジェクトルールをどのように書きますか?

プロジェクトルールは .cursor/rules 配下の .mdc ファイルで、コードと一緒にコミットされ、各ルールはフロントマターブロックを持つ Markdown 形式です。 ルールシステムは .cursor/rules 配下の通常の .md ファイルをスキップします。この種のファイルにはフロントマターがないからです。 description、globs、alwaysApply フィールドは、Cursor がルールを適用するタイミングを決定します。

このルールは glob でスコープされているので、Cursor はコンテキストにサービスやそのテストのファイルを持つ要求に対して適用します。そして @ironzip-bundles は名前でそれを添付します。 複数のパターンは1行にカンマで区切って入力されます。 .cursor/rules/ironzip-bundles.mdc として保存してください。

---
description: Move ClientDrop bundle code from System.IO.Compression to IronZIP
globs: src/ClientDrop/**/*.cs, tests/ClientDrop.Tests/**/*.cs
alwaysApply: false
---

ClientDrop writes bundles with IronZIP and follows these rules:
- Use IronZIP only. Its package ID is IronZIP and its namespace is IronZip.
- Remove System.IO.Compression from src/ClientDrop.
- Do not add SharpZipLib, DotNetZip or another archive package.
- IronZIP's docs start at https://ironsoftware.com/zip/csharp/llms.txt.
- Set License.LicenseKey from IRONZIP_LICENSE_KEY.
- Never write a license key or a bundle password into code, tests or logs.
- Encrypt every bundle with EncryptionMethods.AES256 and BundleOptions.Password.
- Open an existing bundle with new IronZipArchive(path, password).
- FromFile, FromFiles and FromDirectory build a new archive instead.
- Do not invent IronZIP members. For a member no page documents, say so and cite the page searched.
Markdown

FromFile 行があるのは、FromFile を使用してバンドルを開いてもエラーが発生せず、元のバンドルは変更されないからです。

ルールはエージェントの要求のみに影響を与えます。 Cursor のルールページの FAQ に応じて、Tab 補完はルールを無視し、インライン編集(Ctrl+K)はユーザールールを無視します。

System.IO.Compression 呼び出しを IronZIP にマッピングする方法は?

「IronZIP を使用する」とだけ書かれたルールは、モデルが各呼び出しが何になるかを考え出します。 各 IronZIP 結果は、クライアント C-1042 の IronZIP 2026.10.2 で測定され、そのフォルダーには7つのドキュメントがあり、そのうち3つは statement.pdf という名前、2つは異なる月のフォルダに invoice.pdf として保存されています。

System.IO.Compression 呼び出し期待されるものIronZIP
ZipFile.CreateFromDirectory7 つのエントリー、フォルダが保持されるFromDirectory、スキルファイルに示されているもののみ、contract.pdfのみをパック
CreateEntryFromFile 各ファイルに対してファイルごとの 1 エントリーAdd で保存された 7 エントリーのうち 4 つは名前の下で抽出し、残りのファイルを 4 つ残しました
Delete および CreateEntryFromFile 更新モードで再発行されたドキュメントはその名前を保持しますReplaceEntry は、それが与えられたパスにちなんで新しいエントリーを命名しました。ここでは ZipWork/cursor/repo-baseline/TestData/reissue/C-1042/contract.pdf です。
ZipFile.OpenRead テストですべてのエントリーが読み取れますAES エントリーがリストされて、一つを読むと InvalidDataException 'サポートされていない圧縮方法' をスロー

重複した名前を持つバンドルでは、ReplaceEntry はリネームの前に失敗しました。 '同じキーの項目がすでに追加されています' という ArgumentException をスローし、2 つの invoice.pdf エントリーに関して発生しました。 暗号化自体は動作しました。 Encrypt を EncryptionMethods.AES256 と共に実行して 7 つすべてのエントリーが暗号化されたとマークし、ユニークな平坦名でフォルダのステージされたコピーを作成しました。たとえば statements_2026-03_statement.pdf のようなもので、オリジナルに一致する SHA-256 で抽出され 7 つのファイルになりました。この名前の重複は最も捉えにくい問題で、ステートメントを失ったバンドルでも 7 つのエントリーを保持し、クライアントが 4 つのドキュメントをダウンロードする一方で、カウントチェックが通過するからです。

ルールに翻訳を追加してください。

The port translates System.IO.Compression habits this way:
- Add keeps only the file name.
- Copy each file to a staging folder under a name unique in the bundle, and add the copy.
- One such name is statements_2026-03_statement.pdf.
- ReplaceEntry names the new entry after the path it is given.
- To swap a document, Delete the entry and Add a staged copy named like the old entry.
- System.IO.Compression cannot read AES entries. Tests open bundles with IronZIP.
Markdown

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

次のプロンプトを送信する前に、Shift+Tab を使ってチャットの入力を Plan Mode に切り替えます。 Plan Mode では、エージェントはコードを調査する際に確認の質問をすることができます。

@src/ClientDrop/ @tests/ClientDrop.Tests/ @ironzip-bundles

Plan the move of BundleBuilder from System.IO.Compression to IronZIP.
Every bundle is encrypted with AES-256 using BundleOptions.Password.
Map each System.IO.Compression call to the IronZIP member that replaces it.
For each call, name the file it lives in.
Public method signatures on BundleBuilder stay as they are.
No test is renamed or loses an assertion.
Write no code yet.

In the plan, tell me how each of these works:
- The three files called statement.pdf in different folders all survive.
- The tests read an encrypted bundle.
- Reissue swaps a document without renaming it.
Text

計画は編集可能な Markdown ファイルですので、誤ったマッピングは何かが構築される前に修正できます。 計画が正しいとき、Plan Mode からそれを構築するか、次のプロンプトで Agent モードに戻り検査を追加することができます。

Build the approved plan with @ironzip-bundles attached.
Remove every System.IO.Compression call from src/ClientDrop.
In the tests, change only BundleReader.
Set CLIENTDROP_BUNDLE_PASSWORD to a throwaway value inside each command you run.

After the build, carry out these steps in sequence:
1. Build and run the tests.
2. Run "bundle C-1042", then run "inspect" on the result with that password.
3. Extract that bundle with IronZIP to an empty folder.

Report how many tests pass now and how many passed at the start.
Also report how many files the client folder and the extracted folder each hold.
Text

校正の結果、各呼び出しを最も近い IronZIP メンバーにスワップした真っ直ぐな翻訳がクリーンにコンパイルされ、6 つのテストのうち 4 つに合格しました。 失敗したのは抽出チェックと再発行の 2 つ。 ルールに従ったポートは6つすべてを合格しました。

保護されたバンドルから 1 つのドキュメントを取り出す方法は?

BundleBuilder は、クライアントがまだダウンロードしていないバンドルから 1 つのドキュメントを取り除く方法も必要とします。 BundleBuilder.cs 内の Reissue メソッド全体をハイライトし、Ctrl+Shift+L を押して開いているチャットに追加し、Agent モードでリクエストを送信します。

Below the highlighted Reissue, add Withdraw(string bundlePath, string entryName).
It takes one document out of an existing bundle and keeps the rest encrypted.
For a name the bundle lacks, it throws KeyNotFoundException, as Reissue does.
Add a "withdraw <zip> <entry>" command to Program.cs.
Try it on a fresh C-1042 bundle, with CLIENTDROP_BUNDLE_PASSWORD set inside each command.
Show me what each command prints.
Text

結果として得られた Withdraw は Contains ガードで、その後 Delete、Encrypt を EncryptionMethods.AES256 と Save で行い、パスワードで開かれたアーカイブに対して実行します。 C-1042 から contract.pdf を引き出しても 6 つのエントリが残り、すべてが引き続き暗号化されました。 校正の中で、2 つのドキュメントが含まれるバンドルが 1 つのドキュメントを保持し、その後そのバンドルを開くのに失敗しました。

1 ドキュメントのバンドルが自分のパスワードを拒否するのはなぜ?

IronZipArchive コンストラクタは、保護されたアーカイブがちょうど 1 つのエントリーを持つとき、正しいパスワードを拒否します。 IronZIP 2026.10.2 では、AES-256、AES-128、従来の暗号化で暗号化された 1 エントリーのアーカイブに対して '無効なパスワード!' というメッセージを返す例外をスローし、バイト配列のオーバーロードと FromArchive も同様にしました。 同じパスワードで ExtractArchiveToDirectory がファイルを問題なく抽出しました。2 つ以上のエントリーは通常通り開くことができました。

クライアント C-1077 に 1 つのドキュメントがあります。それは歓迎の手紙です。 そのフォルダ、訂正された手紙、プログラムを一緒に言及してください。

@TestData/clients/C-1077/ @TestData/reissue/C-1077/ @src/ClientDrop/Program.cs

Client C-1077 has a single document.
Set the same throwaway CLIENTDROP_BUNDLE_PASSWORD inside each command.

Run these three steps in order:
1. Run bundle C-1077.
2. Run list on out/C-1077.zip.
3. Reissue its welcome-letter.pdf from TestData/reissue/C-1077/.

If any step throws, find the cause and fix it in BundleBuilder.
Don't catch and hide the exception.
If a line of @ironzip-bundles led to it, change that line too.
Then run all three steps again.
Show me the error you hit and the list output after the reissue.
Text

校正の中で、そのバンドルは書かれ、続いてリストと再発行が失敗し、またバンドルコマンド自体も失敗しました。これにより新しいバンドルがリストされ、そのエントリ数を出力するようにしています。 バンドルを一時フォルダに抽出して読み取り、そのフォルダから再発行や引き出しのために再度書き込み、2,643 バイトの手紙をリストにし、訂正されたものに置き換えられました。 このブロックを翻訳の下に追加してください。

One-document bundles follow this rule:
- On a protected one-entry bundle, the IronZipArchive constructor rejects the correct password.
- List, reissue and withdraw such a bundle by extracting it with ExtractArchiveToDirectory.
- Then pack the extracted folder again.
Markdown

バンドルの回帰テストをどのように書きますか?

クラウドエージェントが回帰スイートを書けます。接続されたソースコントロールからリポジトリをクローンするので、先にポートしてください。そしてクラウドエージェントのダッシュボードに IRONZIP_LICENSE_KEY をシークレットとして追加し、開始します。

@tests/ClientDrop.Tests/ @TestData/

Extend BundleBuilderTests for the IronZIP port with tests for these cases:
- The three statement.pdf documents from different C-1042 folders all survive a round trip.
- Those three documents keep distinct entry names.
- Every entry in the C-1042 bundle is encrypted.
- A wrong password fails when the bundle is extracted.
- A one-document bundle can be listed, reissued and extracted.
- Withdraw removes exactly one document.
- Withdraw throws KeyNotFoundException for an unknown name.

Compare extracted files by SHA-256, never archive bytes.
Run dotnet test and report how many tests pass and fail.
Text

誤ったパスワードのテストはバンドルを抽出する必要があります。 3 つのエントリーを持つバンドルで、コンストラクタはエラーなしで間違ったパスワードを受け取り、エントリー数、エントリーリスト、名前の検索はすべて正しいかのように応答しました。 ExtractArchiveToDirectory がそれを拒否する最初の呼び出しであり、「無効なパスワード!!」という ArgumentException をスローしました。 抽出によってエントリーをリストするポートは、最初の読み取りで間違ったパスワードを拒否します。

IronZIP の AI コーディングアシスタントガイド は、1 つの IronZIP タスクを定義された合格基準に対して完全に実行します。

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

7 つのプロンプトがこのガイド用に作られた ClientDrop リポジトリのコピーに対して、1 つのチャットで順に Cursor に送信されました。このコピーには System.IO.Compression の BundleBuilder、System.IO.Compression を用いてバンドルを読む 6 つの xUnit テスト、クライアント C-1042 を含んでいます。ルールファイルとクライアント C-1077 はそれを使用するプロンプトの直前に追加され、ライセンスキーは環境変数としてのみ設定されました。 以下のすべての数字は、チャット終了後にコミットされたコードのビルドと実行の結果です。

  • ポートの前にすべての 6 つのテストが合格し、ポートの後も同じ 6 つが合格しました。
  • ポートされた C-1042 バンドルにはユニークな平坦名の下で 7 つのエントリが含まれていました。
  • IronZIP はそのバンドルから 7 つのファイルを抽出し、クライアントフォルダに含まれる数と一致しました。
  • pyzipper、IronZIP とはコードを共有していない Python ZIP リーダーは、すべての 7 つのエントリで AES-256 暗号化を見つけました。
  • すべての 7 つの抽出されたファイルが、SHA-256 によってクライアントフォルダのファイルと一致しました。
  • IronZIP がパスワードを確認する場所を尋ねた際、Cursor はコンストラクタを名指しし、アクセスの例を引用しました。
  • Withdraw はバンドルに欠けている名前に対して KeyNotFoundException をスローしました。
  • 修正前は C-1077 のためのバンドル、リスト、再発行ステップがそれぞれ IronZipArchive コンストラクタから「無効なパスワード!」という例外をスローしました。
  • 修正後、リストは 2,643 バイトの welcome-letter.pdf を示し、再発行後は 2,761 バイトでした。
  • pyzipper が抽出した再発行済みの手紙は、SHA-256で訂正後のファイルと一致しました。
  • 各 C-1077 バンドルも空のエントリー __bundle_keep を保持しており、抽出によりそれを 2 番目のファイルとして出力しました。
  • 最終コードでは、2 ドキュメントバンドルから 1 つのドキュメントを引き出して 1 つのエントリーが残り、リストは「無効なパスワード!」をスローしました。
  • テストプロンプトは 6 つのテストを追加し、すべての 12 が合格しました。
  • IronZIP 2026.10.2 はサービスで唯一のパッケージであり、そこには System.IO.Compression 呼び出しが残っていませんでした。
  • プロンプト完了後、各リリースビルドは警告やエラーなしに終了しました。
  • 一部のステップはページと異なる方法で実行されました。 Plan Mode では、Cursor はルールファイルを開く前にリポジトリ外のフォルダを検索して ironzip-bundles を探しました。C-1077 用に、Cursor は 1 ドキュメントバンドルに __bundle_keep エントリを追加し、その読み出しを抽出の代わりにルールに書きました。 クラウドエージェントプロンプトはローカルで同じチャット内でエージェントモードとして送信され、クラウドエージェントではありませんでした。

コード良好の計画は、Claude Code ガイドでも行われ、計画は抽出されたコピーから各アーカイブを再構築し、単一エントリーアーカイブを扱いました。GitHub Copilot ガイドはその TAR ルールを適用価値に基づいてログアーカイバとそのテストに制約し、globs は同じ方法でこのルールを制限します。 実行記録は、Cursor のバージョンとモデルの名前付け、総プロンプト時間、テスト機のハードウェアを示しています。


トラブルシューティング


質問ありますか?

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

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

もっと読む

準備はできましたか?

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