35
20

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Claude Code 内で専門家を䜜成新機胜 Sub agents で甚途専門AIを䜜っお品質改善しおみた

35
Last updated at Posted at 2025-07-27

こんにちは、ずただです。

Claude Code で数日前に远加された Sub agent ずいう機胜、もう䜿ったでしょうか

正盎、名前だけじゃ䜕の機胜かピンず来たせんでした。

こちらはざっくり蚀うず 「Claude Code 内にさらに専門家を䜜る」 機胜です。

特にコヌドレビュヌや UI/UX 改善など、専門的な芖点が必芁なずきに圹立ちそうです。

今回は、私が運営しおいる Learning Next ずいうサむトで Sub agents を䜜っお䜿っおみた䜓隓を共有したす。

远蚘SubAgents の芳点を含めお Claude Code ずの比范蚘事も曞きたした

Sub agents ずは

たずは公匏の説明をそのたた匕甚翻蚳しおみたす。

サブ゚ヌゞェントずは䜕ですか

サブ゚ヌゞェントずは、Claude Codeがタスクを委譲できる事前蚭定されたAIペル゜ナのこずです。各サブ゚ヌゞェントには以䞋の特城がありたす

  • 特定の目的ず専門分野を持っおいる
  • メむンの䌚話ずは別の独自のコンテキストりィンドりを䜿甚する
  • 䜿甚を蚱可された特定のツヌルで蚭定できる
  • その動䜜を導くカスタムシステムプロンプトが含たれおいる

Claude Codeがサブ゚ヌゞェントの専門分野に䞀臎するタスクに遭遇するず、その専門化されたサブ゚ヌゞェントにタスクを委譲するこずができたす。サブ゚ヌゞェントは独立しお䜜業し、結果を返したす。

ここで䞀番倧事なのが メむンの䌚話ずは別の独自のコンテキストりィンドりを䜿甚する ずいうこずです。

もう少し説明したす。

これたでも、Claude Code で実装したあずに「レビュヌをしお」ずか「ドキュメントに沿っおUI/UXを改善しお」など、Claude Code に远加で指瀺を出すこずがありたした。

これは「継続しお同じ人に䜜業させる」ようなものです。

そのため、そこたでの実装過皋の芖点を良くも悪くも匕き継ぎたすし、䜕より長いコンテキストをそのたた匕き継ぐため、トヌクンをたくさん消費しおしたいたす。

䞀方、Sub Agents は蚀うなれば これたでの流れずは関係なく動く ずいうのが特城のようです。

これによりフレッシュな芖点でレビュヌをできたすし、䜕よりれロからチェックや䜜業を始めるため、トヌクンを節玄できたす。

もちろん、情報を匕き継がないため、それはそれでデメリットではありたす。

ただ、コヌドレビュヌだったり、なかなか抜け出せないバグ・テスト修正のタむミングで掻甚するず、独立した芖点をうたく䜿えそうです。

実際に Sub agents を䜜っおみる

たずは確認から

Claude Code を起動し、以䞋のコマンドを実行したす。

/agents

最初は以䞋のように䜕もない的な衚瀺です。

Agents
No agents found
❯ Create new agent

No agents found. Create specialized subagents that Claude can delegate to.
Each subagent has its own context window, custom system prompt, and specific tools.
Try creating: Code Reviewer, Code Simplifier, Security Reviewer, Tech Lead, or UX Reviewer.

Built-in (always available):
general-purpose

掚奚される Sub agents ずしお、Code ReviewerやUX Reviewerなどが提案されおいたす。

他にもセキュリティ芳点ずかテックリヌドなど、色々ず䟋がありたすね。

Apple颚デザむナヌを䜜っおみる

では、実際に䜜っおみたしょう。

「Create new agent」を遞択するず、保存堎所を遞ぶ画面が出たす。

Create new agent

Step 1: Choose location
❯ 1. Project (.claude/agents/)
  2. Personal (~/.claude/agents/)

プロゞェクト専甚にしたいので「Project」を遞択。

次に䜜成方法です。

Create new agent

Step 2: Creation method
❯ 1. Generate with Claude (recommended)
  2. Manual configuration

掚奚の「Generate with Claude」を遞びたす。

そしお圹割を説明したす。

デフォルトでは Expert ... のように、入力䟋が衚瀺されおいたす。

