ZUFE Thesis Typesetter

総覧

このスキルを使用して Word 論文を ZUFE-Thesis LaTeX/PDF 成果物に変換します。以下の3つのプロセスを厳密に進めてください：

プロセス A：厳格なゲートキーピングとインテリジェントな事前準備。
プロセス B：DOCX からの正式な抽出、コンテンツ台帳作成、意味確認、テンプレートへの書き込み。
プロセス C：コンパイル、診断、品質検査、納品説明。

非技術ユーザーへの主なフィードバックは対話内で行います。スクリプトは安定したチェック、抽出、ファイル書き込み、コンパイル、機械可読な証跡の生成を担当します。

中核契約

ZUFE-Thesis テンプレートのルートディレクトリから実行する必要があります。ファイルを変更する前に、テンプレートの署名が完全であることを確認してください。

ユーザーがまだテンプレートプロジェクトを準備していない場合、まず本スキルがオリジナルの ZUFE-Thesis LaTeX テンプレートに依存していることを説明し、以下の順序で対応します：

デフォルトではオリジナルテンプレートの GitHub リポジトリ https://github.com/sqsssq/ZUFE-Thesis の使用を案内します。
GitHub がネットワーク環境により利用できない場合、ユーザーの確認を得た上で国内の代替リンク https://gitee.com/cwf818/ZUFE-Thesis を使用できます。
GitHub と Gitee の両方が利用できない場合、変換を中止し、ユーザーにテンプレートの圧縮ファイル、解凍済みの完全なテンプレートディレクトリ、またはその他の信頼できる入手方法を要求してください。

エージェントはユーザーの確認後にテンプレートのダウンロード、解凍、またはルートディレクトリへの切り替えを支援できますが、テンプレート準備を黙ってスキップしたり、空のディレクトリ、本スキルのリポジトリ、またはテンプレート署名が欠落したディレクトリで変換を続行してはなりません。

標準入力：

workspace/input/thesis.docx
workspace/input/metadata.yaml

標準中間成果物：

workspace/intermediate/thesis.json
workspace/intermediate/extracted.md

標準出力：

main.pdf
workspace/output/report.md
workspace/output/qa_report.md

プロセスの順序

プロセスを順番に実行し、後続のスクリプトで修復できる可能性があるからといってゲートをスキップしないでください。

プロセス A：テンプレート、ワークスペース、DOCX、メタデータ、古い出力、Python DOCX 環境、LaTeX/Biber 環境の確認。
プロセス B：Word の可視または抽出可能なコンテンツブロックを thesis.json に書き込みます。エージェントは意味スロットの割り当てと、低信頼度のコンテンツについてユーザーへの確認を行います。スクリプトは確認されたマッピングのみをレンダリングします。
プロセス C：古いコンパイル成果物をアーカイブし、xelatex -> biber -> xelatex -> xelatex を実行し、失敗を診断し、限定的な機械的修復を行い、新しい PDF の品質検査を実施します。

スクリプトの使用

すべてのスクリプトは --root を受け入れ、JSON を出力するか JSON レポートに書き込みます。エージェントは JSON を使用して判断し、その結果を一般ユーザーが理解できる短いリストに翻訳します。

