| name | wiki-assess-mastery |
| description | 对某个知识节点进行掌握度登记与评估。支持完整模式与 quick 快速模式。完整模式先让用户自述,再提出 5~10 个问题;quick 模式只问 2~3 个关键问题。最后更新该节点的 mastery 属性,并可谨慎更新相邻节点。 |
| allowed-tools | Read, Write, Edit, Glob, Grep, Agent, mcp__obsidian-mcp__search_vault, mcp__obsidian-mcp__read_note, mcp__obsidian-mcp__read_multiple_notes, mcp__obsidian-mcp__update_note, mcp__obsidian-mcp__create_note |
Wiki Assess Mastery
你现在要对一个节点做“掌握度登记”。
目标节点与参数在 $ARGUMENTS 中。
模式
完整模式(默认)
用于:
- 中高难概念
- 需要较准确判断用户层次
- 需要连同周边节点一起观察系统性理解
流程:自述 → 5~10 个问题 → 更新掌握度。
Quick 模式
当 $ARGUMENTS 中包含 quick 时启用。
用于:
- 十分基础的知识点
- 用户只是想快速补录掌握状态
- 不值得走完整长问答
流程:自述 → 2~3 个关键问题 → 更新掌握度。
Quick 模式仍然必须先让用户自述,但不得扩展成冗长盘问。
总原则
- 不允许直接把节点标记为“已掌握”。
- 必须先让用户自述,再进行问题诊断,再更新掌握度。
- 问题以目标节点为主,并适度覆盖周边节点,用于判断系统性理解。
- 默认使用中文。
- 最终写入的
mastery 应当简短、具体、描述性强,不要过长。
步骤
第 1 步:定位节点
- 解析目标节点路径或名称。
- 读取目标页面。
- 读取与其最相关的 2~6 个邻近页面(前置概念、并列概念、常混淆概念、上层概念)。
- 读取目标节点当前的
mastery 字段;若有 wiki/learning/ 历史记录,也一并参考。
第 2 步:先让用户自述
你的第一轮不要直接下结论。
先让用户用自己的话简短说明:
- 他觉得这个概念是什么
- 他觉得自己哪里会、哪里不会
- 他是否能举例、推导、应用或与周边概念建立联系
第 3 步:提出问题
完整模式
提出 5~10 个问题。
要求:
- 以目标节点为主
- 至少覆盖:定义/核心思想、典型例子或应用、常见误区
- 至少 1~2 题轻触周边节点,用来判断系统性理解
- 优先短问短答,避免超长大题
- 若节点偏数学/物理,可包含公式记号辨析
- 若节点偏 agent,可包含流程、边界、与相邻机制的比较
Quick 模式
只提出 2~3 个问题。
要求:
- 仍以目标节点为主
- 至少覆盖“是否真的理解定义”和“是否会与近邻概念区分”中的两项
- 最多只轻触 1 个邻近节点
- 不得变相扩展成完整盘问
第 4 步:基于回答更新掌握度
用户回答后,你要:
- 判断他“理解到了哪一层”
- 找出他最主要的短板
- 若证据充分,可对周边节点做极轻量更新
写回目标节点 frontmatter:
mastery
mastery_updated
mastery_basis
mastery_neighbors
其中:
mastery:建议 12~40 个汉字,描述“会什么、不会什么”
mastery_basis:
- 完整模式示例:
自述 + 7 题问答
- Quick 模式示例:
自述 + quick 3 题
mastery_neighbors:一句话概括周边节点表现
第 5 步:沉淀学习记录
将本次评估摘要保存到:
wiki/learning/assess-YYYY-MM-DD-HHMM-<slug>.md
并更新:
wiki/learning/_index.md
wiki/log.md
wiki/hot.md
输出要求
最终向用户汇报:
- 你的掌握度判断
- 主要薄弱点
- 是否顺带观察到相邻节点短板
- 下一步建议学什么