ローカルAIコーディングエージェント: コードに触らせる前に安全なOdysseus AIワークフローを作る

目的から始める: 自律メンテナーではなくコーディング支援

ローカルAIコーディングエージェントは、コード理解、変更計画、パッチ作成、結果確認を助けるためのものです。最初から無制限のシェル権限や未レビューのファイル変更を与えるべきではありません。

Odysseus AIはセルフホストの作業レイヤーとして使えます。会話、ファイル、設定、文脈をまとめ、OllamaなどのOpenAI互換エンドポイントはモデル実行レイヤーとして分けておきます。

重要な境界は、モデルは変更を提案できるが、ファイルを書き込む時、コマンドを実行する時、コミットを公開する時はワークフロー側が決めるという点です。

ローカルAIコーディングエージェントの構成

モデル実行、ワークスペース、リポジトリ境界、実行レイヤーの四つに分けて考えます。混同すると問題が起きます。

きれいに分けると、リポジトリの方針を変えずにモデルを差し替えられ、Odysseus AIを作業面として安全に試せます。

コードを接続する前のチェックリスト

最も重要な非公開リポジトリから始めないでください。小さなプロジェクトでモデル品質、パス、コマンド、権限の挙動を確認します。

このチェックリストは特定UIではなく境界を守るためのものなので、保守的に作っています。

• ダッシュボードを開く前に、簡単なプロンプトでモデルエンドポイントを確認します。
• 専用の作業フォルダを作り、ユーザーディレクトリ全体を渡さないようにします。
• .env、APIキー、DBダンプ、非公開ログを最初の文脈から外します。
• 初期設定ではダッシュボードとモデルをlocalhostに保ちます。
• チャット、アップロード、埋め込み、設定の保存場所を確認します。
• 変更を依頼する前にGitの状態がきれいか確認します。
• 通常のテストとフォーマッタを一度手で実行し、基準を知っておきます。

モデルサイズより権限ゲートが重要

大きなモデルは良いパッチを出せますが、被害範囲を決めるのは権限です。自由なターミナルはインストール、削除、情報露出につながります。

読み取り、書き込み、実行、Gitを分けます。読み取りから始め、書き込みとコマンドは見える形で承認します。

エージェントを役立てる日常ワークフロー

小さな目的、調査、計画、限定編集、検証、diffレビューという退屈な流れが最も強力です。

Odysseus AIは文脈、メモ、モデルルーティングに使い、コマンドは制御された実行レイヤーで扱います。

1. State the change boundary

   Name the feature, bug, or file area. Avoid broad prompts like 'clean up the repo' until the agent has proven itself.

2. Let the agent inspect before editing

   Ask for existing patterns, routes, tests, and build commands. Good coding assistance starts with context.

3. Approve a narrow edit

   Small patches are easier to review and revert. Keep unrelated refactors out of the first pass.

4. Run targeted checks

   Use the project's real build, tests, linters, or browser checks. Do not accept a patch that was never exercised.

5. Review Git status before publishing

   Generated files, caches, profiles, and build artifacts need explicit handling. Commit only what belongs to the task.

ローカルAIコードエージェントのよくある失敗

多くの失敗は早すぎる広い権限から生まれます。既知のプロジェクト、既知のコマンド、見えるdiffの中で使うほど安全です。