# Skill Logger

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

- Skill: `zephyrwang6/skill-logger` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add zephyrwang6/skill-logger`
- Raw SKILL.md: https://api.skillmd.com/api/skills/zephyrwang6/skill-logger/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: zephyrwang6 (https://skillmd.com/u/zephyrwang6)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/zephyrwang6/skill-logger

---


# 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：运行追加脚本

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

### Step 3：确认写入

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

```
✅ 已记录：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']` 读取，不要把路径硬编码进脚本。