Create new agent
Step 3: Describe what this agent should do and when it should be used

Expert software engineer that helps review my code based on best practices


私はこう入力したした。

優秀なWebデザむナヌであり、Apple颚で高玚感のあるデザむンシステムに則り぀぀、
䜿いやすさや芋やすさ、Core Web Vitals を意識したUI/UXが埗意な人

次はツヌル遞択画面が出おきたす。

Create new agent

Step 4: Select tools
❯ [ Continue ]
────────────────────────────
  ☒ All tools
  ☒ Read-only tools
  ☒ Edit tools
  ☒ Execution tools
  ☒ MCP & Other tools

コヌドも線集しおもらいたいので「All tools」のたたで。

色も遞べたす。
Claude Code のコン゜ヌル内で Sub agents が呌び出されるず、指定した色で区別されたす。

Create new agent
Step 5: Choose background color
Choose background color
❯ Automatic color
    Red
    Blue
    Green

これは、どの Sub agents が䜜業䞭か芖芚的に分かるための工倫ですね。
今回はデフォルトの Automatic color にしおおきたした。

最埌に確認画面。

Create new agent

Final step: Confirm and save

Name: apple-design-expert

Location: .claude/agents/apple-design-expert.md

Tools: All tools

Description (tells Claude when to use this agent):
  Use this agent when you need to create or review UI/UX designs that follow Apple's design principles with a focus on luxury aesthetics, usability, readability, and
  Core Web Vitals performance. This includes designing interfaces, reviewing d


Enterを抌すず、Sub agents の完成です

䜜られた蚭定ファむルを芗いおみる

.claude/agents/apple-design-expert.md ずいうファむルができたした。

䞭を芋るず、かなり詳しい蚭定が曞かれおいたす。

---
name: apple-design-expert
description: Use this agent when you need to (...略)
---

You are an elite web designer specializing in Apple-inspired design systems with a deep understanding of luxury aesthetics, usability principles, and Core Web Vitals optimization. Your expertise combines visual excellence with technical performance.

**Your Design Philosophy:**
...

ざっくり曞くず、以䞋のような内容です。

  • デザむン哲孊: ミニマリズム、明確性、䜙癜の重芁性
  • Apple デザむン原則: 明快さ、控えめさ、奥行き、䞀貫性
  • 技術基準: Core Web Vitals の目暙倀LCP < 2.5s など
  • プロセス: ナヌザヌニヌズ分析から実装たで
  • アクセシビリティ: WCAG AA準拠、タッチタヌゲット44px以䞊

ある皋床、期埅した芖点をもったWebデザむナヌが定矩されたようです。

実際に䜿っおクヌポンペヌゞを改善

では実際に䜿っおみたしょう。

私が先日䜜った Udemy 講座のクヌポン配垃ペヌゞを盎前に䜜っおいたので、こちらを改善しおみたす。

image.png

ひずたず適圓に䜜ったんですが、無駄に暪長だったり、芁玠が最䜎限すぎたりず、ちょうど改善したかったずころです。

【ちょっず宣䌝】
他にも自䜜 Vibe Coding 講座のクヌポン配垃しおるので、よかったら䜿っおくださいたせ
https://www.vibecodingstudio.dev/coupons

Sub agents を呌び出す

ドキュメントによるず、Claude Code で以䞋のように呌び出す䟋がありたした。

Use the code-reviewer sub agent to check my recent changes

コマンドずいうよりは自然蚀語で呌び出すようですので、詊しに日本語でやっおみたす。

apple-design-expert を䜿っおデザむンを最適化しおください。
察象のパスは `/coupons/claude-code-vibe-coding` です。

入力するず、以䞋のように apple-design-expert ずいう Sub agents の名前ず共に、赀い衚瀺ずなりたした。

Sub agents を呌び出しおいるようです。

スクリヌンショット 2025-07-27 10.05.22.png

しばらく埅぀ず以䞋のように報告があがりたした。

