skill-logger

name	skill-logger
description	记录一次 Skill 使用情况到日志文件。每次用完某个 Skill 后调用，追加一条使用记录。 触发词："记录这次使用"、"记录用了 xxx"、"log skill"、"记录一下"（在使用完某个 Skill 之后）。 用于追踪 Skill 使用频率和满意度，为 skill-analyzer 提供数据。

Skill 使用日志记录

每次使用完某个 Skill 后，调用本 Skill 记录一条使用日志。日志追加到 06 计划/skill_usage_log.jsonl。

日志文件位置

$OBSIDIAN_VAULT/06 计划/skill_usage_log.jsonl

OBSIDIAN_VAULT 环境变量需在 .env 中配置（见下方）。

使用方式

方式一：用完 Skill 后手动触发

记录这次使用：x-post，场景是把播客笔记改成即刻动态，满意度 4 分，结尾不够有力手动改了

方式二：让 AI 引导填写

直接说"记录一下"，AI 会依次询问：

1. 用了哪个 Skill？
2. 使用场景是什么？
3. 满意度（1-5 分）？
4. 备注（可选）？

工作流程

Step 1：收集信息

如果用户没有提供完整信息，逐项询问：

• skill：Skill 名称（如 x-post）
• scene：这次用它做了什么（一句话描述）
• satisfaction：满意度 1-5 分（1=很差，3=一般，5=完美）
• note：备注，比如哪里不满意、手动改了什么（可为空）

Step 2：运行追加脚本

python3 scripts/log_skill_usage.py \
  --skill "x-post" \
  --scene "把播客笔记改成即刻动态" \
  --satisfaction 4 \
  --note "结尾不够有力，手动改了"

Step 3：确认写入

脚本输出追加成功后，向用户确认：

✅ 已记录：x-post（满意度 4/5）
   场景：把播客笔记改成即刻动态
   备注：结尾不够有力，手动改了

日志格式

每条记录是一行 JSON：

{"date": "2026-03-24", "weekday": "周二", "week": "W13", "skill": "x-post", "scene": "把播客笔记改成即刻动态", "satisfaction": 4, "note": "结尾不够有力，手动改了"}

环境变量配置

在 ~/.env 或项目根目录的 .env 文件中配置：

# Skill 日志文件所在的 Obsidian vault 路径
OBSIDIAN_VAULT=/Users/ugreen/Documents/obsidian

脚本通过 os.environ['OBSIDIAN_VAULT'] 读取，不要把路径硬编码进脚本。