القائمة
根据笔记主题（如 Python、Java、数据结构等）在 main.typ 中生成注释形式的三层目录结构（Part-Chapter-Section）
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
审查笔记目录结构的合理性，包括边界问题、内容重复、章节均衡、学习曲线等维度。当用户要求审查目录、检查章节划分是否合理、或询问某个知识点应该放在哪里时调用。
在 main.typ 中规划章节大纲，包括设计 == 二级目录和 === 三级目录，并编写 // 内容注释
本技能文件规定了在本项目中使用 Typst 编写笔记时必须遵守的语法规范和最佳实践。
根据 main.typ 中的目录草稿，为每个 Part 创建对应的章节文件并引入
本技能文件规定了如何编译验证 Typst 文件，确保修改后的笔记可以正确生成 PDF。
| name | create_content |
| description | 根据笔记主题（如 Python、Java、数据结构等）在 main.typ 中生成注释形式的三层目录结构（Part-Chapter-Section） |
当用户要求为某个技术栈或主题生成笔记目录时，在 main.typ 文件中生成注释形式的完整目录结构。
Part 划分原则：
常见 Part 模式：
编程语言类：
框架类：
算法类：
Chapter 划分原则：
标记系统：
Section 划分原则：
格式要求：
输出格式：
// ─────────────────────────────────────────────────────────────────────
// Part X：Part 标题
// ─────────────────────────────────────────────────────────────────────
// Chapter 1：Chapter 标题 ✅/🔶/⚪
// 1.1 标题
// 1.2 标题
// 1.3 标题
// Chapter 2：Chapter 标题 ✅/🔶/⚪
// 2.1 标题
// 2.2 标题
注意事项：
// ---... 隔开//，不要用 %在目录草稿的最后，添加一段设计思路注释，简要说明目录的整体设计考量：
格式：
// ─────────────────────────────────────────────────────────────────────
// 设计思路
// ─────────────────────────────────────────────────────────────────────
// 1. 应用场景：xxx
// 2. 重点倾斜：xxx
// 3. 面试/实战：xxx
// 4. 省略考量：xxx
main.typ 中的目录区域（通常在最下面）用户请求："为 Python 教程生成目录"
// ─────────────────────────────────────────────────────────────────────
// Part 1：Python 核心基础（语法 + 编程范式）
// ─────────────────────────────────────────────────────────────────────
// Chapter 1：Python 入门与环境搭建 ✅
// 1.1 语言概述：Python 设计理念、解释型 vs 编译型、动态类型系统
// 1.2 开发环境搭建：Python 安装、虚拟环境（venv/conda）、IDE 配置
// 1.3 运行流程：源码→字节码→解释执行、.pyc 文件作用
// 1.4 第一个程序：Hello World、交互式解释器、脚本模式
// Chapter 2：基础语法 ✅
// 2.1 标识符、注释、编码规范（PEP 8）
// 2.2 变量与数据类型：动态类型、基本类型、类型注解
// 2.3 运算符与表达式：算术、比较、逻辑、身份、成员运算符
// 2.4 流程控制：if-elif-else、for/while 循环、break/continue/pass
// 2.5 输入输出：input()、print() 格式化、f-string
// ─────────────────────────────────────────────────────────────────────
// Part 2：Python 高级特性与函数式编程
// ─────────────────────────────────────────────────────────────────────
// Chapter 1：迭代器与生成器 🔶
// 1.1 迭代协议：__iter__/__next__、可迭代对象
// 1.2 生成器函数：yield、惰性求值、无限序列
// 1.3 生成器表达式：与列表推导式的区别
// 1.4 itertools 模块：高效迭代工具
// Chapter 2：装饰器 🔶
// 2.1 闭包与作用域：嵌套函数、自由变量
// 2.2 装饰器基础：@syntax、函数装饰器
// 2.3 带参数的装饰器、类装饰器
// 2.4 functools 模块：wraps、lru_cache、partial
// 2.5 装饰器实战：日志、缓存、权限检查
// ─────────────────────────────────────────────────────────────────────
// 设计思路
// ─────────────────────────────────────────────────────────────────────
// 1. 应用场景：Python 主要用于后台开发、脚本自动化、数据科学/AI
// 2. 重点倾斜：数据模型和装饰器是 Python 面试高频点且体现设计深度，篇幅较重
// 3. 面试/实战：函数式编程和并发模型侧重工程实践，包含 asyncio 实战案例
// 4. 省略考量：GUI（tkinter）和移动端（Kivy）非主流场景，省略；Web 框架移至独立笔记
突出领域特色：不同技术栈的目录应体现其独特性
逻辑递进：从基础到高级，循序渐进
粒度适中：
标记清晰：
格式规范：
// 注释，不用 %