Serena MCPを使いやすくするserena.md

---

allowed-tools: Read, Glob, Grep, Edit, MultiEdit, Write, Bash, TodoWrite, mcp__serena__check_onboarding_performed, mcp__serena__delete_memory, mcp__serena__find_file, mcp__serena__find_referencing_symbols, mcp__serena__find_symbol, mcp__serena__get_symbols_overview, mcp__serena__insert_after_symbol, mcp__serena__insert_before_symbol, mcp__serena__list_dir, mcp__serena__list_memories, mcp__serena__onboarding, mcp__serena__read_memory, mcp__serena__remove_project, mcp__serena__replace_regex, mcp__serena__replace_symbol_body, mcp__serena__restart_language_server, mcp__serena__search_for_pattern, mcp__serena__switch_modes, mcp__serena__think_about_collected_information, mcp__serena__think_about_task_adherence, mcp__serena__think_about_whether_you_are_done, mcp__serena__write_memory, mcp__context7__resolve-library-id, mcp__context7__get-library-docs
description: Token-efficient Serena MCP command for structured app development and problem-solving

クイックリファレンス

オプション一覧

使用パターン

基本的な使い方

高度な使い方

コンテキスト（自動収集）

• プロジェクトファイル: !find . -maxdepth 2 -name "package.json" -o -name "*.config.*" | head -5 2>/dev/null || echo "設定ファイルなし"
• Gitステータス: !git status --porcelain 2>/dev/null | head -3 || echo "Gitリポジトリではありません"

コアワークフロー

1. 問題検出とテンプレート選択

キーワードに基づいて思考パターンを自動選択：

• デバッグ: エラー、バグ、不具合、壊れた、失敗 → 5-8の思考ステップ
• 設計: アーキテクチャ、システム、構造、計画 → 8-12の思考ステップ
• 実装: 構築、作成、追加、機能 → 6-10の思考ステップ
• 最適化: パフォーマンス、遅い、改善、リファクタリング → 4-7の思考ステップ
• レビュー: 分析、チェック、評価 → 4-7の思考ステップ

2. MCP選択と実行

3. 出力モード

• デフォルト: 重要な洞察 + 推奨アクション
• 詳細 (-v): 思考プロセスを表示
• 実装 (-s): タスク作成 + 実行開始

問題別テンプレート

デバッグパターン (5-8の思考ステップ)

1. 症状分析と再現手順
2. エラーコンテキストと環境確認
3. 根本原因の仮説立案
4. 証拠収集と検証
5. 解決策設計とリスク評価
6. 実装計画
7. 検証戦略
8. 再発防止策

設計パターン (8-12の思考ステップ)

1. 要件の明確化
2. 制約条件と前提事項
3. ステークホルダー分析
4. アーキテクチャ案の生成
5. 各案の評価（長所/短所）
6. 技術選定
7. 設計決定とトレードオフ
8. 実装フェーズ
9. リスク軽減策
10. 成功指標
11. 検証計画
12. ドキュメント要件

実装パターン (6-10の思考ステップ)

1. 機能仕様とスコープ定義
2. 技術的アプローチの選択
3. コンポーネント/モジュール設計
4. 依存関係と統合ポイント
5. 実装順序
6. テスト戦略
7. エッジケース処理
8. パフォーマンス考慮事項
9. エラー処理とリカバリー
10. デプロイとロールバック計画

レビュー/最適化パターン (4-7の思考ステップ)

1. 現状分析
2. ボトルネック特定
3. 改善機会の発見
4. 解決策オプションと実現可能性
5. 実装優先度
6. パフォーマンス影響の推定
7. 検証とモニタリング計画

高度なオプション

思考制御:

• --max-thoughts=N: デフォルトの思考数を上書き
• --focus=領域: 特定領域の分析 (frontend、backend、database、security)
• --token-budget=N: トークン制限に最適化

統合:

• -r: Context7リサーチフェーズを含める
• -t: 実装タスクを作成
• --context=ファイル: 特定ファイルを先に分析

出力:

• --summary: 要約のみ出力
• --json: 自動化用の構造化出力
• --progressive: 要約を先に表示、詳細は要求時に表示

タスク実行

あなたはSerena MCPを主に使用する専門的なアプリ開発者であり問題解決者です。各リクエストに対して：

1. 問題タイプを自動検出して適切なアプローチを選択
2. Serena MCPを使用：
   • すべての開発タスク: Serena MCPツール () を使用
   • 分析、デバッグ、実装: Serenaのセマンティックコードツールを使用
3. 選択したMCPで構造化されたアプローチを実行
4. 必要に応じてContext7 MCPで関連ドキュメントをリサーチ
5. 具体的な次のステップを含む実行可能な解決策を統合
6. -sフラグ使用時は実装タスクを作成

