锻造你的知识体系 — 通用知识笔记模板
考研 · 考公 · 专业课 · 科研 · 项目 · 竞赛 · 期末
更新日志 • 特性 • 快速开始 • 模板体系 • 预览 • 核心结构 • 适配指南 • 配套工具
- 修复自定义 subagent 类型缺失导致的工具调用错误：新增
.agents/segment-writer.md和.agents/verifier.mdagent 定义文件；SKILL.md 将 subagent 类型改为默认 general-purpose，确保所有环境均可正常使用 subagent 派发
- Skill 目录精简：移除 .claude/skills/novaforge/ 冗余副本，skills/novaforge/SKILL.md 为唯一源文件；根目录新增 NovaForge.skill 独立下载入口；新增 scripts/install-skill.bat/sh 一键安装脚本
- TikZ 箭头标签防重叠规则：SKILL.md 新增 alabel 样式强制规则，AI 生成 TikZ 时自动使用 alabel/alabel above/alabel below
- 修复箭头标签与目标重叠：新增 alabel/alabel above/alabel below 三层 TikZ 样式（pos=0.4 + auto），在 preamble.tex 中全局生效，template.tex 中附使用示例
- 改用标准 Skills 目录布局：
NovaForge.skill→skills/novaforge/SKILL.md、.claude/skills/NovaForge.skill→.claude/skills/novaforge/SKILL.md。让 ccswitch 等外部工具及 Claude Code 本地发现机制能按官方约定识别 skill
- 移除 pdf companion 依赖：NovaForge 独立完成 LaTeX 编译，不再依赖 pdf skill
- 新增 .claude/skills/NovaForge.skill：克隆后 Claude Code 自动识别
/novaforge命令，无需手动复制 - NovaForge.skill 更新：
- Intake 模式选择优化：明确指令直接推断，模糊指令按上下文给出 2~4 个选项
- 编译格式选择用 AskUserQuestion 交互
- 修复引号渲染方向：导言区新增中文引号规范，强制使用 Unicode 弯引号（U+201C/U+201D）
- 消除目录红框：hyperref 改用
hidelinks，去除目录条目链接边框 - 编译清理说明：模板注释和 Build 流程补充辅助文件（.aux/.log/.out/.toc）清理指引
- 清理 template.tex 死代码：移除
\end{document}后的残留命令定义 - 修复 Typst 模板语法错误：修正
template.typ中引号不平衡 - README 目录树补全：scripts/ 目录新增缺失的 3 个脚本
- compile-typst.sh 增强：新增编译失败的错误处理
- 新增 Typst 模板版本：提供
typst/preamble.typ+typst/template.typ，语法更现代、编译更快（单次编译，无需多遍） - 三种输出格式：Intake 流程扩展为 LaTeX（默认）/ Typst / Markdown 三选一
- NovaForge.skill 同步：已与本地 SKILL.md 内容完全一致（修复上次遗留问题）
- README 更新：新增 Typst 安装指引、模板目录、编译命令
- 重构 NovaForge 模板体系：从 3 种模式扩展至 6 种模式，新增考研、考公、项目三个专属模式
- 考研模式：7 步结构 + 考研真题标注（院校+年份+题号）+ 院校专业说明 + 每编题型专项总结
- 考公模式：行测/申论/面试分模块 + 考点概述 + 核心方法 + 真题标注 + 时政/规范链接
- 项目模式：架构设计 + 模块详情 + 进度管理 + 问题决策 + 总结复盘完整文档结构
- 科研模式：新增文献概览表 + 与自身研究关联分析模块（不可缺省）
- 优化 Intake 流程：用户通过选择题确认模板模式，降低使用门槛
- 新增触发关键词：整理文献、文献笔记、论文笔记、科研笔记、项目总结、技术方案
- README 从此条开始记录更新日志，后续每次更新 GitHub 均需追记
NovaForge 是一份领域无关的知识整理与复习资料模板集合。无论你在：
- 📚 备战考研/考公 — 系统梳理考纲，标注历年真题
- 📖 学习专业课 — 按章节整理概念+公式+例题
- 🔬 做科研笔记 — 文献卡片+实验记录+课题思路
- 🏗️ 总结项目 — 架构设计+决策记录+复盘回顾
- 🏆 冲刺竞赛 — 题型分类+方法总结+限时模拟
核心理念：从零散信息到结构化知识，从被动输入到主动输出。
| 特性 | 说明 |
|---|---|
| 三版本支持 | LaTeX（经典 PDF）/ Typst（现代 PDF）/ Markdown（即写即用） |
| 7 步模块化结构 | 概念→原理→方法→示例→实战→练习→复盘 |
| 领域无关 | 不预设学科，理科文科工科医科均可 |
| 6 种场景模板 | 章节笔记 / 期末复习 / 考研 / 考公 / 科研文献 / 项目总结 |
| 中文原生 | 完整中文排版（xeCJK + 宋体） |
| 一键配色 | 换一行代码即可切换整套视觉风格 |
| Claude Code 集成 | 提供独立 .skill 文件，配合 AI 自动生成笔记 |
| MIT 开源 | 自由使用、修改、分享 |
# 1. 克隆
git clone https://github.com/SiriusFzh/NovaForge.git
cd NovaForge
# 2. 选择你的版本
# LaTeX 版（需安装 TeX 发行版）
cd latex
# 编辑 template.tex → xelatex template.tex
# Typst 版（需安装 Typst）
cd typst
# 编辑 template.typ → typst compile template.typ
# Markdown 版（任意编辑器打开）
cd markdown
# 直接用 VS Code / Obsidian 编辑 .md 文件
# Claude Code 集成
# 仓库已内置 .claude/skills/novaforge/SKILL.md，克隆后 /novaforge 直接可用LaTeX 版：
# Windows（推荐 TeX Live）
# 下载安装：https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/Images/
# macOS
brew install --cask mactex
# Linux
sudo apt install texlive-xetex texlive-latex-extraTypst 版：
# 方式一：Cargo 安装（推荐）
cargo install typst-cli
# 方式二：直接下载二进制
# 访问 https://github.com/typst/typst/releases
# macOS Homebrew
brew install typst
# 编译
typst compile template.typ # 生成 PDF
typst watch template.typ # 实时预览（修改后自动重编译）NovaForge/
├── README.md # 本文件
├── LICENSE # MIT 开源协议
├── .gitignore
├── .claude/ # Claude Code 集成（本地自动发现）
│ └── skills/
│ └── novaforge/
│ └── SKILL.md # 笔记模板（/novaforge）
│
├── skills/ # 标准 Skills 目录（供 ccswitch 等外部工具发现）
│ └── novaforge/
│ └── SKILL.md # ← 同一份 skill，标准命名
│
├── assets/ # 预览图与资源
│ ├── preview-1.png # 封面与整体效果
│ ├── preview-2.png # 目录与章节结构
│ ├── preview-3.png # 公式与知识点展示
│ ├── preview-4.png # 真题与例题环境
│ ├── preview-5.png # 题型专项总结
│ ├── preview-6.png # 公式速查表
│ └── preview-7.png # 参考文献与结尾
│
├── latex/ # LaTeX 版（PDF 输出）
│ ├── preamble.tex # 导言区 — 可独立 \input{}
│ └── template.tex # 完整可编译模板（封面→目录→正文→附录）
│
├── typst/ # Typst 版（PDF 输出，语法更现代）
│ ├── preamble.typ # 共享样式与自定义函数
│ └── template.typ # 完整可编译模板
│
├── markdown/ # Markdown 版（快速记录）
│ ├── chapter-notes.md # 章节笔记模板
│ ├── exam-review.md # 考前复习冲刺模板（含考情分析+错题本）
│ ├── research-note.md # 科研文献笔记模板（文献卡片+实验记录）
│ └── project-summary.md # 项目总结模板（架构+决策+复盘）
│
└── scripts/ # 配套工具脚本
├── new-project.bat # Windows: 快速新建项目
├── new-project.sh # macOS/Linux: 快速新建项目
├── compile.bat # Windows: 一键编译 LaTeX
├── compile.sh # macOS/Linux: 一键编译 LaTeX
├── compile-typst.bat # Windows: 一键编译 Typst
└── compile-typst.sh # macOS/Linux: 一键编译 Typst
每章/每节遵循统一框架，可根据场景灵活裁剪：
┌─────────────────────────────────────────┐
│ ① 概念引入 建立直觉，理解"为什么" │
│ ② 核心原理 公式/原理框 + 逻辑推导 │
│ ③ 方法技巧 解题/实操技巧浓缩 │ ← 不能省略
│ ④ 典型示例 经典例题搭桥 │
│ ⑤ 真题/实战 真实题目/项目实战 │
│ ⑥ 巩固练习 带解答的复盘训练 │
│ ⑦ 总结复盘 易错点 + 思维导图 │
└─────────────────────────────────────────┘
\knowtitle{知识点标题} % 浅蓝灰背景标题栏
\formula{核心公式/原理} % 带框居中展示
\key{关键术语} % 橙红强调
\super{拓展内容} % 紫红超纲标记
\source{来源标注} % 紫色小字标注
\begin{exampenv}{标题} % 案例/例题环境（自动带"分析："）
...题目和解答...
\end{exampenv}
\begin{pracenv}{标题} % 练习/复盘环境（带解答）
...练习内容...
\end{pracenv}解题注释格式（LaTeX 版）：
\[\begin{aligned}
F &= ma \quad\Big(\text{牛顿第二定律，合力产生加速度}\Big) \\
a &= \frac{v^2}{r} \quad\Big(\text{圆周运动向心加速度公式}\Big)
\end{aligned}\]所有注释必须解释为什么这么做，而非只展示数学推导。
| 场景 | 推荐模式 | 微调建议 |
|---|---|---|
| 考研 | 考研模式（章节 7 步 + 真题标注） | 按考纲分章，标注院校+年份+题号 |
| 考公 | 考公模式（行测/申论/面试） | 题型模块化，时政链接 |
| 专业课学习 | 章节笔记模式（7 步结构） | 同步教材章节，每课一记 |
| 科研 | 科研模式（文献笔记） | 文献卡片 + 方法归纳 + 关联分析 |
| 项目总结 | 项目模式（架构+进度+复盘） | 架构图 + 决策记录 + 复盘 |
| 竞赛 | 期末复习模式 | 题型分类 + 方法模板 + 限时策略 |
| 期末复习 | 期末复习模式 | 精简版，聚焦考点+公式+典型题 |
修改 latex/preamble.tex 中的 \definecolor{titlecolor}：
%% 理科冷静蓝（默认）
\definecolor{titlecolor}{HTML}{1a237e}
%% 文科典雅红
\definecolor{titlecolor}{HTML}{8b0000}
%% 清新自然绿
\definecolor{titlecolor}{HTML}{2e7d32}
%% 活力竞赛橙
\definecolor{titlecolor}{HTML}{e65100}%% ── 数学/公式（非理工科可注释掉） ──
% \usepackage{amsmath,amssymb,amsthm}
% \usepackage{cancel}
% \usepackage{physics}
% \usepackage{mathrsfs}
% \usepackage{bm}# Windows
scripts\new-project.bat 我的考研笔记
# macOS / Linux
bash scripts/new-project.sh 我的考研笔记NovaForge 提供独立 .skill 文件，可直接用于 Claude Code：
# 1. 下载 skill 文件
# 从 GitHub 下载 skills/novaforge/SKILL.md（连同 novaforge/ 目录一起）
# 2. 放入 Claude Code skill 目录
cp -r skills/novaforge ~/.claude/skills/
# 3. 在 Claude Code 中调用
# /NovaForge "帮我整理量子力学的复习笔记"
# 或加载后使用
# skill NovaForgeIntake → 理解知识结构 → 按章节/主题分块 → 派发写手 →
合并结构草稿 → 校验器审核 → 生成模板文件 → 编译 PDF → 最终检查
- Controller：确认需求、全局理解、分块规划、合并、生成文件
- Segment Writer：每块按对应模式结构独立编写
- Verifier：检查覆盖完整度、结构完整性、公式/内容准确性
Skill 支持以下 6 种模式，Intake 阶段通过选择题确认：
| 模式 | 适用场景 | 核心结构 |
|---|---|---|
| 章节笔记模式 | 系统学习新知识 | 7 步结构（概念→公式→方法→示例→真题→练习→复盘） |
| 期末复习模式 | 备考冲刺 | 考法→真题(标签)→方法→练习留白→答案末尾 |
| 考研模式 | 考研专业课 | 7 步 + 考研真题(标注院校+年份) + 题型专项总结 |
| 考公模式 | 公务员/事业单位 | 考点→方法→真题→练习→时政链接 |
| 科研模式 | 文献整理/研究笔记 | 背景→方法→结果→创新→局限→关联 |
| 项目模式 | 项目文档/技术总结 | 概览→架构→模块→进度→问题→复盘 |
Skill 会在必要时自动用 tikz（LaTeX）生成辅助理解的示意图。
- 默认输出文件夹：
NovaForge-Output-<project-name>/ - LaTeX 模式：
.tex+ 编译.pdf - Typst 模式：
.typ+ 编译.pdf - Markdown 模式：
.md - 所有文件在该文件夹内，不散落在外
.skill文件为独立文件，下载单个文件即可使用，无需克隆整个仓库。
# LaTeX 一键编译（Windows）
scripts\compile.bat
# LaTeX 手动编译
cd latex
xelatex template.tex # 第 1 遍：生成 .toc
xelatex template.tex # 第 2 遍：解析引用
# Typst 编译（一次完成，无需多遍）
cd typst
typst compile template.typ
# 清理中间文件
rm *.aux *.log *.out *.toc| 问题 | 原因 | 解决 |
|---|---|---|
| 目录为空（0 bytes） | \formula{ 缺闭合 } |
全文搜索 \formula{ 检查闭合 |
\cancel 未定义 |
缺少宏包 | 导言区加 \usepackage{cancel} |
| PDF 只有部分页面 | 编译中断 + .toc 未更新 | 修复错误后 3 遍编译 |
| 中文显示为方框 | 缺少 SimSun 字体 | 安装中文字体或换用系统自带宋体 |
欢迎通过 Issue 和 PR 贡献：
- 新模板：添加更多场景的模板
- 配色方案：贡献更多一键换色配置
- 示例：分享你用 NovaForge 整理的学科笔记到
examples/ - Bug 修复：LaTeX 编译问题、环境兼容性
MIT License — 自由使用、修改、分享。
NovaForge — 锻造你的知识体系
Built with ❤️ for learners everywhere