work-with-overleaf

Overleaf での作業

多くの研究者は .tex ファイルをディスク上ではなく Overleaf に保存しています。そのため、このスキルでは Overleaf のプロジェクトをローカルの作業コピーに取り込み、ツールキットのほかの機能（preflight-check、polish-prose、verify-citations、match-style など）で作業できるようにしてから、変更を同期し直します。これは最初の足がかりであり、実作業はほかのスキルが担います。

アカウントに合った方法を選ぶ

Overleaf では、プロジェクトを取り込んだり戻したりする方法が 3 つあります。アカウントの機能やメニュー名は変わることがあるため、利用する前に Overleaf の最新ドキュメントで、現在の方法とプレミアム機能かどうかを再確認してください。最後に確認した時点では、次のとおりです。

方法	対象	手順
Git integration（推奨）	Premium / Server Pro 4.0+	Project → Menu → Git を選択し、git clone https://git.overleaf.com/<id> コマンドをコピーします。Overleaf token（トークンベースの認証）で認証します。ローカルで作業してから、git pull / git push を実行します。ブランチは main です（古いクローンでは master の場合があります）。
GitHub synchronization	Premium	プロジェクトを GitHub リポジトリにリンクします（Menu → GitHub）。双方向に同期できます。すでにローカルにある GitHub クローンでスキルを実行します。
Download ZIP	Free（全員）	Menu → Download → Source を選択します。ローカルで作業します。自動マージはありません。変更したファイルを Overleaf エディターに再アップロードするか、編集内容を貼り付けてください。1 回限りのチェックに最適です。

ユーザーがどの方法を利用できるか分からない場合は、確認してください。プレミアムだと決めつけないでください。

手順

1. ローカルコピーを用意します。 上記から該当する方法を判断し、プロジェクトをローカルに取り込みます（クローンを作成する、既存の GitHub クローンを使う、またはダウンロードした ZIP を展開します）。メインの .tex と .bib があることを確認します。
2. 依頼されたスキルをローカルファイルに対して通常どおり実行します。 査読前却下のリスクには preflight-check、文章の推敲には polish-prose / match-style、.bib には verify-citations、論文全体の精読には assess-paper を使います。出力先は paper-workspace/ にします。
3. 同期前に変更を確認します。 変更内容の diff を著者に提示します。自動で push してはいけません。学術論文の草稿は共同執筆者と共有されており、未確認の push によって共同執筆者の編集内容が上書きされるおそれがあります。
4. 同じ方法で変更を同期します。Git integration では git push、GitHub synchronization ではリンク済みの GitHub リポジトリに commit と push を行うか、ZIP では再アップロードするファイルを著者に正確に伝えます。Git / GitHub では先に確認を取り、マージ競合があれば無理に解決せずに提示します。
5. コンパイルを確認します。 Overleaf はサーバー側でコンパイルするため、ローカルでの編集に使ったパッケージやオプションによっては、Overleaf の TeX Live バージョンと異なる場合があることを伝えます。PDF を信頼する前に、著者が Overleaf で再コンパイルするよう注意を促してください。

安全策

• Overleaf token は秘密情報です。 表示、ログへの記録、ファイルへの書き込み、コミットは絶対にしないでください。クローン URL にトークンが含まれている場合は、出力時に伏せてください。
• 明示的な確認なしに自動で push またはアップロードしてはいけません。Overleaf プロジェクトの履歴を書き換えることも絶対にしないでください。共同執筆者が同時に編集している可能性があります。
• プレミアムだと決めつけないでください。 Git / GitHub を使う方法はプレミアム機能です。ユーザーが Overleaf の無料プランを利用している場合は ZIP を使い、その旨を伝えてください。
• 指示する前に、Overleaf の最新ドキュメントで現在の方法（プレミアム機能かどうか、メニューの手順、クローン先のホスト、ブランチ名）を再確認してください。保存済みの古い手順に頼らないでください。
• コパイロットとして行動し、オートパイロットにはならないでください。同期を提案し、diff を提示して、実行は著者に任せてください。

メモリ

共有の .paper-memory/ 規約を使用します（paper-memory-convention.md）。

• 開始時： profile.yml / lessons.md を読み、著者が普段使っている Overleaf の方法を確認します。毎回聞き直す必要はありません。
• 終了時： 重複を取り除いてから、date · work-with-overleaf · path used · note を追記します（例：「著者は Git integration を使用し、トークンはキーチェーンに保存している」）。
• 必要に応じて .paper-memory/ を作成します。ローカルのみで使用し、アップロードはしません。トークンは保存しないでください。