skill logger
- Repo stars 304
- Author repo myskill
- Domain
- Other
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 88 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @zephyrwang6 · no license declared
- Token usage
- Lean
- Setup complexity
- Plug-and-play
- External API key
- Not required
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- No explicit requirements detected
- Detected file/system behavior
-
- Read-only
- Env read
- Network behavior
- Local-only
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# 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']` 读取,不要把路径硬编码进脚本。
Sections and files
Listed in source order.
sections -> See the original source for section headings
terms -> skill · scene · satisfaction · note
files/cmd -> 06 计划/skill_usage_log.jsonl · OBSIDIAN_VAULT · .env · x-post · ~/.env · os.environ['OBSIDIAN_VAULT']
body sha256 -> c50f9eb83ddd