skill-security-auditor

スキルセキュリティ監査ツール

インストール前に AI エージェントのスキルをスキャンし、セキュリティリスクを監査します。コードファイルの静的解析で危険なパターンを検出し、Markdown ファイルでプロンプトインジェクションをスキャンし、依存関係のサプライチェーンを検証し、ファイルシステムの境界を確認して、難読化を検出します。検出結果を重大度別に分類し、実行可能な修正ガイダンスを添えた、構造化された PASS / WARN / FAIL の判定を出力します。

キーワード： スキルセキュリティ、AI セキュリティ、プロンプトインジェクション、コード監査、サプライチェーン、依存関係スキャン、データ流出、認証情報の窃取、難読化の検出、インストール前セキュリティ

主な機能

• コード実行リスクの検出 — コマンドインジェクション（os.system、subprocess shell=True、バッククォート）、eval／exec／compile、難読化（base64／hex／chr()）、ネットワーク経由のデータ流出、認証情報の窃取（~/.ssh、~/.aws）、権限昇格。
• プロンプトインジェクションの検出 — システムプロンプトの上書き、ロールの乗っ取り、安全対策の回避、不可視のゼロ幅文字／HTML コメント内の指示、データ抽出の指示、過剰な権限要求。
• サプライチェーン分析 — 既知の脆弱性があるバージョン固定、タイポスクワッティング、バージョン未固定、インラインの pip／npm install、評判の低いパッケージ。
• ファイルシステムと構造の検証 — 対象範囲外のパス、隠しファイル／認証情報ファイル、想定外のバイナリ、範囲外に抜けるシンボリックリンク、サイズ超過のペイロード。
• 判定とレポート — 重大度別に分類された検出結果と修正方法を含む PASS / WARN / FAIL 判定、および CI ゲート用の厳格モード。

使用するタイミング

• インストール前に、信頼できないソースから入手したスキルを評価する場合
• CI/CD パイプラインのインストール前セキュリティゲート
• スキルのディレクトリや git リポジトリを監査して、悪意のあるコードがないか確認する場合
• チームの承認済みリストに追加する前にスキルをレビューする場合
• インストール済みスキルをインシデント発生後にスキャンする場合

先に確認すること

監査の前に、次の入力を確認してください。不明または曖昧な項目があれば、推測せずに質問してください。

• 対象パス — スキャンするスキルのファイルまたはディレクトリ（すべてのスキャナーの対象）
• スキャン項目 — コード実行／プロンプトインジェクション／サプライチェーン（3 つのスキャナーのうち、どれを実行するかを選択します）
• 厳格モード／ゲートのしきい値 — HIGH の検出結果が 1 件でも FAIL になるかどうか（CI ゲートと参考用レポートでは判定が異なります）

中断ルール：出力を最も大きく左右する 2〜3 項目だけ質問してください。ユーザーが「とりあえずドラフトして」と言った場合は作業を進め、成果物の冒頭に前提を列挙してください。

ツール

ツール	用途	コマンド
code_scanner.py	Python スクリプトをスキャンし、eval／exec、subprocess、ネットワーク経由のデータ流出、認証情報の窃取、難読化、安全でないインポートを検出します	python scripts/code_scanner.py <target> --strict --json
prompt_injection_scanner.py	Markdown／テキストをスキャンし、プロンプトインジェクションのパターンや隠された指示を検出します	python scripts/prompt_injection_scanner.py <target> --strict --json
supply_chain_checker.py	インポート／requirements を確認し、タイポスクワッティング、バージョン未固定、インラインインストールを検出します	python scripts/supply_chain_checker.py <target> --strict --json

すべてのツールは target（ファイルまたはディレクトリ）を受け取り、--strict（HIGH の検出結果が 1 件でもあれば FAIL）と --json をサポートします。

参考資料

タスクに合った参考資料を読み込みます。このファイルは簡潔に保ち、必要に応じて詳細を参照してください。

• references/threat-model-and-patterns.md — 攻撃ベクトルの脅威モデル、信頼境界、コード実行およびプロンプトインジェクション検出用の正規表現パターン一式、既知の回避手法が記載されています。スキャン対象の判断や検出の調整を行う際に読んでください。
• references/audit-output-and-workflow.md — レポート形式、判定基準（厳格モードを含む）、CI/CD 統合 YAML、手動監査チェックリストが記載されています。監査の実施や解釈を行う際に読んでください。
• references/quality-and-best-practices.md — 静的解析の限界、よくある落とし穴、ベストプラクティス、トラブルシューティング表、成功基準が記載されています。監査をリリースする、または監査結果を頼りにする前に読んでください。

対象範囲と制限事項

このスキルの対象範囲：

• Python、Bash、JavaScript、TypeScript ファイル内の危険なコード構造をパターンベースで静的に検出します
• スキルパッケージ内のすべての Markdown ファイルを対象にプロンプトインジェクションをスキャンします
• requirements.txt と package.json の依存関係サプライチェーンを検証します
• シンボリックリンク、バイナリ、隠しファイル、過大なペイロードを含むファイル構造の境界をチェックします

このスキルの対象外：

• 実行時または動的解析 — 監査中にコードが実行されることはありません（実行時の検証には skill-tester を参照してください）
• CVE データベースのライブ検索やリアルタイムの脆弱性フィード（アクティブな CVE スキャンには dependency-auditor を参照してください）
• ネットワークのセグメンテーション、コンテナの強化、クラウド IAM ポリシーなど、インフラストラクチャレベルのセキュリティ制御（ra-qm-team の infrastructure-compliance-auditor を参照してください）
• ISO 27001、SOC 2、GDPR、その他の規制基準に対するコンプライアンスフレームワーク認証（ra-qm-team の information-security-manager-iso27001 と gdpr-dsgvo-expert を参照してください）

統合ポイント

スキル	統合	データフロー
dependency-auditor	監査結果を、フラグが付いた依存関係のライブ CVE スキャンに引き継ぎます	セキュリティ監査レポート → リアルタイムの脆弱性検索を行う dependency-auditor
ci-cd-pipeline-builder	生成する CI/CD パイプラインで、監査ワークフローを必須チェックとして組み込みます	パイプラインテンプレート ← このスキルの CI/CD セクションにある監査ジョブ YAML
skill-tester	静的解析に合格したスキルに対し、動的な実行時テストを実行します	このスキルの PASS 判定 → 動作検証を行う skill-tester
infrastructure-compliance-auditor	監査範囲をスキルレベルからインフラストラクチャレベルのセキュリティ制御まで拡張します	スキルの監査結果 → 環境全体のセキュリティ態勢をレビューするインフラストラクチャ監査ツール
env-secrets-manager	認証情報の窃取に関する検出結果を、シークレット管理ポリシーと照合します	監査で検出された認証情報アクセスのフラグ → ポリシーを検証する env-secrets-manager
pr-review-expert	監査結果を、該当行に対するインラインの PR レビューコメントとして提示します	監査レポートの行参照 → 開発者が確認できる PR レビュー注釈