IronZIP と ChatGPT Codex の使い方

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

パートナーは、自社システムが作成する形式で夜間ファイルを送信します。 一つはZIPファイルで、パスワードの有無に関わらず、LinuxホストからのTARとTGZバンドル、BZIP2ストックバンドル、ZIPである.tarと名付けられたファイル、途中でアップロードが停止したファイルが含まれています。 受付はそれぞれを解凍し、各ファイルがパートナーから送られたとおりに到着したことを証明し、どのアップロードが失敗したかとその理由を報告する必要があります。

ChatGPT Codex は、OpenAIのコーディングエージェントで、ターミナル、エディタ、ChatGPTデスクトップアプリ内、そしてクラウドサービスとして動作し、これらすべてがChatGPTのサインインを受け入れます。 IronZIP は、Iron Software の .NET ライブラリで、ZIP、TAR、GZIP、BZIP2 アーカイブの読み書きに使用されます。

このガイドはCodexに25のアップロードを落として、ステータスを示すマニフェストと各パートナーからのSHA-256リストを提供します。 ほとんどのプロンプトがCodexに対して各ファイルに1行を持つCSVを要求し、以下で記載されたすべてのIronZIPの動作はバージョン2026.10.2で測定されました。

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

PM > Install-Package IronZip

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

.NETコンソールプロジェクトからCodexを起動し、最初にリストを要求してください。

$ironzip Add IronZIP 2026.10.2 from NuGet to this console project.
Next, Program.cs opens every file in Drop/sample/ with IronZipArchive, read-only.

out/quickstart.csv gets one row per file, holding these values:

- entry count
- encrypted entry count
- the exception type when IronZIP refuses the file

Read that CSV back and print its totals.
Assign the key from IRONZIP_LICENSE_KEY and never print it.
Extract nothing yet.
Build and run it with three repair attempts at most, then report what happened.
Text


ChatGPT Codexとは何で、.NETアーカイブ作業にどのように適合するのですか?

Codex CLI ページは、npm install -g @openai/codex や単独のインストーラーでのインストールをカバーし、IDE ページはエディターをカバーしています。

OpenAIのセキュリティガイダンスは、Codexの提案を他のプルリクエストと同様に取り扱い、ターゲットとした検証と差分レビューを行うよう求めています。 発明されたメンバーがビルドに失敗し、誤処理されたアーカイブがマニフェストに反するステータスとして表示されます。

IronZIPのプロンプトを書いてCodexをどのように設定しますか?

受付のプロンプトは入力、形式ルール、出力フォルダー、チェックサムの証明、パスワードのソース、読み取り専用フォルダーを指定します。 省略された部分はエージェントが選択を行います。

Codexは、作業ディレクトリ内およびリポジトリのルートまでの各親フォルダー内の.agents/skillsをスキャンします。 IronZIPのskill.mdは.agents/skills/IronZIP/SKILL.mdとして保存され、$ironzipを解決します。 その例では2026.8.2を固定しており、以下で測定されたTARフォルダの失敗や単一エントリパスワードの失敗には言及していません。

Codexは、各実行の開始時にAGENTS.mdを読み込み、プロジェクトルートから作業フォルダーまでのパス上にあるフォルダーごとに最大1つのファイルを読み込みます。 作業フォルダーに近いファイルが以前のファイルを上書きします。 IronZIPのllms.txtインデックスは2番目のAPIソースです。

Give the repository root an AGENTS.md holding a Partner drop intake section.
The section holds these rules:

- IronZIP is the only archive library allowed.
- Its package is IronZIP, and its namespaces are IronZip and IronZip.Enum.
- The API sources are the ironzip skill in .agents/skills/ironzip/ and the llms.txt index.
- The index URL reads https://ironsoftware.com/zip/csharp/llms.txt.
- Nothing under Drop/ or config/ may change.
- Passwords from config/passwords.csv never appear in code, output or logs.
- IRONZIP_LICENSE_KEY is checked for presence and length only.
- A reply gives a count only when a results file backs it.
- That file was read or written in the same turn.
Text

CodexにIronZIPを追加してパッケージを確認する方法は?

Show me these:

- the IronZIP PackageReference in DropIntake.csproj
- the version restore resolved
- every IronSoftware package that dotnet list package --include-transitive reports

