chinese-thesis-workbench

中国語論文ワークベンチ

運用モデル

標準とエビデンスを制御レイヤーとして使用し、中国語論文の執筆パイプラインを出力レイヤーとして使用します。学校のテンプレート、指導教員の要件、課題書、参考論文、ソースコード、データベース、API、テスト、文献 PDF、スクリーンショット、Word のコメント、既存の草稿は、正式な文章を書く前に構造化された状態へ整理する必要がある資料として扱います。

ワークベンチは次の 2 つの側面で構成されます。

• ガバナンス側：paper-context/ には、ワークフローの状態、標準、エビデンス、文献、AIGC レポート、Word コメントの修正内容を保存します。
• 成果物側：paper-output/ には、論文の Markdown、DOCX、付録 DOCX、図、スクリーンショット、画像マップ、参考文献の検証成果物を保存します。
• ユーザー向けの可視化と意思決定側：paper-context/workflow/user-dashboard.md には、現在の進捗、不足している資料、ユーザーの判断が必要な事項、次に推奨されるアクションをまとめます。paper-context/workflow/content-decisions.md には、候補となる内容を利用できる場合に、任意の内容の重点化や除外に関する決定を記録します。paper-context/workflow/blocker-report.md には、最新の阻害要因、選択肢、推奨案、限定的な続行が可能かどうかを記録します。paper-context/workflow/user-decisions.md には、範囲、エビデンス、標準、アウトライン、成果物、制限に影響する、ユーザーが承認した選択を記録します。これらのファイルは透明性を高めるためのものであり、標準、エビデンス、成果物の品質ゲートに優先するものではありません。

必須ワークフロー

ユーザーが限定的な確認や修正のみを依頼している場合を除き、次の順序でワークフローを実行します。

1. intake_materials：資料を収集し、優先度、不足事項、不足による影響、続行の制限、ユーザーが次に行うべきことを paper-context/workflow/material-inventory.md に記録します。
2. init_workspace：thesis-ai-standard/、paper-context/、ワークフローログを初期化します。
3. resolve_standards：thesis-ai-standard/templates/standard-profile.yaml に情報を入力します。
4. analyze_sample_and_template：学校のテンプレートと参考論文のパーサー出力を、軽量な分析レポート、アウトラインの提案、文字数の予算に正規化してから執筆します。ユーザーが --sample-analysis でサンプルスタイルの生成を明示的に選択するか、--from-template でテンプレートのコピーを埋める方法を選択しない限り、パーサー出力は DOCX の書式設定には使用しません。
5. build_evidence：プロジェクトの事実を抽出し、paper-context/evidence/ に保存します。
6. stop_and_report：エビデンス、標準、図、引用、DOCX の成果物を検証できない場合は、その影響を受ける範囲のみを停止または制限し、選択肢を blocker-report.md に記録します。
7. build_thesis_spec：thesis-ai-standard/templates/thesis-ai-spec.yaml に情報を入力します。
8. build_figure_registry：thesis-ai-standard/templates/figure-registry.yaml に情報を入力します。
9. confirm_outline：執筆前に、章構成、文字数、サンプルやテンプレートから得られた所見、利用可能な内容の重点化や除外に関する決定を確認します。
10. draft_chapters：確認済みの構造化された事実とエビデンスのみを使用して執筆します。
11. produce_assets：図、ダイアグラム、スクリーンショット、表、付録のソースを生成または収集します。
12. produce_docx：記録された成果物作成方法を使用して、本文の DOCX と付録の DOCX を生成または編集し、paper-output/ に保存します。
13. quality_gates：標準、エビデンス、参考文献、図、DOCX、AIGC の各チェックを実行します。
14. delivery_report：出力、制限、未解決の人による判断事項、検証エビデンスを報告します。

stop_and_report はステップ 6 だけに適用されるものではなく、全体に適用されるブロック機構です。続行に推測が必要となる場合は、references/workflow/stop-and-report.md を確認してください。

フェーズ＋ステータスの状態モデル

paper-context/workflow/workflow-status.mdではこの2層の状態モデルを使用し、ユーザー向けの概要をpaper-context/workflow/user-dashboard.mdに反映します。

