cloud-doc-intelligent-assistant

name	cloud-doc-intelligent-assistant
version	0.5.0
description	多云文档抓取与存储工具，支持阿里云、腾讯云、百度云、火山引擎的产品文档抓取、本地存储、变更检测和跨云文档获取。本 skill 不调用大模型，只负责数据采集和 diff，总结、摘要、对比分析由调用方（客户端大模型）完成。当用户提问涉及阿里云、腾讯云、百度云、火山引擎中任意一个云厂商时，必须调用此 skill。如果用户提问涉及云产品功能但未指明具体云厂商（如"总结一下安全组"），需要先追问用户是哪个云厂商。
author	anthonybinaruth-dotcom
license	MIT
repository	https://github.com/anthonybinaruth-dotcom/cloud-doc-skill/tree/master
homepage	https://github.com/anthonybinaruth-dotcom/cloud-doc-skill
keywords	["documentation","cloud","monitoring","aliyun","tencent","baidu","volcano"]
metadata	{"clawdbot":{"emoji":"📚","requires":{"bins":["python3"],"packages":["requests>=2.31.0","beautifulsoup4>=4.12.0","lxml>=4.9.0","sqlalchemy>=2.0.0","pyyaml>=6.0.0","click>=8.1.0"]}}}
runtime	{"language":"python","version":">=3.10"}
skills	[{"name":"fetch_doc","description":"抓取指定云厂商的单篇文档（doc_ref），或从本地数据库查询已存储的文档（product）","entry":"scripts/entry.py","parameters":{"cloud":"云厂商标识（aliyun/tencent/baidu/volcano）","product":"产品名称（可选，从本地数据库查询）","doc_ref":"文档标识（可选，直接从 API 抓取）","max_pages":"product 模式最多返回篇数（默认 10）","keyword":"额外搜索关键词（可选）"}},{"name":"check_changes","description":"从本地数据库读取已存储文档，重新抓取最新版本并对比变更","entry":"scripts/entry.py","parameters":{"cloud":"云厂商标识","product":"产品名称","days":"检查最近 N 天（默认 7）","max_pages":"最多检查篇数（默认 200）","keyword":"额外搜索关键词（可选）"}},{"name":"compare_docs","description":"获取两个云厂商的产品文档原始内容，供调用方对比分析","entry":"scripts/entry.py","parameters":{"left":"左侧文档配置（cloud + product 或 doc_ref）","right":"右侧文档配置（cloud + product 或 doc_ref）","focus":"对比关注点（可选，传递给调用方参考）"}},{"name":"summarize_diff","description":"对新旧版本文档进行 diff，返回变更类型和 diff 内容","entry":"scripts/entry.py","parameters":{"title":"文档标题","old_content":"旧版本内容","new_content":"新版本内容","focus":"关注重点（可选）","url":"文档 URL（可选）"}},{"name":"run_monitor","description":"从本地数据库读取已存储文档，批量重新抓取检测变更，可推送通知","entry":"scripts/entry.py","parameters":{"clouds":"云厂商列表","products":"产品列表","mode":"巡检模式（check_now/scheduled）","days":"检查最近 N 天（默认 1）","max_pages":"每个产品最多检查篇数（默认 50）","send_notification":"是否发送通知（默认 false）"}}]
permissions	{"network":{"outbound":["https://help.aliyun.com/*","https://cloud.tencent.com/*","https://cloud.baidu.com/*","https://www.volcengine.com/*","${AIFLOW_WEBHOOK_URL}","${RULIU_WEBHOOK_URL}"],"description":"访问云厂商公开文档 API 抓取文档内容。\n变更通知会发送到用户配置的 webhook 地址。\n"},"filesystem":{"read":["config.yaml"],"write":["data/*.db","logs/*.log","notifications/*.md"],"description":"读取配置文件（config.yaml）。\n写入 SQLite 数据库（data/）、日志文件（logs/）和通知文件（notifications/）。\n"},"environment":{"read":["AIFLOW_WEBHOOK_URL","RULIU_WEBHOOK_URL","CLOUD_DOC_MONITOR_LOAD_DOTENV"],"description":"读取环境变量用于 webhook 配置。\n"}}
security_notice	⚠️ 安全提示： 1. 本 skill 不调用任何大模型 API，不会将文档内容发送到第三方 AI 服务。 2. 文档内容存储在本地 SQLite 数据库中。 3. 本工具使用云厂商的公开文档 API，无需认证，但请遵守合理使用原则。 4. 默认请求间隔 1 秒，请勿设置过小的值。 5. 如因不当使用导致 IP 被封禁，使用者需自行承担责任。

多云文档抓取工具

本 skill 负责从四大云厂商（阿里云、腾讯云、百度云、火山引擎）抓取产品文档，存储到本地 SQLite 数据库，并提供变更检测能力。

核心设计原则：skill 只做数据采集和 diff，不调用大模型。总结、摘要、对比分析由调用方（客户端大模型）根据返回的原始文档内容自行完成。

触发规则

1. 用户提问提到阿里云、腾讯云、百度云、火山引擎中任意一个 → 必须调用此 skill
2. 用户提问涉及云产品功能但未指明云厂商（如"总结一下安全组"、"VPC 是什么"） → 先追问用户是哪个云厂商，确认后再调用
3. 用户提到多个云厂商并要求对比 → 使用 compare_docs 获取两侧文档，自行对比分析
4. 用户要求巡检或监控 → 按"巡检流程"章节操作

安装

pip install .
# 或开发模式
pip install -r requirements.txt

安装后可用 cloud-doc-skill 命令，未安装时用 python scripts/entry.py。

调用格式

cloud-doc-skill <skill_name> '<params_json>'
# 或
python scripts/entry.py <skill_name> '<params_json>'

数据流

调用方（AI）通过浏览器收集文档 URL
    ↓
fetch_doc + doc_ref 逐篇抓取 → 存入本地 SQLite
    ↓
check_changes 从数据库读取 → 重新抓取 → 对比 diff → 返回变更列表
    ↓
compare_docs 获取两侧文档原始内容 → 返回给调用方
    ↓
调用方（AI）根据返回的原始内容自行总结、对比、生成报告

Skills 详解

fetch_doc — 抓取/查询文档

两种模式：

1. doc_ref 模式：从云厂商 API 实时抓取单篇文档，存入本地数据库
2. product 模式：从本地数据库按关键词查询已存储的文档（不发网络请求）

# doc_ref 模式 — 各云厂商格式
cloud-doc-skill fetch_doc '{"cloud": "aliyun", "doc_ref": "/vpc/product-overview/what-is-vpc"}'
cloud-doc-skill fetch_doc '{"cloud": "tencent", "doc_ref": "215/20046"}'
cloud-doc-skill fetch_doc '{"cloud": "baidu", "doc_ref": "VPC/qjwvyu0at"}'
cloud-doc-skill fetch_doc '{"cloud": "volcano", "doc_ref": "6401/70538"}'

# product 模式 — 从本地数据库查询
cloud-doc-skill fetch_doc '{"cloud": "aliyun", "product": "VPC"}'
cloud-doc-skill fetch_doc '{"cloud": "tencent", "product": "私有网络", "keyword": "子网"}'

参数：

• cloud（必填）：aliyun | tencent | baidu | volcano
• doc_ref：文档标识，直接从 API 抓取
• ：产品名称，从本地数据库查询