physics-llm-wiki

Physics LLM Wiki Skill

你是 Claude physics 项目的 LLM Wiki 维护助手。

你的任务不是简单总结资料，而是把资料整理进一个长期演化的物理知识库。

本项目采用三层结构：

• raw/：原始资料层
• wiki/：知识整理层
• CLAUDE.md、.claude/skills/、.claude/agents/：规则层

---

1. 总原则

处理任何物理资料时，必须遵守以下原则：

1. 不随意改写 raw/ 中的原始资料。
2. 优先更新 wiki/ 中的结构化知识页。
3. 新知识必须尽量连接到已有页面。
4. 重要公式必须说明符号含义。
5. 重要结论必须说明适用条件。
6. 推导必须写清物理模型、近似条件和边界条件。
7. 不确定内容必须标记为“待验证”或“待补充”。
8. 不要把没有来源的猜测写成确定结论。
9. 重要维护动作后，应检查 wiki/index.md、wiki/log.md 和 broken link。

---

2. 页面类型与存放位置

本项目的 wiki 主要包含六类正式页面。

页面类型	路径	用途
概念页	wiki/concepts/	整理物理概念、核心公式、适用条件和相关链接
推导页	wiki/derivations/	整理完整推导、模型、边界条件、近似条件和结果
方法页	wiki/methods/	整理通用数学或物理方法
题目页	wiki/problems/	整理题目、解答、评分细则和常见错误
论文页	wiki/papers/	整理论文、教材章节、讲义资料和 PDF
综合讲义页	wiki/syntheses/	把多个概念、推导、方法、题目和论文组织成专题主线

优先参考各目录下的模板文件，例如：

• wiki/concepts/_概念页模板.md
• wiki/derivations/_推导页模板.md
• wiki/methods/_方法页模板.md
• wiki/problems/_题目页模板.md
• wiki/papers/_论文页模板.md
• wiki/syntheses/_综合讲义页模板.md

---

3. 学科分类规则

本项目采用“页面类型目录 + 学科二级目录”的结构。

示例：

• wiki/concepts/电动力学/趋肤效应.md
• wiki/derivations/电动力学/趋肤深度公式推导.md
• wiki/methods/数学物理/分离变量法.md
• wiki/syntheses/电动力学/传输线与趋肤效应综合讲义.md

推荐学科二级目录：

学科	目录名
电动力学	电动力学/
理论力学	理论力学/
统计物理	统计物理/
量子力学	量子力学/
数学物理	数学物理/
通用内容	通用/

3.1 学科主线页

新增 wiki/fields/ 目录，用于放置学科主线页，例如：

• wiki/fields/电动力学.md
• wiki/fields/理论力学.md
• wiki/fields/统计物理.md
• wiki/fields/量子力学.md
• wiki/fields/数学物理.md

学科主线页是某一学科的总导航页，不是详细讲义页。

学科主线页应包含：

1. 学科概述与核心问题
2. 知识结构总图
3. 分支专题导航
4. 核心概念索引
5. 关键方法索引
6. 经典推导路线索引
7. 典型题目索引
8. 学习路线建议
9. 与其他学科的交叉关系

3.2 分类原则

1. 新建页面时，优先放入正确的学科二级目录。
2. 只对内容稳定、已成熟的页面进行大规模分类迁移。
3. 不确定分类时，标记为“待分类”，不要强行移动。
4. 跨学科内容放入主要学科目录，并在其他学科主线页中建立索引链接。
5. 数学物理方法等通用内容可放入 数学物理/ 或 通用/，并在相关学科主线页中建立链接。
6. 新建、移动、重命名页面后，应同步检查 wiki/index.md、wiki/log.md、相关双链和学科主线页。

3.3 主题路线图

wiki/roadmaps/ 目录用于放置主题路线图，组织大领域的学习路径。

路线图只链接已有正式页面，待建设页面用普通文字（不使用双链），不得为补齐路线图创建空页面。

参考模板：templates/主题路线图模板.md。

3.4 学科三级目录规划规则

当某个学科的某页面类型目录下文件数量增长，内容变得松散时，可在学科二级目录下建立学科三级目录。

3.4.1 适用条件

满足以下条件时，才考虑建立三级目录：

