SuperAPI AI Directory

huawei-cloud-icp-process-guidance

General & other

View repository

Updated 10-15 22:14

About this skill

Huawei Cloud · ICP Filing Knowledge Q&A

Built-in ICP filing knowledge base, providing direct retrieval-based Q&A.

Prerequisites

External dependencies (required for search fallback)

When the knowledge base cannot cover a question, this Skill will call agent-reach 's Exa search for completion.

Why it is needed: The search capability is provided by agent-reach; this Skill is only responsible for the judgment logic and output format.

Installation method(copy to AI for execution):

帮我安装 Agent Reach:https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md

After installation is complete, verify:

mcporter call 'exa.web_search_exa(query: "test", numResults: 1)'

If you encounter problems during installation, see agent-reach troubleshooting。

Knowledge base preparation

This Skill comes with an ICP filing knowledge base, located in the ./kb/ directory:

  • index.json: Knowledge base document index (pre-generated, ready to use out of the box)
  • kb/: Original Markdown document directory

To update the knowledge base content, please:

  1. Update the Markdown files in the kb/ directory
  2. Run python scripts/build_index.py to regenerate the index

Environment check

Ensure the following paths are accessible:

# 检查 skill 目录结构
ls -la <skill-dir>/

# 检查知识库目录
ls -la <skill-dir>/kb/

Where <skill-dir> is the installation directory of this Skill.

Trigger conditions

Activated when the following conditions are met simultaneously:

  1. The user mentions "Huawei Cloud" or "Huawei Cloud ICP"
  2. And mentions one of the following keywords:
    • Filing-related: filing, filing process, filing materials, filing conditions, filing review, filing rejection, filing cancellation, filing change
    • Resource-related: authorization code, filing authorization code
    • Question type: FAQ, frequently asked questions, questions, what to do
    • Specific scenarios: adding a website, domain filing, individual filing, enterprise filing, branch office filing

Example questions:

  • "What materials need to be prepared for Huawei Cloud ICP filing?"
  • "What should I do if the filing is rejected?"
  • "How is the authorization code generated?"
  • "Can a branch office file under the parent company's account?"
  • "What is the difference between individual filing and enterprise filing?"
  • "What should I do if the ECS filing count exceeds the limit?"

Retrieval process

Step 1: Read index.json

First read index.jsonto understand which documents are in the knowledge base, and the type and summary of each document.

Step 2: Semantic matching to select documents

Based on the semantics of the user's question, select the 1-3 most relevant documents from index.json.

Matching basis:

  • title: Document title
  • case_types: Case type tag
  • summary: Document summary (LLM-generated)
  • The core intent of the user's question (e.g., "materials" → find materials-related documents)

Step 3: Read the selected documents

Read the original text of the Markdown documents selected in index.json.

Step 4: Extract Relevant paragraphs

Find the paragraphs/sections in the original document text that are most relevant to the user's question.

Step 5: Assemble the answer

Assemble the answer according to the response format.

Step 6: Search fallback (conditionally triggered)

When the following situations occur, enable web search supplementation (see references/search-fallback.md):

Trigger condition Action
Knowledge base retrieval results have low relevance (<0.3) or are empty Search immediately
Knowledge base content was published more than 6 months ago Search for the latest policy comparison
The user explicitly asks about "latest" or "recent" related matters Search for the latest developments

When supplementing with search:

  1. Construct Query:华为云ICP备案 + [核心关键词] + 2026
  2. Call mcporter call 'exa.web_search_exa(query: "...", numResults: 3)'
  3. Append at the end of the answer the **网络补充**(仅供参考) section
  4. Must include a disclaimer

Parameter confirmation

This Skill is in pure Q&A mode, and no external parameters require user confirmation.

However, when performing retrieval, it will automatically infer based on the semantics of the user's question:

  • Filing type: Individual filing / Entity filing
  • Filing stage: First-time filing / Add website / Change filing / Cancel filing
  • Question category: Materials consultation / Process consultation / Rejection consultation / Authorization code consultation

If the user's question is vaguely worded, proactively ask for clarification.

Boundary definition

Questions that should be answered

  • ICP filing process, steps, and precautions
  • Filing materials preparation (individual/entity)
  • Filing conditions, restrictions, and resource requirements
  • Common questions, rejection reasons, and handling methods
  • Authorization code usage rules and generation methods
  • Review status tracking
  • Filing change, cancellation, and migration processes
  • Administration bureau policies and region selection rules

Questions that should not be answered

