技能使用积分榜
概述
本技能用于追踪和记录 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