publish-exam-study-notes：从考研资料到可信知识文章

publish-exam-study-notes 是我为 Zemengzhou Space 使用的一套 Codex Skill。它面向考研课堂照片、手写笔记、扫描件和 PDF，把“看懂一份资料”变成一条可重复执行的内容生产流程：

忠实读取源资料 → 重建知识结构 → 保留完整题解 → 验证数学内容 → 检查网站构建 → 安全提交发布。

它的核心价值不是更快地生成文字，而是让每一篇考研文章都能追溯、能核对、能构建，也能安全进入网站。

一、为什么本站需要专门的 Skill

把一组截图整理成 Markdown，看上去只是 OCR 加排版，实际包含许多容易被忽略的问题：

• 公式中的正负号、上下标和矩阵元素可能识别错误；
• 一道题可能跨越两页，题干、选项和解答容易被拆散；
• 普通摘要会省略中间推导，而考研复习恰恰依赖这些步骤；
• 原资料的结构适合课堂讲解，却不一定适合网站检索；
• 图片、LaTeX、frontmatter 或内部链接可能导致构建失败；
• Git 工作区中可能已有其他修改，粗放提交会把无关内容一起发布。

因此，本站没有把这类任务处理成“一次性提示词”，而是把规则写进 Skill。Codex 每次使用它时，都必须先检查仓库、读取站点格式、核对来源、验证公式，再进入提交和推送阶段。

二、它在 Zemengzhou Space 中承担什么作用

1. 建立考研知识文章的统一入口

Skill 约定文章写入 src/content/blog/，使用本站既有 frontmatter、标签和 Markdown 语法。这样，无论资料来自线性代数手稿、控制原理课堂照片还是概率统计 PDF，最终都能进入同一套 Astro 内容系统。

它不会机械照搬页码顺序，而是按知识逻辑组织内容，例如：

1. 定义与问题背景；
2. 核心结论；
3. 适用条件；
4. 推导过程；
5. 完整例题与解答；
6. 易错点、反例与总结。

这种重组提升了搜索和复习效率，但不能以“结构优化”为理由删减原资料。

2. 保护完整题目和完整解答

一旦决定收录某道题，Skill 要求保留：

• 题号、全部已知条件和设问；
• 选择题的所有选项；
• 必需的题图与标注；
• 原资料提供的全部解题步骤；
• 分类讨论、中间等式和最终结论。

如果资料只有题目而没有答案，文章必须明确写出“原资料未提供解答”。如需补充解法，则单独标注“整理补充解答”，不能伪装成来源原文。

这条规则很重要。考研文章不是结论索引，读者需要看到一个方法如何从题干走到答案。

3. 为数学内容设置验证层

数学笔记最危险的问题不是文风，而是一个不起眼的符号错误。Skill 会优先寻找实际可用的 Wolfram MCP，并用它检查适合机器验证的部分，例如：

• 符号化简、求导、积分和极限；
• 方程与方程组求解；
• 行列式、矩阵秩、特征值和参数分类；
• 数值抽样、边界情况与代回检查；
• 必要时生成辅助函数图像或几何图形。

不过，Wolfram 的返回值不是文章本身。计算工具负责核对结果，正文仍需保留可读、可独立检查的教学推导。数值实验也只能作为支持证据，不能冒充一般性证明。

对于含参数矩阵，Skill 还特别要求检查所有异常参数点。只计算一般情形下的 MatrixRank，可能会漏掉行列式或子式为零时的降秩情况。

4. 决定哪些图片值得进入网站

并不是每张截图都应该原样发布。Skill 只保留无法用文字、LaTeX 或紧凑表格可靠替代的内容，例如：

• 题目必需的几何图；
• 控制系统结构图；
• 液压、气压回路图；
• 函数区域或重要的视觉关系。

保留的图片需要裁掉无关界面，但不能裁掉题目标签、数值和连接关系。图片使用独立目录、ASCII 文件名、绝对站内路径和有意义的中文替代文本。

普通公式页、纯文字页和矩阵推导通常直接转写为 Markdown 与 LaTeX，不再发布整页截图。

5. 充当发布前的质量门禁

文章完成后，Skill 还要求进行一次面向网站的检查：

• frontmatter 是否符合 src/content.config.ts；
• 标题和文件名是否冲突；
• UTF-8、数学分隔符和 KaTeX 语法是否正确；
• 是否残留乱码、占位符或未确认标记；
• 图片是否真实存在，路径和替代文本是否完整；
• 每一道已收录例题是否拥有完整题干与完整解答；
• 站点完整构建是否通过。