フィールド	許可される値
phase	intake_only, workspace_ready, standards_resolved, sample_analysis_done, evidence_built, spec_confirmed, outline_confirmed, writing_allowed, delivery_done
status	pending, in_progress, blocked, needs_review, done, deprecated

ステータスがblockedになったら、ステータスファイルにblocked_reason、missing_materials、next_action、can_continue_with_limitationsを記入します。ブロッカーをチャット内だけに留めてはいけません。

フェーズ、ブロッカー、資料、アウトライン、納品範囲に重要な変更があった場合は、user-dashboard.mdを更新して、ユーザーが以下を確認できるようにします。

• 現在のフェーズとステータス
• 完了した作業
• ユーザーの確認待ちの決定事項
• 不足している資料とその影響
• 次に推奨されるアクション
• 制限付きで作業を続行できる選択肢（ある場合）

判断ツリー

1. ワークスペースがない場合は、scripts/workspace/init_thesis_workspace.pyを実行します。
2. 学校、指導教員、テンプレートの規則が不足している場合や、内容が矛盾している場合は、まず規則を整理します。
3. サンプルやテンプレートの分析がまだの場合は、thesis-ai-spec.yamlより先に分析します。
4. 根拠資料や文献が不足している場合は、執筆前に根拠資料と参考文献の候補を整備します。
5. thesis-ai-spec.yamlの確認が完了していない場合は、正式な論文本文を執筆しません。
6. figure-registry.yamlの準備ができていない場合は、図、表、スクリーンショットが揃っていると主張しません。
7. Wordのコメントの修正を依頼された場合は、コメントを抽出してwriting_allowedに戻します。
8. 最終納品を依頼された場合は、品質ゲートを実行し、本文と付録の両方のDOCXを作成します。

厳守事項

• 学校および指導教員の要件は、既定のルールより優先されます。
• 資料が収集される前、またはユーザーが資料はもうないと明示的に確認する前に、正式な論文本文を書いてはいけません。
• 資料の受け入れ時には、資料を required、strongly_recommended、optional に分類し、必須資料または強く推奨される資料が不足した場合の影響を説明してください。
• ユーザーが機能／モジュール／実験／付録の候補を提示した場合は content-decisions.md を使用してください。ただし、候補となる内容がまだ提示されていないことだけを理由に、主要なワークフローを止めてはいけません。
• ユーザーが承認した範囲、資料が入手できないこと、制限付きでの続行、基準との矛盾、内容の除外、アウトライン、文字数、DOCX、付録、ファイル名に関する決定を user-decisions.md に記録してください。
• ユーザー向けのワークフローファイルは意思決定を支援するものに限ります。学校／指導教員の要件、証拠要件、引用の検証、図の出典確認、DOCX の納品チェックを弱めてはいけません。
• 基準、サンプル／テンプレートの分析、証拠の構築が完了する前に、正式な論文本文を書いてはいけません。
• 証拠が不十分な場合は stop_and_report を実行してください。不足している事実を推測してはいけません。
• 作業が阻まれている場合は、問題を hard_blocker、limited_continue、user_choice_needed に分類し、ユーザーに選択肢と推奨する進め方を提示してください。
• thesis-ai-spec.yaml を論文に関する事実の単一のエントリーポイントとします。
• figure-registry.yaml を図、表、スクリーンショット、図表の出典の単一のエントリーポイントとします。
• 論文の文章には、構造化された事実と証拠のみを使用してください。README ファイルや古いメモから直接内容を膨らませてはいけません。
• content-decisions.md で却下、除外、または証拠待ちとされている内容を書いてはいけません。
• 機能、フィールド、API、テスト結果、実験データ、参考文献を捏造してはいけません。
• AIGC スタイルのガバナンスは証拠の連鎖が完成した後に実施し、学術的な表現、証拠の密度、曖昧な表現の改善にのみ適用できます。
• 論文本文に AI ワークフローに関する表現を含めてはいけません。
• 第 4 章の実装は、実際のモジュール、スクリーンショット、中核となるコード、SQL、または同等の証拠に結び付ける必要があります。
• E-R 図または同等のデータ設計の証拠がないシステム設計論文は、完成と判定してはいけません。
• 本文の論文 DOCX と付録の DOCX の両方を生成してください。学校の書式指定が厳格な場合は、scripts/docx/apply_textual_edits.py --from-template を使ったテンプレートへの書き込みを優先してください。それ以外の場合は、既定の形式またはサンプルのスタイルで生成してください。テンプレートを完全に再現できると約束してはいけません。図のソース、E-R 図のソース、フローチャートのソース、および関連アセットは付録に保持してください。
• 数式の出力方法を明示してください。latex_text は数式のソーステキストを保持し、formula_image には対応する画像アセットが必要です。
• 出力ファイル名には論文のタイトルを使用してください。final、draft、paper-final、doc1 などの汎用的な名前は使用しないでください。
• 文献のワークフローは、文献プールの構築 -> 検証 -> 絞り込み -> 書式設定 -> 検証チェックリストの生成、の順に進めてください。

