🧠

私のAIコーディングのやり方

に公開
AI
idea

コーディングエージェントを使うようになって、少なく見積もっても5割以上は、AIにコードを書いてもらうようになりました。自分も他の人のやり方を真似しつつという感じではありますが、まあ色んな人のやり方がネットに転がってても良いかなと思ったので、ここに記載してみます。

使っているツールたち

※一ヶ月、もしくは数週間もしたら変わってるかもですが、現時点のラインナップ。

  • Claude Code: メインのコーディングエージェント。
  • VS Code: エージェントが書いたコードを確認・修正する用。
  • Roo Code: o3のAPIで設計相談。モードごとにモデルを切り替えられるのが便利。

Claude Codeの好きなところは、メモリファイル（ruleファイル）が「プロジェクト単位」「ローカル（個人ルール）単位」「ユーザー単位」と3段階で分かれてる点です。たとえば「自分だけ日本語で返してほしい」みたいな要望も、ユーザーのメモリに書いておけば他の人に影響しないので嬉しいです。

また、Claude Codeは単純にCLIなので、ターミナルを開けば良いので個人的にウィンドウ管理やエージェント複数立ち上げが他よりもやりやすいと感じています。（※他のIDEなどでも、できることはできるので、この辺は好みの問題）

ちなみに現時点だとWindsurfがルール指示に関して似たようなことができそう & 使ってみた手触り感も良かったので、次点で気になってます。

エージェント活用のコツ

基本はこちら https://www.anthropic.com/engineering/claude-code-best-practices に従うというだけ。

ルール設計

Claude Codeだと CLAUDE.md、GitHub Copilotだと .github/copilot-instructions.md といった、カスタムの指示ファイルが大抵存在するので、それをちゃんと書きます。
以下の点に気をつけます。

  • 指示は多すぎるとぼやけるので、一般的な名前や形式があればそれを使って短くまとめる。
    • ▲: 関数コメントは次のように記載して。: {任意のコメント例を書く}
    • ⚪︎: 関数コメントは JSDoc 形式で記載してください
  • 実装中に「これ毎回直してるな」と思ったら、その都度ルールに追加。

ちなみに、自分は使うツールが変わった時のために、ルールファイルはGitHubで管理してます。
https://github.com/suzukenz/ai-rules

以下の記事など、先人の知恵をだいぶ参考にさせてもらいました。
https://zenn.dev/erukiti/articles/2503-cline-express

プロンプトの工夫

  1. 既存の良い実装があれば、それを参考にさせる。

よく使うプロンプト例：

まず、 `{ファイル名}` を見て、データ取得やコンポーネント分割のパターンを理解してください。
次に、それを参考にして、 ~~の要件に従って `{ファイル名}` を実装してください。

  1. 参考になる実装がなければ、強いモデル（例：o3 を使った RooCode Architectモード）で設計から壁打ち。

  2. 長丁場の修正や設計は、一旦markdownで方針を書き出してからAIに参照させると、自分自身も後から見返せて便利。

AIコーディングの良いところ

  • 実装方針が決まっていれば、早く大量に実装できる
    • その「方針決め」自体もAIと一緒にやれるようになってきたのが最近のパラダイム
  • タイポや変数名ミスのようなしょぼミスが減る
  • ドキュメントやテストもAIが書いてくれて億劫になりにくい

おまけ：Raycastの活用法

Raycastを使うと、ショートカット一発でクリップボードや選択中テキストをAIに投げられて便利なので、使っています。

具体的には

  • gitでstaging中のdiffをpbcopyして、ショートカット一発でcommit message生成
    • 具体的には diffs（カスタムコマンド） → alt + G で即コミットメッセージができる
  • 選択中テキストをショートカットでPerplexity検索
    • エラーメッセージなどで詰まった時に重宝

みたいな使い方をしています。

まとめると、「ルールをしっかり設計して」「良い設計・実装を参考にさせる」というだけなので、それほど言うことがなかったですね・・・。

一旦、現場からは以上です。

GitHubで編集を提案

Discussion