If that command can't read the package reference, find out why within three attempts.
Make the smallest change that lets it run, and say what you changed.
Keep the same package and version.
Write the packages that command lists to out/packages.csv.
Text

NuGetはパッケージをIronZIPとしてリストし、コードはIronZipネームスペースをインポートします。 .NET SDK 10.0.400を使用して、IronZIPのスキルが提供するコマンドdotnet add package IronZipは、リファレンスをIronZIPとして書き込み、リストア時にIronZipを記録し、dotnet list packageは次にパッケージリファレンスを読み取れない状態で停止しました。 パッケージをIronZIPとして追加することで、2つのスペルが同じままになりました。 唯一の依存関係であるIronSoftware.Common 2026.4.2は、.NET 9のリストアに23のパッケージを追加しました。

IronZIPはキーなしの縮小モードがありません。 プローブでは、開く、リストする、またはアーカイブを抽出するためのすべての呼び出しが、Production License Requiredというメッセージを含むLicensingExceptionを投げました。 IRONZIP_LICENSE_KEYが定義され、コードが値をLicense.LicenseKeyに代入するまでLicense.IsLicensedはfalseのままでした。

Add a public Startup class with a public ApplyIronZipKey method, called first in Program.cs.
It assigns IRONZIP_LICENSE_KEY to IronZip.License.LicenseKey.
It reports only whether License.IsLicensed is true.

Then add a --list-sample mode that makes one listing pass over Drop/sample/.
Run it twice as a child process:

1. Run it unchanged.
2. Run it with IRONZIP_LICENSE_KEY removed from that child's environment alone, never the session's.

Write out/license-check.csv with columns run, file, IronZIP call, exception type and message.
IronZIP's licensing exception is internal, so catch Exception and log GetType().FullName.
Tell me which calls threw.
Text

ライセンスキーのページは、appsettings.json、App.config、Web.configのIronZip.LicenseKey設定を文書化しています。

抽出する前にアーカイブが何であるかをどう判断しますか?

IronZipArchiveはZIPファイルのみを読み取ります。 TAR、GZIP、BZIP2、またはテキストファイルを与えると、ZipExceptionを投げ、中央ディレクトリが見つからないと表示され、0バイトのファイルを開くとヘッダー内でEOFが発生しました。 先頭バイトが形式を識別します。 OpenAIは、読み重視のコードベース探索のための組み込みエージェントを文書化しています。

Have the explorer agent go through Drop/inbox/ and note these values for every file:

- the byte count
- the opening eight bytes as hex
- the five bytes at offset 257, skipped for files shorter than 262 bytes
- the format those bytes indicate under Drop/README.md

Save what it reports as out/inventory-explorer.csv.
Then write a small script that computes the same fields into out/inventory.csv.
For GZIP and BZIP2 data, IronZIP decompresses a temporary copy saved under out/tmp/.
That copy gets a .gz or .bz2 name, and the script tests it for a TAR header.
The script labels each file ZIP, TAR, GZIP, TAR.GZ, BZIP2, TAR.BZ2, EMPTY or NONE.

Then list the rows where the two files differ.
Also list every file whose extension disagrees with its content.
Text

5つのアップロードがフラグされるべきです。 1つは.tarと名付けられたZIP、1つは.zipと名付けられたTGZ、1つはテキストファイル、1つはアーカイブ拡張子を持つランダムなバイトで、1つは空です。

各アーカイブの中身をどうリストしますか?

Create Services/EntryLister.cs.
It lists every inbox archive the inventory calls ZIP or TAR, without extracting.
It reads them this way:

- For ZIP, open an IronZipArchive and call its Entries() method.
- When an open without a password fails, open again with the password from config/passwords.csv.
- For TAR, open an IronTarArchive and call GetArchiveEntryNames().

Give out/entries.csv the columns archive, entry, size, stored CRC, encrypted, or the exception type.
Also write out/entry-counts.csv.
It compares the file entries of each archive with the files column of Drop/manifest.csv.
Tell me which archives the comparison flags.
Text

GetArchiveEntryNamesはTARの名前のみを表示し、Entriesは各アイテムの名前、サイズ、保存されたCRCとIsCryptedフラグを含むEntryを返します。 GZIPとBZIP2にはリスト呼び出しがありません。 フォルダーエントリはエントリとしてカウントされ、ケストレルポッドのアーカイブには250のファイルに対して252がリストされました。

