@dongfangw/study-kit 0.0.0-stage → 0.1.0

package/skills/aero-study-guide/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: aero-study-guide
+description: 《空气动力学基础》本科课程学生上手导航。告诉学生课程资源在哪、如何用 DeepSeek Harness 学习、如何有效提问。触发词："怎么开始学""资源在哪""学习指南""怎么用""上手""课程介绍"。
+---
+
+# 空气动力学学生上手导航（aero-study-guide）
+
+## 一、课程资源地图
+
+本课程配套资源在 `aero/` 工作区（学生拿到的是这些仓库的克隆或打包拷贝）：
+
+| 资源 | 路径 | 用途 |
+|---|---|---|
+| **知识手册（全速域）** | `knowledge-base/正文/`（8 编：基础→低速→亚/跨/超声速→高超声速→高温→应用；曾明教材 50 节全覆盖 + FoA/MCF/HHTGD 等参考书融合，逐条来源标注） | **学生优先阅读的策展知识册**，从 `正文/index.adoc` 或工作台置顶分组进入 |
+| **数学基础手册** | `knowledge-base/数学基础/正文/`（3 编 9 章 28 节：代数与张量→场论→方程与近似工具；矢量/指标/矩阵、张量代数、场论三算子、正交曲线坐标、积分与输运定理、复变、PDE 辨型与特征线、级数/量纲/Fourier/相似） | **数学前置工具链**：遇到「公式里的张量/场论算子/复势/特征线看不懂」时按需查；从 `数学基础/正文/index.adoc` 或工作台「数学基础手册」分组进入 |
+| 中文主教材 | `textbook/空气动力学基础-曾明/`（9 章 MD + 每章思维导图） | 公式/定义/结论的**唯一权威基准** |
+| 习题与解答 | `textbook/习题集与解答/` | 巩固练习；**解答仅在教师端可见**（工作台学习模式下目录/检索/阅读均隐藏，防抄袭） |
+| 教学大纲 | `textbook/教学大纲/` | 章节结构 + 学时安排 |
+| 知识图谱 | `textbook/知识图谱/source/*.yaml`（绪论/可压缩流/黏性流） | 概念关系导航 |
+| 英文参考书 | `textbook/参考书/`（Anderson FoA/MCF、Bertin、Schlichting 等 32+ 本） | 多教材视角、物理直觉、历史脉络 |
+| Python 演示 | `lesson-plan/python教学案例/`（位势流/激波/边界层/喷管/NACA 等 11 案例） | 动手算、动态可视化 |
+
+> Web 工作台：DSH 会话顶部有「学习资料」标签页，**置顶分组为「知识手册（全速域）」，其下第二个分组即「数学基础手册」**（其次教材/参考书/教案/课件，提问自动带上下文）；
+> 其后的「仿真」标签页把上表的 Python 演示做成可点按的仿真案例（静态出图 / 前端动画 /
+> Streamlit 交互应用 / 外链卡片 / 离线自托管仿真，27 案例全部可用），详见 `aero/仿真工作台-建设方案.md`。
+
+> 若找不到 `aero/` 目录，先问老师资源的位置；本技能默认资源在 `aero/` 下。
+
+## 二、三种学习用法
+
+1. **建立知识框架** → 用 `aero-learning-path`（"第 X 章讲什么""知识框架"）
+2. **掌握思维方式** → 用 `aero-think`（"怎么想""物理直觉""量级估算"）
+3. **解答疑惑** → 用 `aero-concept-qa`（"为什么…""什么是…""帮我解释…"）
+
+## 三、有效提问技巧
+
+向 AI 提问时，尽量做到：
+- **具体**：指出是哪一章/哪个公式/哪道题（如"教材 §6.1 的达朗贝尔佯谬"）
+- **给上下文**：说明你已理解到哪里、卡在哪一步
+- **要溯源**：要求回答标注"教材 §X.Y"或"参考书书名 §章节"，并现场验算数值
+- **追因果**：不只问"是什么"，更问"为什么"和"有什么用"
+
+## 四、学习守则
+
+- 公式/定义/数据以曾明教材原文为唯一基准；英文参考书仅作多视角补充
+- 具体数值必须现场计算验证，不凭印象
+- 引用材料标注来源

package/skills/aero-think/SKILL.md