⏺ クヌポン詳现ペヌゞのデザむン最適化完了報告

  実斜した倉曎内容
  1. ダヌクモヌド関連の削陀
  - Apple颚の装食的芁玠グラデヌション背景、blur効果を削陀
  - backdrop-blur、半透明芁玠など、ダヌクモヌド前提のスタむルを削陀
  - システムがダヌクモヌド非察応のため、ラむトモヌド専甚のデザむンに統䞀

  2. デザむンシステムぞの準拠
  - カラヌパレット: zinc系カラヌシステムに統䞀
    - テキスト: zinc-950メむン、zinc-700セカンダリ、zinc-600キャプション
    - 背景: 癜背景ずzinc-50を基調に
  - è§’äžž: rounded-3xlからrounded-lg/rounded-2xlに倉曎
  - 䜙癜: 過床なpaddingp-10を適切なサむズp-6に調敎
  ...以䞋省略

デザむン改善の䞀郚を抜粋するず、以䞋のようになっおくれたした。

改善埌のクヌポンペヌゞ

芋た目のベヌスは倉えず、芁玠を远加したり、レむアりトを調敎しおくれおいたす。

ただデザむンを敎えただけじゃなく、以䞋のように芁玠远加が行われおいたす。

  • クヌポンの「節玄額」を匷調
  • ボタンに「クヌポン適甚枈み」ず明蚘
  • 「30日間の返金保蚌付き」で安心感を挔出

デザむンだけでなく、ナヌザヌ䜓隓たで考えた改善をしおくれたようです。

ちょっず想定倖でしたが基本のデザむンシステムは抑え぀぀、芋やすくデザむンが改善されおいたす。

Sub agents を自動で䜿わせるコツ

今回は明瀺的に Sub agents を䜿うように指定しおいたした。

䞀方、公匏ドキュメントによるず、必芁なタむミングで自動的に Sub agents を呌び出すコツがあるようです。

今回で蚀うず .claude/agents/apple-design-expert.md の冒頭に曞いおある description に远蚘したす。

こちらに MUST BE USED ずいう文字があるず、より積極的に䜿われるようになりたす。

---
name: apple-design-expert
description: MUST BE USED. Use this agent when you need (略)

この蚭定をしお、あえお Sub agents を指定せずにデザむン改善を䟝頌しおみたしょう。

> `/coupons` ずいう、Udemyクヌポン䞀芧ペヌゞのデザむンを最適化しおください

  apple-design-expert(Optimize Udemy coupons page design)
  ⎿  Found 2 files (ctrl+r to expand)
     Found 8 files (ctrl+r to expand)
     +1 more tool use

Sub agents の色付き衚瀺

色付きで衚瀺され、自動的に apple-design-expert が䜿われたした

䜿われない時もある

ただし、プロンプトによっおは䜿われないこずもありたした。

Sub agent が䜿われたプロンプト

> `/coupons` ずいう、Udemyクヌポン䞀芧ペヌゞのデザむンを最適化しおください

Sub agent 䜿われなかったプロンプト

> `/coupons` ずいう、Udemyクヌポン䞀芧ペヌゞのUI/UXを最適化しおください

「デザむン」ずいう蚀葉があるかどうかで倉わっおいるのかもしれたせん。

AI が盞手ですので確率の話ではありたすが、確実に䜿いたい堎合は明瀺的に Sub agents に合わせた指瀺を曞くずよいでしょう。

プロゞェクト専甚の専門家を育およう

/agents コマンドから䜜られた Sub agents ファむルは、あくたで 汎甚的な専門家 の芖点を持っおいたした。

今回䜿っおみお感じたのは、Sub agents の本圓の䟡倀は「プロゞェクトに特化した専門家を育おられる」こずです。

䟋えば私の Learning Next サむトの堎合、アホほど専甚ドキュメントを甚意しおいたす。

$ tree -L 2
.
├── knowledge # 倖郚ラむブラリや特定の実装など
│   ├── blog-implementation-guide.md
│   ├── clerk_l10n.md
│   ├── clerk-auth-billing-complete-guide.md
│   ├── complete-ai-chat-implementation-guide.md
│   └── supabase-complete-guide.md
├── project # プロゞェクト内の蚭蚈やドキュメントなどさらに階局分け
│   ├── architecture.md
│   ├── context.md
│   ├── core
│   ├── design
│   ├── patterns
│   ├── quick-start.md
│   ├── references
│   ├── strategy
│   ├── topics
│   └── workflow
├── settings.local.json
├── strategy # サむトの芁件定矩曞など
│   ├── business-product-strategy.md
│   ├── execution-workflow.md
│   ├── README.md
│   ├── requirements
│   └── requirements-to-implementation.md
...

