SuperAPI AI 工具集

wiki-review

写作与研究

查看项目

更新于 10-16 06:14

技能介绍

用途:在采用 FSRS 调度的 Obsidian 笔记库中运行复习会话。智能体担任复习老师,Python 脚本负责扫描、调度、状态与日志。适用场景包括初始化或刷新复习队列、从到期笔记提问回忆、用 FSRS 为完成复习评分、让 review-state.json 和 review-log.jsonl 与笔记库同步。

前提条件:项目含 wiki/ 目录;可复习笔记位于 wiki/<topic>/<article>.md;YAML frontmatter 含 内化: true;有非空 ## 内化 段;已安装 .agents/skills/wiki-review/requirements.txt 中的 Python 依赖。

工作流:1. 运行 sync 初始化或刷新复习状态,读取返回的问题并报告,不要编造或填补用户内化内容,也不要将笔记标为可复习;仅在明确要求且修复无歧义时做机械性 YAML 修复。2. 运行 due 收集待复习笔记,同样读取其问题与初始化输出。3. 阅读笔记,让用户用自己的话回忆要点,追问直到答案足够清晰。4. 为整篇笔记选择一个 FSRS 评分。5. 用该评分和简短答案摘要运行 submit。6. 报告 due 问题,只继续处理返回 due 列表中的条目,给出简洁反馈后继续下一条。智能体负责提问与判断回忆质量,脚本负责计算调度、存储状态和写日志;不要直接编辑 FSRS 字段。

命令(在项目根目录运行): python .agents\skills\wiki-review\scripts\wiki_review.py --wiki-root wiki --project-root . sync python .agents\skills\wiki-review\scripts\wiki_review.py --wiki-root wiki --project-root . due python .agents\skills\wiki-review\scripts\wiki_review.py --wiki-root wiki --project-root . submit --article wiki/topic/article.md --rating Good --answer-summary "用户解释了核心概念。"

评分含义:Again 表示无法可靠回忆或严重误解;Hard 表示需大量提示才能部分回忆;Good 表示准确回忆主要思想;Easy 表示流畅回忆并能清晰应用。

状态文件:wiki/review-state.json 是调度的唯一依据;wiki/review-log.jsonl 为追加式复习历史;YAML 中的复习字段只是供 Obsidian 显示的摘要,不是权威调度状态。