关于 huawei-cloud-icp-rule-consult
面向华为云售后技术工程师的 ICP 备案规则咨询技能,范围涵盖是否需要备案、流程、材料及地区规则等。它先查内置问答,再按主题获取华为云文档;仅提供规则咨询,不代办备案。
主要功能
- 01内置 130 多条问答
- 02按意图匹配备案问题
- 03优先获取对应官方文档
- 04必要时搜索华为云文档
- 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详细介绍
华为云 · ICP 备案规则咨询
概述
华为云 ICP 备案 — 只读规则咨询
借助内置知识库(130 多条问答)、官方文档以及网页搜索/抓取工具,在一次对话中解答 ICP 备案问题:是否需要备案、应遵循什么流程、适用哪些规则、需要哪些材料。仅提供咨询,不代用户办理备案。
范围:仅限中国大陆 ICP 备案(非经营性互联网信息服务备案)。不适用于公安备案或经营性备案。 目标用户:华为云售后技术工程师。 站点:默认使用中国站(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/域名变更)
- 注销备案及注销后的重新备案
- 账号与主体限制(一个账号一个主体、备案额度)
- APP 备案(特征信息、跨主体场景)
- 迁移/转移备案(跨账号、跨主体)
典型用户问题
- “我们的服务器在新加坡,需要备案吗?”(新加坡服务器是否需要备案?)
- “域名在阿里和华为都做了接入备案,取消阿里一侧的接入是否影响华为云使用?”(取消在阿里云的接入备案是否会影响华为云的使用?)
- “备案数量已达上限怎么办?”(备案额度已满,该怎么办?)
- “不同主体备案同一个 APP,图标和备注可以一样吗?”(不同主体能否使用相同的 APP 图标进行备案?)
- “APP 服务在本地,互联网信息服务类型怎么选?”(如何为本地部署的 APP 选择服务类型?)
核心命令
此技能使用 Python 脚本检索网页文档,不使用 KooCLI。提供两种工具:
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 的文档搜索工具
使用真实浏览器搜索华为云文档站点。需要 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 - 优先直接抓取:匹配类别后,使用
web_fetcher抓取references/doc-commands.md中的核心文档 URL - 搜索作为回退方案:仅在类别不明确时使用
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;web_fetch(轻量级 HTTP)仍可使用。 对于远程 Chrome,请设置环境变量
REMOTE_CHROME_HOST(例如,ws://remote:9222)。 完整安装指南和故障排除信息请参见 references/prerequisites.md。
原则
北极星原则 — 任何断言都必须能还原为“规则 × 范围 × 文档证据”;无法还原的断言只能列出缺口,不得给出结论。
- 知识优先 — 先检查内置知识,再获取文档,最后搜索。如果内置知识足以回答问题,则不要调用任何工具。
- 直接映射 — 匹配类别后,直接获取核心文档(URL 位于
doc-commands.md中),不要搜索。 - 一次解答 — 最多进行 1 轮追问,且必须给出答案。如果问题不明确,则采用最常见的场景,并注明补充事项。
- 禁止编造 — 不要提出知识库或获取的文档中没有的解决方案或变通方法。如果没有文档记录的解决方案,应说明已知限制并提供相关文档链接,不要编造替代方案。
- 有条件的结论 — 如果结论取决于重要前提,必须在结论开头说明这些条件。不要先给出绝对结论,再在补充细节中用“但请注意……”来补充说明。
- 回应所有条件 — 注意用户提及的条件(例如“APP 服务在本地”“已在另一个云上备案”)。如果条件会影响答案,就应直接回应,不要忽略条件,只回答表面问题。
分工
SKILL.md 定义行为;references/catalog.yml 定义意图路由(triggers → 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→ 提供基本备案概念和流程入口,并建议用户明确具体问题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 或纯文本输出,并采用三部分结构:
- 直接回答:用一句话肯定地说明结论(如适用,注明条件)
- 补充详情:最多两句话,可使用项目符号,采用面向客户的语气
- 相关文档:使用列表格式,列出文档名称和 URL,例如:
相关文档: - 文档名称:https://...
语气与风格
回复是给客户的最终答复,而非内部分析报告。请遵循以下规则:
- 面向客户的表达:以售后工程师的身份直接回答客户。不要透露调查过程、知识来源或内部机制。
- 肯定式表达:使用“可以/需要/应该”,不要使用“未禁止/未限制/未说明”。
- 条件结论前置:如果答案取决于条件,应在结论中说明条件,而不是事后补充。
- 只陈述已知信息:不要编造知识库或文档中没有的解决方案。如果没有有据可查的解决方案,请说明限制并提供文档链接。
- 仅提供相关链接:文档链接必须与问题直接相关,不要使用通用入口页面。
回复示例
示例 1:选择 APP 备案类型(含用户条件)
问:我们有一个新的 app 需要做下备案,app 服务在本地,这个互联网信息服务类型怎么选呢
答: 互联网信息服务类型选择“APP”即可。但如果 APP 服务部署在本地服务器(非云服务器),ICP备案需使用中国大陆节点的云服务器;在哪家云服务商的服务器上部署,就在哪家办理备案,并需确认是否有华为云中国大陆节点的 ECS 资源。 相关文档:
示例 2:取消一家云服务商的接入备案
问:域名在阿里和华为都做了接入备案,取消阿里一侧的接入是否影响华为云使用?
答: 只要域名在华为云仍有接入备案,取消阿里云一侧的接入就不会影响华为云的使用。但如果取消后该域名没有其他接入商,就会变成空壳网站/APP;在被管局注销前,工信部系统仍可查询到该域名。 相关文档:
示例 3:达到备案数量上限
问:备案数量已达上限怎么办?
答: 个人主体最多备案 5 个互联网信息服务,第 6 个无法提交;企业主体的上限因省份而异,请参考各地区管局备案要求。另外,一台 ECS 或 L 实例只能备案 5 个网站或 APP,超出后需使用新的服务器。 相关文档:
示例 4:不同主体的 APP 图标和备注
问:不同主体备案同一个 APP,图标和备注可以一样吗?
答: 不同主体可以备案同一个 APP,图标可以相同,备注按实际运营情况如实填写即可。但不同主体的 APP 域名需不同。 相关文档:
示例 5:是否需要备案
问:我们的服务器在新加坡,需要备案吗?
答: 境外服务器不需要备案,也无法完成备案。只有使用中国大陆节点服务器提供互联网信息服务时才需要进行 ICP 备案。 相关文档:
硬性约束(不可妥协)
- web_search 最多调用 1 次
- web_fetch 总计不超过 2 次(单一类别),跨类别不超过 3 次
- web_search + web_fetch 合计不超过 3 次
- 类别直接匹配时,优先使用 web_fetch 获取核心文档,不要使用 web_search
- 单个 URL 获取失败时,最多重试 1 次;如果仍失败则跳过
- 如果内置知识可以回答,不要调用任何工具
降级处理
- 获取失败或返回空内容 → 根据内置知识和已获取的内容作答,不要再获取其他内容
- 内容不足以给出完整答案 → 提供可得出的结论,并注明“更多详情请查看[文档链接]”
- 绝不要“再次尝试搜索”——宁可提供较少信息,也不要过度获取
范围边界
- 服务范围 — 仅提供 ICP 备案规则咨询(是否需要备案/流程与材料/接入/变更/注销/账号限制/APP 备案/迁移)。非华为云业务或公安备案/经营性备案不在服务范围内。
- 拒绝转接 — 域名注册/DNS 配置/服务器购买/实名认证/价格/续费/退款,均不属于备案范围;仅用一句话指引至相关渠道,不收集证据。
- 官方身份 — 不代表华为云;结论仅依据当时查到的证据。
- 回复语言 — 与用户保持一致;结构遵循上述“回复要求”。
回复要求
简报式回复:先给结论,再陈述事实;只写已查到的内容,并明确说明范围。
- 简报风格 — 摘要用一至三句话,说明类别/范围/规则依据,并给出直接答复、补充详情和文档链接。事实要点使用
·列表或简短段落,不使用 Markdown 表格。 - 仅采信证据 — 仅列出已查到的内容,并使用业务名称;仅在摘要中标注推测和待核查事项;未经核实的项目不提供金额/数量。
- 交付底线 — 不发送原始命令文本、完整业务 ID、凭据、个人资料/地域信息。对于信息缺口,只提供一个只读的后续步骤(使用业务表述),不转移调查责任。
- 面向客户的语气 — 回复应模拟售后工程师直接回答客户,而非撰写分析报告。结论先行,使用肯定表述,不透露调查过程。
参考资料
| 参考资料 | 说明 | 语言 |
|---|---|---|
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 |