forked from EduCraft/curriculum-project-hub
51 lines
2.6 KiB
Markdown
51 lines
2.6 KiB
Markdown
---
|
||
name: outline
|
||
description: 根据教研讨论结论生成结构化课程粗大纲并写入项目根目录 outline.md。用户要求写大纲、整理课程结构，或准备把讨论落成 cph 工程时使用。
|
||
---
|
||
|
||
# 生成可落地为 cph 0.0.2 工程的课程大纲
|
||
|
||
将已经确认的教研结论写入项目根目录 `outline.md`。大纲是后续 `lesson-project` skill 的施工图，不是自由扩写的文章。
|
||
|
||
## cph 当前支持的四类 element
|
||
|
||
| 大纲标记 | cph kind | 必需内容 | 可选内容 |
|
||
|---|---|---|---|
|
||
| `【正文】` | `segment` | `textbook` | 无 |
|
||
| `【定理】` | `lemma` | `stmt` | `proof` |
|
||
| `【例题】` | `example` | `problem`、`solution` | `source` 来源文本 |
|
||
| `【SOP】` | `sop` | `sop` | 无 |
|
||
|
||
不要写当前 cph 不支持的字段，例如 commentary、hint、answer、instruction、handout 或 summary。需要保留的点评、提示、授课建议应明确并入对应正文、证明或解析的描述中。
|
||
|
||
## 写法
|
||
|
||
1. 用 Markdown 标题表达课程章节层级。
|
||
2. 每个 element 单独成条，格式为 `- **【类型】名字**：描述`。
|
||
3. 描述必须足以让后续作者直接写对应 `.typ` 文件；不能只有“介绍一下”“讲清楚”等空话。
|
||
4. 定理必须给出明确结论或公式；若需要证明，在下一行写 ` > **证明要求**：...`。不需要证明时明确写无需证明。
|
||
5. 例题必须给出完整题面，或清楚说明引用来源与必要改编；同时写 ` > **解析要求**：...`。若有来源，写 ` > **来源**：...`。
|
||
6. 不替用户补充未确认的领域事实。缺关键题面、公式或结论时，停下来询问。
|
||
7. `> **说明**：...` 只用于施工说明，不进入正式讲义内容。
|
||
|
||
## 最小示例
|
||
|
||
```markdown
|
||
# 表面张力
|
||
|
||
## 宏观图像
|
||
|
||
- **【正文】液面拉伸的本质**：解释增加液面面积为何需要外界做功，并引出表面能密度。
|
||
|
||
- **【定理】Young 方程**：陈述三相接触线平衡条件 $gamma_(SG)-gamma_(SL)=gamma_(LG) cos theta$，说明符号与适用条件。
|
||
> **证明要求**：从总界面能对接触线位移的一阶变分推出。
|
||
|
||
- **【例题】接触角反演**：给定三种界面张力，求平衡接触角并判断完全浸润条件。
|
||
> **解析要求**：先检查 Young 方程是否存在实数解，再讨论边界情形。
|
||
> **来源**：自编。
|
||
|
||
- **【SOP】三相浸润判断流程**：形成“列界面能—检查完全浸润—求接触角—验证范围”的固定步骤。
|
||
```
|
||
|
||
完成前检查：每条都能唯一映射到上表中的 cph 文件；所有公式、题面、证明和解析要求均来自已确认材料。
|