カスタムエージェント

Claude Code によるソフトウェア開発

Dani Zysman

AI Curriculum Manager @ DataCamp

エージェントとは？

専門的なツールを持つロボットアシスタントのチーム

エージェントとは、Claude Code 内の専門的な AI アシスタントです。

それぞれ固有の機能を持ち、独立して動作します
組み込み型とカスタム作成型があります

組み込みエージェント

エージェント	目的	使用場面
Explore	読み取り専用でコードベースを調査	「このアーキテクチャを把握したい」
Plan	調査と戦略立案	「どう進めるべきか？」
General	すべてのツールでタスクを実行	ほとんどの作業で既定として使用

/agents で利用可能なエージェントを一覧表示できます

カスタムエージェントを作る理由

専門タスク用のカスタムエージェント

メリット： 再利用可能で一貫性があり、チームで共有できます
一般的なユースケース：
- コードレビュー - チームの基準を徹底
- セキュリティ監査 - 脆弱性をチェック
- ドキュメント作成 - 一貫したドキュメントを生成
- テスト - テストケースを提案

エージェントファイルの作成

ファイルの場所：
- .claude/agents/code-reviewer.md
必須セクション：
- name：エージェントの識別子
- description：起動条件
- 本文： Markdown 形式の指示

___
# code-reviewer.md
name: code-reviewer
description: Reviews code for 
best practices
___
Check for:
1. Clear naming conventions
2. Proper error handling
3. Performance concerns

コードレビュー用カスタムエージェントの作成

> /agents

> [Select] Create new agent

> [Select] Project level (.claude/agents)

> [Select] Generate with Claude (recommended)

>  Create a code reviewer agent that reviews code for naming, error handling, 
and performance.

生成されたファイルを確認して承認しましょう。

ここまでのプロジェクト

music-analytics-api/
  app.py
  routes.py        # <- We'll review this file
  models.py
  analytics.py
  CLAUDE.md
  .claude/
    agents/
      code-reviewer.md  # <- Our custom agent

エージェントが起動するタイミング

サブエージェントなし（直接処理）：

"Fix the bug in routes.py"
  -> Claude handles it

"Add validation here"
  -> Claude handles it

サブエージェントを起動：

"Map the architecture"
  -> Explore agent

"How should we refactor?"
  -> Plan agent

カスタムエージェントの利用

> @code-reviewer review @routes.py

Review Complete

Quick Fixes:
- Remove unused `session` import (line 3)
- Replace hardcoded `* 5` popularity metric with a named constant

Structural Issues:
- Album dictionaries built twice in get_album_stats() and
  get_average_tracks() extract to a shared helper
- get_artist_albums() returns empty list if artist doesn't exist;
  validate artist first
- No range validation on artist_id parameter

Would you like me to fix any of these?

エージェントのメリット

安全な調査のための保護シールド付き拡大鏡

独立したコンテキスト
- エージェントは独立して動作します
- メインの会話はクリーンに保たれます
安全な調査
- Explore エージェントは読み取り専用です
- 不慣れなコードベースに最適です

エージェントを使うタイミング

質問の種類	動作
「この関数は何をしますか？」	Claude が直接回答
「このコードベース全体で認証はどう機能しますか？」	Explore エージェントが調査
「これをリファクタリングする最善の方法は？」	Plan エージェントが調査
「code review @routes.py」	カスタムエージェントが処理

練習しましょう！

Claude Code によるソフトウェア開発