mcpField
H
huawei-cloud-icp-rule-consult

huawei-cloud-icp-rule-consult

github.com/huaweicloudその他59134 回インストール2 日前に更新
リポジトリ

huawei-cloud-icp-rule-consult について

Huawei Cloud のアフターサービス技術者向け ICP 届出ルール相談スキルです。届出の要否、手順、書類、地域別規則を扱い、まず内蔵 Q&A を参照してから関連文書を取得します。相談専用で、届出の代行は行いません。

主な機能

  1. 01130 件以上の Q&A を内蔵
  2. 02意図に応じた質問の振り分け
  3. 03関連する公式文書を優先取得
  4. 04必要に応じた Huawei Cloud 文書検索
  5. 05読み取り専用のルール相談

活用シーン

  1. 01サーバーやドメインの届出要否の確認
  2. 02地域別の手順と必要書類の確認
  3. 03接続・変更・取消届出の相談
  4. 04アカウント・主体・APP の届出上限の確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/huaweicloud/huaweicloud-skills --skill huawei-cloud-icp-rule-consult

インストール後、Claude Code で/huawei-cloud-icp-rule-consultを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
catalog.yml
doc-commands.md
filing-rules.yml
knowledge-base.md
prerequisites.md
verification-method.md
scripts/
__init__.py
requirements.txt
web_fetcher.py
web_searcher.py

詳細

Huawei Cloud · ICP 登録ルール相談

概要

Huawei Cloud ICP 登録 — ルールに関する読み取り専用の相談

組み込みのナレッジベース(130 件以上の Q&A エントリー)、公式ドキュメント、ウェブ検索/取得ツールを使用して、ICP 登録に関する質問に1回の会話で回答します。登録が必要か、どの手順に従うか、どのルールが適用されるか、どの資料が必要かを確認できます。相談のみで、ユーザーに代わって登録手続きは行いません。

対象範囲:中国本土の ICP 登録(非営利のインターネット情報サービス登録)のみです。公安登録(公安备案)や営利事業登録(经营性备案)は対象外です。 対象ユーザー:Huawei Cloud のアフターサービス技術エンジニアです。 サイト:既定では中国サイト(support.huaweicloud.com)です。

アーキテクチャ
User Question
    │
    ├─► catalog.yml (intent routing)
    │       │
    │       ▼
    │   entry_point + ontology_entities
    │       │
    ├─► knowledge-base.md 
    │       │
    │       ▼ (if insufficient)
    ├─► doc-commands.md → web_fetcher.py (direct document fetch)
    │       │
    │       ▼ (if category unclear)
    └─► web_searcher.py (search fallback, max 1 call)
適用シナリオ
  • サーバー/ドメインに ICP 登録が必要かどうか
  • 登録手順、必要資料、省ごとのルール
  • 接続登録(既存の登録を別のクラウドプロバイダーから移行)
  • 登録情報の変更(事業者/IP/ドメインの変更)
  • 登録の取り消しと、取り消し後の再登録
  • アカウントと事業者の制限(1アカウントにつき1事業者、登録件数の上限)
  • APP 登録(特徴情報、事業者をまたぐシナリオ)
  • 登録の移行/譲渡(アカウント間、事業者間)
よくあるユーザーの質問
  1. 「我们的服务器在新加坡,需要备案吗?」(サーバーがシンガポールにある場合、登録は必要ですか?)
  2. 「域名在阿里和华为都做了接入备案,取消阿里一侧的接入是否影响华为云使用?」(ドメインを Alibaba Cloud と Huawei Cloud の両方で接続登録しています。Alibaba Cloud 側の接続を取り消すと、Huawei Cloud の利用に影響しますか?)
  3. 「备案数量已达上限怎么办?」(登録件数が上限に達した場合、どうすればよいですか?)
  4. 「不同主体备案同一个APP,图标和备注可以一样吗?」(異なる事業者が同じ APP を登録する場合、アイコンと備考は同じでもよいですか?)
  5. 「APP服务在本地,互联网信息服务类型怎么选?」(APP サービスがローカル環境にある場合、インターネット情報サービスの種類はどのように選択すればよいですか?)

主なコマンド

このスキルでは、KooCLI ではなく、ウェブドキュメント取得用の Python スクリプトを使用します。利用可能なツールは2つあります。

web_fetcher — 軽量 HTTP ドキュメント取得ツール

requests を使用して、既知の URL からドキュメントの内容を取得します。ブラウザーは不要です。

