数据流

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

Skills 详解

fetch_doc — 抓取/查询文档

两种模式：

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

bash

doc_ref 模式 — 各云厂商格式

product 模式 — 从本地数据库查询

参数：

• - cloud（必填）：aliyun | tencent | baidu | volcano
• docref：文档标识，直接从 API 抓取
• product：产品名称，从本地数据库查询
• maxpages：product 模式最多返回篇数（默认 10）
• keyword：额外搜索关键词

返回示例（doc_ref 模式）：
json
{
machine: {
cloud: aliyun,
mode: doc_ref,
items: [
{
title: 什么是专有网络,
url: https://help.aliyun.com/zh/vpc/product-overview/what-is-vpc,
doc_ref: https://help.aliyun.com/zh/vpc/product-overview/what-is-vpc,
content: 专有网络VPC（Virtual Private Cloud）是...,
last_modified: 2024-03-15T10:30:00
}
],
total: 1
},
human: { summary_text: 成功抓取 1 篇文档。 },
error: null
}

调用方拿到 content 后，自行进行总结、摘要等操作。

check_changes — 检测变更

从本地数据库读取已存储的文档，逐篇重新抓取最新版本，与旧版本对比，返回变更列表和 diff。

前提：需要先通过 fetchdoc + docref 抓取过文档，数据库中有基线数据。

bash
cloud-doc-skill check_changes {cloud: aliyun, product: vpc, days: 7}
cloud-doc-skill check_changes {cloud: baidu, product: DNS, days: 30}

参数：

• - cloud（必填）：云厂商标识
• product（必填）：产品名称（用于从本地数据库搜索）
• days：检查最近 N 天（默认 7）
• max_pages：最多检查篇数（默认 200）
• keyword：额外搜索关键词

返回示例：
json
{
machine: {
cloud: aliyun,
product: vpc,
days: 7,
total_checked: 15,
changes: [
{
change_type: major,
title: VPC 配额限制,
url: https://help.aliyun.com/zh/vpc/...,
doc_ref: https://help.aliyun.com/zh/vpc/...,
old_hash: abc123,
new_hash: def456,
diff: --- old\n+++ new\n@@ -10,3 +10,5 @@\n...
}
],
fetch_errors: 0
},
human: { summary_markdown: 检查了 15 篇文档，最近 7 天内无变更。 },
error: null
}

调用方拿到 changes 列表和 diff 后，自行生成变更摘要。

compare_docs — 获取两侧文档

获取两个云厂商的产品文档原始内容，返回给调用方进行对比分析。skill 本身不做对比。

bash

doc_ref 模式（推荐）

product 模式（从本地数据库查询）

参数：

• - left（必填）：cloud + product 或 docref
• right（必填）：cloud + product 或 docref
• focus：对比关注点（传递给调用方参考）

返回示例：
json
{
machine: {
left: { cloud: aliyun, product: vpc, title: 什么是专有网络, content: ... },
right: { cloud: tencent, product: 私有网络, title: 私有网络概述, content: ... },
focus: 能力差异
},
human: { summary_text: 已获取 aliyun/什么是专有网络 和 tencent/私有网络概述 的文档内容，请对比分析。 },
error: null
}

调用方拿到两侧 content 和 focus 后，自行进行对比分析。

summarize_diff — 文档 Diff

对新旧两个版本的文档内容进行 diff，返回变更类型（minor/major/structural）和 diff 内容。

bash
cloud-doc-skill summarizediff {title: VPC API 文档, oldcontent: 旧版本..., new_content: 新版本...}

参数：

• - title（必填）：文档标题
• oldcontent（必填）：旧版本内容
• newcontent（必填）：新版本内容
• focus：关注重点（可选）
• url：文档 URL（可选）

返回示例：
json
{
machine: {
title: VPC API 文档,
change_type: major,
focus: null,
diff: --- old\n+++ new\n...,
old_hash: abc123,
new_hash: def456
},
human: { summary_text: 文档《VPC API 文档》发生了 major 级别的变更，请根据 diff 内容进行分析。 },
error: null
}

调用方