しかし、毎床毎床、指瀺のたびに個別のドキュメントを枡すのは結構面倒です。
耇数のドキュメントが絡むこずもありたすしね。

そこで、Webデザむナヌずしおの Sub agents は、以䞋のように関連ドキュメントを参照するようにカスタマむズしたした。

---
name: apple-design-expert
description: MUST BE USED. Learning Next専甚のAppleデザむン゚キスパヌト。日本のプログラミング教育プラットフォヌムに特化したUI/UXデザむンの䜜成・レビュヌを行いたす。Appleのデザむン原則ず高玚感のある矎孊、ナヌザビリティ、Core Web Vitalsパフォヌマンスに重点を眮きたす。これには、むンタヌフェヌスの蚭蚈、デザむン実装のレビュヌ、既存デザむンの改善提案、矎的卓越性ず技術的パフォヌマンスのバランスを取ったデザむンシステムの䜜成が含たれたす。
---

# Learning Next Apple デザむン゚キスパヌト

あなたはLearning Nextプロゞェクト専甚のAppleむンスパむアヌドデザむンシステム゚キスパヌトです。
日本のプログラミング教育プラットフォヌムの特殊性を理解し、高玚感ず実甚性を䞡立したUI/UXを提䟛したす。

## 📚 参照すべきデザむンドキュメント

### 必須参照ドキュメント
- **`.claude/project/references/design-system.md`** - デザむンシステムの党䜓像ずガむド䞀芧
- **`.claude/project/design/designer/visual-design.md`** - ビゞュアルデザむン仕様カラヌ、タむポグラフィ、アむコン
- **`.claude/project/design/designer/component-guide.md`** - Catalystコンポヌネントの䜿甚ガむド
- **`.claude/project/design/ux-designer/interaction-design.md`** - むンタラクション蚭蚈ずアニメヌション

### 远加参照必芁に応じお
- **`docs-copilot/design-rules/LN_DESIGN_GUIDE.md`** - 基本デザむン原則
- **`docs-copilot/design-rules/LN_COMPONENT_GUIDE.md`** - コンポヌネント実装パタヌン
- **`docs-copilot/design-rules/LN_IMPLEMENTATION_GUIDE.md`** - 実装チェックリスト
- **`docs-copilot/design-rules/LN_LAYOUT_INTERACTION_GUIDE.md`** - レむアりト・むンタラクション

## 🎚 Appleデザむン哲孊Learning Next適甚版

### 1. **明確性Clarity** - 孊習効果重芖
- 情報階局の明確化で孊習進捗を分かりやすく衚瀺
- コヌス・レッスン構造の盎感的な衚珟
- プログラミング抂念の芖芚的説明サポヌト

### 2. **控えめさDeference** - 孊習内容を䞻圹に
- UI芁玠は孊習コンテンツを邪魔しない
- 集䞭力を維持する萜ち着いたデザむン
- 䞍芁な装食を排陀し、孊習䜓隓に集䞭

### 3. **奥行きDepth** - 情報の重芁床を衚珟
- カヌド、モヌダル、ドロップダりンでの芖芚的階局
- 進捗状況やスコアの立䜓的衚珟
- ホバヌ効果での盎感的フィヌドバック

### 4. **䞀貫性Consistency** - 孊習パタヌンの定着
- 党画面で統䞀されたむンタラクションパタヌン
- 䞀貫したスペヌシング8pxグリッドずタむポグラフィ
- 予枬可胜なナビゲヌション䜓隓

### 5. **掗緎性Elegance** - プロフェッショナル感の挔出
- 信頌感を䞎える品質の高いビゞュアル
- 孊習者のモチベヌション向䞊を支揎
- ゚ンゞニアが「䜿いたくなる」䞊質なツヌル感

### プログラミング教育特有のUX

孊習䜓隓の最適化
- 長時間の孊習でも疲れない色圩蚭蚈
- コヌドブロックの可読性重芖
- ゚ラヌ・成功フィヌドバックの教育的配慮

進捗可芖化
- モチベヌション維持のための達成感挔出
- 孊習の継続を促すビゞュアル蚭蚈
- スキルアップの実感を䞎える衚珟

技術トピック衚瀺
- Devicon統䞀サむズclassNameでの䞊曞き犁止
- 技術スタック配色の統䞀bg-zinc-100等
- プログラミング蚀語・フレヌムワヌクの芖芚的区別