# Fetch document text content
python {skill_dir}/scripts/web_fetcher.py fetch <URL> --mode text

# Fetch with CSS selector
python {skill_dir}/scripts/web_fetcher.py fetch <URL> --mode text --selector ".doc-content"

# Extract all links from a page
python {skill_dir}/scripts/web_fetcher.py fetch <URL> --mode links

# Fetch raw HTML
python {skill_dir}/scripts/web_fetcher.py fetch <URL> --mode html
web_searcher — Playwright ベースのドキュメント検索

実際のブラウザーを使用して、Huawei Cloud のドキュメントサイトを検索します。Playwright と Chromium が必要です。

# Search Huawei Cloud docs
python {skill_dir}/scripts/web_searcher.py search "ICP备案 <keywords>"

# With remote Chrome
python {skill_dir}/scripts/web_searcher.py search "ICP备案 <keywords>" --remote-chrome-host http://host:port
ツールの選択優先順位
  1. まず組み込みのナレッジを確認:references/knowledge-base.md を確認します
  2. 直接取得を優先:カテゴリを特定した後、references/doc-commands.md のコアドキュメント URL を web_fetcher で取得します
  3. 検索はフォールバックとして使用:カテゴリが不明な場合に限り web_searcher を使用します

前提条件

前提条件の確認:Python >= 3.9 が必要です。ウェブ検索には Playwright が必要です

python --version
pip install requests beautifulsoup4
# Required for web search capability
pip install playwright aiohttp
playwright install chromium

