技能分析日报 (skill-everyday)

每天执行一次，抓取 Clawhub 热门技能，深入分析并生成报告。

特性

• - 无需平台账号或 API Key：榜单与详情来自公开页面；运行期状态只写在本地 data/。
• 去重：按 data/analyzed.json 记录已分析 slug，每次只取「当前榜单中、未分析过的第一个」热门技能。
• 依赖需先行安装：本技能依赖 Node.js、Playwright 与 Chromium（见下方「依赖」）。装好后再执行脚本即可，无需编辑配置文件。

目录结构

skill-everyday/
├── SKILL.md # 本文件
├── README.md # 安装与运行（给人看的简要说明）
├── package.json # 可选：声明 playwright 依赖，便于 npm install
├── data/
│ ├── analyzed.json # 已分析技能列表（自动管理）
│ └── reports/ # 每日报告
│ └── YYYY-MM-DD-.md
└── scripts/
└── runner.mjs # 执行脚本

首次运行 scripts/runner.mjs 时会自动创建 data/、data/reports/（若不存在），并初始化 data/analyzed.json。

使用方法

在本技能根目录（SKILL.md 所在目录）执行：

bash
node scripts/runner.mjs

或在 OpenClaw 中按触发语调用本技能后，由 Agent 执行上述命令。

工作流程

1. 获取热门技能列表

使用 Playwright 访问 clawhub.ai/skills 并拦截页面请求的 Convex api/query 响应以取得榜单数据：

javascript
import { chromium } from playwright;

let apiData = null;
const browser = await chromium.launch({ headless: true });
const page = await browser.newPage();

await page.route(https://wry-manatee-359.convex.cloud/api/query, async route => {
const response = await route.fetch();
const data = await response.json();
apiData = data;
route.continue();
});

await page.goto(https://clawhub.ai/skills, { waitUntil: networkidle });
await page.waitForTimeout(3000);

const result = apiData?.status === success ? apiData.value : apiData;
const skills = result?.page || [];
// 按下载量排序
skills.sort((a, b) => (b.skill?.stats?.downloads || 0) - (a.skill?.stats?.downloads || 0));

2. 避免重复分析

从技能根目录下的 data/analyzed.json 读取已分析列表（路径以 SKILL.md 为锚：path.join(skillRoot, data, analyzed.json)）。

javascript
// 与 scripts/runner.mjs 一致：SKILL_DIR = dirname(scripts)，再拼 data/analyzed.json
const analyzedFile = path.join(SKILL_DIR, data, analyzed.json);
if (!analyzedData.analyzed.includes(skillSlug)) {
// 分析该技能
}

3. 获取技能详情

打开技能详情页 https://clawhub.ai/skill/{slug}，读取标题、描述与页面正文（与榜单接口分离，非单独「完整信息」REST 文档）。

4. 尝试读取本地技能源码

在常见 OpenClaw 布局下，技能根目录的上一级为 skills/，据此拼接目标技能目录：

javascript
const skillsRoot = path.join(SKILL_DIR, ..);
const targetSkillDir = path.join(skillsRoot, skillSlug);

5. 生成报告

按模板生成报告，保存到 data/reports/YYYY-MM-DD-.md（同日多次运行不会互相覆盖）。

6. 更新状态

自动更新 data/analyzed.json 添加新技能。

报告模板

• - 内置深度模板的技能（如 self-improving-agent）：标题行 + 核心原理 + Clawhub 简介 + 元数据表 + 一、核心工作原理（OpenClaw 主流实现）（1～4 小节）+ 二、为什么受欢迎 + 可选榜单数据补充；不插入通用「技术/设计亮点」占位段落。
• 其他技能：排名/名称/标识/分类/下载与点赞 + Clawhub 功能介绍 + 核心流程与特点（默认模板）+ 可选榜单数据补充。

报告保存到 data/reports/YYYY-MM-DD-.md。

依赖

• - Node.js：执行 scripts/runner.mjs（ESM）。
• Playwright + Chromium：若目录内有 package.json，可在技能根目录执行 npm install，再 npx playwright install chromium；否则全局或上级环境已安装 playwright 亦可。仅声明 metadata.openclaw.requires 不会自动安装浏览器。

触发方式

用户发送 分析一个 Clawhub 技能 或 skill-everyday 时执行。