運用中のサービス開発でCursor Agentにコードを書かせた話

2025/5/22 生成AI横断勉強会@BuySell での登壇で使用したものです

Transcript

1. 運⽤中のサービス開発でAgentにコードを書かせた話 2025/5/22 AI勉強会 @ BuySell
2. ©GROWTH VERSE Co., Ltd. 運⽤中のサービス開発でAgentにコードを書かせた話 ⾃⼰紹介
3. ©GROWTH VERSE Co., Ltd. 運⽤中のサービス開発でAgentにコードを書かせた話 AgentやAIについての驚き屋が⽇々、Xで驚き続け、もはやエンジニアは⼿を動かさなくていいみたいな説もある ⼀⽅で、個⼈開発やSandboxでの開発と実際の実務は様々な前提が異なるのでそうはいかないケースが多い 👉 Bugfixとかではなく、実際の機能開発をAgentをできるだけ活⽤してやってみたので、その際の知⾒を共有します 💡 実務でのAgent利⽤の活かし⽅や議論の⼟台になれば幸いです 今⽇話すこと、伝えたいこと
4. ©GROWTH VERSE Co., Ltd. 運⽤中のサービス開発でAgentにコードを書かせた話 1. 仕様〜実装までの開発PRJをCursorと進める際の勘所 a. AIMSTARと開発プロセス b. 仕様作成: 箇条書きからMermaidへ c. 技術設計: 仕様と実装からUMLへ d. タスク分解‧Issue化は⼈がやった⽅が良い e. 実装時のAgentの活⽤⽅針 f. オニオンアーキテクチャのbackend実装の各レイヤーとコード⽣成の相性 g. Agentへの実装指⽰のプロンプティングパターン 2. Cursorの（個⼈的）隠れ機能と使⽤感 a. rule generation b. @commit c. multi root d. custom mode e. その他 アジェンダ
5. 仕様〜実装までの開発PRJをCursorと進める際の勘所 運⽤中のサービス開発でAgentにコードを書かせた話
6. ©GROWTH VERSE Co., Ltd. 仕様〜実装までの開発PRJをCursorと進める際の勘所 AIMSTARと開発プロセス
7. ©GROWTH VERSE Co., Ltd. 仕様〜実装までの開発PRJをCursorと進める際の勘所 AIMSTARと開発プロセス プチウォーターフォールのような開発プロセス ドキュメンテーションを割とやっていくスタイル
8. ©GROWTH VERSE Co., Ltd. 仕様〜実装までの開発PRJをCursorと進める際の勘所 Goal: 何を作るのかが、⼈間とAIにわかりやすいようにまとめる Tips: ⼈間は箇条書きでまとめ、AgentでMermaidを使って⾁付けをさせる Ex: パスワードの試⾏失敗によるアカウントロックと有効化のフロー ⼈間: 箇条書きで、ユーザーと管理者の操作を時系列で書き出す Cursor: シーケンスで、⾏間を補いながらMermaidで書き出す ⼈間: Mermaidをレビュー 仕様作成: 箇条書きからMermaidへ
9. ©GROWTH VERSE Co., Ltd. 仕様〜実装までの開発PRJをCursorと進める際の勘所 Goal: システムのどこに、どんな変更を加えるのかを⼈間とAIにわかりやすくまとめる Tips: 加える変更を⼈間が考えるにあたって必要な情報をAgentに収集させる、Agentで変更が適切か検証する Ex: BackendのAPIとRDBの変更情報、仕様書から、より詳細なシーケンスを記述させ、考慮の抜け漏れを検証する 技術設計: 仕様と実装からUMLへ
10. ©GROWTH VERSE Co., Ltd. 仕様〜実装までの開発PRJをCursorと進める際の勘所 Goal: 全体の変更を数百⾏オーダーほどのタスクに分解してIssueにし、依存関係順にならべる 以下の理由でAgentとの協業は諦めたor失敗に終わった • タスクの依存関係をプロンプトのcontextに含めるのが困難 • Issueのdescriptionを丁寧に書かせてみたが、、結局実装の際に参照させることはなかった └ NotionやObsidianにcontextは集約させるのが無難 タスク分解‧Issue化は⼈がやった⽅が良い
11. ©GROWTH VERSE Co., Ltd. 仕様〜実装までの開発PRJをCursorと進める際の勘所 実装時のAgentの活⽤⽅針 AIに指⽰を出してペアプロをさせるイメージで⼤きすぎないcontextで細かに指⽰を与える。極⼒でテストも実装させて⼈間がFBしやすい状態のアウ トプットを出させる オライリーの「Beyond Vibe Coding」に記載の、AI Assisted Codingの３つの部類のうち、「ペアプロ」に該当するやり⽅ Osmani, A. (2025) Beyond Vibe Coding. O'Reilly Media, Inc. https://learning.oreilly.com/library/view/beyond-vibe-coding/9798341634749/
12. ©GROWTH VERSE Co., Ltd. 仕様〜実装までの開発PRJをCursorと進める際の勘所 他のモジュールと疎結合で、Agentのアウトプットをテスト‧レビューしやすいレイヤーとの相性は良い ⼀⽅で、DBとの結合や特定のライブラリへの依存度が⾼い箇所（ORM Mapperなど）の実装には⼯夫が必要 オニオンアーキテクチャのbackend実装の各レイヤーとコード⽣成の相性
13. ©GROWTH VERSE Co., Ltd. 仕様〜実装までの開発PRJをCursorと進める際の勘所 1. ⼿本となるcommitを参照させて似たような実装をさせる a. state: commitで参照させる⼿本のパターン b. intent: 同じような実装を横展開させる 2. 新規のエンドポイントやロジックをフルスクラッチで作らせる a. state: 実装のパターンやコーディングのガイドライン（project rulesなどで⽤意しておくのがベスト） b. intent: 技術設計の該当箇所を実装させる 3. テストを実装させる a. state: テスト作成箇所のコード‧テストのパターン b. intent: テストコードの作成 教科書的にプロンプティング⼿法を知りたい場合は https://www.promptingguide.ai/jp などが参考となる Agentへの実装指⽰のプロンプティングパターン https://docs.cursor.com/guides/working-with-context
14. Cursorの（個⼈的）隠れ機能と使⽤感 運⽤中のサービス開発でAgentにコードを書かせた話
15. ©GROWTH VERSE Co., Ltd. Cursorの（個⼈的）隠れ機能と使⽤感 • Agentにruleの作成‧編集をしてもらえる ◦ リポジトリのディレクトリ構造やアーキテクチャをベースにしてproject ruleのベースを作成させることができる ◦ 既存のruleにも追記できるので、チャットをする中でruleに記載するべきと判断した内容をシームレスにagentに追記させることがで きる 👉 プロンプティングパターンの磨き込みがより楽に Rule Generation
16. ©GROWTH VERSE Co., Ltd. Cursorの（個⼈的）隠れ機能と使⽤感 • commitのdiffをcontextとして加えることができる 👉 ⼈間が⼿本のコードを書いてAgentに真似させる。複数のモジュールやレイヤーを跨ぐような実装の際に良質なcontextになる @commit
17. ©GROWTH VERSE Co., Ltd. Cursorの（個⼈的）隠れ機能と使⽤感 • monorepoでなくても、複数のリポジトリを⼀つのワークスペースで同時開くことができる 👉 技術設計の際など、複数のリポジトリを参照させたい場合に有効 👉 実装メモ⽤の個⼈obsidianレポジトリを含める chatのexporting機能と組み合わせて、過去のチャットでのcontextを参照させる使い⽅も Multi root
18. ©GROWTH VERSE Co., Ltd. Cursorの（個⼈的）隠れ機能と使⽤感 • agentで利⽤させるtools(標準のtoolsとmcpのtools)を⾃分で組み合わせることができる 👉 mcpのtoolsが40までしか使えない制限に対応できる Ex: フロントエンド開発⽤にはfigmaとデザインシステムのmcpを利⽤させる / バックエンドの開発にはobsidianのmcpだけ利⽤させる Custom mode
19. ©GROWTH VERSE Co., Ltd. Cursorの（個⼈的）隠れ機能と使⽤感 • exporting chat ◦ cursorとのチャットをmdファイルでdonwloadできる ◦ やり取りのログを残すことが可能になる • Tabs ◦ チャットを複数タブ開いて並⾏してagentとの対話が進められる ◦ duplicateでチャットの複製ができる • Sound base ◦ agentの実⾏完了を⾳声で通知してくれる • Commit generation ◦ commitメッセージを作成してくれる ◦ user rules参照してしまうため⽇本語のアウトプットになるのでイマイチ その他機能
20. ©GROWTH VERSE Co., Ltd. Thank you