サブエージェント活用ガイド¶

概要¶

Claude Codeで利用できるサブエージェントの具体的なユースケースと活用方法をまとめたガイドです。

1. 既存のスキル（`.claude/skills/`）のユースケース¶

conversation-memory¶

用途: 会話ログの自動保存とObsidian連携

フロー:

ユーザー: 「会話を保存して」または /conversation-memory
→ スキルが起動
→ 会話ログをMarkdownに変換
→ Obsidian Vaultに保存
→ Gitコミット

活用場面: - 重要な技術的議論の記録 - トラブルシューティングの履歴保存 - ナレッジベース構築

buzz-tweet-summary¶

用途: バズツイートの自動収集とスプレッドシート保存

フロー:

定期実行や手動実行で：
→ TwitterAPI.ioからバズツイート取得
→ ジャンル別に分類（テック、ビジネス、エンタメなど）
→ Google Sheetsに自動保存

活用場面: - トレンド調査 - コンテンツ企画のネタ収集 - 定期レポート作成

info-curator ⭐ NEW¶

用途: 情報収集・整理・キュレーションの統括マネージャーエージェント

フロー:

# 情報収集
/info-curator collect --source all
→ バズツイート収集（buzz-tweet-summaryを統合）
→ ITニュース収集
→ Obsidian Vaultに整理して保存

# Web記事要約
/info-curator summarize <URL>
→ 記事をスクレイピング
→ AI要約生成
→ Markdownフォーマットで保存
→ 自動タグ付け

# デイリーレポート生成
/info-curator daily-report
→ 本日の収集情報を集計
→ カテゴリ別サマリー生成
→ 注目記事トップ5抽出
→ プロジェクト提案

# Vault整理
/info-curator organize --deep-clean
→ 重複ノート検出・マージ
→ リンク切れ修正
→ タグ正規化
→ 古いノートアーカイブ

活用場面: - 毎朝のルーティン（情報収集 + レポート生成） - 気になる記事の即座要約・保存 - Vaultの定期メンテナンス - プロジェクトマネージャー的な情報整理

既存スキルとの統合: - buzz-tweet-summary: collect --source buzzで統合 - it-news-summary: summarize <URL>で統合・強化 - conversation-memory: Vault管理機能で連携

特徴: - 複数の情報源を統合管理 - Obsidian Vaultへの統一的な保存 - デイリー/ウィークリーレポート自動生成 - 収集情報から「何を作るべきか」の提案

code-quality-check¶

用途: コード品質の自動チェック

フロー:

/code-quality-check
→ Lintチェック（flake8等）
→ フォーマットチェック
→ ベストプラクティス検証
→ 問題箇所をレポート

活用場面: - プルリクエスト前のセルフチェック - コードレビュー準備 - 継続的な品質改善

it-news-summary¶

用途: Web記事の要約とObsidian保存

フロー:

/it-news-summary <URL>
→ 記事をスクレイピング
→ AI要約生成
→ Markdownフォーマット
→ Obsidian Vaultに保存

活用場面: - 技術記事の効率的な収集 - 学習ノート作成 - 情報整理の自動化

2. Task toolのサブエージェントのユースケース¶

Explore（コードベース探索）¶

用途: 大規模コードベースの横断的調査

使用例:

# ケース1: 機能の実装場所を探す
「この認証機能はどこに実装されている？」
→ Exploreエージェントが複数ファイルを横断的に調査
→ 関連ファイル、関数、依存関係をレポート

# ケース2: 特定パターンの使用箇所を調査
「このライブラリを使っている箇所をすべて見つけて」
→ 使用箇所を網羅的に検索
→ 使用方法のパターンを分析

活用場面: - レガシーコードの理解 - リファクタリングの影響範囲調査 - セキュリティ監査

thoroughnessレベル: - quick: 基本的な検索（1-2分） - medium: 中程度の探索（3-5分） - very thorough: 包括的な分析（5-10分）

Plan（実装計画）¶

用途: 新機能追加前の設計と影響範囲分析

