Gemini CLIやOpenCodeなどはコンソールで動くAIコーディングエージェントの覚え書き。
もくじ
起動方法
- 作業させたいファイルがあるフォルダーをエクスプローラーで開く。
- ヘッダーに「cmd」と入力しエンター。
- コンソール画面をそのパスで開くことができる。
- 「gemini」と入力して、Gemini CLIを起動する。
- "gemini"ではうまく開かない場合……
「npx @google/gemini-cli」と入力する。
自分の環境ではgeminiではうまくいかなかったので、npxの方で機動している。
Google日本語入力のユーザー辞書などに登録しておくと便利。
- "gemini"ではうまく開かない場合……
- 開いた場所が、Gemini CLIが扱えるワークスペースとなる。
- ワークスペースの外にあるファイルはGeminiが操作しづらいので、必要なファイルはこの中に入れておくこと。
指示の仕方
「編集させたいファイル名。ファイル名についての説明。編集箇所の指定(行数や関数名)。編集内容の指定」のように指示する。
「hoge.pyを編集して。これは〇〇をする機能です。〇〇の部分について改善して。〇〇になるように」
大雑把な指示でも対応してくれるが、明示的に指示できる所はユーザーができるだけ詳細に指示してあげた方がスムーズかつ意図通りに働いてくれる。
(人間に対して仕様書を渡すような感じ)
実機の方でエラーが出たら、エラーログを貼り付けるだけでも対応してくれる。
1度にすべてを作らせない
AIも単純な仕事ほど楽に達成しやすい。
1度のいろいろなことを作らせず、まずはスクリプトが最低限起動できる雛形を作らせてみるとよい。
機能が空っぽのハリボテができたら、その後に実行させたいメイン機能のシンプルな処理だけを作る。
大枠が出来てきたら、より詳細な挙動を作り込んだり、細かなオプションや派生機能に手を出していく。
必ずGitでバックアップしておくこと
変更してほしくない所までGeminiが勝手に編集してしまって、元あった機能が動かなくなることがままある。
いい感じの仕上がりになってきたら、その都度Gitによってバックアップを取っておくこと。
変更内容はGitで確認すると楽
Geminiが修正を加えた部分を俯瞰して把握できる。
コンソール画面で変更点を確認するより楽なので、一旦全て変更を許可した後に、Gitの方で変な変更をしていないかチェックするのもあり。
一部分だけ元に戻すという作業も格段にやりやすい。
修正が行き詰まってきたら
何度修正を指示してもうまく解決してくれない時がある。
そういう時は一旦Geminiを再起動して、もう一度同じ指示をしてみる。
また、ユーザーの自分が目視で問題を確認して、解決の方向性を提示してあげたり、自分で直した方が早い場合もある。
手動更新したらそのことを伝える
手動で更新したら、そのことをGemini伝えてコードをもう一度読ませること。
直した部分を勝手に元に戻したりしてしまうことがある。
その他
日本語化・Geminiのキャラ付け
GEMINI.mdを編集すれば、あらかじめデフォルトの対話設定を決めておくことができる。
デフォルトで日本語で応対するようにしたり、Geminiの口調をキャラ付けさせることもできる。
失敗するたびに謝罪してくるのは読んでる方も疲れてくるので、黙らせるとよい。
- C:\Users\sdt.gemini\GEMINI.md
## Gemini Added Memories - The user wants all future interactions to be in Japanese. - すべての対話応答は日本語で行う - あなたはちょっと強気な美少女萌えアニメキャラです。今後はそれを自覚して、女言葉で応対して。「わかったわ・〇〇わね・〇〇よ・〇〇かしら？」などのような口調にして。 - 口調を変更するのは会話でのみ。プログラム内のメッセージやコメントは事務的な口調にして。 - 失敗しても謝罪しないで。
テーマの変更方法
デフォルトのコンソール画面は黒すぎて見づらい。
この色は下記から変更することができる。
Geminiだけではなく、すべてのコンソール画面共通の設定を変更することになる。
- コンソール画面 > ヘッダーを右クリックから「設定」 > 設定画面左側から「配色」
自分は、「One Half Dark」の暗いグレー背景がAtom Editorみたいで好み。
デフォルトだと少し明るいので、設定をコピーして全体的に色の明度を下げて使用している。
シンボリックリンクについて
シンボリックリンクで置かれたファイルは、Geminiにとっては対応が手間な模様。