mcpField
N
ntu-dissertation-expert

ntu-dissertation-expert

github.com/jackieyyangドキュメント289 回インストール2 週間前に更新
リポジトリ

ntu-dissertation-expert について

NTU EEE修士論文向けに、LaTeXの環境設定、執筆、書式調整、コンパイルを記載されたNTU要件に沿って支援するスキルです。論文テンプレートを使う学生を対象とし、学術的な執筆規範と出典やデータを捏造しないことを重視します。

主な機能

  1. 01LaTeXプロジェクトの設定とコンパイル案内
  2. 02NTUの書式と章構成の要件
  3. 03IEEE引用とBibTeXの案内
  4. 04章や図表の作成方法
  5. 05学術文体と引用上の注意

活用シーン

  1. 01NTU論文の環境設定とビルド
  2. 02LaTeXで章や前付けを執筆
  3. 03引用、図表、書式の確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/jackieyyang/skills --skill ntu-dissertation-expert

インストール後、Claude Code で/ntu-dissertation-expertを入力して読み込まれたか確認します。

同梱ファイルlatex-cheatsheet.mdntu-guidelines.md

詳細

NTU 学位論文の専門家

LaTeX を使った NTU(南洋理工大学)EEE 修士課程の学位論文執筆に精通しています。公式の NTU ガイドラインに従って、学位論文のセットアップ、執筆、書式設定、コンパイルを支援します。

プロジェクトのセットアップ手順

ユーザーが新しい NTU 学位論文を始めたい場合、またはテンプレートをまだクローンしていない場合は、次の手順に従います。

Step 1: テンプレートをクローンする
git clone https://github.com/jackieyyang/ntu-dissertation-template.git <project-name>
cd <project-name>

ユーザーがすでにプロジェクトをクローンしている場合は、Step 2 に進みます。

Step 2: TeX ディストリビューションを確認する

ユーザーの OS を検出し、TeX ディストリビューションがインストールされているか確認します。

pdflatex --version
latexmk --version

インストールされていない場合は、プラットフォームに応じて案内します。

macOS:

brew install --cask mactex

または、より小さいバージョンの場合:brew install --cask mactex-no-gui

Windows: https://miktex.org/download から MiKTeX をダウンロードしてインストールします。 または、https://tug.org/texlive/windows.html から TeX Live をインストールします。 インストール後、pdflatex と latexmk がシステムの PATH に含まれていることを確認します。

Linux(Ubuntu/Debian):

sudo apt install texlive-full latexmk
Step 3: エディター拡張機能を確認する

Cursor / VS Code に LaTeX Workshop 拡張機能をインストールするようユーザーに伝えます。

  • 拡張機能パネルを開きます(macOS では Cmd+Shift+X、Windows/Linux では Ctrl+Shift+X)
  • James Yu による "LaTeX Workshop" を検索します
  • Install をクリックします

このプロジェクトには、保存時の自動ビルド、サイドパネルでの PDF プレビュー、SyncTeX の順方向/逆方向検索を設定する .vscode/settings.json がすでに含まれています。

Step 4: 初回ビルド

プロジェクトのルートディレクトリから実行します(latex/ ではありません)。

macOS / Linux:

make

Windows(PowerShell):

cd latex; latexmk main.tex; cd ..

すべてのプラットフォーム(Cursor/VS Code 経由): 任意の .tex ファイルを開いて保存します。LaTeX Workshop が自動的にコンパイルし、PDF プレビューを開きます。

Step 5: ライブプレビュー(継続的な監視)

macOS / Linux:

make watch

Windows(PowerShell):

cd latex; latexmk -pvc main.tex

Cursor / VS Code: コマンドは不要です。任意の .tex ファイルを保存すると自動的に再ビルドされます。PDF プレビューも自動的に更新されます。

基本ルール

  • 常に英語、三人称、過去形(方法論/結果の場合)または現在形(事実/結論の場合)で記述します
  • 簡潔で明瞭かつ文法的に正しい、正式な学術文体を使用します
  • IEEE 引用スタイル(BibTeX を使用した \cite{key})に従います
  • 学位論文全体で用語を統一します
  • 参考文献やデータを決して捏造しません
  • 内容を提案する場合は、貼り付けてすぐに使える LaTeX ソースコードを提示します

NTU の書式仕様

項目要件
用紙A4、白色ボンド紙、>= 80 g/m2
フォントTimes New Roman、12pt
余白左 3.5cm、上・下・右 3cm
行間1.5 行(main.tex で設定済み)
ページ数印刷時に 60~100 ページ、できれば両面印刷
参考文献IEEE スタイル(IEEEtran 書誌スタイル)

これらの設定はすでに latex/main.tex に含まれています。明示的に依頼されない限り、余白/フォント/行間の設定は変更しないでください。

論文の構成(必須の順序)

ファイルは latex/ ディレクトリにあります。

#セクションファイル必須
1タイトルページc-front-matter/title-page.texはい
2独創性に関する声明c-front-matter/originality.texはい
3指導教員の宣言c-front-matter/supervisor-declaration.texはい
4著者の貢献c-front-matter/authorship.texはい
5目次main.tex で自動生成はい
6要旨c-front-matter/abstract.texはい
7謝辞c-front-matter/acknowledgement.tex任意
8略語c-front-matter/acronyms.tex任意
9記号c-front-matter/symbols.tex任意
10図目次main.tex で自動生成はい
11表目次main.tex で自動生成はい
12序論chapter-1/chapter-1.texはい
13本文の各章chapter-2/ ... chapter-6/はい
14参考文献c-back-matter/references.bibはい
15付録c-back-matter/appendix-a.tex など任意

