报告专家 · 技能介绍

为 AI Agent 设计的报告生成与站点部署技能 · 1.4.38

1. 安装与设置

1.1 安装技能

技能支持两种安装渠道：

ClawHub 安装（推荐）

通过 ClawHub CLI 安装，自动管理版本和安全扫描。升级使用 clawhub update report-expert。

clawhub install report-expert
复制
CF Pages 安装

复制以下内容发送给 OpenClaw 即可自动安装。包含 upgrade.py 自更新脚本，升级时运行 python3 upgrade.py。

复制

Agent 会读取 manifest.json 获取文件清单，自动下载到 skills/ 目录并生效。

1.2 配置部署参数

在 Agent 工作区的 TOOLS.md 中添加配置。技能有四个独立部署目标：

配置组变量说明示例
本地报告REPORT_LOCAL_DIR本地站点根目录/home/user/my-site
REPORT_LOCAL_URL站点访问地址https://example.com
REPORT_SITE_NAME站点显示名称我的报告站
远程报告REPORT_CF_PROJECT报告站 CF Pages 项目名my-reports
技能 CFSKILL_CF_PROJECT技能站 CF Pages 项目名report-expert-skill
技能 ClawHubSKILL_CLAWHUB_SLUGClawHub 技能标识report-expert
SKILL_CLAWHUB_NAMEClawHub 显示名报告专家
通用CLOUDFLARE_API_TOKENCF API Token（CF 操作需要）cfut_xxx

1.3 快速配置示例

1.3.1 本地报告模式

文件直接写入本地目录，适合自建站点。复制以下配置粘贴到 TOOLS.md：

REPORT_LOCAL_DIR=/home/user/my-site REPORT_LOCAL_URL=https://example.com REPORT_SITE_NAME=我的报告站
复制

1.3.2 远程报告模式

报告部署到 Cloudflare Pages。需要先创建 CF Pages 项目并获取 API Token：

1登录 Dashboard
2头像 → API Tokens → Create Token
3Pages → Edit → 创建 Token
REPORT_LOCAL_DIR=/home/user/my-site REPORT_LOCAL_URL=https://example.com REPORT_SITE_NAME=我的报告站 REPORT_CF_PROJECT=my-reports CLOUDFLARE_API_TOKEN=cfut_你的Token
复制

将 cfut_你的Token 替换为实际 Token 值。

1.3.3 完整配置（四目标）

同时启用本地报告、远程报告、技能 CF 发布和 ClawHub 发布：

# 本地报告 REPORT_LOCAL_DIR=/home/user/my-site REPORT_LOCAL_URL=https://example.com REPORT_SITE_NAME=我的报告站 # 远程报告 REPORT_CF_PROJECT=my-reports # 技能发布 SKILL_CF_PROJECT=report-expert-skill SKILL_CLAWHUB_SLUG=report-expert SKILL_CLAWHUB_NAME=报告专家 # 通用 CLOUDFLARE_API_TOKEN=cfut_你的Token
复制

2. 使用方式

以下所有操作均通过自然语言对话完成，Agent 会自动调用技能执行。

Agent 自动调研、生成内容、转为 HTML、部署到站点并更新索引。你只需描述需求，整个流程自动完成。

帮我写一份 AI Agent 市场调研报告
复制

支持直接部署 HTML 文件，或将 Markdown 自动转换后部署。可选择分类、指定标题和描述。

把这个 HTML 文件部署到研究报告分类
复制

扫描全站页面，提取标题、日期、描述等信息，自动识别分类并重建完整索引。

整理一下报告
复制

将独立部署的页面（游戏、工具等）添加到站点索引，支持站内 iframe 内嵌查看。

把这个游戏链接加到站点里
复制

支持发布技能到 Cloudflare Pages（预览+生产）和 ClawHub。每次自动更新版本号、文件哈希和介绍页。

发布报告专家技能
复制

3. 技能详细介绍

3.1 核心能力

点击展开查看工作流程

设计系统

内置专业配色方案、SVG 图标体系、响应式栅格布局。生成的报告页面视觉统一，无需额外样式调整。

base.css 变量 报告模板 完整 HTML
智能页面生成

接受 Markdown 或 HTML 输入，自动提取内容并套用模板生成完整页面，包含大纲导航、滚动进度等交互组件。

Markdown/HTML 内容提取 模板渲染 完整 HTML
索引管理

自动扫描站点下所有页面，提取标题、日期、描述、分类等信息，重建索引数据并刷新首页。

扫描 dist/ 提取信息 识别分类 生成 index.json 刷新首页
内嵌查看器

外部页面可在站内通过 iframe 打开查看，保持导航体验一致。支持 hash 路由和 postMessage 通信。

点击外部链接 写入 #v=hash 打开 iframe postMessage 返回
四目标部署系统

四个独立部署目标，统一配置管理。报告可部署到本地目录或 Cloudflare Pages，技能可发布到 CF Pages 或 ClawHub。

本地报告 远程报告 技能 CF ClawHub
版本管理与发布

支持两种升级方式和多个发布目标。ClawHub 渠道使用 clawhub update 升级，CF Pages 渠道使用内置 upgrade.py 升级。发布到 CF Pages（预览+生产）和 ClawHub 时自动更新版本号、文件哈希和介绍页。

版本号+1 更新哈希 生成介绍页 部署/发布

3.2 内容分类体系

分类不是固定枚举，而是通过扫描页面内容自动识别。Agent 读取每个页面的 HTML，根据标题和正文语义判断所属分类，该分类决定页面在索引首页中归入哪个分组。

页面 HTML 语义分析 匹配分类 索引分组

内置分类标识：

research深度研究
analysis数据分析
project项目作品
summary内容摘要
comparison对比评测
tutorial教程指南
other其他

3.3 技能文件结构

report-expert/ ├── SKILL.md 技能定义（Agent 自动读取） ├── deploy.py CLI 入口（参数解析与命令分发） ├── upgrade.py 自动升级工具 ├── manifest.json 版本清单（发布用） ├── lib/ │ ├── config.py 统一配置管理（四组部署目标） │ ├── page.py HTML 模板生成 │ ├── local_deploy.py 本地报告部署（写文件到 dist/） │ ├── remote_deploy.py远程报告部署（Cloudflare Pages） │ ├── skill_cf_publish.py 技能发布到 CF Pages │ ├── skill_clawhub_publish.py 技能发布到 ClawHub │ ├── index.py 索引管理（重建/添加/扫描） │ └── backup.py 备份恢复与页面模板更新 ├── templates/ │ ├── base.css 全局样式 │ └── index.html 首页模板 └── scripts/ └── main.js 首页交互脚本
复制

3.4 版本更新记录

最新四目标部署系统：本地报告、远程报告、技能CF发布、技能ClawHub发布独立管理
v1.4统一页头页脚注入、iframe hash 路由、非报告页面隔离
v1.3iframe 内嵌查看器、报告页自动刷新
v1.2自适应部署配置、项目分类支持