NovaForge

✨ NovaForge

锻造你的知识体系 — 通用知识笔记模板
考研 · 考公 · 专业课 · 科研 · 项目 · 竞赛 · 期末

更新日志 • 特性 • 快速开始 • 模板体系 • 预览 • 核心结构 • 适配指南 • 配套工具

📋 更新日志

2026/5/25 12:30

• 修复自定义 subagent 类型缺失导致的工具调用错误：新增 .agents/segment-writer.md 和 .agents/verifier.md agent 定义文件；SKILL.md 将 subagent 类型改为默认 general-purpose，确保所有环境均可正常使用 subagent 派发

2026/5/17 14:30

• 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

2026/5/17 12:08

• 修复箭头标签与目标重叠：新增 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

2026/5/16 23:22

• 移除 pdf companion 依赖：NovaForge 独立完成 LaTeX 编译，不再依赖 pdf skill

2026/5/16 23:13

• 新增 .claude/skills/NovaForge.skill：克隆后 Claude Code 自动识别 /novaforge 命令，无需手动复制
• NovaForge.skill 更新：
  • Intake 模式选择优化：明确指令直接推断，模糊指令按上下文给出 2~4 个选项
  • 编译格式选择用 AskUserQuestion 交互

2026/5/16 12:00

• 修复引号渲染方向：导言区新增中文引号规范，强制使用 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 增强：新增编译失败的错误处理

2026/5/15 23:28

• 新增 Typst 模板版本：提供 typst/preamble.typ + typst/template.typ，语法更现代、编译更快（单次编译，无需多遍）
• 三种输出格式：Intake 流程扩展为 LaTeX（默认）/ Typst / Markdown 三选一
• NovaForge.skill 同步：已与本地 SKILL.md 内容完全一致（修复上次遗留问题）
• README 更新：新增 Typst 安装指引、模板目录、编译命令

2026/5/15 17:47

• 重构 NovaForge 模板体系：从 3 种模式扩展至 6 种模式，新增考研、考公、项目三个专属模式
• 考研模式：7 步结构 + 考研真题标注（院校+年份+题号）+ 院校专业说明 + 每编题型专项总结
• 考公模式：行测/申论/面试分模块 + 考点概述 + 核心方法 + 真题标注 + 时政/规范链接
• 项目模式：架构设计 + 模块详情 + 进度管理 + 问题决策 + 总结复盘完整文档结构
• 科研模式：新增文献概览表 + 与自身研究关联分析模块（不可缺省）
• 优化 Intake 流程：用户通过选择题确认模板模式，降低使用门槛
• 新增触发关键词：整理文献、文献笔记、论文笔记、科研笔记、项目总结、技术方案
• README 从此条开始记录更新日志，后续每次更新 GitHub 均需追记

🎯 这是什么

NovaForge 是一份领域无关的知识整理与复习资料模板集合。无论你在：

• 📚 备战考研/考公 — 系统梳理考纲，标注历年真题
• 📖 学习专业课 — 按章节整理概念+公式+例题
• 🔬 做科研笔记 — 文献卡片+实验记录+课题思路
• 🏗️ 总结项目 — 架构设计+决策记录+复盘回顾
• 🏆 冲刺竞赛 — 题型分类+方法总结+限时模拟

核心理念：从零散信息到结构化知识，从被动输入到主动输出。

✨ 特性

🚀 快速开始

# 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-extra

Typst 版：

# 方式一：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

👀 预览

📐 核心结构

7 步模块化结构

每章/每节遵循统一框架，可根据场景灵活裁剪：

┌─────────────────────────────────────────┐
│  ① 概念引入    建立直觉，理解"为什么"      │
│  ② 核心原理    公式/原理框 + 逻辑推导      │
│  ③ 方法技巧    解题/实操技巧浓缩           │ ← 不能省略
│  ④ 典型示例    经典例题搭桥                │
│  ⑤ 真题/实战   真实题目/项目实战           │
│  ⑥ 巩固练习    带解答的复盘训练            │
│  ⑦ 总结复盘    易错点 + 思维导图           │
└─────────────────────────────────────────┘

LaTeX 模板核心命令

\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}\]

所有注释必须解释为什么这么做，而非只展示数学推导。

🧭 跨领域适配指南

🎨 自定义

一键换色

修改 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 我的考研笔记

🤖 Claude Code 集成

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 NovaForge

Skill 工作流程

Intake → 理解知识结构 → 按章节/主题分块 → 派发写手 →
合并结构草稿 → 校验器审核 → 生成模板文件 → 编译 PDF → 最终检查

• Controller：确认需求、全局理解、分块规划、合并、生成文件
• Segment Writer：每块按对应模式结构独立编写
• Verifier：检查覆盖完整度、结构完整性、公式/内容准确性

6 种模板模式

Skill 支持以下 6 种模式，Intake 阶段通过选择题确认：

图片优先

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

常见问题

🤝 贡献指南

欢迎通过 Issue 和 PR 贡献：

1. 新模板：添加更多场景的模板
2. 配色方案：贡献更多一键换色配置
3. 示例：分享你用 NovaForge 整理的学科笔记到 examples/
4. Bug 修复：LaTeX 编译问题、环境兼容性

📄 License

MIT License — 自由使用、修改、分享。

NovaForge — 锻造你的知识体系
_{Built with ❤️ for learners everywhere}