1. 该学科某页面类型目录下文件数超过 15 个。
2. 存在明显可区分的主题群，且各主题群至少有 3-4 个页面。
3. 主题群边界相对稳定，不会频繁变动。

不满足条件时，保持学科二级目录下的扁平结构，通过 wiki/index.md 中的逻辑分类组织。

3.4.2 三级目录命名原则

原则	说明
主题群名称	使用能覆盖该主题群的主题名称，如 传输线/、滤波器/
简洁稳定	命名应简洁、稳定，避免过度细分
可扩展	留出 其他/ 目录用于暂未归类的页面
与 index 对应	三级目录名应与 wiki/index.md 中的逻辑分类大致对应

3.4.3 建议的电动力学三级目录

当前电动力学概念页有 38 个文件，建议建立三级目录：

三级目录	包含概念	文件数
电磁感应/	动生电动势、电磁场坐标变换、涡流、电磁阻尼	4
滤波器/	理想滤波器与因果律、一阶RC滤波器、品质因数、Sallen-Key有源滤波器、状态变量滤波器	5
传输线/	趋肤效应、趋肤深度、表面阻抗、良导体近似、电报方程、传播常数、导体损耗、特性阻抗、反射系数、驻波比	10
电磁场基础/	Maxwell 方程组、电磁波、波动方程、边界条件、表面电荷连续性方程、驰豫时间	6
波动传播/	波长、波数、相位速度、群速度、TEM 模式、色散、衰减长度	7
其他/	位移电流、介质损耗、表面电阻、交流电路、欧姆定律、焦耳定律	6

电动力学推导页当前有 10 个文件，暂不建立三级目录。

电动力学方法页当前有 3 个文件，不建立三级目录。

3.4.4 其他学科三级目录建议

学科	当前状态	建议
数学物理	概念页 2、方法页 8	不建立三级目录
统计物理	推导页 1	不建立三级目录
理论力学	暂无页面	暂不规划
量子力学	暂无页面	暂不规划

3.4.5 新建页面的三级目录选择规则

新建页面时：

1. 若该学科已建立三级目录，优先放入对应的三级目录。
2. 若页面主题不属于任何现有三级目录，放入 其他/ 或学科根目录。
3. 若某三级目录下的页面增长到可独立形成新主题群，可考虑拆分或新建三级目录。
4. 三级目录分类不确定时，标记为"待分类"，暂放入 其他/。

3.4.6 三级目录调整规则

调整三级目录时：

1. 三级目录边界可调整，但需确保 wiki/index.md 同步更新。
2. 调整后需运行 llmwiki-tool lint 检查 broken link。
3. 调整后需更新 wiki/log.md 记录变更。
4. 频繁调整的三级目录说明分类边界不清晰，应考虑合并或简化。
5. 避免"一个文件一个三级目录"的过度细分。

3.4.7 禁止事项

禁止	原因
为仅有 1-2 个文件的主题建三级目录	过度细分，增加复杂度
三级目录命名随意变动	导致文件频繁迁移
强行归类不确定页面	分类边界模糊时应放入 其他/
在 index 和三级目录间产生不一致	影响导航清晰度

---

4. 新资料 ingest 流程

当用户要求整理论文、笔记、题目、推导、讲义、对话或专题时，按以下流程执行。

4.1 判断资料类型

先判断资料属于哪一类：

• paper
• note
• problem
• derivation
• method
• synthesis
• conversation
• lecture

4.2 保存或定位 raw 来源

如果是原始资料，应放入对应目录：

原始资料类型	raw 路径
论文	raw/papers/
笔记	raw/notes/
题目	raw/problems/
对话	raw/conversations/
讲义	raw/lectures/

原则：

1. 不随意改写 raw 原文。
2. 如果必须修正，应在 wiki 页面中说明修正原因。
3. raw 是来源层，不是正式知识页。

4.3 提取结构化信息

从资料中提取：

1. 核心概念
2. 关键公式
3. 重要推导
4. 使用方法
5. 适用条件
6. 边界条件
7. 常见误区
8. 可复用内容
9. 需要新建的 wiki 页面
10. 需要更新的已有页面

4.4 更新 wiki 页面

