Menu
根据笔记主题（如 Python、Java、数据结构等）在 main.typ 中生成注释形式的三层目录结构（Part-Chapter-Section）
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
审查笔记目录结构的合理性，包括边界问题、内容重复、章节均衡、学习曲线等维度。当用户要求审查目录、检查章节划分是否合理、或询问某个知识点应该放在哪里时调用。
在 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 框架移至独立笔记
突出领域特色：不同技术栈的目录应体现其独特性
逻辑递进：从基础到高级，循序渐进
粒度适中：
标记清晰：
格式规范：
// 注释，不用 %