scripts/check_template.py：ZUFE-Thesis テンプレートの署名を確認します。
scripts/prepare_workspace.py：workspace/ を作成し、DOCX を標準パスに配置し、ユーザーの承認後に古い出力をアーカイブできます。
scripts/check_env.py：Python、python-docx、xelatex、biber、およびテンプレートの主要 TeX パッケージを確認します。
scripts/prescan_docx.py：プロセス A の DOCX 軽量プリスキャンとメタデータ候補抽出。正式な thesis.json は生成しません。
scripts/import_docx.py：プロセス B の正式な抽出、thesis.json と extracted.md の生成。
scripts/export_assets.py：DOCX メディアを Images/word_media/ に抽出し、証跡を記録します。
scripts/render_basicinfo.py：メタデータ、要約、キーワードを chapters/basicinfo.tex に書き込みます。
scripts/render_chapters.py：確認された章マッピングを chapters/*.tex と chapters/mainbody.tex に書き込みます。
scripts/render_bib.py：確認された BibTeX を Reference.bib に書き込みます。参考文献を捏造してはなりません。
scripts/check_flow_b_gate.py：未処理、未確認、または未レンダリングのソースブロックが残っている場合、プロセス B の完了を防ぎます。
scripts/build.py：古い main.pdf をアーカイブし、一時的なコンパイルファイルをクリーンアップし、固定コンパイルチェーンを実行します。
scripts/diagnose_build.py：ビルドの失敗を実行可能な問題に分類します。
scripts/qa.py：PDF の鮮度、テキスト、重要なシグナル、未解決の参照、BibTeX/引用のクロージャ、テンプレートの残骸、プレースホルダーを確認します。

エージェントの責務

エージェントは意味判断を担当し、スクリプトはそれを代替してはなりません：

段落がセクションタイトル、本文、要約、参考文献、謝辞、付録、図表キャプション、または破棄可能なノイズのいずれであるかを判断します。
低信頼度の問題を統合し、ユーザーに確認します。
対話の中で、どこで何が原因でスタックしているか、次のステップを説明します。
コンテンツを黙って破棄したり、誤った場所に配置したりしません。
ファイル名から学院、専攻、日付、指導教員、またはレポートの種類を推測してはなりません。メタデータは Word の証拠またはユーザーの確認からのみ取得します。
run レベルのスタイル問題を通常のテキスト問題として無視してはなりません。上付き文字、下付き文字、表のフォントサイズ異常はすべてプロセス B/C で明らかにされなければなりません。
プロセス C では文書の意味を修正しません。コンテンツの帰属誤りはプロセス B に戻さなければなりません。

変換品質のハード制約

DOCX 段落はプレーンテキストのみを保持してはなりません。run レベルの bold、italic、superscript、subscript、およびフォントサイズの証拠を保持する必要があります。上付き数字は \textsuperscript{...} としてレンダリングし、本文の通常の数字に平坦化してはなりません。
Word 内の参照番号と思われる上付き数字を、黙って通常のテキストに書き換えてはなりません。正式な \cite/\supercite に変換する場合、事前に参考文献マッピングを確認する必要があります。そうでない場合は、少なくとも視覚的な上付き文字を保持します。
Word 本文中の手書きの図表番号（例：図2.1、図 2.1、表1.2）は、そのまま最終的な章のソースコードに持ち込んではなりません。エージェントは対応する図表ブロックを確認し、図表に安定した label を書き込み、本文を 図~\ref{...} または 表~\ref{...} に書き換える必要があります。確認できない場合はプロセス B をブロックします。
通常の本文中の ASCII 二重引用符は LaTeX の左右引用符 ``...'' に変換する必要があります。中国語のスマート引用符はデフォルトで保持します。生の LaTeX、画像パス、引用コマンド、数式には本文引用符変換を適用してはなりません。
英語要約または英語キーワードが欠落している場合、ユーザーに選択させる必要があります：空欄の確認、手動提供、または生成の許可。デフォルトで空欄にしたり、中国語から自動的に補完してはなりません。ユーザーが生成を許可した場合、まずこれが内容的な補完であることを説明し、メタデータにその許可を記録する必要があります。
chapters/basicinfo.tex を生成する際には、グローバルな \hypersetup{hidelinks,pdfborder={0 0 0},pdfborderstyle={/S/U/W 0}} を書き込み、図表参照や URL が PDF でカラーリンク枠を表示しないようにする必要があります。
表はデフォルトでテンプレートスタイルのフォントサイズ \zihao{5} を使用します。\resizebox{\textwidth}{!}{...} を無条件に使用してはなりません。これは狭い表を拡大しフォントサイズを破壊するためです。
表の自然な幅が実際に版面を超え、かつより安全な列幅の解決策がない場合にのみ、表を縮小することが許可されます。版面を埋めるために表を拡大することは禁止します。
脚注、注釈、数式、ハイパーリンク、コメント、変更履歴、テキストボックス、ヘッダー/フッターなど、自動変換されないコンテンツは unsupported_features に記録し、黙って無視してはなりません。

詳細リファレンス

プロセス A を実行する前に、references/flow-a-gatekeeping.md を読んでください。
環境の判断や修復を行う前に、references/environment-sop.md を読んでください。
プラットフォームのコマンド、インストールの詳細、PATH の修正、TeX パッケージの追加インストールが必要な場合にのみ、references/environment-setup-and-repair.md を読んでください。
プロセス B の抽出またはレンダリングを行う前に、references/flow-b-conversion.md を読んでください。
プロセス C のコンパイルまたは QA を行う前に、references/flow-c-export-and-qa.md を読んでください。
thesis.json を手動で編集する前に、references/thesis-json-schema.md を読んでください。

ユーザーフィードバック

非技術ユーザーはまずレポートを開く必要はありません。最初に対話で以下を提供します：

ゲートがどこで詰まっているか。
なぜ続行すると安全でないのか。
エージェントが自動で修復できること。
どの操作にユーザーの承認やファイル提供が必要か。

技術ユーザーが詳細を必要とする場合にのみ、レポートのパスを補足します。

ZUFE 论文排版助手