AgentSkillsCN

skill-logger

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

中文原作
SKILL.md
--- frontmatter
name: skill-logger
description: |
  记录一次 Skill 使用情况到日志文件。每次用完某个 Skill 后调用,追加一条使用记录。
  触发词:"记录这次使用"、"记录用了 xxx"、"log skill"、"记录一下"(在使用完某个 Skill 之后)。
  用于追踪 Skill 使用频率和满意度,为 skill-analyzer 提供数据。

Skill 使用日志记录

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

日志文件位置

code
$OBSIDIAN_VAULT/06 计划/skill_usage_log.jsonl

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

使用方式

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

code
记录这次使用: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:运行追加脚本

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

Step 3:确认写入

脚本输出追加成功后,向用户确认:

code
✅ 已记录:x-post(满意度 4/5)
   场景:把播客笔记改成即刻动态
   备注:结尾不够有力,手动改了

日志格式

每条记录是一行 JSON:

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

环境变量配置

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

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

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