skill-everyday

# 技能分析日报 (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-<slug>.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-<slug>.md`（同日多次运行不会互相覆盖）。

### 6. 更新状态

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

## 报告模板

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

报告保存到 `data/reports/YYYY-MM-DD-<slug>.md`。

## 依赖

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

## 触发方式

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