pal

Pal MCP Toolkit

Pal MCP Toolkit は、包括的なコード分析と開発ワークフローのための専門ツールを提供します。各ツールは、専門家による検証を伴う複数ステップのワークフローパターンに従います。

クイックリファレンス：ツールの選択

タスクの種類	ツール	リファレンス
複雑なタスクに取りかかる前のアーキテクチャとコード分析	mcp__zen__analyze	analyze.md
バグ調査と根本原因分析	mcp__zen__debug	debug.md
戦略的な計画とタスクの分割	mcp__zen__planner	planner.md
コードスメルの検出とリファクタリング	mcp__zen__refactor	refactor.md
タスク完了後のコードレビュー	mcp__zen__codereview	review.md
実行フローと依存関係の追跡	mcp__zen__tracer	tracer.md

重要なワークフロー要件

必須の完了ルール

• 絶対に next_step_required: false が返される前にワークフローを終了しないでください
• 必ず next_step_required: true の場合は step_number を増やしてツールを再度呼び出してください
• タスクの無効化：ワークフローが未完了の場合、タスクは直ちに却下されます
• 例外なし：ステップ1の後に分析が完了したように見えても、必ずすべてのステップを完了してください

モデル要件

• 必須：すべての Pal MCP ツール呼び出しでは、常に model: "anthropic/claude-opus-4.6" を使用してください
• 禁止：Pal MCP ツールの呼び出しに、ほかのモデルを使用しないでください

ワークフロー検証チェックリスト

1. すべての応答で next_step_required を確認します
2. true の場合は、step_number を増やしてツールを再度呼び出します
3. next_step_required: true の間は、実装に進まないでください
4. ワークフローが完了するのは、next_step_required: false の場合のみです

ツールの概要

Analyze（mcp__zen__analyze）

使用する場面：

• 複雑なタスクに取りかかる前に、既存のアーキテクチャを把握する
• アーキテクチャレビューとシステム設計の評価
• パフォーマンス、セキュリティ、技術的負債の分析

主なパラメーター：

• analysis_type："architecture" | "performance" | "security" | "quality" | "general"
• output_format："summary" | "detailed" | "actionable"

詳細なドキュメントについては、references/analyze.md を参照してください。

---

Debug（mcp__zen__debug）

使用する場面：

• バグ調査と根本原因分析
• パフォーマンスの問題、メモリーリーク、競合状態
• 統合の失敗やサービス間の通信問題

主なパラメーター：

• hypothesis：根本原因についての現在の仮説
• confidence："exploring" | "low" | "medium" | "high" | "very_high" | "almost_certain" | "certain"

詳細なドキュメントについては、references/debug.md を参照してください。

---

Planner（mcp__zen__planner）

使用する場面：

• 複雑なタスクを管理しやすいステップに分割する
• システム設計とアーキテクチャ上の判断
• 移行計画と実装戦略

主なパラメーター：

• is_step_revision：以前のステップを調整する場合に使用
• is_branch_point：代替アプローチを検討する場合に使用
• branch_id：代替アプローチの命名

詳細なドキュメントについては、references/planner.md を参照してください。

---

Refactor（mcp__zen__refactor）

使用する場面：

• コードスメルと技術的負債への対処
• 大規模なモジュールやクラスの分割
• レガシーパターンのモダン化

主なパラメーター：

• refactor_type："codesmells" | "decompose" | "modernize" | "organization"
• focus_areas：["performance", "readability", "maintainability", "security"]

詳細なドキュメントについては、references/refactor.md を参照してください。

---

コードレビュー（mcp__zen__codereview）

使用するタイミング：

• タスクの完了後（必須）
• プルリクエストの提出前
• プロジェクト標準に照らした実装の検証

主なパラメーター：

• review_type：包括的な分析には "full"
• severity_filter：すべての重大度レベルを対象にするには "all"
• focus_on：「パフォーマンス」、「セキュリティ」、「型安全性」など、対象領域を指定します

詳しくは、references/review.md を参照してください。

---

トレーサー（mcp__zen__tracer）

使用するタイミング：

• コードの実行経路を把握するとき
• リファクタリング前に依存関係をマッピングするとき
• 複雑な処理フローをデバッグするとき

主なパラメーター：

• trace_mode："precision"（実行フロー）｜"dependencies"（構造分析）｜"ask"
• target_description：追跡する対象とその理由を明確に記述します

詳しくは、references/tracer.md を参照してください。

共通の必須パラメーター

すべての Pal MCP ツールで、次の基本パラメーターが必要です。

{
  "step": "Description of current step",
  "step_number": 1,
  "total_steps": 2,
  "next_step_required": true,
  "findings": "Findings from this step",
  "model": "anthropic/claude-opus-4.6"
}

ファイルパスの要件

• relevant_files には必ず完全な絶対パスを使用してください
• 分析に直接関係するファイルを含めてください
• コンテキストを提供する関連ファイルを含めてください
• 該当する場合はテストファイルを含めてください

一般的なワークフローのパターン

1. 開始：step_number: 1 と初期戦略を指定してツールを呼び出します
2. 反復：step_number を増やし、前のステップに基づいて調査結果を洗練させます
3. 継続：next_step_required: false になるまで呼び出しを続けます
4. 完了：ワークフローが完了してから実装に進んでください

違反例（タスクの却下）

• Pal ツールを一度だけ呼び出して実装に進む
• 分析が完了したように見えるという理由でステップを省略する
• next_step_required: false になる前に実装を開始する
• anthropic/claude-opus-4.6 以外のモデルを使用する