Playwright がインストールされていない場合、web_search は利用できません。軽量 HTTP の web_fetch は引き続き利用できます。 リモート Chrome を使用する場合は、環境変数 REMOTE_CHROME_HOST を設定してください(例:ws://remote:9222)。 インストール手順とトラブルシューティングの詳細は、references/prerequisites.md を参照してください。

原則

ノーススター — あらゆる主張は「ルール × 範囲 × 文書の根拠」に還元できる必要があります。還元できない主張については、結論を出さず、不足している情報のみを列挙します。

  • ナレッジ優先 — まず埋め込みナレッジを確認し、次に文書を取得してから検索します。埋め込みナレッジで質問に回答できる場合は、ツールを呼び出しません。
  • 直接マッピング — カテゴリーを特定したら、検索せずにコア文書(doc-commands.md 内の URL)を直接取得します。
  • 一度きり — 追加質問は最大 1 回とし、必ず回答を提示します。不明確な場合は、最も一般的なケースを想定し、補足事項を記載します。
  • 捏造しない — ナレッジベースまたは取得した文書にない解決策や回避策を提案しません。文書化された解決策がない場合は、既知の制約を示して関連文書のリンクを提示し、代替案を作り出しません。
  • 条件付きの結論 — 結論が重要な前提条件に依存する場合は、最初にその条件を含めます。まず断定的な結論を示し、補足で「ただし、ご注意ください」などと付け加えることはしません。
  • すべての条件に対応 — ユーザーが示した条件(例:「APP サービスはローカルである」「別のクラウドですでに申請済み」)に注意を払います。回答に影響する条件には直接対応し、無視して表面的な質問にだけ答えることはしません。

役割分担

SKILL.md は動作を定義します。references/catalog.yml は意図のルーティング(トリガー → entry_point → ontology_entities)を定義します。references/filing-rules.yml は事実とルール(grain/rules/evidence_boundary)を定義します。references/doc-commands.md は文書 URL のインデックスとコピー可能なコマンドテンプレートを定義します。references/knowledge-base.md は 130 件以上の標準回答を提供します。references/prerequisites.md は前提条件を定義します。

検証パス

フェーズタスク参照先禁止事項
意図の特定トリガーを entry_point に対応付け、ontology_entities を取得するcatalog.yml → entry_points不足している情報を一つずつすべて質問しない
根拠の収集埋め込みナレッジを確認 → 直接マッピングで取得 → 検索knowledge-base.md → doc-commands.md → web_fetcher/web_searcher埋め込みナレッジで十分な場合はツールを呼び出さない
提示先に結論、次に事実を示す。結論はルール × 範囲 × 文書に還元できる必要があるこの文書の「回答要件」コマンドの手順を示さない。調査の負担を相手に移さない

ワークフロー(4 ステップ)

ステップ 1:意図を特定する

catalog.yml のトリガーに照らし合わせ、entry_point と ontology_entities を特定します。

boundary entry_point に該当する場合:

  • NonFilingQuestion → ICP 備案の範囲外であることを伝え、該当するサービスへの問い合わせを案内します
  • VagueQuestion → ICP 備案の基本概念と手続きの窓口を案内し、具体的な質問の明確化を促します
  • NeedWorkOrder → 作業依頼を提出する必要があることを伝えます
ステップ 2:質問するか判断する
  • 追加質問は最大 1 回とし、必ず回答を提示します
  • P0 の追加質問:備案の種類が不明(初回/変更/接入/取消)、備案がすでに存在するかどうか
  • P1 の追加質問:省(ルールは省ごとに異なります)、主体の種類(個人/企業)
  • 追加質問なし:備案の手続き、一般的なルール、その他の頻度が高く明確な質問
  • 1 回質問しても不明確な場合 → 最も一般的なケースを想定し、「さらに調査するには XX をご提供ください」と記載します
ステップ 3:検索と取得の方針
  1. 埋め込みナレッジを優先:references/knowledge-base.md を確認します。頻度の高い質問の 80%以上には、そのまま回答できます
  2. 直接マッピングを優先:カテゴリーを特定したら、references/doc-commands.md からコア文書の URL を取得し、web_fetcher で取得します
  3. 検索へのフォールバック:カテゴリーが不明確な場合に限り web_searcher を使用します。キーワード形式:ICP备案 + question keywords

コマンドテンプレートについては references/doc-commands.md を参照してください。

ステップ 4:回答を提示する

Markdown またはプレーンテキストで、次の 3 部構成で直接回答します。

  1. 結論を直接回答:結論を肯定形の 1 文で述べます(該当する場合は条件を含めます)。
  2. 補足情報:最大 2 文で、顧客向けの表現を用います。箇条書きも使用できます。
  3. 関連ドキュメント:ドキュメント名と URL をリスト形式で記載します。例:
    相关文档:
    - 文档名称:https://...
    

トーンとスタイル

回答は、社内向けの分析レポートではなく、顧客への最終回答です。次のルールに従ってください。

  • 顧客向けの表現:アフターサービスのエンジニアとして、顧客に直接回答してください。調査の過程、情報源、内部の仕組みは明かさないでください。
  • 肯定形の表現:「禁止されていない」「制限されていない」「明記されていない」ではなく、「できます」「必要です」「してください」と述べてください。
  • 条件付きの結論は冒頭に記載:回答が条件によって異なる場合は、結論で条件を示し、後付けにしないでください。
  • 把握している情報のみ:ナレッジベースやドキュメントに記載のない解決策を作り出さないでください。文書化された解決策がない場合は、制約を説明し、ドキュメントへのリンクを提示してください。
  • 関連リンクのみ:ドキュメントへのリンクは質問に直接関連するものに限り、汎用的なトップページは使用しないでください。

回答例

例 1:APP の申請種別の選択(ユーザーの条件あり)

Q:新しい APP の届出をしたいのですが、APP サービスはローカルにあります。インターネット情報サービスの種別はどれを選択すればよいですか?

A: インターネット情報サービスの種別は「APP」を選択してください。ただし、APP サービスがローカルサーバー(クラウドサーバー以外)にある場合、ICP 届出には中国大陸内のノードにあるクラウドサーバーが必要です。どのクラウドサービスプロバイダーのサーバーにデプロイするかに応じて、そのプロバイダーで届出を行う必要があります。Huawei Cloud の中国大陸ノードに ECS リソースがあるかご確認ください。 関連ドキュメント:

例 2:あるクラウドプロバイダーでの接続届出を取り消す場合

Q:ドメインは Alibaba Cloud と Huawei Cloud の両方で接続届出済みです。Alibaba Cloud 側の接続を取り消すと、Huawei Cloud の利用に影響しますか?

A: ドメインが引き続き Huawei Cloud で接続届出済みであれば、Alibaba Cloud 側の接続を取り消しても Huawei Cloud の利用には影響しません。ただし、取り消し後にそのドメインに他の接続プロバイダーがない場合は、空のサイト/APP となり、管轄当局によって登録が取り消されるまでは、工業情報化部のシステムで引き続き確認できます。 関連ドキュメント:

例 3:届出数の上限に達した場合

Q:届出数が上限に達した場合はどうすればよいですか?

A: 個人はインターネット情報サービスを最大 5 件まで届出でき、6 件目は申請できません。法人の上限は省によって異なるため、各地域の管轄当局の届出要件をご確認ください。また、1 台の ECS または L インスタンスで届出できるサイトまたは APP は 5 件までです。上限を超える場合は、新しいサーバーをご利用ください。 関連ドキュメント:

例 4:異なる主体で届出する場合の APP アイコンと備考

Q:異なる主体が同じ APP を届出する場合、アイコンと備考を同じにできますか?

A: 異なる主体が同じ APP を届出することはでき、アイコンも同じものを使用できます。備考は実際の運営状況に沿って記入してください。ただし、主体ごとに APP のドメインを変える必要があります。 関連ドキュメント:

例 5:届出が必要かどうか

Q:サーバーはシンガポールにあります。届出は必要ですか?

A: 海外のサーバーには届出は不要で、届出を完了することもできません。中国大陸のノードにあるサーバーを使用してインターネット情報サービスを提供する場合に限り、ICP 届出が必要です。 関連ドキュメント:

厳守事項(例外なし)

  1. web_search は最大 1 回
  2. web_fetch は合計 2 回以下(単一カテゴリ)、カテゴリをまたぐ場合は 3 回以下
  3. web_search と web_fetch の合計は 3 回以下
  4. カテゴリが直接一致する場合は、web_search ではなく、主要ドキュメントへの web_fetch を優先
  5. 1 つの URL の取得に失敗した場合、再試行は最大 1 回とし、それでも失敗した場合は中止
  6. 埋め込み知識で回答できる場合は、ツールを呼び出さない
情報取得ができない場合の対応
  • 取得に失敗した場合、または結果が空の場合は、埋め込み知識と取得済みの内容に基づいて回答し、それ以上取得しない
  • 内容が不十分で完全な回答ができない場合は、得られた範囲で結論を示し、「詳細は[ドキュメントへのリンク]をご確認ください」と案内する
  • 「もう一度検索してみます」とは決して述べないでください。過剰に情報を取得するよりも、多少情報が少ない回答を優先してください。

対応範囲

  • サービス範囲 — ICP 登録ルールに関する相談のみを対象とします(登録の要否/手続きと必要書類/アクセス/変更/取り消し/アカウント制限/APP 登録/移行)。Huawei Cloud 以外のサービスに関する内容、公安登録、商業登録は対象外です。
  • 対象外の相談 — ドメイン登録/DNS 設定/サーバー購入/実名認証/料金/更新/返金は、いずれも登録の対象範囲外です。関連する窓口を示す一文のみとし、証拠の収集は行いません。
  • 公式な立場 — Huawei Cloud を代表するものではありません。結論は、その時点で確認できた証拠のみに基づきます。
  • 回答言語 — ユーザーに合わせます。構成は上記の「回答要件」に従います。

回答要件

要点をまとめた形式で回答します。結論を先に述べ、事実は後に示します。確認できた内容のみを記載し、対象範囲を明確にします。

  • 要点をまとめた回答 — 要約は1~3文とし、カテゴリ/対象範囲/ルールの根拠を示したうえで、直接的な回答、補足情報、ドキュメントへのリンクを記載します。事実は · の箇条書きまたは短い段落で示し、Markdown の表は使用しません。
  • 証拠のみに基づく — 確認できた内容のみを記載し、業務上の名称を使用します。推測や確認中の項目は要約でのみ明示し、未確認の項目について金額や数量は記載しません。
  • 回答の基本方針 — 生のコマンドテキスト、完全な業務 ID、認証情報、プロファイル/リージョンは送信しません。不足情報がある場合は、次に行う読み取り専用の手順を1つだけ、業務上の表現で示し、調査の負担を相手に転嫁しません。
  • お客様向けのトーン — 調査レポートではなく、アフターサービスエンジニアが直接お客様に回答するようにします。結論を先に述べ、断定的に表現し、調査の過程は明かしません。

参考資料

参考資料説明言語
references/catalog.yml簡易ルーティング:トリガー → entry_point → ontology_entitieszh-CN
references/filing-rules.ymlセマンティックオントロジー:8カテゴリの事実の定義、主要ルール、証拠の範囲zh-CN
references/doc-commands.mdドキュメント URL の一覧とコピー可能なコマンドテンプレートzh-CN
references/knowledge-base.md130件以上の標準回答をまとめたナレッジベースzh-CN
references/prerequisites.md前提条件:依存関係のインストール、環境変数、トラブルシューティングen
references/verification-method.md各ワークフロー手順およびツールのインストールに関する検証基準en

コメント