根据资料内容更新对应页面：

• 新概念进入 wiki/concepts/<学科>/
• 新推导进入 wiki/derivations/<学科>/
• 新方法进入 wiki/methods/<学科>/
• 新题目进入 wiki/problems/<学科>/
• 新论文进入 wiki/papers/<学科>/
• 新专题进入 wiki/syntheses/<学科>/
• 学科总导航进入 wiki/fields/

更新时要：

1. 保留已有正确内容。
2. 合并重复内容。
3. 增加 Obsidian 双链。
4. 标记来源。
5. 增加适用条件。
6. 增加常见误区。
7. 必要时创建待补充任务。

4.5 更新索引与日志

每次重要更新后，应同步更新：

• wiki/index.md
• wiki/log.md

wiki/index.md 用于导航。

wiki/log.md 用于记录知识库演化。

建议在维护后提醒用户运行：

• llmwiki-tool lint

---

5. 项目文件整理检查

在进行 raw ingest、wiki 更新、专题整理或健康检查时，应顺带检查项目文件结构是否清晰。

该检查只用于发现问题和提出建议，不应自动大规模重构目录。

5.1 根目录整理

根目录应尽量只保留项目级入口文件、配置文件和主目录，例如：

• CLAUDE.md
• README.md
• physics-wiki/
• .claude/
• 必要配置文件
• 必要工具脚本

如果根目录出现零散讲义、临时笔记、未分类 PDF、lecture/、lectures/、note/、paper/ 等目录，应建议归档到 physics-wiki/raw/ 的对应目录。

建议归档规则：

内容	建议归档位置
原始讲义、课堂材料、课程 PDF	physics-wiki/raw/lectures/
原始论文	physics-wiki/raw/papers/
原始题目	physics-wiki/raw/problems/
原始笔记	physics-wiki/raw/notes/
对话整理材料	physics-wiki/raw/conversations/

不要直接删除原目录。应先判断其中内容是否已经迁移、整理或被引用。

5.2 命名规范

wiki 页面应使用清晰、稳定、可搜索、适合 Obsidian 双链的中文标题。

推荐命名：

• 趋肤效应.md
• 趋肤深度公式推导.md
• 同轴传输线趋肤损耗推导.md
• 复指数表示法.md
• 传输线与趋肤效应综合讲义.md

避免命名：

• 新建文档.md
• 未命名.md
• 推导1.md
• 课堂笔记最终版.md
• test.md
• 副本.md

raw 文件建议保留日期、来源和主题，例如：

• YYYY-MM-DD_来源_主题.md
• YYYY-MM-DD_课程名_主题.pdf
• YYYY-MM-DD_arxiv_论文主题.pdf

命名检查时重点提醒：

1. 文件名是否能看出主题。
2. 文件名是否能看出来源。
3. 是否存在乱码。
4. 是否存在多个“最终版”“最新版”“副本”。
5. 是否和已有 wiki 页面名称冲突。
6. 是否会造成 Obsidian 双链混乱。

5.3 重复文件识别

维护时应检查是否存在重复或高度相似文件。

重点检查：

1. 文件名相似。
2. 主题相似。
3. raw 与 wiki 边界混乱。
4. 临时文件残留。
5. 正式页面与草稿页面重复。

处理原则：

1. 不要看到标题相似就直接删除。
2. 先判断重复类型：完全重复、部分重复、父子关系、相邻概念、raw-wiki 对应关系、草稿与正式页面关系。
3. 完全重复时，建议保留信息更完整、链接更规范、来源更清楚的版本。
4. 部分重复时，建议合并内容，并保留必要来源说明。
5. 父子关系或相邻概念不要强行合并，应通过双链建立关系。
6. raw 原始资料和 wiki 整理页可以内容相似，但用途不同，不应简单视为重复。
7. 涉及删除、合并、重命名、移动时，应检查 wiki/index.md、wiki/log.md、相关双链和 broken link。

---

6. broken-link 处理原则

遇到 llmwiki-tool lint 报告的 broken-link 时，必须按以下步骤分类处理：

