AI開発 · 2026.11.15

PyPI Security Tabで何が変わる?5項目のAI開発チェック

PyPI Security Tabで何が変わる?5項目のAI開発チェック

PyPI Security Tabは、AIコーディングで増えがちなPython依存追加を、勘ではなく来歴で確認するための新しい確認場所です。2026年11月6日、PyPI公式ブログはプロジェクトページの再設計完了を発表しました。AIエージェントにライブラリ追加を任せるチームは、インストール前レビューを5項目に固定すると運用しやすくなります。

PyPI Security Tabとは?AI開発者が見るべき変更点

新しいSecurityタブは、release fileがどこから来たかを示すprovenance stateと、ファイル単位のattestationを表示します。Full Provenanceはリリース内の100%のファイルにattestationがある状態です。attestationにはTrusted Publisher経由のPyPI Publish attestationと、source commit・build platform・build instructionsへ結びつくSLSA Build Provenance attestationがあります。

No Provenanceは悪意あるパッケージという意味ではありません。公式ドキュメント上も、ファイルの出所を暗号学的に検証できない状態を指すだけです。ただしAIが提案した依存をそのまま入れる場面では、この差が重要です。名前だけでなく、どのworkflowから出たwheelなのか、前回リリースと来歴が変わったのかを見ます。

5項目チェック:依存追加前に確認する順番

1つ目はSecurityタブでprovenance stateを見ることです。2つ目はwarningの種類を見ることです。Incompleteは一部ファイルだけattestationなし、Inconsistentは同じリリース内で出所が揃わない、Changeは前回とbuild/publish元が変わった、Lossは以前あったprovenanceを失った状態です。どれも即ブロックではありませんが、AIエージェントの自動更新では人間確認に回すべきシグナルです。

3つ目はattestation metadataでsource repository、source commit、build platform、workflowを確認することです。4つ目はRelease filesタブとRelease historyタブで、ファイル数、yanked・archived・pre-release・quarantinedなどの状態、過去リリースとの変化を見ます。5つ目はCIに記録を残すことです。AIがrequirements.txtやpyproject.tomlを変更したら、version、provenance state、warning有無、判断理由をPRコメントに残します。

AIコーディングで特に危ない3つの場面

危ない場面は3つあります。第一に、AIが小さな便利ライブラリを追加する場面です。第二に、既存パッケージのminor updateです。名前が同じでも、Change of ProvenanceやLoss of Provenanceが出ているなら、maintainerの移行なのか、publish workflowの破損なのかを確認します。第三に、ローカル検証だけで通った修正です。テストが通ることと、配布物の来歴が信頼できることは別問題です。

AIエージェント運用では、依存追加を『コード差分』ではなく『外部実行物の導入』として扱います。agentが新規パッケージを提案したら、通常のテストに加えてSecurityタブ、release history、package integrityをPRテンプレートに入れます。警告がある場合は、代替パッケージ、version固定、vendor化、一時保留の4択に分けると判断が速くなります。

導入判断:全部止めるより、警告別に扱う

No Provenanceをすべて禁止すると、古いが広く使われるパッケージまで止まり、開発体験が悪くなります。現実的には、Full Provenanceは通常レビュー、No Provenanceはmaintainer historyとrepository activityを確認、Incomplete/Inconsistent/Change/Lossは人間承認に回す、という3段階が扱いやすいです。

attestationは万能ではありません。公式ドキュメントも、attestationはファイルの出所を示すもので、元コードやbuild環境が安全だと証明するものではないと説明しています。SecurityタブはSAST、依存脆弱性スキャン、lockfileレビューを置き換えるものではなく、レビューの最初に見る信頼シグナルです。

30日PoC:AI開発チームで始める運用

最初の30日は、新規依存とmajor/minor updateだけを対象にします。1週目は直近10件の依存追加PRを棚卸しし、PyPI上のprovenance stateとwarning有無を記録します。2週目はPRテンプレートに5項目チェックを追加します。3週目はCIでrequirementsやpyprojectの変更を検知します。4週目は警告が出たパッケージの判断履歴を見返し、例外処理の基準を固めます。

KPIはシンプルで十分です。新規依存PRのprovenance確認率、warning付きreleaseの人間確認率、代替パッケージへ切り替えた件数、AIエージェントが追加した依存の差し戻し率を見ます。開発速度を落とさずにレビューを足せたかを説明できます。

FAQ

Q. No Provenanceのパッケージは使ってはいけませんか? A. いいえ。公式説明では、No Provenanceは悪性を意味せず、ファイルの出所を暗号学的に検証できない状態です。maintainer history、release pattern、repository activityを追加で見て判断します。

Q. pipやuvだけでattestation検証できますか? A. 2026年11月時点のPyPI公式ドキュメントでは、一般的なinstallerへの組み込みはまだで、pipとuvには提案があるもののactive developmentではないとされています。必要ならIntegrity APIや第三者ツールも検討します。

Q. AIエージェントに何を指示すべきですか? A. 新規依存を追加したら、パッケージ名、version、追加理由、代替候補、PyPI Securityタブのprovenance state、warning有無をPR本文に書かせます。警告がある場合は自動merge対象から外すのが安全です。

HelloCraftAIでは、AIコーディング導入時の権限設計、依存追加ルール、PRレビュー手順、社内AIエージェントの安全な運用設計を支援しています。Python開発でAIエージェントを使い始めたものの、依存管理やレビュー基準が曖昧な場合は、 相談してください 。まず小さなPoCから整えるのがおすすめです。