パスワードなしで暗号化されたZIPを開くとArgumentNullExceptionを投げ、パスワードのないZIPにパスワードを渡しても同様でした。 1つ以上のエントリがあるAESアーカイブでは、コンストラクタは間違ったパスワードを受け入れ、Entriesはすべてのファイルをリストしたので、リストでは良いパスワードと悪いパスワードを区別できません。

各アーカイブを抽出し、ファイルが無事に到着したことを証明する方法は?

OpenAIは、実装と修正に焦点を当てた組み込み作業エージェントを記述しています。 保護されたZIPを抽出する例は、静的抽出呼び出しのパスワードオーバーロードを示しています。

Have the worker agent write Services/IntakeExtractor.cs.
It applies Drop/README.md to every inbox file in this order:

1. Choose the IronZIP class from the format in out/inventory.csv.
2. Extract into out/extracted/<file name>/.
3. Hash each extracted file against Drop/checksums/.
4. Set the README status and reason.

Add an --intake mode that writes out/intake-results.csv.
Its columns are file, format, IronZIP call, status and reason.
After those come files expected, files matching and exception type.
The mode prints the status counts read from that file.
Tell me those counts.
Text

IronZIPでは抽出がエントリとその保存されたCRCを比較しないため、ハッシュチェックが必要です。 アイビーオーダーで保存されたエントリのバイトが1つ反転すると、例外なしに出力され、そのエントリのCrcの値がディスクに書き込まれたファイルのCRCと異なりました。

ZIP、TAR、またはテキストファイルのGZIP解凍はスローされ、さらにアーカイブ名の下に空のファイルが書き込まれ、間違ったパスワードは空のフォルダーを残したので、READMEはクリーンアップを求めます。同じフォルダーに2回目の抽出を行うと、警告なしにファイルが上書きされました。

サブフォルダーを持つTARが抽出に失敗する理由は?

IronTarArchive.ExtractArchiveToDirectoryはフォルダーを作成しません。 サブフォルダーにエントリーがあるすべてのTARでDirectoryNotFoundExceptionをスローし、何も書き出しませんでした。TARがフォルダーエントリーを持っているかどうかにかかわらず。 最初にGetArchiveEntryNamesから各フォルダーを作成することで、同じ呼び出しが成功しました。

同じGZIPファイルが別名で異なる抽出を行う理由は?

Rerun --intake.
Find each row of out/intake-results.csv whose status or reason disagrees with Drop/manifest.csv.
Add <Compile Remove="scratch/**" /> to DropIntake.csproj.
Make a scratch console project under scratch/format-probe/.
From it, call the same IronZIP method on a copy of each such file, and record what it wrote.

Save the findings to out/format-check.csv, then fix the extractor.
Stop after three fix rounds or when every row agrees.
Tell me which rows still disagree.
Text

ファイル名に基づいてIronGZipArchiveが決定します。 .tgzまたは.tar.gzで終わる名前では、ExtractArchiveToDirectoryおよびExtractTGZArchiveToDirectoryが内部のTARを解凍しました。その他の名前の場合は、アーカイブの最後の拡張子を除いた名前の単一の解凍ファイルを書き込みましたので、.zipと名付けられたTGZは単一のTARファイルとして出てきました。IronBZip2Archiveは.tar.bz2の名前からのみTARを解凍し、.tbz2からは解凍しませんでした。GZIPを抽出する例では、最初のコードサンプルでExtractArchiveToDirectoryを呼び出し、2番目のサンプルでTGZ呼び出しを行います。

IronZIPは使用できないパスワードで何をしますか?

Check the protected ZIP files in out/intake-results.csv against these rules:

- A file with no listed password is Protected with reason no-password.
- A file whose listed password fails is Protected with reason wrong-password.

Name the IronZIP call that first rejected the wrong password.
Base that on out/entries.csv together with out/intake-results.csv.
Then write out/password-scan.csv, listing every file under out/.
Each row says yes or no for whether that file holds any password from config/passwords.csv.
Read the passwords inside the program at run time, and never pass one on a command line.
Report the match count from that file.
Text

抽出は、無効なパスワード!!というメッセージを持つArgumentExceptionで誤ったパスワードを拒否する最初の呼び出しでした。

正しいパスワードが拒否される理由は?