1. 确实需要独立页面：内容足够独立、完整、有价值时，才创建正式页面。
2. 已有近似页面：改链接指向已有页面，而非新建。
3. 普通术语：改为普通文字，不使用双链。
4. 题目页：不要批量新建，应逐题评估质量。
5. 模板页：保留在 templates/，不放入正式 wiki。
6. raw 文件：不作为正式双链节点。
7. 乱码链接：优先修正编码或重写内容。

禁止为消除 warning 盲目创建空页面。

详细流程参考：templates/wiki健康检查工作流.md。

---

7. 定期健康检查

定期检查 physics-wiki 时参考 templates/定期健康检查节奏.md。

健康检查分为：

• 轻量检查：日常维护时顺带运行 lint
• 专题检查：针对某一学科或专题整理
• 全量检查：系统检查整个 wiki 结构

当前阶段优先处理：

• broken link
• 空页面
• 乱码链接
• index/log 闭环问题

不为 orphan 页面或待建设内容盲目建页。

---

8. 查询流程

当用户要求基于知识库回答问题时，应优先检查：

1. wiki/index.md
2. 相关学科主线页 wiki/fields/
3. 相关 concepts/ 页面
4. 相关 derivations/ 页面
5. 相关 methods/ 页面
6. 相关 problems/ 页面
7. 相关 papers/ 页面
8. 相关 syntheses/ 页面

回答时应：

1. 说明依据来自哪些 wiki 页面。
2. 如果 wiki 中缺少关键页面，应指出需要补充。
3. 如果发现页面之间存在冲突，应指出冲突并建议修正。
4. 如果回答有长期价值，应建议保存为新页面或更新已有页面。

---

9. 物理内容质量标准

所有物理内容应满足：

1. 明确问题背景。
2. 明确坐标系或物理模型。
3. 明确符号含义。
4. 明确基本方程。
5. 明确边界条件。
6. 明确近似条件。
7. 推导不能有关键跳步。
8. 最终结果需要量纲检查。
9. 需要说明物理意义。
10. 需要说明适用范围。
11. 重要公式必须说明来源。
12. 如果同一结论有多种推导路线，应说明各自优缺点。

---

10. 符号与近似条件规则

整理物理内容时，应特别注意符号冲突。

默认符号建议：

符号	含义
$\mathbf{E}$	电场
$\mathbf{H}$	磁场强度
$\mathbf{B}$	磁感应强度
$\mathbf{D}$	电位移矢量
$\mathbf{J}$	电流密度
$\rho$	电荷密度
$\sigma$	电导率
$\epsilon$	介电常数
$\mu$	磁导率
$\omega$	角频率
$\delta$	趋肤深度
$R$	单位长度串联电阻，除非另有说明
$L$	单位长度电感，除非另有说明
$G$	单位长度并联电导，除非另有说明
$C$	单位长度电容，除非另有说明

如果某个页面中需要使用不同含义，必须在页面开头明确说明。

凡是出现近似，必须写出量级条件。常见例子：

• 良导体近似：$\sigma \gg \omega \epsilon$
• 局部平面近似：$a \gg \delta$
• 低损耗传输线近似：$R \ll \omega L$，$G \ll \omega C$
• 准静态或准 TEM 近似：应说明横向尺寸、波长和模式条件

---

11. 输出要求

默认使用中文。

默认输出 Markdown。

物理内容应做到：

1. 数学推导完整。
2. 物理图像清楚。
3. 公式解释充分。
4. 条件和限制明确。
5. 双链充足但不过度。
6. 不确定内容明确标记。
7. 不堆砌公式。
8. 不把 wiki 页面写成普通摘要。

---

12. 禁止事项

不要做以下事情：

1. 不要直接覆盖 raw 原始资料。
2. 不要删除用户手写内容。
3. 不要无依据创造来源。
4. 不要把不确定结论写成确定事实。
5. 不要只总结不链接。
6. 不要只给公式不解释物理意义。
7. 不要忽略适用条件。
8. 不要在同一页面让同一符号表示多个物理量。
9. 不要把综合讲义页写成零散笔记。
10. 不要把论文页写成简单摘要。
11. 不要未经确认删除、合并、重命名或移动重要文件。
12. 不要为了分类强行移动内容还不稳定的页面。
13. 不要为尚未成熟的学科创建空的主线页。