vn-law-checkとは？
vn-law-checkは、AIコーディングエージェントがベトナム法に基づく潜在的なコンプライアンスリスクについて、ウェブサイトやモバイルアプリをレビューするための、無料の手順、チェックリスト、参考資料、スキャンスクリプトをまとめたものです。Claude Code、Cursor、GitHub Copilot、Windsurf、Cline、Codexに対応しています。
エージェントにプロジェクトの監査を依頼すると、関連する機能についてコードを調査し、ファイルと行番号ごとに問題の可能性を特定し、適用される法的規定を引用して、変更案を提示します。その後、優先度の高い指摘への対応をエージェントに依頼できます。
このプロジェクトは、アプリケーションが氏名、メールアドレス、電話番号を収集する場合、Google AnalyticsやFacebook Pixelなどのサービスを使用する場合、アカウント、ショッピングカート、決済機能を提供する場合、またはAIチャットボットを含む場合に役立ちます。単純な静的サイトもレビューでき、関連するデータ収集が見つからない場合はその旨を報告します。
vn-law-checkは初期レビュー用のツールであり、弁護士に代わるものではありません。生成されたレポートやポリシーには不完全または誤った内容が含まれる可能性があるため、重要な指摘は資格を持つ法律専門家に確認してもらう必要があります。
主な機能
- ソースコードとURLの監査：ローカルプロジェクトをレビューするか、ウェブサイトで公開されているページをスキャンします。
- ファイル単位の指摘：ファイル、行、問題のあるテキストまたは実装、法的根拠、修正案を特定したレポートを作成できます。
- 優先度付きの結果：指摘は、🔴 即時対応が必要、🟡 改善を推奨、🟢 準拠、⚪ 該当なしに分類されます。
- プライバシー文書の作成：コード内で検出されたデータフローと第三者サービスに基づき、エージェントがプライバシーポリシーの草案を作成できます。
- 同意に関するガイダンス：チェックリストには、同意フォームやCookieバナーに関するガイダンスが含まれています。
- モバイルアプリ対応：スキャナーは、権限、トラッキングまたは広告SDK、アカウント削除機能を調査できます。
- 複数のAIツールに対応：リポジトリのファイルは、対応するエージェントが各自の指示形式を通じて同じ中核的なコンプライアンスガイダンスを読み込めるよう構成されています。
対象となる法分野
リポジトリの説明によると、参考資料には2026年11月までに施行されたベトナムの法令が含まれています。対象分野として、個人データ保護、電子商取引、サイバーセキュリティ、広告、人工知能、消費者保護、電子取引が挙げられています。全文へのリンクと施行日はsources/legal-references.mdで管理されています。
READMEでは、個人データ保護法91/2025および政令356/2025が特に取り上げられています。2026年1月1日から、組織は個人データを収集する理由を明確に開示し、適切に同意を取得しなければならないと説明されています。また、リポジトリは、すでに置き換えられた規則を引用し続ける古いポリシーに注意を促しています。
インストールと設定
方法1：Claude Codeにインストールする
以下のコマンドは通常のターミナルではなく、Claude Code内で入力してください。
/plugin marketplace add mhfed/vn-law-check
/plugin install vn-law-checkインストール後、レビューするプロジェクトをClaude Codeで開きます。
方法2：Cursor、Windsurf、Copilot、Cline、Codex向けにインストールする
プロジェクトディレクトリでターミナルを開き、次を実行します。
curl -fsSL https://raw.githubusercontent.com/mhfed/vn-law-check/main/install.sh | bashインストーラーはチェックリストを.vn-law-check/に配置し、プロジェクトファイルを上書きしません。プロジェクトにAGENTS.mdやCLAUDE.mdなどの指示ファイルがすでに存在する場合、スクリプトはインストールしたチェックリストへの短い参照のみを追加します。インストーラーを再度実行すると、重複する参照を挿入せずに連携を更新します。
方法3：スキルを手動でクローンする
マーケットプレイスを使用せずにClaude向けのスキルをグローバルにインストールするには、次を実行します。
git clone --depth=1 https://github.com/mhfed/vn-law-check ~/.claude/skills/vn-law-checkプロジェクト固有のインストールでは、ホームディレクトリのパスを使う代わりに、そのプロジェクト内の.claude/skills/vn-law-checkへクローンします。
最初の法務監査を実行する
開いているプロジェクトを監査する
対応しているAIコーディングエージェントでプロジェクトを開き、リポジトリが推奨するベトナム語のプロンプトを入力します。
audit pháp lý website này theo luật Việt Namこれは「このウェブサイトをベトナム法に基づいて監査してください」という意味です。エージェントはまずサイトの種類を分類し、その後、関連するチェックリストを適用します。プロジェクトによっては、フォーム、トラッカー、アカウントシステム、ショッピング機能、決済、AI連携、ホスティング情報、関連する開示事項などを調査します。
公開URLを監査する
ソースコードがない場合は、公開ウェブサイトのアドレスを指定します。
audit pháp lý https://ten-mien-cua-ban.vnURL監査では、リポジトリのfetch-site.shスクリプトが指定サイトから公開ページをダウンロードし、scan.shがそれらを調査できるようにします。READMEによると、この処理は同一ドメインの15ページおよびJavaScriptファイル20個に制限されています。収集したサイトデータを外部へ送信することはありません。
URLのみのスキャンでは、非公開のサーバーコードや、外部に公開されていない設定を調査できません。結果は基盤システム全体の完全な評価ではなく、アクセス可能なサイトのレビューとして扱ってください。
レポートを理解する
各結果は、次の4つの分類のいずれかになります。
- 🔴 即時対応: 深刻な可能性がある問題で、速やかに調査・修正すべきもの。
- 🟡 改善を推奨: 改善すべき弱点、または実装が不完全な部分。
- 🟢 満足: 確認した項目が該当するチェックリストを満たしていると考えられるもの。
- ⚪ 該当なし: 確認対象のプロジェクトまたは機能には要件が適用されないもの。
指摘事項には、問題のあるテキスト、その出典箇所、引用した法的根拠、および推奨される変更内容が含まれる場合があります。デモでは、ウェブサイトの継続利用を同意として扱うプライバシーポリシーが指摘されています。レポートは、91/2025/QH15号法第9条第4項d号を引用しています。この規定では、沈黙または応答しないことを同意として扱うことはできません。そのため、データを収集する際は明示的な同意を求めることが推奨されています。
関連情報を収集しないブログや静的サイトの場合、多数の指摘事項ではなく、短い結論だけが示されることがあります。
重大な指摘事項の修正をエージェントに依頼する
レポートを確認したら、赤色の項目への対応をエージェントに依頼します。
sửa giúp các mục 🔴これは「🔴の項目を修正してください」という意味です。編集内容を受け入れる前に、提案された変更を確認し、影響を受けるフォームとトラッキング動作をテストし、実装が実際の業務プロセスと一致していることを確認してください。リポジトリにない組織上の事実を、コード変更によって検証することはできません。
プライバシーポリシーの草案を作成する
プロジェクトにプライバシーポリシーがない場合、または現在、一般的なコピー済みポリシーを使用している場合は、プロジェクト固有の草案を依頼します。
soạn chính sách bảo mật cho dự án nàyエージェントはコードを調査し、アプリケーションが収集していると考えられるデータや、そのデータを受け取る可能性のあるサービスを特定できます。対象には、Google Analytics、Firebase、OpenAIなどの連携サービスも含まれます。そのうえで、ポリシー文案を作成し、同意フォームやCookieバナーの更新を提案できます。
組織の正式名称や納税者番号など、コードから確定できない情報は空欄のまま残されるため、あなたが記入してください。草案を公開する前に、すべての項目、データの目的、受領者、保存方法、連絡先を確認してください。
高度な利用のヒント
可能な限りソースコード監査を優先する
ローカルのソース監査では、公開URLからは確認できない実装の詳細を調査できます。リポジトリには、コードディレクトリをスキャンする際にscan.shがローカルファイルのみを読み取ると記載されています。そのため、ソース監査は、埋め込まれたSDK、条件付きトラッカー、モバイル権限、アカウント削除ロジック、レンダリングされたページからは分かりにくい連携を検出するうえで、より適した方法です。
同意前のトラッキングを確認する
訪問者が同意を選択する前に読み込まれる分析・広告スクリプトには、特に注意してください。また、プライバシー通知がプロジェクト内で見つかったサービスを正確に説明していること、継続的な閲覧、沈黙、非アクティブ状態を同意として扱っていないことも確認してください。
技術的事実と業務上の事実を分ける
エージェントは多くの実装上の詳細を推測できますが、コードだけからすべての運用実態を確実に把握することはできません。データ管理者の身元、保存期間、社内アクセスルール、越境処理、契約関係、カスタマーサポート手順などの事実は、組織内の担当者に確認してください。
AIエージェントなしでチェックリストを使う
自動ワークフローでは、現在、対応しているAIツールのいずれかが必要です。AIコーディングエージェントを使用しない場合でも、リポジトリのreferencesディレクトリ内のファイルを読み、手動のセルフレビュー用チェックリストとして利用できます。
第三者の監査には責任を持って対応する
所有していないサイトをスキャンする場合は、結果を非公開にし、サイト所有者へ直接送ってください。このプロジェクトは、スキャン結果を根拠に組織を公に非難しないよう明示的に助言しています。
未検証の参照情報を慎重に確認する
メンテナーは法律家ではなく開発者であると説明しており、法令の全文と照合されていない参照情報には、CHƯA XÁC MINH（「未検証」）という印を付けています。READMEによると、そのような項目がまだ数十件残っており、主に罰則の参照情報と政令356/2025の資料に含まれています。これらの項目は特に慎重に扱ってください。
訂正への貢献
法令の引用やチェックリストは変更される可能性があるため、コミュニティによるレビューが重要です。誤った条文番号、古い文書、不正確な罰則、欠落している法律、チェックリストに含まれていない一般的な問題、または誤ったサイト分類を報告するには、GitHub issueを作成できます。元の法令本文へのリンクを含めると、メンテナーが訂正を確認しやすくなります。
プルリクエストを提出する開発者は、リポジトリに記載されたソースファイルを編集し、tools/sync.shを実行してツール固有のコピーを再生成してください。さらに、scripts/scan.shを変更した場合はtests/run.shを実行してください。生成されたコピーが同期されていない場合、継続的インテグレーションによってエラーが報告されます。
費用、ライセンス、制限事項
リポジトリは無料です。利用時に発生する費用は、現在使用しているコーディングツールが請求するAI利用料のみです。コードとリポジトリ構成はMITライセンスで提供されています。一方、参照されているベトナムの法令本文は政府の公開文書であり、このソフトウェアライセンスの対象ではありません。
最も重要な点として、監査は完全な法令遵守を保証するものではありません。vn-law-checkを使用して、潜在的な不足を見つけ、是正作業を整理し、初稿を作成してください。本番環境で依拠する前に、重要な指摘事項とポリシー文書を資格を有する法律専門家に確認してもらう必要があります。
結論
vn-law-checkは、ベトナムのコンプライアンスチェックリストとAI支援ソフトウェア開発の間をつなぐ実用的な手段を提供します。対応しているエージェントにインストールし、ソースコードまたは公開URLを監査して、優先順位付けされたレポートを確認し、対象を絞った修正やプライバシーポリシーの草案作成を依頼してください。このワークフローにより初期レビューを迅速化できますが、最終的な法的判断には、検証済みの事実、最新の原典、および専門家の判断が引き続き必要です。