只有这些检查全部通过，draft: false 的文章才具备发布条件。

6. 保护 Git 工作区和发布历史

Skill 会在开始和结束时检查 Git 分支与状态，保存用户已有改动，只暂存当前文章及其专属图片。它禁止宽泛地暂存整个仓库，也禁止强推和静默改写历史。

默认直推流程只在 main 分支执行：

1. 审查最终差异；
2. 精确暂存目标文件；
3. 再次确认暂存区没有无关修改；
4. 创建内容提交；
5. 推送到 origin/main；
6. 若远端拒绝推送，停止并报告，不强制覆盖。

这让“生成文章”和“发布文章”成为两个有明确门槛的阶段。

三、遇到不确定内容时为什么必须停下来

Skill 中最严格的一条规则是：只要存在会影响数学意义的不确定性，就不能继续写入、提交或推送。

需要暂停确认的情况包括：

• 一个符号可能是 +，也可能是 -；
• 指数、下标、积分上下限或矩阵元素看不清；
• 题图连线被遮挡；
• 例题缺页或解答跨页不完整；
• 来源正文与手写批注相互冲突；
• 原资料疑似存在数学错误。

Codex 必须说明具体页码、区域、上下文和可能读法，再等待确认。它不能因为某个候选“看起来更合理”就静默选择。

这会让工作流慢一点，却能避免一篇排版精美但数学含义错误的文章被发布。

四、一次典型任务怎样运行

在实际使用中，我通常把连续截图或 PDF 交给 Codex，并明确调用 Skill：

使用 publish-exam-study-notes，
忠实转录这些考研资料，
按知识逻辑整理，
保留每一道完整题目和完整解答，
验证数学内容并安全发布。

随后，Codex 会依次完成：

1. 检查仓库结构、分支和未提交改动；
2. 读取站点文章规范和近期同类文章；
3. 逐页查看原图，建立页码到内容的对应关系；
4. 报告需要人工确认的歧义；
5. 按知识结构编写 Markdown；
6. 调用实际可用的数学工具进行有限、明确的验算；
7. 检查资源、LaTeX 和内容完整性；
8. 运行 Astro 完整构建；
9. 精确暂存、提交并推送。

Skill 让这套流程从“依赖当次对话记忆”变成“每次都要遵守的项目规范”。

五、它不负责什么

为了保持边界清楚，publish-exam-study-notes 不会：

• 把看不清的公式猜成一个可能答案；
• 为追求简洁而删掉来源中的解题步骤；
• 把新增解释冒充原资料原文；
• 用生成图片替代题目必需的原始结构图；
• 把数值拟合说成严格证明；
• 在构建失败或仍有歧义时发布部分成果；
• 顺手修改导航页或其他无关文章；
• 把用户已有的工作区改动一起提交。

它也不是一个通用写作模板。它专门服务于“从考试资料到可验证知识文章”的场景。

六、对本站长期建设的意义

Zemengzhou Space 中的考研文章会不断增加。数量变多之后，真正稀缺的不是生成速度，而是一致性与可信度：

• 同一种公式是否使用一致记号；
• 不同文章是否都保留了适用条件；
• 真题是否始终包含完整选项和解答；
• 数学结论是否经过同等级别的核对；
• 图片和资源是否能够长期维护；
• 每次发布是否都能从 Git 历史追踪。

publish-exam-study-notes 把这些要求变成可执行的检查项。它既是一份 Codex 操作说明，也是一份本站考研内容的质量标准。

七、GitHub

Zemengzhou Space 的源码、文章历史与构建配置托管在 GitHub：

• LeaningLearner/zemengzhou-space

publish-exam-study-notes 当前作为本机 Codex Skill 使用，负责把来源资料安全转化为这个仓库中的文章。网站上的每次新增、修订和删除都可以通过 Git 提交历史追踪与恢复。

八、总结

publish-exam-study-notes 在本站承担的是一条完整的内容工程流水线：

阶段	目标
读取	忠实识别截图、扫描件和 PDF
整理	按知识逻辑重组，但不删改实质内容
题解	保留完整题目、条件、选项和解答
验证	用推导、代回与 Wolfram 等工具核对
资源	只保留必要图片，并规范路径与说明
构建	检查 frontmatter、KaTeX、链接和资源
发布	精确提交，保护现有改动与 Git 历史

它最终解决的不是“怎样让 AI 多写一篇文章”，而是“怎样让 AI 产出的考研文章值得长期保留”。