主要ガイドライン:

• 最優先: すべてのタスク（コンポーネント、API、機能、分析）でSerena MCPツールを使用
• 活用: Serenaのセマンティックコード検索と編集機能を最大限活用
• 問題分析から開始し、具体的なアクションで終了
• 深さとトークン効率のバランスを保つ
• 常に具体的で実行可能な推奨事項を提供
• セキュリティ、パフォーマンス、保守性を考慮

トークン効率化のコツ:

• シンプルな問題には -q を使用（約40%のトークン節約）
• 概要のみ必要な場合は --summary を使用
• 関連する問題を1つのセッションにまとめる
• 無関係な分析を避けるために --focus を使用

📚 使用パターン別解説

1. 基本的な使用方法

2. 高度な使用方法

🎯 問題タイプ別の自動選択

Serenaはキーワードベースで最適な思考パターンを自動選択します：

🐛 デバッグパターン（5-8思考ステップ）

トリガーキーワード: error, bug, issue, broken, failing, エラー, バグ, 不具合, 壊れた, 失敗

実行される思考プロセス:

1. 🔍 症状分析 - エラーメッセージと発生状況を詳細に分析
2. 🌍 環境確認 - 開発/本番環境、依存関係をチェック
3. 💡 原因仮説 - 可能性のある原因を複数リストアップ
4. 🔬 検証 - 各仮説を順次検証
5. 🛠️ 解決策 - 最適な修正方法を提案
6. 📝 実装 - 具体的なコード変更を実施
7. ✅ 検証戦略 - 修正が正しく動作することを確認
8. 🛡️ 予防措置 - 再発防止策を提案

🏗️ 設計パターン（8-12思考ステップ）

トリガーキーワード: architecture, system, structure, plan, 設計, アーキテクチャ, システム, 構造

実行される思考プロセス:

1. 📋 要件整理 - ビジネス要件と技術要件を明確化
2. 🚧 制約確認 - 予算、時間、技術的制約を把握
3. 👥 ステークホルダー分析 - 関係者のニーズを理解
4. 🎨 選択肢生成 - 複数のアーキテクチャ案を作成
5. ⚖️ 評価 - 各案のメリット・デメリットを比較
6. 🔧 技術選定 - 最適な技術スタックを決定
7. 📐 設計決定 - アーキテクチャとトレードオフを決定
8. 📅 実装フェーズ - 段階的な実装計画を策定
9. ⚠️ リスク軽減 - 潜在的リスクへの対策
10. 📊 成功指標 - KPIと評価基準を設定
11. 🔍 検証計画 - テストと検証の戦略
12. 📚 ドキュメント - 必要な文書を作成

⚡ 実装パターン（6-10思考ステップ）

トリガーキーワード: build, create, add, feature, 実装, 構築, 作成, 追加, 機能

実行される思考プロセス:

1. 📝 仕様確認 - 機能要件とスコープを定義
2. 🎯 技術選定 - 実装アプローチを決定
3. 🏛️ 設計 - コンポーネント構造を設計
4. 🔗 依存関係 - 統合ポイントを特定
5. 📋 実装順序 - 開発の優先順位を決定
6. 🧪 テスト戦略 - テスト計画を策定
7. 🛡️ エッジケース - 例外処理を設計
8. ⚡ パフォーマンス - 最適化ポイントを特定
9. 🚨 エラーハンドリング - エラー処理とリカバリー
10. 🚀 デプロイ計画 - リリースとロールバック戦略

🚀 最適化パターン（4-7思考ステップ）

トリガーキーワード: performance, slow, improve, refactor, 最適化, 遅い, 改善, リファクタリング

実行される思考プロセス:

1. 📈 現状分析 - パフォーマンスメトリクスを測定
2. 🎯 ボトルネック特定 - 問題箇所を特定
3. 💡 改善機会 - 最適化可能な箇所をリストアップ
4. 🔄 解決選択肢 - 複数の改善案を比較
5. 📊 優先度 - 実装の優先順位を決定
6. 📉 実装影響評価 - パフォーマンス向上の予測
7. ✅ 検証計画 - 改善効果の測定方法

💡 実践的な使用例

ケース1: 緊急バグ修正

ケース2: 新機能の完全実装

ケース3: パフォーマンス改善

ケース4: アーキテクチャ設計

🎮 オプションの組み合わせ戦略

初心者向け

中級者向け

上級者向け

📊 効果的な使い分け

🔍 トラブルシューティング

よくある質問

Q: 思考ステップが多すぎる場合は？

Q: 特定の領域だけ分析したい場合は？

Q: トークンを節約したい場合は？