Oleafly でアシスタントと作業する

モデルまたは CLI エージェントを接続し、承認ルールを設定し、検証できる課題を与える。

Oleafly でアシスタントと作業する

役に立つ依頼は、アシスタントに確認できる結果を与えます。たとえば「このプロジェクトの未定義の引用を直し、コンパイルして、まだ足りないキーを報告して」と頼んでみましょう。Oleafly は、アシスタントにプロジェクトのファイル、参考文献ツール、コンパイラのログ、PDF の検査へのアクセスを与えるので、作業は提案されたスニペットで終わらず、先へ進められます。

使うアシスタントを接続する

設定 → AI アシスタントを開きます。プロバイダとキーで、ホスト型のプロバイダ、OpenAI 互換のカスタムエンドポイント、または Ollama を設定します。ローカルのモデルを使うなら、Ollama を起動して使いたいモデルをダウンロードし、そのローカルサーバーに接続します。モデルとプロジェクトの依存関係をダウンロードし終えれば、この構成はオフラインでも使えます。

CLI エージェントを選んで、Claude Code や Codex などインストール済みのエージェントを設定することもできます。これらは、それぞれ独自のアカウントと認証を使います。アシスタントに戻り、Oleafly エージェントまたは CLI エージェントを選んでから、会話で使うランタイムとモデルを選択します。具体的な手順は、プロバイダの設定、CLI エージェント、Ollama を参照してください。

承認モードを設定する

承認の選択欄は、チャットのメッセージ入力欄の下にあり、プロジェクトごとに保存されます。

モード使う場面
承認を求める読み取りに分類されるツールは実行させ、それ以外の操作は先に確認する。
自動で承認する読み取りとネットワークのツールは許可し、ファイルの変更とシェルコマンドは引き続き先に確認する。
フルアクセスツールの操作を、承認の確認なしで実行させる。
カスタム保存した許可・拒否のルールを適用し、一致しないツールには標準のリスクポリシーを適用する。

最初の編集セッションでは、承認を求めるを選びましょう。各承認カードでは、受け入れる前にツールの操作内容を読んでください。選択した範囲の編集には、インライン編集を使うと、確認しやすい形で置き換え案が示されます。承認の操作は選択したランタイムによって異なり、CLI エージェントには独自の設定もあります。

指示と承認では、プロジェクトのルール、approvals.toml、そのほかの設定ファイルを説明しています。指示は作業の方向を導き、承認モードはアシスタントが実行してよいことを制御します。

十分な文脈を与える

関連する章、参考文献、図、データはプロジェクトの中に置いておきます。コンテキストを追加を使って、依頼に関係する資料をアシスタントに示します。記法や文体の好みについては、設定 → AI アシスタント → 指示にカスタム指示として保存できます。

プリアンブルの記法マクロは変えないこと。引用キーは変更しないこと。LaTeX を編集したらコンパイルし、影響を受けた PDF のページを確認すること。確認できなかったことはすべて報告すること。

スキルは、文献検索、図、レビューなど、繰り返し行う作業のために再利用できるワークフローを提供します。アシスタントのスキルカードかスラッシュメニューから 1 つ選び、そこに質問と必要な出力を加えてください。

結果を確認できる形にする

ビルドの修復なら、失敗しているファイルを指定し、コンパイルの成功を求めます。図なら、データ、寸法、ラベル、出力先を指定します。文献検索なら、タイトル、出典のリンク、それぞれの論文がそのレビューに入る理由の短い説明を求めます。

特定のセクションを頼むなら、次のような依頼になります。

序論の最初の 2 段落を、分かりやすくなるよう推敲して。主張、記法、引用キーは変えないこと。プロジェクトをコンパイルし、修正した文章が PDF に反映されているか確認すること。変更点を一覧にすること。

結果は、依頼と照らし合わせて読んでください。ビルドが成功したことは、文書がコンパイルできることを確かめるだけで、科学的な主張や引用が正しいことまでは保証しません。

長い作業には調査タスクを使う

リサーチワークスペース → タスク → 新規タスクを開きます。タイトルを付け、指示を書き、利用できるエージェントとモデルを選びます。タスクを作成したら、開始します。エージェントは分離したコピーの中で作業するので、あなたは執筆を続けられます。

たとえば、関連する論文 5 本、検証済みの識別子、各論文の関連性についての 1 段落をまとめた reading-list.md を作るよう頼んでみましょう。経過を追い、確認でファイルのプレビューを開き、準備ができたら選んだ結果を適用します。文献の総ざらい、独立したレビュー、原稿に取り込む前に中身を確かめたい図の実験に便利です。

調査タスクのガイドでは、タスクの開始、停止、確認、適用、削除を説明しています。

役に立つバージョンを残す

保存したチェックポイントと Git には、それぞれ別の役割があります。コンパイルが成功したあと、ソースが変更されていてビルドが対象になる場合、Oleafly はチェックポイントを保存できます。バージョン管理 → 保存したチェックポイントを開くと、確認や復元ができます。Git で意図的にコミットし、共同作業者と共有するには、ソース管理を使います。

チェックポイントは、AI による編集のたびに自動で作られるわけではありません。大きな改訂の前には、現在の下書きをコンパイルしてチェックポイントがあることを確かめるか、Git のコミットを作ってください。チェックポイントと Git の履歴を参照してください。

人 + モデル に戻る