Skill Scoreboard

技能使用积分榜 v1.3 — OpenClaw 技能使用追踪与积分管理系统。 触发场景： (1) 用户询问技能使用榜单、积分统计（日榜/周榜/月榜/年榜/总榜） (2) 用户要求查看技能调用记录、错误日志 (3) 用户要求查看某技能的使用详情 (4) 用户要求生成每日/历史积分报告 (5) 用户询问"今天情况如何"、"工作流复盘" 核心功能： - 支持日榜、周榜、月榜、年榜、总榜五种榜单模式 - 每次技能调用自动记录积分 (+1 * 调用时间秒/权重) - 记录调用结果和错误日志 - 根据技能文件复杂度计算权重（归一化到0.95~0.9975，差距≤5%） - 每日定时生成积分榜单快照 - 每日定时复盘：找出积分冠军技能并固化最佳工作流 - 支持实时查询当前榜单和历史数据 优先级：第一级（最高优先级）

技能使用积分榜

概述

本技能用于追踪和记录 OpenClaw 中所有技能的使用情况，并根据调用时长和复杂度计算积分。

积分规则

积分 = 1 × (调用时间秒 / 技能复杂度权重)

复杂度权重由技能文件的规模决定（归一化到 [0.95, 0.9975]）：

• 最小权重：0.9500
• 最大权重：0.9975
• 任意两技能权重差距 ≤5%
• 计算方式：原始分数 → 对数缩放 → min-max 归一化

权重越高，相同时间获得的积分越少（复杂技能调用成本更高）

文件结构

skill-scoreboard/
├── SKILL.md                      # 本文档
└── scripts/
    └── score_tracker.py          # 核心追踪脚本

使用方式

1. 手动记录技能调用

python3 ~/SharedSkills/skill-scoreboard/scripts/score_tracker.py record \
  --skill <技能名> \
  --duration <调用时长(秒)> \
  --success <true|false> \
  --error <错误信息(可选)>

2. 查询各类榜单

榜单类型	命令	说明
今日榜	today	当天技能调用排名
本周榜	week	最近7天技能调用排名
本月榜	month	当月技能调用排名
本年榜	year	当年技能调用排名
总榜	leaderboard	历史累计积分排名

# 今日榜单
python3 ~/SharedSkills/skill-scoreboard/scripts/score_tracker.py today

# 本周榜单
python3 ~/SharedSkills/skill-scoreboard/scripts/score_tracker.py week

# 本月榜单
python3 ~/SharedSkills/skill-scoreboard/scripts/score_tracker.py month

# 本年榜单
python3 ~/SharedSkills/skill-scoreboard/scripts/score_tracker.py year

# 总榜（历史）
python3 ~/SharedSkills/skill-scoreboard/scripts/score_tracker.py leaderboard --limit 10

4. 生成每日快照

python3 ~/SharedSkills/skill-scoreboard/scripts/score_tracker.py daily

5. 查看技能详情

python3 ~/SharedSkills/skill-scoreboard/scripts/score_tracker.py detail --skill <技能名>

6. 查看所有技能权重

python3 ~/SharedSkills/skill-scoreboard/scripts/score_tracker.py weight

7. 每日工作流复盘报告

python3 ~/SharedSkills/skill-scoreboard/scripts/score_tracker.py review

定时任务

用户可通过 OpenClaw cron 功能设置每日定时执行：

# 每日23:00自动执行
openclaw cron add \
  --name "每日技能积分榜复盘" \
  --schedule "0 23 * * *" \
  --tz "Asia/Shanghai" \
  -- python3 ~/SharedSkills/skill-scoreboard/scripts/score_tracker.py daily && \
     python3 ~/SharedSkills/skill-scoreboard/scripts/score_tracker.py review

数据存储

文件/目录	内容
~/.skill_scoreboard/scores.json	所有技能的积分数据
~/.skill_scoreboard/logs/calls.log	调用日志
~/.skill_scoreboard/logs/errors.log	错误日志
~/.skill_scoreboard/daily/	每日快照目录

使用示例

场景1：用户问"今天用了哪些技能"

python3 ~/SharedSkills/skill-scoreboard/scripts/score_tracker.py today

场景2：用户问"哪个技能最常用"

python3 ~/SharedSkills/skill-scoreboard/scripts/score_tracker.py leaderboard --limit 5

场景3：用户问"xia-zhua-zhua 用得怎么样"

python3 ~/SharedSkills/skill-scoreboard/scripts/score_tracker.py detail --skill xia-zhua-zhua

场景4：用户想看完整的历史统计

python3 ~/SharedSkills/skill-scoreboard/scripts/score_tracker.py leaderboard --limit 20