使用例:

# ケース1: 新機能追加
「ログイン機能を追加したい」
→ Planエージェントが既存コードを分析
→ アーキテクチャパターンを特定
→ 影響範囲を特定（データベース、API、UI等）
→ ステップバイステップの実装計画を提案
→ ユーザー承認後、実装開始

# ケース2: バグ修正計画
「このバグを修正する最適な方法は？」
→ 関連コードを分析
→ 複数の修正アプローチを提案
→ トレードオフを説明

活用場面: - 複雑な機能追加 - アーキテクチャ変更 - 技術的意思決定のサポート

feature-dev（機能開発）¶

用途: 既存パターンを踏襲した機能開発

サブタイプ: - code-architect: アーキテクチャ設計 - code-explorer: 既存機能の深掘り調査 - code-reviewer: コードレビュー

使用例:

# ケース1: 新機能開発
「APIレート制限機能を追加」
→ 既存のミドルウェアパターンを分析
→ コード生成
→ テスト作成
→ ドキュメント更新

# ケース2: コードレビュー
「このPRをレビューして」
→ バグ、セキュリティ脆弱性をチェック
→ ベストプラクティス違反を検出
→ 改善提案

活用場面: - エンタープライズレベルの機能開発 - コードベース全体の一貫性維持 - 品質保証の強化

general-purpose（汎用）¶

用途: 複数ステップが必要な複雑タスク

使用例:

# ケース1: リサーチタスク
「この技術スタックの最新動向を調査して」
→ Web検索
→ 公式ドキュメント確認
→ ベストプラクティス収集
→ レポート作成

# ケース2: ファイル横断作業
「すべてのdeprecated関数を新しいAPIに置き換えて」
→ 対象ファイルを検索
→ 各ファイルを順次更新
→ テスト実行で確認

活用場面: - 調査・リサーチ - 一括置換・リファクタリング - マルチステップの自動化

3. カスタムスキルの作成例¶

例1: 定期レポート生成スキル¶

# 毎週月曜日に実行
/weekly-report

【処理内容】
→ Git活動を集計（コミット数、PR数など）
→ TODOリストをチェック（未完了タスク）
→ 進捗レポートをMarkdown生成
→ Obsidianに保存
→ オプション：Slackに通知

実装場所: .claude/skills/weekly-report/

例2: デプロイ前チェックスキル¶

/pre-deploy-check

【処理内容】
→ Lintチェック（flake8, eslint等）
→ テスト実行（pytest, jest等）
→ セキュリティスキャン（bandit, npm audit等）
→ 依存関係の脆弱性チェック
→ 問題があれば詳細レポート
→ 問題なければデプロイ手順を提示

実装場所: .claude/skills/pre-deploy-check/

例3: ドキュメント自動生成スキル¶

/generate-docs

【処理内容】
→ コードからDocstringを抽出
→ APIエンドポイントを自動検出
→ Markdownドキュメント生成
→ docs/ディレクトリに保存
→ 目次の自動更新

実装場所: .claude/skills/generate-docs/

4. Hooks（自動実行）のユースケース¶

コミット前フック¶

{
  "hooks": {
    "beforeCommit": "python -m pytest && flake8"
  }
}

効果: - コミット前に自動でテスト実行 - 品質の低いコードのコミット防止

ファイル保存時フック¶

{
  "hooks": {
    "onSave": "python -m black ${file}"
  }
}

効果: - ファイル保存時に自動フォーマット - コードスタイルの統一

プロンプト送信前フック¶

{
  "hooks": {
    "beforePromptSubmit": "echo '🔍 Checking for sensitive data...'"
  }
}

効果: - 機密情報の送信防止チェック - プロンプト送信前の確認

5. MyLabプロジェクト向けカスタム提案¶

提案1: vault-sync-agent¶

目的: Obsidian Vaultとの自動同期

機能: - 会話ログの自動転送 - ノート間のリンク生成 - タグの自動付与 - デイリーノートへの統合

トリガー: - 会話終了時 - /sync-vaultコマンド

