メインコンテンツへスキップ
見出し画像

REALITYでClineを導入しました ~活躍する領域と工夫~

    サーバーエンジニアのうすぎぬです。本記事ではREALITYのエンジニアリングチームで「Cline」の利用を開始した話を紹介します。

    画像

    Clineとは

    Clineは、AIを活用した開発者支援ツールで、VSCodeなどのソースコードエディタ上で動作します。「コードの修正」「プロジェクトの構造解析」「タスクの自動化」など、多岐にわたる作業をサポートしてくれます。普段からVSCodeを利用しているエンジニアにとっては、手軽に導入できる拡張機能として魅力的です。

    AIモデルは複数選択可能ですが、2025年4月現在はコーディングに適しているとされるClaude 3.7 SonnetをREALITYでも採用しています。REALITYでは普段の開発にGoogle Cloudを利用していることもあり、Vertex AI経由でClaude 3.7 Sonnet利用しています。(昨今のLLM界隈の隆盛を見るに、来月には別のモデルを使っているかもしれませんね。)

    Clineの特徴

    Clineの最大の魅力は「ターミナル操作」「ファイル作成・編集」「差分管理」などを自動で行ってくれる点にあります。これまで、手元のコードをChatGPT等のLLMサービスにコピーして修正を依頼し、その出力をエディタに貼り付けて動作確認をする、といった作業をしたことがある方も多いと思いますが、Clineはそのプロセスを自動化します。たとえば「この関数のユニットテストを書いて」と一言依頼するだけで、対象ファイルを読み取り、テストコードを生成・実行し、テストが失敗した場合には修正まで行ってくれます。

    次の動画は「reality_sample.goのメソッドのユニットテストを作成して」と一言お願いしたときの動作です。完全に手放しでテストケースが実装されています。

    画像

    Clineの活用事例

    REALITYでは、まずサーバーチームからClineの利用を開始しました。サーバーチームは、Go言語やNode.js/TypeScriptを用いたサーバーアプリケーションおよびウェブフロントエンドの開発を担当しており、元よりVSCode利用者が多かったため導入は非常にスムーズでした。

    現在、Clineが大活躍している領域:
    ・社内ツールのUI作成
    ・CI/CDツールの作成
    ・サーバーアプリケーションコードのユニットテスト作成
    ・その他、アドホックなツールの作成

    人間が慎重にチェックしながら活用している領域:
    ・社内ツールのロジック作成
    ・サーバーアプリケーションコードのリファクタリング
    ・サーバーアプリケーションのビジネスロジック等のコードの生成

    まだClineに任せるのが難しい領域:
    ・機能開発の仕様書のレビュー等のハイコンテキストな業務
    ・機能開発などで必要なアプリケーション・データモデルの設計
    ・機能開発の効果分析等の定型化しづらい業務
    ・ミドルウェアや外部API等を駆使した処理系の実装

    現状、事業上のリスクが低い部分、REALITY特有の作業が少なく定型的な作業に落とし込みやすい部分については、積極的にClineを活用しています。また、iOS、Android、Unity等の他の技術領域については、エディタの制約もあり、部分的に利用するか、別のアプローチを模索中です。

    ちなみに、今年のエイプリルフール企画では、短期間の開発にもかかわらずClineの支援もあり多数の機能をリリースできました。早速、Clineが大いに活躍した例になりました。

    ◤◢◤◢◤◢◤◢◤◢◤◢
    ブラウザ版REALITY解禁
    ◤◢◤◢◤◢◤◢◤◢◤◢
    4/1 0:00 ~約1週間 🎉
    ブラウザでREALITYがお楽しみいただけます!
    推しを大画面で見ちゃおう👀✨️
    ▼視聴はコチラhttps://t.co/PeyrHFQqaU
    ▼機能詳細https://t.co/9w7s0AQ2t5#REALITYエイプリルフール pic.twitter.com/GvvyDIedV9

    — REALITY 公式 (@REALITY_app) March 31, 2025

    .clinerulesについて

    さて、冒頭にはClineにユニットテストの生成をお願いした動画を掲載しましたが、実は最初はここまでスムーズにユニットテストを生成してくれるわけではなく、.clinerulesをそれなりに整備したことによりこのような動作を実現できています。

    REALITYのサーバーチームでは、コーディング、テスト、レビューの各ガイドラインが整備され、これらのルールを.clinerulesに保存することで、概ねガイドライン通りのテストが生成されるようになりました。.clinerulesには、プロジェクトのディレクトリ構成や、Clineに実行してほしくないことなども記述しています。

    効果が大きかったものを一部を紹介します。

    プロジェクト構成

    プロジェクトのディレクトリ構成を.clinerulesに記述することで、Clineが周辺のファイルを検索する回数が減り、より迅速かつ正確な修正が可能になりました。プロジェクトのディレクトリ構成は次のようにtree形式で与えています。さらに、サーバーごとの詳細な構成を追加で与えています。

    ## プロジェクト構成
    
    プロジェクトは次のコンポーネントで構成されています。
    ```
    .
    ├── Makefile                  # リポジトリ全体に関係するmakeコマンドを記述する
    ├── github                    # GitHub Actionsの設定ファイルを管理するためのディレクトリ
    │   └── workflows             # GitHub Actionsのワークフロー設定ファイルを管理するためのディレクトリ
    │       └── ...
    ├── go                        # Goのコードを管理するディレクトリ
    │   ├── Makefile              # go/lib,go/servers全体実行するmakeコマンドを記述する
    │   ├── lib                   # Goのserverで使う共通ライブラリを管理するためのディレクトリ
    │   │   ├── Makefile          # go/lib全体実行するmakeコマンドを記述する
    │   │   └── common            # 全サーバーから利用する共通ライブラリ
    │   │       └── ...
    │   └── services              # goのserverごとのコードを配置するディレクトリ
    │       ├── Makefile          # go/services全体実行するmakeコマンドを記述する
    │       ├── gateway           # アプリからのリクエストを全て受け付けるGatewayサーバーのソースコード
    │       │   └── ...
    │       ├── media             # 配信等のAPIを提供するサーバーのソースコード
    │       │   └── ...
    │       └── user              # ユーザー等のAPIを提供するソースコード
    │           └── ...
    └── tools                     # 各種toolの置き場
        └── ...
    ```

    コーディングガイドライン

    .clinerulesには、一般的なコーディングルールに加え、REALITY特有の書き方も記述されています。たとえば、命名規則、レイヤーごとの実装方針、バリデーションの注意点、ユニットテストのガイドラインなど、数百行にわたる詳細なルールが盛り込まれています。(将来的にはClineに要約してもらう予定です。)

    # コーディングガイドライン
    
    REALITY のサーバーコードを書く際に知っておくべきことや、守ってほしいガイドラインをまとめています。
    
    ## Code Formatter
    
    GoにはいくつかのFormatterコマンドが存在しますが、REALITYでは `goimports` でコードをフォーマットしています。
    
    ## スライスの初期化
    
    スライスは `append` する際に容量が足りないとアロケーションが発生するため、必要となる最大数があらかじめ分かっている場合は `make` の第3引数で指定します。
    
    ```go
    // Bad
    userIDs := []string{}
    for _, user := range users {
      userIDs = append(userIDs, user.ID)
    }
    ```
    
    ```go
    // Good
    userIDs := make([]string, 0, len(users))
    for _, user := range users {
      userIDs = append(userIDs, user.ID)
    }
    ```
    
    .
    .
    .

    その他

    公開されている.clinerulesの設定例から、良さそうだったものを取り入れています。
    ・コードを書く上でのエージェントのロール設定
    ・技術スタック
    ・ワークフローでの注意
    ・ブランチルール
    ・典型的なWebAPI実装のフロー
    ・典型的なテスト追加のフロー
    ・機密ファイル他セキュリティ対策等
    ・…

    Clineを利用したメンバーの感想

    実際にClineを利用しているメンバーの声を集めました。

    【ポジティブ】 ユニットテストを正確で迅速に作成できる

    Clineはユニットテスト・テストケースを自動で生成・実行し、必要に応じて修正まで行ってくれます。ChatGPTでは、テスト作成後に手元で実行するとコケることもありましたが、Clineはテストが通るまで修正を続け、お願いすれば抜け漏れのないテストを作成してくれます。ただし、当然元の関数に誤りがある場合もあるため、人間によるコードレビューは欠かせません。将来的には、お願いしなくとも処理の違和感を検知して教えてくれると嬉しいですね。

    【ポジティブ】 アドホックなツール作成が非常に楽に

    Google Apps ScriptやCloud Functionで動作する小規模ツールの作成ハードルが大幅に下がりました。そのうち、ある程度定型的な社内ツールの作成等も、ほぼClineに任せられるようになる可能性があります。

    【ネガティブ】 しばしばoverloaded_errorが発生する

    Claude 3.7 SonnetのAPIエラーにより、「overloaded_error」が発生することがあります。REALITYでは、一時的にClaude 3.5 Sonnet v2やGemini 2.5 proを利用しこの問題を回避しています。体感では編集するファイルの行数が1000行を越えると、「overloaded_error」を見る頻度が高まるような気はします。

    529 - overloaded_error: AnthropicのAPIが一時的に過負荷状態です。

    https://docs.anthropic.com/ja/api/errors

    【ネガティブ】 REALITY特有の書き方やミドルウェアの使い方に対応できない

    ある程度は.clinerulesを整備することで解決可能ですが、限界はあります。今後、コンテキストウィンドウ(モデルが一度に処理できるトークン数)が大きくなれば、ソースコードの一部をそのまま食わせて解決できるかもしれないなあと妄想しつつ、現時点では全てのケースを網羅することは難しく、対応できない領域があることは否めません。

    また、Clineには過去の作業内容や技術情報を記録し、リセット後でも正確な開発文脈を再現するMemory Bankという機能が提供されており、これによりある程度解決できるか手元で試しています。チームメンバーと共有可能になると良いのですが。。。

    【ネガティブ】 ローカルでのコマンド実行等で動作が止まったり、同じ動作を繰り返したりしてしまうことがある

    REALITY特有のツールや環境起因の問題もあります。大抵はプロンプトを改善するなどして回避できるため、よく踏むパターンは.clinerulesに手順を記述して回避できるようにしています。しかし、どうしても回避できないパターンもポツポツある印象です。

    【ネガティブ?】 コード生成のスピードが早まり、コードレビューのコストが高まった

    事業目線ではアウトプットの速度が高まっており、ポジティブな効果だと言えます。やろうと思えば、現在テストコードのない関数全てにテストコードを書いて!などとお願いはできますが、レビュワーへの気遣いは大事です。

    まとめ

    REALITYのエンジニアリングチームで、Clineの利用を開始しました。Clineは数多くの領域で大いに活躍しているものの、すべてを完全に任せられるわけではなく、難易度の高い部分については.clinerulesやMemoryBankなどの補助ツールを活用し、精度向上に努めています。また、社内向けMCPの開発も視野に入れ、現状の環境でどこまでコーディングエージェントにタスクを委任できるか、その限界と可能性を模索中です。

    一方、Clineは開発プロセスの自動化によって効率化を実現する反面、コードレビューなど人間の判断が必要な部分とのバランスを取る必要があるツールです。さらに、日々新機能が追加され、開発が進む環境下では、ツールの運用方法すら1ヶ月後には大きく変わっている可能性があります。今後の進化に大いに期待しながら、変化の激しい環境を引き続き注視していきます。

    さて、そんなREALITYでは現在エンジニアを募集しています。REALITYのアプリ開発にご興味をお持ちの方は、以下のリンクよりぜひご応募ください。


     
     
    REALITY株式会社は"なりたい自分で、生きていく。"をビジョンに掲げ、バーチャルライブ配信アプリ「REALITY」の運営やバーチャルライブ制作などのライブエンターテインメント事業を展開しています。 https://reality.inc/