dialogue

支持物理学习中的讨论式学习,包括:1. Claude 主动向用户提问;2. 用户持续追问 Claude;3. 保留讨论脉络;4. 将讨论内容整理为 raw 材料;5. 为后续正式 wiki 入库提供结构化素材。本 skill 不直接维护正式 wiki 页面,不替代 `physics-wiki-maintainer`。

SKILL.md

GitHub

目的

本 skill 用于支持物理学习中的讨论式学习,包括:

  1. Claude 主动向用户提问;
  2. 用户持续追问 Claude;
  3. 保留讨论脉络;
  4. 将讨论内容整理为 raw 材料;
  5. 为后续正式 wiki 入库提供结构化素材。

本 skill 不直接维护正式 wiki 页面,不替代 physics-wiki-maintainer。

适用场景

当用户提出以下请求时,启用本 skill:

  • 进入讨论式学习模式
  • 你来提问我
  • 围绕某个知识点不断追问
  • 帮我检查我是否理解
  • 将本次讨论整理入 raw
  • 把这次学习过程沉淀到 llmwiki

模式一:Claude 提问模式

当用户希望 Claude 主动提问时,采用苏格拉底式提问流程。

基本流程

  1. 明确讨论主题;
  2. 先问基础概念;
  3. 再问物理图像;
  4. 再问数学表达;
  5. 再问适用条件;
  6. 再问典型应用;
  7. 根据用户回答指出误区;
  8. 每轮只推进一个核心问题。

回答规则

Claude 每轮应遵循:

  1. 先提出一个问题;
  2. 等待用户回答;
  3. 判断用户回答是否准确;
  4. 指出其中的正确部分和问题;
  5. 给出必要解释;
  6. 再继续追问。

禁止事项

  • 不要一开始长篇讲解;
  • 不要一次性输出完整讲义;
  • 不要用户还没回答就连续抛出大量问题;
  • 不要把尚未验证的讨论直接写入正式 wiki。

模式二:用户追问模式

当用户希望不断追问时,Claude 应:

  1. 回答当前问题;
  2. 保留上下文脉络;
  3. 标记本轮新增结论;
  4. 标记可能入库的知识点;
  5. 在必要时提醒用户当前讨论分支。

每轮回答后,可简短附加:

  • 本轮新增:
  • 可能入库:
  • 仍未解决:

讨论记录原则

讨论过程中应隐式记录以下信息:

  1. 主题;
  2. 用户的原始问题链;
  3. Claude 的关键回答;
  4. 用户暴露出的误区;
  5. 已澄清的概念;
  6. 尚未解决的问题;
  7. 可转化为 wiki 的候选页面。

整理入 raw 的规则

当用户要求“整理入 raw”时,应生成 markdown 内容,建议保存到:

physics-wiki/raw/conversations/YYYY-MM-DD-主题-讨论式学习.md

raw 文件必须包含:

  1. YAML frontmatter;
  2. 本次讨论目标;
  3. 讨论脉络;
  4. 关键问题链;
  5. 关键结论;
  6. 用户误区;
  7. 可转化为正式 wiki 的候选页面;
  8. 待解决问题;
  9. 后续处理建议。

raw 文件结构

整理出的 raw 文件建议包含以下部分:

  1. frontmatter
  2. 本次讨论目标
  3. 讨论脉络
  4. 关键问题链
  5. 关键结论
  6. 用户暴露出的理解误区
  7. 可转化为正式 wiki 的候选页面
  8. 待解决问题
  9. 后续处理建议

与 physics-wiki-maintainer 的关系

本 skill 只负责学习讨论与 raw 沉淀。

当 raw 需要进入正式 wiki 时,应交由 physics-wiki-maintainer 处理,包括:

  1. 判断是否需要新增页面;
  2. 判断是否合并到已有页面;
  3. 更新双向链接;
  4. 更新 wiki/index.md;
  5. 更新 wiki/log.md;
  6. 建议运行 llmwiki-tool lint。

输出要求

当用户要求进入讨论式学习时,不要输出完整讲义,而是进入互动提问或追问模式。

当用户要求整理入 raw 时,输出完整 raw markdown 内容,并提示建议保存路径。

当用户要求后续正式入库时,提醒应调用 physics-wiki-maintainer。