提案2: credentials-checker¶

目的: 認証情報の漏洩防止

機能: - コミット前にCredentials/内のキーをスキャン - ハードコードされたAPIキーを検出 - .gitignoreの妥当性チェック - 警告とブロック

トリガー: - コミット前フック - /check-credentialsコマンド

提案3: project-health-monitor¶

目的: プロジェクト全体の健全性チェック

機能: - テストカバレッジ測定 - Lint違反数の集計 - ドキュメント更新状況（最終更新日） - 依存関係の最新性チェック - 週次レポート生成

トリガー: - 毎週月曜日自動実行 - /health-checkコマンド

提案4: skill-sync-agent¶

目的: Gemini CLI（.agent/）からClaude Code（.claude/）へのスキル移植

機能: - .agent/skills/の構造を分析 - Claude Code形式に変換 - SKILL.mdファイル生成 - 実装コードの適応

トリガー: - /migrate-skillsコマンド

6. 開発フロー別活用例¶

日常開発フロー¶

1. 朝：/weekly-report で週次レビュー
2. 機能開発：Plan → feature-dev → code-quality-check
3. コミット：beforeCommit hook で自動テスト
4. PR作成：/code-review スキルで自己レビュー
5. 夕方：/conversation-memory で学習内容を記録

新規プロジェクト開始フロー¶

1. Explore で既存コードベース理解
2. Plan で実装計画立案
3. カスタムスキル作成（プロジェクト固有の自動化）
4. Hooks設定（品質チェック自動化）

トラブルシューティングフロー¶

1. Explore でエラー箇所を特定
2. general-purpose でログ分析
3. Plan で修正戦略立案
4. 修正後、conversation-memory で記録

7. ベストプラクティス¶

スキル作成時¶

単一責任: 1つのスキルは1つの明確な目的
再利用性: 汎用的なロジックは共通化
ドキュメント: SKILL.mdに使用例を必ず記載

サブエージェント選択時¶

単純な検索: Glob/Grep直接使用
3回以上の検索が必要: Exploreエージェント
実装前の設計: Planエージェント
複雑な機能開発: feature-devエージェント

Hooks設定時¶

軽量な処理のみ: 長時間実行は避ける
失敗時の挙動: エラーハンドリングを適切に
フィードバック: 実行結果をユーザーに通知

まとめ¶

サブエージェントの選択基準：

ニーズ	推奨サブエージェント
定型作業の自動化	カスタムスキル
コードベース調査	Explore
実装計画・設計	Plan
機能開発	feature-dev
複雑な多段階タスク	general-purpose
自動実行	Hooks

次のステップ: 具体的に作成したいサブエージェントが決まったら、実装に進みましょう！

サブエージェント活用ガイド¶

概要¶

1. 既存のスキル（.claude/skills/）のユースケース¶

conversation-memory¶

buzz-tweet-summary¶

info-curator ⭐ NEW¶

code-quality-check¶

it-news-summary¶

2. Task toolのサブエージェントのユースケース¶

Explore（コードベース探索）¶

Plan（実装計画）¶

feature-dev（機能開発）¶

general-purpose（汎用）¶

3. カスタムスキルの作成例¶

例1: 定期レポート生成スキル¶

例2: デプロイ前チェックスキル¶

例3: ドキュメント自動生成スキル¶

4. Hooks（自動実行）のユースケース¶

コミット前フック¶

ファイル保存時フック¶

プロンプト送信前フック¶

5. MyLabプロジェクト向けカスタム提案¶

提案1: vault-sync-agent¶

提案2: credentials-checker¶

提案3: project-health-monitor¶

提案4: skill-sync-agent¶

6. 開発フロー別活用例¶

日常開発フロー¶

新規プロジェクト開始フロー¶

トラブルシューティングフロー¶

7. ベストプラクティス¶

スキル作成時¶

サブエージェント選択時¶

Hooks設定時¶

まとめ¶

1. 既存のスキル（`.claude/skills/`）のユースケース¶