Codexはコマンドラインで-i(長形: --imageとして)画像を受け付け、codex exec resumeを含みます。また、作曲者に貼り付けることもできます。

The image attached to this turn with -i is a Delta Freight support ticket.
It concerns delta-rates-2026-10-09.zip.
Read it, and reproduce the error with the project's own code.
Decide which of these is true:

- The password in config/passwords.csv is wrong.
- IronZIP refuses it for another reason.

Write out/delta-check.csv with these columns:

- IronZIP call
- which file the password came from
- outcome
- exception type

Change code only where that evidence calls for it.
Tell me which of the two it is.
Text

リストされたパスワードは正しいです。 そのアーカイブを開くすべての方法、パス、バイト、ストリームのコンストラクタとFromArchiveは、Invalid Password!というSystem.Exceptionをスローし、同じパスワードでExtractArchiveToDirectoryが一致するハッシュでレートカードを書きました。 アーカイブには1つのエントリが含まれています。

終端までに不正な受付出力をデバッグする方法は?

The nightly log calls 16 archives ok.
Yet Feedback/warehouse-2026-10-11.md lists five of them that reached the warehouse wrong.
Send the explorer agent through Jobs/NightlyIntake.cs and Logs/nightly-2026-10-11/.
The explorer edits nothing.

Work out how each of those five got past the job's success check.
Name the lines responsible.
Suggest the narrowest change and a command that would confirm it.
Save the diagnosis as out/nightly-diagnosis.md, and tell me what it found.
Edit no code in this turn.
Text

健全な診断は2つの原因を見つけます。 ジョブはアップロードごとに最後の拡張子のみを保持するハッシュ化された名前でそれぞれをステージングするため、IronZIPは.tar.gzや.tar.bz2を見ることはありません。各解凍されたTARを1つのファイルとして書き込み、単一ファイルのアップロードをハッシュで名前付けします。 抽出されたファイルをチェックサムまたはCRCと比較するものはないため、ダメージを受けたアイビーエントリはokとして通過します。

一度限りのコードを再利用可能でテスト済みのコンポーネントに変えるにはどうすればよいですか?

Have the worker agent fold the intake modes into a public IntakeJob class, set up like this:

- It's resolved through Microsoft.Extensions.DependencyInjection, version 9.0.20, which it adds.
- A public IntakeOptions record holds its inbox, output root, passwords file and checksums folder.
- IntakeJob.cs stays under 200 lines, with XML doc comments.

Keep these behaviors:

- the byte-based format choice
- the folder creation before TAR extraction
- the name-based staging for GZIP and BZIP2
- the hash check
- the password rules
- the cleanup

Run it over Drop/inbox/, writing out/final/ and out/final.csv.
Confirm every row matches Drop/manifest.csv on status and reason.
Stop after three fix rounds, and tell me how many rows match.
Text

フォルダー作成またはハッシュチェックを省略するリファクタはまだビルドしますので、プロンプトはマニフェストに対して完全に再実行されます。

Add an xUnit project at tests/DropIntake.Tests with these packages:

- xunit 2.9.3
- xunit.runner.visualstudio 3.1.5
- Microsoft.NET.Test.Sdk 18.0.1

Add <Compile Remove="tests/**" /> to DropIntake.csproj.
Put both projects in one DropIntake.sln at the repository root.
Call Startup.ApplyIronZipKey before the first IronZIP call.

Test IntakeJob on real inbox files, with a separate output folder per test, for these cases:

- fern-logs-2026-10-09.tar yields its four logs in their folders.
- juniper-routes-2026-10-09.zip is read as TAR.GZ.
- ivy-orders-2026-10-09.zip is Unreadable with reason damaged.
- elm-claims-2026-10-09.zip is Protected with reason wrong-password.
- delta-rates-2026-10-09.zip is Extracted.

Run dotnet test into out/tests/ with a trx logger.
Report the passed and failed counts, quoted from the .trx file.
Text

ステータスと抽出されたファイルのハッシュをアサートし、アーカイブのバイトにはアサートしないでください。

$ironzip Open IronZip.xml in the ironzip folder of the NuGet package cache and answer two questions:

- Which method extracts an archive, class by class?
- Which archive classes can list their entries without extracting?

Confirm each answer by compiling a probe under scratch/, which DropIntake.csproj must not compile.
Name any member of that IronZip.xml that does not compile, or say that none failed.
Then show the line in IntakeJob that picks the extraction call for each format.
Text