Scenario Refusal wording
Filing for other clouds (Alibaba Cloud, Tencent Cloud, AWS) "I am the Huawei Cloud ICP filing knowledge base here, and I am not very familiar with the situation of other cloud platforms. It is recommended to consult the official documentation of the corresponding platform."
Technical questions unrelated to filing "This question is beyond the scope of ICP filing. It is recommended to consult via a ticket or customer service (950808 extension 3)."
Pricing, purchase, and renewal related "For such questions, it is recommended to contact Huawei Cloud sales or view the product pricing page."
Content not in the knowledge base "Sorry, the knowledge base does not currently include information on this topic. It is recommended to contact Huawei Cloud customer service at 950808 extension 3."

Output format

Standard format (Briefing Style)

## ICP备案 · [问题主题]

**结论**:一句话直接回答用户核心问题

**关键事实**:
· 要点1(来自XXX文档#章节)
· 要点2
· 要点3

**适用场景**:[补充说明适用范围或前提条件]

**操作建议**:
1. 可执行的步骤1(简要说明)
2. 可执行的步骤2(简要说明)
3. 如有需要,引导至控制台或人工客服

**来源**:[文档路径.md]

Example

Q: What materials need to be prepared for individual filing?

A:

## ICP备案 · 个人备案材料

**结论**:个人备案需要准备身份证原件和手机,部分省份需要幕布照。

**关键事实**:
· 个人备案材料:身份证原件、手机、幕布照(部分省份如贵州、湖南等需要)
· 网站内容限制:个人备案的网站不能涉及经营性内容
· 真实性核验:需由互联网信息服务负责人完成活体认证和签字
· 地域选择:根据身份证所在地或实际居住地选择备案省份

**适用场景**:首次备案、新增网站/App备案

**操作建议**:
1. 登录华为云控制台,进入ICP备案页面
2. 准备好身份证原件和手机(部分省份需备好幕布照)
3. 负责人需完成活体认证和签字确认
4. 如有问题可拨打客服热线 950808 转3

**来源**:faq/备案材料咨询.md

Index structure (index.json)

{
  "version": "1.0",
  "generated_at": "2026-07-06T10:00:00",
  "total_docs": 20,
  "docs": [
    {
      "path": "faq/备案常见问题.md",
      "type": "faq",
      "title": "备案常见问题",
      "case_types": ["备案常见问题", "备案材料咨询", "备案流程咨询", "备案驳回咨询"],
      "summary": "汇总ICP备案常见问题,涵盖授权码使用限制、资源备案次数上限、实名核验要求等。"
    }
  ]
}

Reference documents

Document Description
references/cli-installation-guide.md CLI installation guide (this skill is Q&A type and does not involve CLI)
references/iam-policies.md IAM permission policy (this skill is Q&A type and does not require cloud API permissions)
references/verification-method.md Verification methods: environment check, functional verification, performance verification
references/acceptance-criteria.md Acceptance criteria: functional acceptance, quality acceptance, security acceptance
references/search-fallback.md Search fallback strategy: web search supplementation plan when the knowledge base yields no results

Best practices

  1. Do not guess: If there is no clear answer in the knowledge base, honestly say "not included", do not fabricate
  2. Cite sources: Every key fact must cite the source document to enhance credibility
  3. Control length: Keep answers concise, do not copy the entire document, highlight the parts relevant to the question
  4. Consistent terminology: Use terminology consistent with the Huawei Cloud console (such as "filing authorization code" instead of "filing code")
  5. Update index: After the knowledge base content is updated, you need to rerun python build_index.py to update the index

File structure

huawei-cloud-icp-process-guidance/   # 技能包根目录
├── SKILL.md                       # 技能定义文件(必需,唯一入口)
├── index.json                     # 知识库文档索引(预生成)
├── kb/                            # 知识库目录(自包含)
│   ├── faq/                       # FAQ文档
│   ├── procedures/                # 流程文档
│   ├── topics/                    # 主题文档
│   ├── overview.md                # 知识库概览
│   └── index.md                   # 知识库索引
├── scripts/                       # 脚本目录
│   └── build_index.py             # 索引构建脚本
└── references/                    # 参考文档目录
    ├── search-fallback.md         # 搜索兜底策略
    ├── verification-method.md     # 验证方法
    └── acceptance-criteria.md     # 验收标准

Version history

Version Date Change description
1.2.0 2026-07-07 Added prerequisite dependency note: it is explicitly required to install agent-reach to enable the search fallback
1.1.0 2026-07-07 Added search fallback strategy: enable Exa web search to supplement when the knowledge base yields no results
1.0.0 2026-07-07 Initial version, compliant with Huawei Cloud Skills specifications