リソースマップ

必要な内容	リソース
インテークと迅速なワークフロー	references/workflow/intake.md、references/workflow/rapid-thesis-workflow.md
ワークフローの状態、ブロッカー、資料が不足している場合の引き継ぎ	references/workflow/workflow-state-management.md、references/workflow/stop-and-report.md、references/workflow/material-gap-handoff.md
標準とテンプレートの選定	references/standards/standards-and-template-resolution.md、references/standards/style-extraction.md、references/standards/default-style.md
エビデンスの抽出	references/evidence/source-to-thesis-workflow.md、references/evidence/fact-extraction.md
文献／PDF のワークフロー	references/evidence/literature-and-pdf-workflow.md、scripts/literature/
執筆と章の管理	references/writing/writing-pipeline.md、references/writing/chapter-patterns.md、references/writing/sample-analysis.md
AIGC スタイルのガバナンス	references/writing/aigc-style-governance.md、scripts/review/analyze_aigc_style.py
DOCX の納品と Word コメント	references/delivery/docx-delivery.md、references/delivery/word-comment-revision-workflow.md、scripts/docx/
図表とスクリーンショット	scripts/figures/、scripts/screenshots/、thesis-ai-standard/templates/figure-registry.yaml
統合の出典情報	references/merge-map.md

品質ゲート

納品物の品質を保証する前に、以下を確認してください。

• standard-profile.yaml、thesis-ai-spec.yaml、figure-registry.yaml が存在し、相互に整合している。
• すべての主要な事実の主張について、paper-context/evidence/ または検証済み文献に出典がある。
• すべての図表に source_kind、source_path、image_path、evidence_source、first_mention、status がある。
• 参考文献が実在し、検証済みの候補群から選定されており、検証チェックリストが生成されている。
• AIGC スタイルの変更によって新たな事実が追加されていない。
• メインの DOCX と付録の DOCX が paper-output/ にある。
• スクリーンショット、図、画像マップのパスが Windows 上で解決できる。
• ワークフローのログに、現在のフェーズ、状態、ブロッカー、納品上の制約が反映されている。
• user-dashboard.md に、ユーザーから見た進捗、保留中の決定事項、不足資料、次のアクションが反映されている。
• blocker-report.md に、最新のブロッカー、影響範囲、ユーザーの選択肢、推奨される対応、限定的な作業継続が可能かどうかが反映されている。
• user-decisions.md に、作業範囲、不足資料の扱い、制約、標準、アウトライン、納品に影響するユーザー承認済みの選択肢が記録されている。
• content-decisions.md に有効な候補がある場合、その承認済み／保留／除外の状態がアウトライン、論文仕様、図表レジストリと一致している。

納品要件

論文の成果物を paper-output/ 以下に納品してください。

• <论文标题>.md
• <论文标题>.docx
• <论文标题>-附件.docx
• <论文标题>-image-map.json
• <论文标题>-文献核验清单.json
• figures/
• screenshots/

検証済みの内容、検証できなかった内容、人による確認がまだ必要な内容を報告してください。検証を実行できない場合は、コマンドとその理由を明記してください。