2026.10.2では、オブジェクトリファレンスが5つの静的呼び出しと各アーカイブクラスのExtractArchiveToDirectory、加えてExtractTGZArchiveToDirectoryをリストします。

別のアーカイブドロップにこれらのプロンプトを再利用する方法は?

同じプロンプトは、パス、ステータスルール、チェックサムリストが変更された後、別のインバウンドドロップで動作します。 AI コーディングアシスタントガイドは、空のフォルダーから開始する受け入れテストを実行します。

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

すべての14のプロンプトが、順に、コード実行を通じて単一の無人Codex CLIセッションで実行されました。 以下のすべての数字は、その後の独自のチェックから来ており、その中にはエラー0警告0のリリースビルドやIronZIPとは独立したPythonの再ハッシュがあります。

  • 最初の抽出機は16抽出、3保護、6読み取れないを報告し、それらの25行のうち23行がマニフェストと一致しました。
  • チケットプロンプトの後、25行のうち24行が一致しました。
  • 最終ジョブは18抽出、2保護、5読み取れないを報告し、すべての25行がステータスと理由で一致しました。
  • 18抽出されたアップロードからの314ファイルをすべてパートナーリストと一致させました。
  • 他の7つのアップロードのためにディスクに何も残りませんでした。
  • コードのコピーを使用して最終ジョブの再実行には3.9秒かかり、同一のバイトを書き出しました。
  • 全ての5つのテストはキー付きで合格し、再実行でキーなしで全ての5つのテストが不合格になりました。
  • クイックスタートはサンプルファイル8つのうち2つをリストし、18エントリがあり暗号化されていないとし、残りには1つのArgumentNullExceptionと5つのZipExceptionsをログしました。
  • 在庫は上記の5つのアップロードを正確にフラグしました。
  • エクスプローラーエージェントのコピーは、25行のうち書式の単語が9つと、8つの開頭バイトのうち7つのフォーマットでスクリプトのものと異なりました。
  • リストは、16のZIPおよびTARのアップロードから310のエントリ行を書き、13がマニフェストのファイル数と一致しました。
  • パスワードなしで保護されたZIP、単一エントリのZIP、切り捨てられたアップロードはリストできませんでした。
  • サブプロセスからキーを削除すると、8つの呼び出しがライセンス例外を投げました。
  • パスワードスキャンは344の出力ファイルを読み、どれも一致しませんでした。
  • 夜間診断は両方の原因を特定し、コードは変更されませんでした。
  • 夜間ジョブの再生は、同じ16 okと9失敗をログし、その16のうち5つがパートナーのチェックサムを失敗しました。
  • 一部のステップはページと異なる方法で実行されました。 Codexは手動でパッケージリファレンスをIronZIPとして書き、dotnetリストパッケージはすぐに動作しました。 最初の抽出機はすでにTARフォルダーを作成し、.tgz名の下にGZIP TARをステージングしたので、意見の相違があった行はデルタレートとグローブストックでした。 フォーマットプロンプトは3回のラウンドでどちらも修正しませんでしたが、そのプローブはIronTarArchiveに対してすでにIronBZip2Archiveが解凍したCSVを渡しました。 チケットプロンプトはデルタレートを修正し、リファクタはグローブストックを修正しました。 リファクタプロンプトはBZIP2の名前ベースのステージングを維持するように依頼しましたが、それは.tar.bz2名前では必要ありません。 最終的に結果のファイルは、その行のためにコードがもはや行わないIronTarArchive呼び出しを名前付けしています。 IntakeJob.csは、ワークフローが382行の2番目の部分ファイルに移動したため、32行になりました。 4つのエージェントは、スレッドをスポーンした状態でエージェントタイプなしで実行されたため、探索者や作業者の役割は記録されませんでした。

Google Antigravity ガイドは、ダウンロードサービスで同じ単一エントリパスワードの失敗を発見し、抽出とSHA-256によってアーカイブを検査しました。 GitHub Copilot ガイドでは、IronZIPのTARライターが各ログをその裸のファイル名の下に保存したため、同名のログが衝突しました。 Codexのバージョン、モデル、およびタイミングは、共有された実行記録に記載されています。


トラブルシューティング


質問ありますか?

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

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

もっと読む

準備はできましたか?

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