novaforge

# NovaForge — 通用知识笔记模板 将任意学科/项目的知识体系整理为结构化笔记。支持 LaTeX（编译为精美 PDF）和 Markdown（快速记录）双版本模板，适用于考研、考公、专业课学习、科研研究、项目总结、竞赛准备等场景。 **核心理念：** 先理解知识体系 → 按模块组织 → 生成含概念+原理+方法+案例+实战+练习+复盘的完整笔记。 ## Non-Negotiables - 支持三种输出格式，用 AskUserQuestion 让用户选择（如果用户没明确说用哪个）：**LaTeX**（编译 PDF，默认）、**Typst**（编译 PDF，语法更现代）、**Markdown**（纯文本即时记录）。 - 支持六种模板模式，Intake 时按以下规则处理： - **用户已明确指定类型**（如"期末速成""考研笔记""整理文献""项目总结"）→ 直接推断模式，不弹出模式选择 - **用户说法模糊**（如"帮我整理笔记""做份复习资料"）→ 根据学科/上下文给出 2~4 个相关选项供选择，不要全部列出 - 六种可用模式： - **章节笔记模式**（7 步结构）：系统学习新知识，每节 7 步 - **期末复习模式**（真题分类）：备考冲刺，真题+留白练习 - **考研模式**（7 步 + 考研真题）：考研专业课，院校真题标注 - **考公模式**（考点分类）：行测/申论/面试备考 - **科研模式**（文献+笔记+方法）：文献整理与研究笔记 - **项目模式**（项目文档）：架构/进度/决策/复盘 - 期末复习模式下，练习必须**留空**（不给出答案），答案统一在文末"习题答案与提示"一节给出。 - 科研模式下，输出专注于文献总结、方法归纳和与自身研究的关联分析。 - 默认输出路径：在当前工作目录下创建 `NovaForge-Output-<project-name>/` 文件夹，所有文件放入其中。 - 默认编译方式：LaTeX 模式 `xelatex` × 2 遍，Typst 模式 `typst compile` 单次编译。 - 知识点旁如能用图片更直观、更易理解的，必须加入图片（LaTeX 用 tikz 绘制，Typst 用 cetz 或内置绘图，Markdown 用链接/嵌入）。图片应是简洁的概念性图示，而非装饰性插图。 - **TikZ 箭头标签防重叠规则：** 所有 TikZ 箭头上的标签必须使用 `alabel` 系列样式代替裸 `above`/`below`，禁用裸 `pos=` 手动调位置。 - `node[alabel] {条件}` — 自动选择上下侧（推荐） - `node[alabel above] {条件}` — 强制上方，`pos=0.4` 偏左避让目标节点 - `node[alabel below] {条件}` — 强制下方，`pos=0.4` 偏左避让目标节点 - 必须在导言区或 tikzpicture 之前加载样式定义： ```latex \tikzset{ alabel/.style={auto, inner sep=2pt, font=\small}, alabel above/.style={above, pos=0.4, inner sep=2pt, font=\small}, alabel below/.style={below, pos=0.4, inner sep=2pt, font=\small}, } ``` - **日期格式规则：** 所有资料（考研/考公/竞赛/期末/专业课）的最终修订日期必须使用中文完整格式 `YYYY年M月D日`（如 `2026年5月14日`），不可省略年、月、日中的任何部分，不可使用斜杠格式。除非用户明确要求修改，否则必须遵守此格式。 - **知识要点覆盖规则：** 所有知识点**至少必须提及**，不能跳过一个主题完全不写。深度按重要性分档：**重点知识详细展开**（定义、公式、原理、易错点、适用条件等），**边缘知识简要带过**（一两句话说明是什么即可）。核心原则：广度优先、深度按需。用户可随时要求进一步精简或补充。 - 当此 skill 被触发时，仅输出文字聊天不算完成，必须生成文件并确认写入磁盘。 ## Required Outcome 默认成功结果： - LaTeX 模式：保存 `.tex` 源文件 + 编译后的 `.pdf` - Typst 模式：保存 `.typ` 源文件 + 编译后的 `.pdf` - Markdown 模式：保存 `.md` 文件 - 所有生成文件放入 `NovaForge-Output-<project-name>/` 文件夹 - 最终回复报告生成的文件路径 以下情况**不算**完成（除非用户明确要求）： - 仅文字聊天回复 - 草稿未写入磁盘 - 声称完成但未确认文件实际存在 ## When to Use 当用户需要以下场景时使用此 skill： - "帮我整理 **XX** 的笔记" - "做一份 **XX** 的复习资料" - "用 NovaForge 模板" - "整理成 7 步结构笔记" - 考研 / 考公 / 专业课的知识体系整理 - 科研笔记 / 项目总结 / 竞赛准备 - 文献整理 / 论文笔记 / 研究方向综述 - 项目文档 / 实验记录 / 技术方案整理 Common trigger phrases： - 整理笔记 - 复习资料 - 知识总结 - 考前冲刺 - 7 步笔记 - 期末速成 - 期末复习 - 真题整理 - 整理文献 - 文献笔记 - 论文笔记 - 研究方向 - 科研笔记 - 项目总结 - 技术方案 - CNAO - 天文奥赛 - 竞赛 - NovaForge Do not use this skill for： - 单纯总结课件 slides（使用 `summarize-slides`） - 只编译已有 `.tex` 到 PDF（使用 `pdf`） - 纯 PDF 操作（合并/拆分/加密/OCR 等，使用 `pdf`） - 不需要生成文件，只问问题 ## Skill Boundary - Allowed skills for this workflow：`NovaForge` and `pdf` only. - Forbidden：all other skills. ## Workflow Model - `controller`：主流程，负责确认需求、全局理解知识体系、分块规划、合并、生成模板文件、编译、最终检查 - `segment-writer`：每个知识模块的独立写手（agent 定义见 `.agents/segment-writer.md`） - `verifier`：质量审查（agent 定义见 `.agents/verifier.md`） ## Dispatch Rules - 按知识体系的自然模块（章节笔记模式按教材章节，期末复习模式按考试题型，科研模式按文献/研究方向）分块 - 每块用对应的模板结构组织 - 各块之间独立时可并行派发 `segment-writer` subagent - 紧密关联的推导链不应拆分 - `verifier` subagent 必须在合并后单独执行，不可复用 `segment-writer` ## Execution Flow ```dot digraph novaforge_flow { "Intake" [shape=box]; "Understand knowledge structure" [shape=box]; "Segment by chapters/topics" [shape=box]; "Dispatch segment writers" [shape=box]; "Collect per-segment notes" [shape=box]; "Merge into structured draft" [shape=box]; "Dispatch fresh verifier" [shape=box]; "Verifier approved?" [shape=diamond]; "Write template files" [shape=box]; "Build PDF (LaTeX/Typst mode)" [shape=box]; "Final artifact check" [shape=box]; "Report result" [shape=doublecircle]; "Intake" -> "Understand knowledge structure"; "Understand knowledge structure" -> "Segment by chapters/topics"; "Segment by chapters/topics" -> "Dispatch segment writers"; "Dispatch segment writers" -> "Collect per-segment notes"; "Collect per-segment notes" -> "Merge into structured draft"; "Merge into structured draft" -> "Dispatch fresh verifier"; "Dispatch fresh verifier" -> "Verifier approved?"; "Verifier approved?" -> "Merge into structured draft" [label="no, revise and re-verify"]; "Verifier approved?" -> "Write template files" [label="yes"]; "Write template files" -> "Build PDF (LaTeX/Typst mode)"; "Build PDF (LaTeX/Typst mode)" -> "Final artifact check"; "Final artifact check" -> "Report result"; } ``` ## Step 1. Intake - 确认用户要整理什么学科/项目 - 确认用 LaTeX（编译 PDF，默认）、Typst（编译 PDF）还是 Markdown（纯文本）——用户没说则用 AskUserQuestion 弹出选择 - 确认输出路径（默认当前工作目录下的 `NovaForge-Output-<project-name>/`） - 确认覆盖范围（全部内容还是指定章节） - **确认模板模式**： - 用户已明确指定（如"期末速成""考研笔记""整理文献""项目总结"）→ 直接推断，无需询问 - 用户说法模糊 → 根据上下文列出 2~4 个相关选项，用 AskUserQuestion 供选择，不要全部列出 - 记录用户的风格要求 Default style： - language：Chinese - layout：single-column - purpose：知识整理 / 考试复习 / 科研文献整理 - tone：清晰、结构化、不啰嗦 - output：`.tex` + `.pdf`（LaTeX 模式）、`.typ` + `.pdf`（Typst 模式）或 `.md`（Markdown 模式），放入 `NovaForge-Output-<project-name>/` ## Step 2. Check Build Environment - LaTeX 模式：确认 `xelatex` 可用 - Typst 模式：确认 `typst` 可用（安装方式：`cargo install typst-cli` 或从 https://github.com/typst/typst/releases 下载） - 如果 `xelatex`/`typst` 缺失但有 PDF 需求，报告环境问题 ## Step 3. Understand Knowledge Structure - 了解知识体系的宏观结构 - 章节笔记模式：按教材章节划分 - 期末复习模式：按考试题型/知识点划分（行列式、矩阵、方程组、特征值、二次型……） - 考研模式：按教材章节划分，每节 7 步结构 + 考研真题标注 + 题型专项总结 - 考公模式：按考试科目/题型模块划分（行测文/理、申论、面试等） - 科研模式：按文献/研究方向划分（单篇文献按内容逻辑，多篇文献按主题聚类） - 项目模式：按项目阶段/功能模块划分（架构、前端、后端、部署等） - 识别公式密集区、概念密集区、文献密集区 - 构建分块映射 ## Step 4. Segment by Chapters/Topics - 按教材章节或知识模块的自然边界分块 - 章节笔记模式：每块用 7 步结构 - 期末复习模式：每块按题型组织（考法→真题→方法→练习） - 考研模式：每块用 7 步结构 + 考研真题(标注来源院校+年份) + 题型专项总结 - 考公模式：每块按考试题型组织（考点概述→核心方法→真题标注→练习→时政/规范链接） - 科研模式：每块按文献内容逻辑组织（背景→方法→结果→创新→局限→关联） - 项目模式：每块按项目阶段/功能模块组织（目标→架构→实现→进度→问题→复盘） - 紧密关联的内容不应拆分 ## Step 5. Segment Writer Phase 可用 subagent 则并行派发多个 subagent（使用默认 general-purpose 类型，参考 `.agents/segment-writer.md` 的说明），否则 controller 顺序执行。 ### 章节笔记模式 每个 `segment-writer` 返回： - `segment id`、`topic name` - `概念引入` — 核心概念及其直觉理解 - `核心公式` — 公式及推导 - `方法速通` — 解题技巧 - `典型示例` — 经典例题 - `真题/实战` — 真实题目 - `巩固练习` — 带解答 - `总结复盘` — 易错点 ### 期末复习模式 每个 `segment-writer` 返回： - `segment id`、`topic name`、考法描述 - `真题列表`（每道题标注年份/来源） - `方法速通` — 解题技巧与公式（精简） - `真题解答` — 带步骤注释的完整解答 - `练习题目` — 只出题，**不**给出答案 - `易错提醒` ### 科研模式 每个 `segment-writer` 返回： - `segment id`、`topic name` - `研究背景` — 领域现状、现存问题、本文/本方向的研究目标 - `核心方法` — 方法框架、关键技术、实验/分析流程 - `主要结果` — 关键发现、数据/图表、结果解读 - `创新点` — 理论/方法/应用层面的创新贡献 - `局限性` — 方法局限、未解决问题、争议点 - `与己关联` — 对自身研究的启发、可借鉴/可改进之处 ### 考研模式 每个 `segment-writer` 返回： - `segment id`、`topic name`、所属院校/专业 - `基础概念` — 核心概念及其直觉理解（从零讲起） - `核心公式` — 公式框突出 + 推导过程 - `方法速通` — 解题技巧浓缩（考研高频方法标志） - `教材例题` — 经典例题，搭桥用 - `考研真题` — 标注院校+年份+题号的真实考题及解答 - `配套练习` — 巩固训练题 - `总结复盘` — 易错点 + 本章题型归纳 ### 考公模式 每个 `segment-writer` 返回： - `segment id`、`topic name`、所属科目（行测/申论/面试） - `考点概述` — 该题型考什么、怎么考 - `核心方法` — 解题思路、技巧、模板 - `真题标注` — 历年真题标记年份+来源 - `练习题目` — 只出题，不给出答案（留白） - `时政/规范链接` — 相关时政热点或政策规范引用 ### 项目模式 每个 `segment-writer` 返回： - `segment id`、`module name` - `项目概览` — 目标、范围、技术栈 - `架构设计` — 系统架构图、模块划分、数据流 - `模块分工` — 各模块功能描述与接口定义 - `进度记录` — 已完成/进行中/待办 - `问题与决策` — 遇到的技术难点与解决方案 - `总结复盘` — 经验教训、可复用模式 Segment writers 不允许： - 编写最终文档 - 决定最终排版 ## Step 6. Merge into Structured Draft Controller 合并所有 segment 笔记为连贯的结构化草稿。 ### 章节笔记模式结构（每块按顺序）： 1. 概念引入 — 建立直觉 2. 核心公式 — 公式框 + 推导 3. 方法速通 — 解题技巧浓缩（不可省略） 4. 典型示例 — 经典例题 5. 真题/实战 — 标注年份/来源 6. 巩固练习 — 带解答 7. 总结复盘 — 易错点 + 思维导图 ### 期末复习模式完整文档结构： ``` 考试概览（试卷结构表 + 时间分配建议） 内容导航（表格） ├─ 一、题型/知识点1 │ 考法概述 → 真题列表(按年份) │ 方法速通 → 真题解答(带步骤注释) │ 练习留白(标注"答案见末节") ├─ 二、题型/知识点2 ... │ ... ├─ 七、题型/知识点N └─ 附录 考点对比速查表 → 习题答案与提示 → 考场最后叮嘱 ``` ### 考研模式完整文档结构： ``` 封面（科目名 + 院校专业 + 副标题 + 配套教材 + 版本日期） 专业说明（报考方向/考试科目/关键信息表格） 如何使用（读法指南） 目录 ├─ 第一编 编名 │ ├─ 第1章 章名 │ │ 基础概念 → 核心公式(框) → 方法速通 │ │ 教材例题 → 考研真题(标注院校+年份+题号) │ │ 配套练习 → 总结复盘(易错点+题型归纳) │ ├─ 第2章 ... │ └─ 题型专项总结（本编核心题型归纳） ├─ 第二编 ... └─ 附录 公式速查表 → 各章练习答案 → 考场最后叮嘱 ``` ### 考公模式完整文档结构： ``` 封面（科目名 + 考试类型 + 副标题 + 版本日期） 考试概览（试卷结构表 + 时间分配建议） 内容导航 ├─ 一、行测/申论/面试 模块1 │ 考点概述 → 核心方法/模板 │ 历年真题(标注年份) → 练习留白 │ 时政/规范链接 ├─ 二、模块2 ... │ ... └─ 附录 考点速查表 → 练习答案 → 考前叮嘱 ``` ### 科研模式完整文档结构： ``` 标题区（文献标题/研究方向 + 副标题 + 文献概览表） 内容导航（表格） ├─ 一、研究背景与问题 │ 领域背景 → 现存问题 → 研究目标 → 核心研究问题 ├─ 二、方法与技术路线 │ 整体框架 → 关键方法/算法 → 实验/推导流程 ├─ 三、核心结果与发现 │ 关键结果(数据/图表/公式) → 结果分析 → 主要结论 ├─ 四、创新点与贡献 │ 理论创新 / 方法创新 / 应用创新（逐条列出） ├─ 五、局限性与未来工作 │ 方法局限 → 未解决问题 → 改进方向 ├─ 六、与自身研究的关联 │ 启发借鉴 → 可复用的工具/方法 → 可拓展的方向 └─ 附录 参考文献（完整引用信息） → 术语表 → 补充图表 ``` ### 项目模式完整文档结构： ``` 封面（项目名称 + 副标题 + 技术栈 + 版本日期） 项目概览（目标/范围/团队/里程碑） 内容导航 ├─ 一、架构设计 │ 系统架构图 → 模块划分 → 技术选型理由 → 数据流 ├─ 二、模块详情 │ 各模块功能描述 → 接口定义 → 核心实现 ├─ 三、进度管理 │ 已完成 → 进行中 → 待办 → 里程碑节点 ├─ 四、问题与决策 │ 技术难点 → 方案对比 → 最终决策 → 经验教训 ├─ 五、总结复盘 │ 项目成果 → 可复用资产 → 改进方向 └─ 附录 关键代码片段 → 配置文件 → 参考资料 ``` ## Style Rules ### 知识要点编写规范（核心规则） **所有知识点必须被提及，深度按重要性分档：** 1. **核心考点 / 高频内容** → 详细展开： - 定义/概念 — 是什么 - 核心公式/定律 — 定量表达 - 物理/几何意义 — 直觉理解 - 适用条件与限制 — 什么时候能用/不能用 - 与其他知识的联系 — 横向对比，避免孤立记忆 - 常见易错点 — 初学者容易误解的地方 2. **一般知识点** → 中等篇幅： - 一句话定义 + 核心公式（如有）+ 一句话说明用途 - 不展开推导，不列举全部细节 3. **边缘 / 低频知识点** → 简要提及： - 一两句话说明概念是什么即可 - 不配图、不给公式、不展开 - 但不能完全不写，至少让读者知道"存在这个东西" **通用要求：** - 凝练：短句、要点式，不堆砌废话、不照搬教材原文 - 易懂：关键术语首次出现加括号标注英文；能用图示的配图；对比性内容用表格 - 用户可随时要求"精简"（压缩边缘知识）或"补充"（对某部分深入展开） ### 通用风格规则 - 中文为主 - 关键术语如需保留英文加括号标注 - 短句、要点式 - 使用：`定义`、`公式`、`方法`、`技巧`、`典型例题`、`易错点` - 避免长篇大论 - 避免照搬教材原句 - **图片优先：** 知识结构图、对比图、流程图、几何示意图等能辅助理解的，用 tikz（LaTeX）、cetz/内置绘图（Typst）或插入图片（Markdown）实现。每章至少评估一次是否需要配图。 ### 日期格式规则： - 所有资料的最后修订日期、版本日期必须使用中文完整格式 `YYYY年M月D日`（例：`2026年5月14日`）。 - 禁止省略年、月、日中的任何部分（如 `2026年5月` 或 `2026/5/14` 均不可接受），除非用户明确要求。 - 此规则适用于：考研资料、考公资料、竞赛资料、期末复习、专业课笔记等所有标注日期的场景。 - 日期建议放在封面作者署名下方，使用蓝色字体突出显示，格式如：`\color{blue} 最后修订：2026年5月14日`。 - 封面作者署名行（如"一叶知秋"）不应再重复年份，仅保留姓名即可。 ### 期末复习模式特有规则： - 每个题型节以 `\knowtitle{考法：...}` 开头，概括该知识点在考试中的出题方式 - 真题前标注 `\yearlabel{年份}`，如 `\yearlabel{17-18-1}`、`\yearlabel{24}` - 竞赛类资料（如 CNAO）使用 **4位完整年份** 标记：`\yearlabel{2024}`，因竞赛年份跨度大且无学期概念 - 真题如需标注考试类型和题号，使用可选参数格式：`\yearlabel[决赛第3题]{2024}`，显示为 `[2024年决赛第3题]`。命令定义：`\newcommand{\yearlabel}[2][]{\textcolor{supercolor}{\small [#2年#1]}}`（#1可选题型题号，缺省留空时仅显示年份） - pre-selection/preliminary 标注示例：`\yearlabel[预赛第10题]{2023}`、`\yearlabel[选拔赛第5题]{2022}` - 方法速通用 `\noindent\textcolor{emphcolor}{\textbf{方法速通：}}` 起头，**不用** `\knowtitle` 框 - 真题解答用 `\begin{exampenv}{年份：标题}` 包裹，每步 `\quad\Big(\text{注释}\Big)` 解释为什么这么做 - 练习用 `\begin{pracenv}{编号：标题}` 包裹，**不留解答**（留 `\vspace*{3.5em}` 空白），末尾加 `\seeans{编号}` - 所有练习答案统一放在文末 `\section{习题答案与提示}` 中，每条用 `\answer{编号}` 开头 ### 考研模式特有规则： - 每节以 `\knowtitle{概念引入}` 或 `\knowtitle{核心公式}` 等形式分段，不加额外编号 - 考研真题必须标注来源院校+年份+题号，格式如 `\exam{南京大学805·2024·第1题}` 或 `\exam{中科院808·2023·第2题}` - 每编末尾必须包含"题型专项总结"——归纳本编核心考题类型、方法、易错点 - 封面需包含：科目名称、报考院校专业、配套教材信息、版本日期 - 专业说明部分列出研究方向、考试科目对照表、关键信息 - 配套练习带解答，与正文内容紧密结合放置在相对应章节 - 公式速查表作为附录，集中列出全科目核心公式 ### 考公模式特有规则： - 每个题型以 `\knowtitle{考点：...}` 开头，概括该题型的考查要点 - 真题标注 `\exam{年份·来源}`，如 `\exam{2024·国考副省级}` - 行测部分需归纳"秒杀技巧/速算方法"，申论部分需提供"答题模板/框架" - 练习留白，答案统一放在附录 - 时政类内容标注时间范围和来源链接 ### 科研模式特有规则： - 每篇文献/每个研究方向以 `\knowtitle{文献/方向：...}` 开头，给出文献或研究方向的完整标识 - 文献概览用表格列出：标题、作者、期刊/会议、年份、DOI/arXiv - 核心方法部分如有流程图、架构图等，必须用 tikz（LaTeX）/ cetz（Typst）绘制直观图示 - 关键结果部分需引用具体数据、图表或公式，避免空泛描述 - "与自身研究的关联" 部分不可缺省，必须明确写出对当前工作的启发或可借鉴之处 - 参考文献统一放在文末附录，使用 BibTeX 或 thebibliography（LaTeX）/ bibliography（Typst）完整引用 - 多篇文献对比时，使用对比表格横向比较，避免大段文字 #### 排版要求（期末复习模式）： - 概念介绍、说明文字与表格之间 **不应有大间距**：用 `\smallskip` 代替 `\medskip` 或 `\bigskip` - 表格类内容（分类统计表、速览表、对照表等）前后使用 `\smallskip` 即可，无需 `\medskip`/`\bigskip` - 不同类型的节（题型节）之间使用 `\medskip` 合理分隔 - 封面作者署名行（如"一叶知秋"）不重复年份，年份仅出现在最终修订日期中 - 最终修订日期建议使用蓝字 `\color{blue}`，文末祝福区可用灰色保留一致格式 ### 项目模式特有规则： - 每个模块以 `\knowtitle{模块：...}` 或 `\knowtitle{阶段：...}` 开头 - 架构设计部分必须包含系统架构图（tikz / cetz 绘制） - 进度管理部分使用表格列出任务状态、负责人、时间节点 - 问题与决策部分需记录方案对比和选型理由，避免只说结论 - 总结复盘不可缺省，必须包含经验教训和改进方向 #### 排版要求（科研模式）： - 文献概览表放在标题区下方，使用 `\smallskip` 与正文衔接 - 方法部分流程图优先用 tikz/cetz 绘制，置于方法描述之后 - 对比性内容（多篇文献对比、方法对比等）使用表格，前后用 `\smallskip` - "与自身研究的关联"部分用 `\medskip` 与前文分隔，加标题背景框突出 - 参考文献列出完整条目（作者、标题、期刊、年份、卷期页码），使用 thebibliography（LaTeX）/ bibliography（Typst）环境 ## Verifier Phase 所有 segment 合并后，执行独立的 verifier pass（可用 subagent，参考 `.agents/verifier.md`）。 Verifier 检查：