huawei-cloud-icp-process-guidance

Huawei Cloud · ICP备案知识问答

内置 ICP备案知识库，提供直接检索式问答。

前置条件

外部依赖（搜索兜底必需）

本Skill在知识库无法覆盖问题时，会调用 agent-reach 的 Exa 搜索进行补全。

为什么需要：搜索能力由 agent-reach 提供，本Skill只负责判断逻辑和输出格式。

安装方法（复制给 AI 执行）：

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

安装完成后验证：

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

如安装遇到问题，参见 agent-reach 故障排除。

知识库准备

本Skill自带 ICP备案知识库，位于 ./kb/ 目录：

• index.json：知识库文档索引（预生成，开箱即用）
• kb/：原始 Markdown 文档目录

如需更新知识库内容，请：

1. 更新 kb/ 目录下的 Markdown 文件
2. 运行 python scripts/build_index.py 重新生成索引

环境检查

确保以下路径可访问：

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

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

其中 <skill-dir> 为本技能的安装目录。

触发条件

同时满足以下条件时激活：

1. 用户提到「华为云」或「华为云ICP」
2. 并且提到以下关键词之一：
   • 备案相关：备案、备案流程、备案材料、备案条件、备案审核、备案驳回、备案注销、备案变更
   • 资源相关：授权码、备案授权码
   • 问题类型：FAQ、常见问题、问题、怎么办
   • 具体场景：新增网站、域名备案、个人备案、企业备案、分公司备案

示例问题：

• "华为云ICP备案需要准备什么材料？"
• "备案被驳回了怎么处理？"
• "授权码怎么生成的？"
• "分公司能在母公司账号下备案吗？"
• "个人备案和企业备案有什么区别？"
• "ECS备案次数超限了怎么办？"

检索流程

Step 1：读取 index.json

首先读取 index.json，了解知识库中有哪些文档、各文档的类型和摘要。

Step 2：语义匹配选择文档

根据用户问题的语义，从 index.json 中选择最相关的 1-3 篇文档。

匹配依据：

• title：文档标题
• case_types：案例类型标签
• summary：文档摘要（LLM生成）
• 用户问题的核心意图（如"材料"→找材料相关文档）

Step 3：读取选中文档

读取 index.json 中选中的 Markdown 文档原文。

Step 4：提取 Relevant 段落

从文档原文中找出与用户问题最相关的段落/章节。

Step 5：组装回答

按照响应格式组装回答。

Step 6：搜索兜底（条件触发）

当以下情况发生时，启用网络搜索补全（详见 references/search-fallback.md）：

触发条件	操作
知识库检索结果相关性低（<0.3）或为空	立即搜索
知识库内容发布时间超过6个月	搜索最新政策对比
用户明确询问"最新"、"最近"相关	搜索最新进展

搜索补全时：

1. 构造Query：华为云ICP备案 + [核心关键词] + 2026
2. 调用 mcporter call 'exa.web_search_exa(query: "...", numResults: 3)'
3. 在回答末尾追加 **网络补充**（仅供参考） 部分
4. 必须附带免责声明

参数确认

本Skill为纯问答模式，无外部参数需要用户确认。

但在进行检索时，会根据用户问题的语义自动推断：

• 备案类型：个人备案 / 单位备案
• 备案阶段：首次备案 / 新增网站 / 变更备案 / 注销备案
• 问题类别：材料咨询 / 流程咨询 / 驳回咨询 / 授权码咨询

如用户问题表述模糊，应主动询问澄清。

边界定义

应该回答的问题

• ICP备案流程、步骤、注意事项
• 备案材料准备（个人/单位）
• 备案条件、限制、资源要求
• 常见问题、驳回原因及处理方法
• 授权码使用规则、生成方式
• 审核状态追踪
• 备案变更、注销、迁移流程
• 管局政策、地域选择规则

不应该回答的问题

场景	拒绝话术
其他云（阿里云、腾讯云、AWS）的备案	"我这边是华为云ICP备案知识库，其他云平台的情况不太清楚，建议查阅相应平台的官方文档。"
与备案无关的技术问题	"这个问题超出了ICP备案的范围，建议通过工单或客服（950808转3）咨询。"
价格、购买、续订相关	"这类问题建议联系华为云销售或查看产品定价页。"
知识库中没有的内容	"抱歉，知识库中暂时没有收录这方面的信息，建议联系华为云客服 950808 转3 咨询。"

输出格式

标准格式（Briefing Style）

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

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

**关键事实**：
· 要点1（来自XXX文档#章节）
· 要点2
· 要点3

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

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

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

示例

问：个人备案需要准备什么材料？

答：

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

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

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

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

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

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

索引结构（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备案常见问题，涵盖授权码使用限制、资源备案次数上限、实名核验要求等。"
    }
  ]
}

参考文档

文档	说明
references/cli-installation-guide.md	CLI安装指南（本技能为Q&A型，不涉及CLI）
references/iam-policies.md	IAM权限策略（本技能为Q&A型，无需云API权限）
references/verification-method.md	验证方法：环境检查、功能验证、性能验证
references/acceptance-criteria.md	验收标准：功能验收、质量验收、安全验收
references/search-fallback.md	搜索兜底策略：知识库无果时的网络搜索补全方案

最佳实践

1. 不要猜测：如果知识库中没有明确答案，老实说"没有收录"，不要臆造
2. 标明来源：每个关键事实都要标明来源文档，增强可信度
3. 控制长度：回答精简，不要照搬整篇文档，突出与问题相关的部分
4. 术语一致：使用与华为云控制台一致的术语（如"备案授权码"而非"备案码"）
5. 更新索引：当知识库内容更新后，需重新运行 python build_index.py 更新索引

文件结构

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     # 验收标准

版本历史

版本	日期	变更说明
1.2.0	2026-07-07	新增前置依赖说明：明确需要安装 agent-reach 才能启用搜索兜底
1.1.0	2026-07-07	新增搜索兜底策略：知识库无果时启用 Exa 网络搜索补全
1.0.0	2026-07-07	初始版本，符合华为云Skills规范