@@ -0,0 +1,59 @@
+---
+name: aero-think
+description: 《空气动力学基础》思维方式训练。教学生用物理直觉、因果链、无量纲分析、量级估算来思考和解决空气动力学问题，而非死记公式。触发词："怎么想""思路""物理直觉""因果链""量级估算""为什么这样"。
+---
+
+# 空气动力学思维方式（aero-think）
+
+## 一、核心思维工具
+
+### 1. 因果链思维（把概念串成"为什么"）
+空气动力学最重要的因果链之一：
+
+```
+无滑移 → 边界层 → 分离 → 阻力
+```
+
+- **无滑移**（黏流与理想流的本质区别）→ 壁面速度为零 → 形成**边界层**（速度从 0 到自由流的一薄层）
+- 逆压梯度下近壁流体动能耗尽 → **分离**（流线离开壁面）
+- 分离 → 尾迹低压区 → **压差阻力**
+
+遇到"阻力从哪来"类问题，先走这条链，再分辨摩擦阻力 vs 压差阻力。
+
+### 2. 无量纲数 = "物理的开关"
+- **Re = 惯性力/黏性力**：它同时是"流态开关"（层流/湍流）和"力比值"——前者是大 Re 下扰动被放大→失稳→湍流的物理结果，后者是力比值的直接定义，同一枚硬币两面
+- **Ma = 速度/声速**：它开关"可压缩性"（Ma<0.3 可当不可压）
+- 看到无量纲数，先问"它是什么力/效应的比值""过了临界值会怎样"
+
+### 3. 量级估算（Order-of-Magnitude）
+不用精确计算，先用"数量级"判断是否合理：
+```bash
+# 例：台风摩羯 Re 量级（H~1km, U~50m/s, ν~1.5e-5）
+python3 -c "print(50*1e3/1.5e-5)"   # ≈3.3e9 → 10^9 量级
+```
+- "比水大几个量级"要用 lg 验算，别凭印象
+- 量级对了再谈精度；量级错了，精确到小数点也没用
+
+### 4. 极限/理想化思维
+- 先看"理想流体"（无黏）能推出什么 → 达朗贝尔佯谬（零阻力）→ 知道"黏性"补上了哪块
+- 先看"不可压"简化 → 再看"可压缩"修正（Ma 修正）
+- 理想化是"先立靶子"，再逐步加回真实效应
+
+### 5. "局部代价换全局收益"（工程权衡思维）
+- 高尔夫球凹坑：局部增摩（触发转捩）→ 湍流抗分离 → 全局减阻（尾迹变窄）
+- 湍流双刃剑：摩阻大（坏）但抗分离强（好）——判断优劣看具体问题
+- 工程上没有"处处最优"，只有"权衡后的全局最优"
+
+## 二、思考问题的标准动作
+
+1. **这是哪类流动**？（不可压/可压缩 × 无黏/黏性 × 层流/湍流）——先分类
+2. **哪些效应能忽略**？（Re/Ma 判断 → 选对理论框架）
+3. **主导机制是什么**？（惯性？黏性？压差？）——抓主要矛盾
+4. **画图/画剖面**：速度剖面、压力分布、流线——几何直觉常常先于公式
+5. **量级检验**：结果出来先估个数量级，看是否离谱
+
+## 三、典型"直觉题"练习
+
+- 为什么飞机蒙皮铆钉凸起会显著增加阻力？→ 走"无滑移→边界层→转捩/分离→阻力"链
+- 为什么细血管对血流控制更精细？→ 泊肃叶定律 $Q\propto d^4$，管径减半流量只剩 1/16
+- 为什么超声速要用"激波"而亚声速没有？→ Ma 开关，扰动传播速度 vs 来流速度

package/skills/kb-organize/SKILL.md

@@ -0,0 +1,73 @@
+---
+name: kb-organize
+description: 帮学生把"一堆资料"变成一个能被 AI 学伴读的库：生成 library.yaml（分组/扩展名/深度/可见性），从目录标题自动推断学习路径 outline，并给出 30 秒验证步骤。触发词：建库、加库、整理资料、library.yaml、接入我的课程、把笔记接进来。
+metadata:
+  version: "0.1.0"
+---
+
+# 建库向导：把资料变成"可被学伴读的库"
+
+## 1. 先看目录，别急着写清单
+
+1. 列出资料目录的层级（两三层就够）：
+   ```bash
+   ls -R "<资料目录>" | head -80
+   ```
+2. 判断形态（`kind`）：`knowledge`（体系化手册）· `notes`（课堂/自学笔记）· `lesson-plan`（教案）·
+   `slides`（课件）· `textbook`（教材）· `reference`（参考书）· `exercises`（习题）· `other`。
+
+## 2. 写 `library.yaml`（放资料目录根）
+
+最小可用：
+
+```yaml
+schema: aero-library/1
+id: my-course            # kebab-case，全局唯一
+title: 我的另一门课
+kind: notes
+visibility: private      # 自己的资料一律 private
+groups:
+  - { id: main, label: 笔记, dir: notes, exts: [md, adoc], maxDepth: 3 }
+```
+
+要点：
+- `groups[].dir` 是**库根相对目录**，不能越界（`..` 会被拒绝）。
+- `exts` 不含点；`deck: true` 表示该目录下每个子目录的 `slides.md` 算一个课件。
+- `teacherOnly: true` 只给老师看（学生视图变占位）；`visibility: private` 的库**不会被导出/分享**。
+
+## 3. 推断 `outline`（学习路径）
+
+读目录里的一级标题，按出现顺序写进 `outline`：
+
+```yaml
+outline:
+  - { id: ch1, title: 第 1 章 xxx, chapter: 1 }
+  - { id: ch2, title: 第 2 章 xxx, chapter: 2 }
+```
+
+有了它，「学习路径」技能就不用写死某门课的章节表。
+
+## 4. 验证（30 秒）
+
+```bash
+npx @dongfangW/library-core validate "<资料目录>"
+npx @dongfangW/library-core catalog  "<资料目录>"
+```
+
+两条都通过后，刷新学伴的「我的库」，新库即出现；打开任意一篇检查公式与图片。
+
+## 5. 多库：工作区清单
+
+若想一次挂多个库，在工作区根放 `libraries.yaml`（**本地文件，不进 git**）：
+
+```yaml
+schema: aero-workspace/1
+libraries:
+  - { path: ./knowledge-base }
+  - { path: ~/资料/高数 }
+```
+
+## 不要做
+
+- 不要把私人资料放进公开仓；`visibility: private` 只是入口隔离，不是加密。
+- 不要写绝对路径进清单（换机器就废）。