開発現場で使えるSubagent活用術

Claude Code Subagentのお話

Transcript

1. 開発現場で使える Subagent活⽤術 キミたちはClaude Codeをどう使いこなす？ 2025/11/14 RehabforJAPAN Masaki.K
2. © Rehab for JAPAN Inc. ⾃⼰紹介 はじめに 2 • 名前：Masaki.K（久保⽥ 将規） • 会社：RehabforJAPAN ◦ （介護業界：デイサービス向けのリハビリSaas） • 役割：EM / CTO室兼務 ◦ 社内のAI駆動開発推進 • 興味：ClaudeCode中⼼にAI関連 ◦ 個⼈及び組織でのAI活⽤、社内外で発信 ◦ Xで発信中、zennもやってます ◦ 毎週⽊曜に社内向けyoutube Live
3. © Rehab for JAPAN Inc. こんなシーンで困ったことないですか？ 3 １回でタスクが終わらずauto compact が⼊ってしまう‧‧‧ 実装できたのにテストコードが 成功しないまま修正繰り返して、contextが⾜り なくなった‧‧‧ ⼤規模なコードベースだとcontext⾜りない から、AI使えないのかなぁ‧‧‧ 全部Subagentで解決できます！
4. © Rehab for JAPAN Inc. 今⽇お話しすること 4 • Claude Code Subagentとは • 現場の活⽤その１：探索‧計画 • 現場の活⽤その２：コードレビュー • Subagentを組み込む時に意識していること
5. Claude Code Subagentとは
6. © Rehab for JAPAN Inc. Subagent Claude Code Subagentとは 6 Subagentがあれば、200Kというコンテキストウィンドウの限界を突破できる！ 引⽤元：https://code.claude.com/docs/ja/sub-agents
7. © Rehab for JAPAN Inc. Subagentの有⽤性 Claude Code Subagentとは 7 複雑かつ⼤規模なタスクについても、Subagentを使えば最後まで完成させることができる 複雑かつ⼤規模な変更 を伴うタスク 完成に必要なコンテキストウィンドウ 直列 （Subagentなし） 並列 （Subagentあり） /compact or 別のセッション引き継ぎ 1回のセッションで 最後まで
8. 現場の活⽤その１ 探索‧計画
9. © Rehab for JAPAN Inc. Anthropicのベストプラクティス 現場の活⽤その１：探索‧計画 9 探索 計画 実装 コミット 引用元 ：https://www.anthropic.com/engineering/claude-code-best-practices 並列化
10. © Rehab for JAPAN Inc. エージェントフロー１ 現場の活⽤その１：探索‧計画 10 課題の分析 sonnet コードベース調査 haiku /create-plan 入力受付 sonnet 追加ヒアリング （引数）designDocによるファイル指定や、 要件をプロンプトでまとめたもの
11. © Rehab for JAPAN Inc. エージェントフロー２ 現場の活⽤その１：探索‧計画 11 コードベース探索 類似実装の調査 haiku 実装の深堀り sonnet プランA・B・C 作成 選択されたプラン詳 細化 タスクリスト の作成 sonnet テストケース作成 sonnet mdファイル出力 • 松⽵梅メソッドで、選択式 • おすすめ度、規模感も表⽰
12. 現場の活⽤その２ コードレビュー
13. © Rehab for JAPAN Inc. 観点例 現場の活⽤その２：コードレビュー 13 • 計画通りの実装となっているか ◦ インプット：plan.md • コーディング規約に沿っているか ◦ CLAUDE.md • セキュリティ的に問題ない実装か • パフォーマンス観点で問題ない実装か ◦ N+1、⾮効率なクエリ、メモリリークなど • 設計品質的に問題ないか ◦ SOLID原則、DRY原則、エラーハンドリングなど
14. © Rehab for JAPAN Inc. エージェントフロー 現場の活⽤その２：コードレビュー 14 コーディング規 約 haiku 要件整合性 sonnet /code-review レビュー対象の特 定 セキュリティ haiku パフォーマンス haiku 統合 mdファイル出力 設計品質 sonnet （引数）PR番号、ブランチ名、計画書のファイルパス、未指 定の場合はgit変更差分
15. Subagentを組み込む時に 意識していること
16. © Rehab for JAPAN Inc. custom agentのmdファイル構成 Subagentを組み込む時に意識していること 16 • 特定の⽬的と専⾨分野を定義 front matter custom agent（本体部分） • 動作をガイドするカスタムシステムプロンプト • 使⽤を許可された特定のツール定義 description - Subagentの⽬的を説明する箇所 - ⼯夫することで積極的にメインが呼ぶ可能性が上がる https://code.claude.com/docs/en/sub-agents
17. © Rehab for JAPAN Inc. 独⽴したコンテキストウィンドウ（⾃分の解釈） Subagentを組み込む時に意識していること 17 System prompt System tools MCP tools Custom agents （front matter） Messages Free space Auto compact buffer メイン Subagent Custom agents （本体部分） セッション起動時から コンテキストロード 作業に使える コンテキスト量 不要なものは削除！
18. © Rehab for JAPAN Inc. 実装タスクの並列化について Subagentを組み込む時に意識していること 18 メイン セッション 実装 テストコード Subagentどうしの実装範囲の競合を防ぐ⽬的で並列化はしていない。 まとまった作業単位をSubagentに任せる直列運⽤は、積極的に利⽤する。 メイン セッション メイン セッション ファイル編集やテスト実⾏は直列のSubagentに任せる
19. © Rehab for JAPAN Inc. ワークフローを定義したカスタムスラッシュコマンドが組織内展開の鍵 Subagentを組み込む時に意識していること 19 ClaudeCodeを使いこなす能⼒はメンバー間でばらつきがある。有識者がリポジトリへプッシュ。特定のコマンドの使 い⽅を周知することで、チームメンバーが無意識にSubagentを使って恩恵を受けられる状態を⽬指す。 カスタムスラッシュコマンド /code-review （コードレビューはこれ） /create-plan （計画はこれ）    AIモブプロ • ClaudeCodeへの指⽰出し役 • 後ろでサポートする役 • 任意参加の観客
20. まとめ
21. © Rehab for JAPAN Inc. まとめ 21 • Subagentを使うと⼤規模かつ複雑な作業を1セッションで最後まで可能 • 探索‧計画、コードレビュー（ファイル参照系）はSubagentの並列化 • 実装（ファイル編集系）はSubagentの直列推奨 • 不要なMCPサーバ、スラッシュコマンドは定期的に⾒直しを • スラッシュコマンドの共有がチーム全体の開発⼒を底上げする Xでも発信してます。 よければフォローお願いします。 @Emukei_