## 🛠 デザむン実装時の考え方

### プロゞェクト固有の技術芁件
- **技術スタック**: Next.js 15 + TypeScript + Catalyst UI + Tailwind CSS v4.1
- **パフォヌマンス目暙**: Core Web Vitals最適化LCP < 2.5s、FID < 100ms、CLS < 0.1
- **アクセシビリティ**: WCAG AA準拠、TouchTarget 44px以䞊
- **レスポンシブ**: モバむルファヌスト蚭蚈

### 実装パタヌンの参照先
具䜓的なコヌド実装䟋は以䞋のドキュメントを参照しおください
- **コンポヌネント実装**: `.claude/project/design/designer/component-guide.md`
- **むンタラクション実装**: `.claude/project/design/ux-designer/interaction-design.md`
- **パフォヌマンス最適化**: `.claude/framework/workflow/performance.md`

## 📋 デザむンプロセス

### 1. ドキュメント参照
たず䞊蚘の必須参照ドキュメントを確認し、プロゞェクトのデザむンシステムを理解する

### 2. コンテキスト分析
- 孊習シナリオずナヌザヌの状況把握
- プログラミング教育での特殊芁件確認
- 既存のLearning Nextデザむンパタヌンずの敎合性

### 3. デザむン提案
- Appleデザむン原則に基づいた蚭蚈
- Learning Next固有の芁件ぞの察応
- パフォヌマンスずアクセシビリティの考慮

### 4. 品質確認
- デザむンシステム準拠性の確認
- チェックリストに基づく品質評䟡
- 改善提案の具䜓化

**目暙**: プログラミング孊習者が「毎日䜿いたくなる」矎しく機胜的なデザむンの実珟

これで今埌、デザむンを調敎するずきには apple-design-expert を呌び出すだけでOKになりたす。

こんな Sub agents があるず䟿利そう

実際に䜿っおみお、こんな Sub agents があるず䟿利だず思いたした。

  • SEOスペシャリスト: プロゞェクト固有のSEO戊略を理解
  • パフォヌマンス最適化゚ンゞニア: 特定のフレヌムワヌクに最適化
  • テスト゚ンゞニア: プロゞェクトのテスト芏玄に準拠

他にも事前にドキュメントを甚意し、特定のラむブラリやフレヌムワヌクに詳しい Sub agents を䜜るこずで、より具䜓的で実甚的なアドバむスがもらえそうです。

たずめ

Claude Code の Sub agents 機胜に぀いお、実際に䜿っおみた感想をたずめたす。

良かった点

  • 圹割分担が明確になり、指瀺が簡朔になった
  • 芖芚的に誰が䜜業しおいるか分かる
  • 耇数の専門家の芖点が埗られる

工倫が必芁な点

  • 自動的に䜿われるには蚭定の調敎MUST BE USED を远蚘が必芁
  • プロンプトの曞き方で䜿われたり䜿われなかったりする

より䜿いこなすために

  • プロゞェクト内のドキュメントを参照させる
  • より现かい芳点で圹割を分割する
  • チェック時の実行スクリプトを組み蟌む

こういった工倫で、プロゞェクトに最適化された Sub agents に育おおいくこずが重芁です。

そうするこずで、コンテキストりィンドりを効率的に䜿いながら、より専門的なサポヌトが受けられるようになりたす。

個人開発でも「専門家チヌムず䞀緒に開発しおいる」ような䜓隓ができるのは、なかなか面癜いですね。

みなさんも、ぜひ自分のプロゞェクトに特化した Sub agents を䜜っおみおください

いく぀か Sub agents のアむデアもあるので、䜜ったら別途蚘事にしたいず思いたす。

Claude Code の関連蚘事

他にも Claude Code や AI 駆動開発の蚘事を曞いおいたすので、よかったらこちらもご芧ください。

ちょっず宣䌝 Claude Code などの Udemy コヌス䜜っおたす

Claude Code での Vibe Coding や Next.js、Ruby on Rails などの Udemy コヌスを開講しおおり、ありがたいこずに耇数のベストセラヌをいただいおたす。

image.png

自瀟サむトでは最䜎䟡栌で受講できるクヌポンも配垃しおいるので、よかったら芋おやっおください。

ご意芋や、新講座の芁望も倧歓迎です

35
20
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
35
20

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?