huawei-cloud-icp-rule-consult について
Huawei Cloud のアフターサービス技術者向け ICP 届出ルール相談スキルです。届出の要否、手順、書類、地域別規則を扱い、まず内蔵 Q&A を参照してから関連文書を取得します。相談専用で、届出の代行は行いません。
主な機能
- 01130 件以上の Q&A を内蔵
- 02意図に応じた質問の振り分け
- 03関連する公式文書を優先取得
- 04必要に応じた Huawei Cloud 文書検索
- 05読み取り専用のルール相談
活用シーン
- 01サーバーやドメインの届出要否の確認
- 02地域別の手順と必要書類の確認
- 03接続・変更・取消届出の相談
- 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.ymldoc-commands.mdfiling-rules.ymlknowledge-base.mdprerequisites.mdverification-method.mdscripts/__init__.pyrequirements.txtweb_fetcher.pyweb_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 登録(特徴情報、事業者をまたぐシナリオ)
- 登録の移行/譲渡(アカウント間、事業者間)
よくあるユーザーの質問
- 「我们的服务器在新加坡,需要备案吗?」(サーバーがシンガポールにある場合、登録は必要ですか?)
- 「域名在阿里和华为都做了接入备案,取消阿里一侧的接入是否影响华为云使用?」(ドメインを Alibaba Cloud と Huawei Cloud の両方で接続登録しています。Alibaba Cloud 側の接続を取り消すと、Huawei Cloud の利用に影響しますか?)
- 「备案数量已达上限怎么办?」(登録件数が上限に達した場合、どうすればよいですか?)
- 「不同主体备案同一个APP,图标和备注可以一样吗?」(異なる事業者が同じ APP を登録する場合、アイコンと備考は同じでもよいですか?)
- 「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
ツールの選択優先順位
- まず組み込みのナレッジを確認:
references/knowledge-base.mdを確認します - 直接取得を優先:カテゴリを特定した後、
references/doc-commands.mdのコアドキュメント URL をweb_fetcherで取得します - 検索はフォールバックとして使用:カテゴリが不明な場合に限り
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:検索と取得の方針
- 埋め込みナレッジを優先:
references/knowledge-base.mdを確認します。頻度の高い質問の 80%以上には、そのまま回答できます - 直接マッピングを優先:カテゴリーを特定したら、
references/doc-commands.mdからコア文書の URL を取得し、web_fetcherで取得します - 検索へのフォールバック:カテゴリーが不明確な場合に限り
web_searcherを使用します。キーワード形式:ICP备案 + question keywords
コマンドテンプレートについては references/doc-commands.md を参照してください。
ステップ 4:回答を提示する
Markdown またはプレーンテキストで、次の 3 部構成で直接回答します。
- 結論を直接回答:結論を肯定形の 1 文で述べます(該当する場合は条件を含めます)。
- 補足情報:最大 2 文で、顧客向けの表現を用います。箇条書きも使用できます。
- 関連ドキュメント:ドキュメント名と 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 届出が必要です。 関連ドキュメント:
厳守事項(例外なし)
- web_search は最大 1 回
- web_fetch は合計 2 回以下(単一カテゴリ)、カテゴリをまたぐ場合は 3 回以下
- web_search と web_fetch の合計は 3 回以下
- カテゴリが直接一致する場合は、web_search ではなく、主要ドキュメントへの web_fetch を優先
- 1 つの URL の取得に失敗した場合、再試行は最大 1 回とし、それでも失敗した場合は中止
- 埋め込み知識で回答できる場合は、ツールを呼び出さない
情報取得ができない場合の対応
- 取得に失敗した場合、または結果が空の場合は、埋め込み知識と取得済みの内容に基づいて回答し、それ以上取得しない
- 内容が不十分で完全な回答ができない場合は、得られた範囲で結論を示し、「詳細は[ドキュメントへのリンク]をご確認ください」と案内する
- 「もう一度検索してみます」とは決して述べないでください。過剰に情報を取得するよりも、多少情報が少ない回答を優先してください。
対応範囲
- サービス範囲 — ICP 登録ルールに関する相談のみを対象とします(登録の要否/手続きと必要書類/アクセス/変更/取り消し/アカウント制限/APP 登録/移行)。Huawei Cloud 以外のサービスに関する内容、公安登録、商業登録は対象外です。
- 対象外の相談 — ドメイン登録/DNS 設定/サーバー購入/実名認証/料金/更新/返金は、いずれも登録の対象範囲外です。関連する窓口を示す一文のみとし、証拠の収集は行いません。
- 公式な立場 — Huawei Cloud を代表するものではありません。結論は、その時点で確認できた証拠のみに基づきます。
- 回答言語 — ユーザーに合わせます。構成は上記の「回答要件」に従います。
回答要件
要点をまとめた形式で回答します。結論を先に述べ、事実は後に示します。確認できた内容のみを記載し、対象範囲を明確にします。
- 要点をまとめた回答 — 要約は1~3文とし、カテゴリ/対象範囲/ルールの根拠を示したうえで、直接的な回答、補足情報、ドキュメントへのリンクを記載します。事実は
·の箇条書きまたは短い段落で示し、Markdown の表は使用しません。 - 証拠のみに基づく — 確認できた内容のみを記載し、業務上の名称を使用します。推測や確認中の項目は要約でのみ明示し、未確認の項目について金額や数量は記載しません。
- 回答の基本方針 — 生のコマンドテキスト、完全な業務 ID、認証情報、プロファイル/リージョンは送信しません。不足情報がある場合は、次に行う読み取り専用の手順を1つだけ、業務上の表現で示し、調査の負担を相手に転嫁しません。
- お客様向けのトーン — 調査レポートではなく、アフターサービスエンジニアが直接お客様に回答するようにします。結論を先に述べ、断定的に表現し、調査の過程は明かしません。
参考資料
| 参考資料 | 説明 | 言語 |
|---|---|---|
references/catalog.yml | 簡易ルーティング:トリガー → entry_point → ontology_entities | zh-CN |
references/filing-rules.yml | セマンティックオントロジー:8カテゴリの事実の定義、主要ルール、証拠の範囲 | zh-CN |
references/doc-commands.md | ドキュメント URL の一覧とコピー可能なコマンドテンプレート | zh-CN |
references/knowledge-base.md | 130件以上の標準回答をまとめたナレッジベース | zh-CN |
references/prerequisites.md | 前提条件:依存関係のインストール、環境変数、トラブルシューティング | en |
references/verification-method.md | 各ワークフロー手順およびツールのインストールに関する検証基準 | en |