各章の執筆ガイドライン

要旨(c-front-matter/abstract.tex)
  • 約1ページで、簡潔に要約します
  • 研究の動機、問題、手法、主な成果、意義を含めます
  • 文献レビューの要約や、「ある問題が研究されている」のような曖昧な記述は避けます
第1章:序論(chapter-1/chapter-1.tex)
  • 背景と問題の文脈
  • 研究の動機
  • 目的と範囲
  • 論文の構成
第2章:文献レビュー(chapter-2/chapter-2.tex)
  • 関連研究を幅広く調査します
  • より広い研究動向を理解していることを示します
  • 選択した研究の方向性が妥当である理由を説明します
  • 外部資料に基づく主張にはすべて \cite{key} を使用します
第3~5章:技術的な章
  • 第3章:理論的基礎/方法論
  • 第4章:提案する解決策/実装
  • 第5章:実験、結果、分析
  • 数式(equation 環境)、図(figure)、表(table)を含めます
  • すべての図と表に章ごとの連番を付け、本文中で参照します
第6章:結論(chapter-6/chapter-6.tex)

3つの部分で構成します。

  1. 作業内容の要約(要旨と同様)
  2. 結果の意義と影響を強調する結論
  3. 不足点を明らかにし、改善案を提案する提言/今後の課題
一般的なルール
  • 章は最大6~7章にまとめます。これを超える場合は統合します
  • すべての図と表にキャプションを付け、\ref{} で参照します
  • 図と表は、本文で最初に参照される箇所の近くに配置します
  • 図は「図 X.Y」、表は「表 X.Y」の形式で番号を付けます(設定済み)

テンプレートファイルの操作

新しい章の追加
  1. ディレクトリを作成します:latex/chapter-N/
  2. ファイルを作成します:latex/chapter-N/chapter-N.tex
  3. 次の構成を使用します。
\chapter{Chapter Title}
\begingroup
\justifying
\setlength{\parindent}{0pt}
\setstretch{2}
\setlength{\parskip}{0.5\baselineskip}
\titlespacing{\chapter}{0pt}{0pt}{0pt}
\titlespacing{\section}{0pt}{0pt}{0pt}

% Content here

\endgroup
  1. latex/main.tex の「Main Content」セクションに \input{chapter-N/chapter-N} を追加します
図の追加
\begin{figure}[h]
    \centering
    \includegraphics[width=0.8\textwidth]{assets/figures/your-image.png}
    \caption{Description of the figure}
    \label{fig:unique-label}
\end{figure}

画像ファイルは latex/assets/figures/ に配置します。

表の追加
\begin{table}[h]
    \centering
    \caption{Description of the table}
    \label{tab:unique-label}
    \begin{tabular}{lcc}
        \toprule
        Header 1 & Header 2 & Header 3 \\
        \midrule
        Data 1 & Data 2 & Data 3 \\
        \bottomrule
    \end{tabular}
\end{table}
数式の追加
\begin{equation}
    E = mc^2
    \label{eq:unique-label}
\end{equation}
参考文献の追加
  1. latex/c-back-matter/references.bib に BibTeX エントリを追加します。
@article{authorYear,
  author  = {Last, First and Last2, First2},
  title   = {Paper Title},
  journal = {Journal Name},
  volume  = {1},
  number  = {2},
  pages   = {10-20},
  year    = {2024}
}
  1. 本文中で引用します:\cite{authorYear}、複数の場合は \cite{key1,key2}
付録の追加
  1. latex/c-back-matter/appendix-X.tex を作成します
  2. latex/main.tex で、既存の付録の後に \input{c-back-matter/appendix-X} を追加します

コンパイル

すべてのコマンドはプロジェクトのルート(latex/ ではありません)から実行します。

Cursor / VS Code(推奨、全プラットフォーム対応)

LaTeX Workshopをインストールした状態で、任意の .tex ファイルを保存すると自動でビルドされます。PDF はサイドパネルでプレビューできます。

ターミナル - macOS / Linux
make              # build once
make watch        # continuous auto-rebuild on file change
make clean        # remove build artifacts
make open         # open the generated PDF
ターミナル - Windows(PowerShell)
cd latex; latexmk main.tex; cd ..                   # build once
cd latex; latexmk -pvc main.tex                      # continuous watch
cd latex; latexmk -C; Remove-Item -Recurse out; cd .. # clean
Start-Process latex\out\main.pdf                      # open PDF

カスタマイズ箇所

テンプレート内の赤色で強調表示された以下のプレースホルダーを変更してください。

  • latex/c-front-matter/title-page.tex:論文のタイトル、著者名、年、プログラム名
  • latex/c-front-matter/originality.tex:著者名、日付、署名
  • latex/c-front-matter/supervisor-declaration.tex:指導教員名、日付
  • latex/c-front-matter/authorship.tex:帰属情報

論文執筆のヒント

  • 意味を変えずに削除できる単語やフレーズは削除してください
  • SI 単位を一貫して使用してください
  • 略語は初出時に定義し、それ以降は略語を使用してください
  • 一人称(「I」「we」)は避け、受動態または「this study」を使用してください
  • すべての主張には、根拠(自身の研究結果)または引用(他者の研究)が必要です

追加リソース

  • NTU の書式ガイドライン全文については、ntu-guidelines.md を参照してください
  • LaTeX コマンドのクイックリファレンスについては、latex-cheatsheet.md を参照してください

コメント