| name | huawei-cloud-icp-process-guidance |
| description | 华为云ICP备案知识问答Skill。
自带 ICP备案知识库（./kb/），开箱即用。
当用户提到华为云/ICP备案/网站备案/App备案 + 流程/材料/条件/问题/驳回/授权码/审核时触发。
只回答ICP备案相关问题，其他问题礼貌拒绝。
|
| tags | ["huawei-cloud","icp-filing","faq","knowledge-base"] |
| version | 1.1.0 |
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 文档目录
如需更新知识库内容，请：
- 更新
kb/ 目录下的 Markdown 文件
- 运行
python scripts/build_index.py 重新生成索引
环境检查
确保以下路径可访问：
ls -la <skill-dir>/
ls -la <skill-dir>/kb/
其中 <skill-dir> 为本技能的安装目录。
触发条件
同时满足以下条件时激活：
- 用户提到「华为云」或「华为云ICP」
- 并且提到以下关键词之一：
- 备案相关：备案、备案流程、备案材料、备案条件、备案审核、备案驳回、备案注销、备案变更
- 资源相关：授权码、备案授权码
- 问题类型：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个月 | 搜索最新政策对比 |
| 用户明确询问"最新"、"最近"相关 | 搜索最新进展 |
搜索补全时：
- 构造Query：
华为云ICP备案 + [核心关键词] + 2026
- 调用
mcporter call 'exa.web_search_exa(query: "...", numResults: 3)'
- 在回答末尾追加
**网络补充**（仅供参考） 部分
- 必须附带免责声明
参数确认
本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备案常见问题，涵盖授权码使用限制、资源备案次数上限、实名核验要求等。"
}
]
}
参考文档
最佳实践
- 不要猜测：如果知识库中没有明确答案，老实说"没有收录"，不要臆造
- 标明来源：每个关键事实都要标明来源文档，增强可信度
- 控制长度：回答精简，不要照搬整篇文档，突出与问题相关的部分
- 术语一致：使用与华为云控制台一致的术语（如"备案授权码"而非"备案码"）
- 更新索引：当知识库内容更新后，需重新运行
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规范 |
