前言¶
在控制台改 DNS、刷缓存、查安全策略时,往往要在多个产品文档和 API 列表之间来回跳。把「要查什么、改什么」说清楚,Agent 仍可能凭旧知识猜参数,或在未确认的情况下直接调用写接口。下面介绍 SkillHub 上的 Tencent EdgeOne(@tencent-adm/tencent-edgeone-skill,v1.1.1):由腾讯云 EdgeOne 团队发布,归类为 it-ops-security,来源为 enterprise。它把 EdgeOne 相关请求路由到内置参考文档,并约定通过 API 完成任务,而不是只靠模型记忆。
这是什么¶
一句话定位:面向腾讯 EdgeOne(边缘安全与加速平台)的综合性 Agent Skill,覆盖边缘加速、边缘安全、可观测性等运维与配置场景。
维护方与分发:发布者为腾讯云 EdgeOne 团队;可在 SkillHub(技能页)安装,上游仓库为 clawhub.ai/tencent-adm/tencent-edgeone-skill。Skill 标注 requires_api_key=true,实际凭证与调用方式以技能包内 references/api/README.md 为准。
解决的问题:当用户提到 EdgeOne / EO 的配置、查询、排障时,Agent 先匹配模块、加载对应入口文档,再按 API 约定执行;技能说明中明确要求参考文件可能滞后,需优先检索而非依赖预训练知识,并与官方产品文档冲突时以官方文档为准。
核心功能¶
以下能力均来自官方技能说明与简介,按模块划分。
边缘加速(Acceleration)
入口文档:references/acceleration/README.md。涵盖站点接入、缓存刷新与预热、证书管理等;简介中还提到 DNS、缓存、规则引擎、L4 代理等加速相关能力。
边缘安全(Security)
入口文档:references/security/README.md。包括安全策略模板审计、封禁 IP 组查询、安全报告等;英文说明中另列 DDoS 防护、Web 防护、Bot 管理等安全方向。
API 与发现(API)
入口文档:references/api/README.md。约定调用规范、工具安装、凭证配置、API 发现,以及站点与域名发现(如 ZoneId 查询)。技能要求:任何任务开始前必须先阅读该文档。
可观测性(Observability)
入口文档:references/observability/README.md。包括流量日报生成、源站健康检查、离线日志下载与分析。
其他产品能力(简介级)
英文技能描述中还提到边缘媒体(实时音视频 / 图像处理)、边缘开发(Edge Functions、EdgeOne Pages)、负载均衡等;若请求无法落入上表模块,技能规定先读 references/api/api-discovery.md 做 API 发现,再查 EdgeOne 产品文档。
执行与安全红线
- 写操作(Create / Modify / Bind / Delete / Apply* 等)须向用户说明影响并等待确认后再调 API。
- 不得向用户索要 SecretId / SecretKey,拒绝可能打印凭证的操作。
- 大批量或重复任务优先写脚本一次性执行,而非逐条手调 API。
安装与启用¶
SkillHub 页面给出的安装方式是:让 AI 按 SkillHub 安装说明 安装 @tencent-adm/tencent-edgeone-skill。
若本机已有 SkillHub CLI,可直接安装到当前 Agent 的 skills 目录(必须使用 --dir,否则默认落在 ./skills/ 可能不被识别):
command -v skillhub && skillhub --version
未安装 CLI 时,可用官方脚本(完整安装含 CLI 与默认 Skill):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本技能示例(将 <skills 目录> 换成当前环境路径):
skillhub install @tencent-adm/tencent-edgeone-skill --dir <skills 目录>
常用客户端 skills 目录(来自 SkillHub 安装文档):
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或项目下的.agents/skills/
在 ClawHub / OpenClaw 生态中,上游页面给出的命令为:
openclaw skills install @tencent-adm/tencent-edgeone-skill
启用后,Agent 加载技能包中的 SKILL.md 及 references/ 下各模块文档;API 密钥与环境检查步骤以 references/api/README.md 为准,正文不重复未在公开页面展开的字段名。
典型用法¶
1. 用自然语言触发模块路由
当对话中出现 EdgeOne 配置、运维、查询或排障需求时,技能会将意图映射到 API、Acceleration、Security 或 Observability 模块,并加载对应 README.md 继续执行。
2. 加速类操作
例如缓存刷新、预热、证书或站点接入相关问题,应走 Acceleration 入口,再按文档调用相应 API。
3. 安全与审计
例如查看封禁 IP 组、安全策略模板或安全报告,走 Security 入口。
4. 报表与日志
流量日报、源站健康、离线日志分析等,走 Observability 入口。
5. 无法直接匹配模块时
先执行 references/api/api-discovery.md 中的 API 发现流程;仍无法覆盖时,检索腾讯 EdgeOne 官方产品文档。
复现路径:安装技能 → 在支持 Skills 的客户端中发起上述类型的问题 → Agent 按技能要求先读 API 文档、对写操作做确认后再调用接口。
适用场景与注意¶
适合谁
负责 EdgeOne 站点加速、安全防护、日志与流量分析的一线运维、SRE,或需要在 IDE / CLI Agent 里用对话驱动 EO API 的工程师。
使用注意
- 技能内参考文档可能过期,定价、限额、参数以官方文档与实时 API 为准。
- 所有任务以 API 调用完成,需提前按 references/api/README.md 配置凭证;标签标明需要 API Key,但不要在对话中明文传递 SecretKey。
- 写操作必须人工确认,适合生产环境变更流程。
- SkillHub 侧统计(以抓取资料为准):评分 100000,下载约 1500 次;安装后若 Agent 未识别技能,检查是否装入了正确的 --dir 并按要求重启或刷新客户端。
结尾¶
Tencent EdgeOne Skill 把 EO 的加速、安全、可观测与 API 发现收敛成一套模块化参考,让 Agent 在明确安全红线的前提下通过 API 干活,而不是泛泛「讲产品」。需要安装或查看详情时,可打开 SkillHub 技能页:https://www.skillhub.cn/skills/tencent-adm/tencent-edgeone-skill,API 入口:https://api.skillhub.cn/tencent-adm/tencent-edgeone-skill。