报告专家 · 技能介绍

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

1. 安装与设置

1.1 安装技能

复制以下内容发送给 OpenClaw 即可自动安装：

复制

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

1.2 配置部署参数

在 Agent 工作区的 TOOLS.md 中添加配置。技能支持两种部署模式：

变量说明示例
REPORT_DEPLOY_MODE部署模式local 或 remote
REPORT_LOCAL_DIR本地站点根目录/home/user/my-site
REPORT_LOCAL_URL站点访问地址https://example.com/reports
REPORT_SITE_NAME站点显示名称我的报告站
CLOUDFLARE_API_TOKENCloudflare API Token（仅 remote 模式）cfut_xxxxxxxxxxxx

1.3 快速配置示例

1.3.1 本地模式

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

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

1.3.2 远程模式

部署到 Cloudflare Pages，需要先获取 API Token：

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

将 cfut_你的Token 替换为上一步复制的实际 Token 值。

2. 使用方式

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

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

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

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

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

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

整理一下报告
复制

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

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

从远程检查新版本，自动下载并替换文件，保持技能最新。也支持发布本地修改到远程。

更新报告专家技能
复制

3. 技能详细介绍

3.1 核心能力

点击展开查看工作流程

设计系统

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

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

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

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

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

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

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

点击外部链接 写入 #v=hash 打开 iframe postMessage 返回
自适应部署

从 TOOLS.md 读取配置，自动适配本地目录部署或 Cloudflare Pages 远程部署。

读取 TOOLS.md 判断 MODE local → 写文件 remote → CF API
自动升级

从远程检查新版本，一键下载替换文件。发布流程支持预览验证后生产部署，每次自动升版本号并备份。

检查远程版本 备份当前文件 下载替换 版本号+1

3.2 内容分类体系

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

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

内置分类标识：

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

3.3 技能文件结构

report-expert/ ├── SKILL.md 技能定义（Agent 自动读取） ├── index.html 技能介绍页（自动生成） ├── index-body.html 技能介绍页内容（手动维护） ├── deploy.py 核心部署脚本 ├── upgrade.py 自动升级工具 ├── manifest.json 版本清单（发布用） ├── templates/ │ ├── base.css 全局样式 │ └── index.html 首页模板 └── scripts/ └── main.js 首页交互脚本
复制

3.4 版本更新记录

最新技能介绍页重构：手风琴能力展示、分类流程图、深色代码块
v1.4统一页头页脚注入、iframe hash 路由、非报告页面隔离
v1.3iframe 内嵌查看器、报告页自动刷新
v1.2自适应部署配置、项目分类支持