explain-comment

Explain Comment

指定されたファイルまたは範囲のコードを読み込み、重要な部分に説明コメントを追加する。

$ARGUMENTS

手順

1. 対象コードを読み込む

$ARGUMENTS で指定されたファイルパス（およびオプションの行範囲）を Read ツールで読み込む。

• src/app.rs — ファイル全体
• src/app.rs:10-50 — 行範囲指定
• 引数が空の場合、現在 Viewer で開いているファイルを対象とする

2. コードを分析

読み込んだコードの中から、説明が有用な箇所を特定する：

• 関数・メソッド定義 — 目的、引数、戻り値の意味
• 構造体・列挙型 — 各フィールドの役割、設計意図
• 複雑なロジック — アルゴリズム、条件分岐の理由、エッジケース処理
• パターン・慣用句 — Rust 固有のパターン（ライフタイム、トレイト境界等）
• 重要な副作用 — DB 操作、ファイル I/O、状態変更

自明なコード（getter/setter、単純な代入等）にはコメントを追加しない。

3. 説明コメントを追加

各箇所に対して mcp__conductor__create_comment を使用してコメントを追加する。

mcp__conductor__create_comment:
  file_path: <対象ファイルの相対パス>
  line_start: <開始行番号>
  line_end: <終了行番号（省略可）>
  body: <説明文>
  kind: "question"

コメント作成のガイドライン

• 簡潔かつ正確に — 1〜3文で要点を伝える
• 「なぜ」を重視 — 何をしているかではなく、なぜそうしているかを説明
• コンテキストを含める — 他のモジュールとの関係、設計判断の背景
• 日本語で記述 — ユーザーの言語に合わせる
• kind は "question" を使用 — 説明コメントは質問形式（❓）で統一

コメント例

良い例:

• この HashMap キャッシュは、毎フレームの O(n) スキャンを避けるため。ファイル変更時に invalidate する
• git2 の diff は working tree 差分を返すが、ここでは HEAD との差分が必要なので reverse している

悪い例:

• Vec を作成している （自明）
• for ループ （コードを読めばわかる）

4. 複数箇所は並列実行

独立した箇所のコメント追加は並列で実行する。同一ファイルの近い行に対する複数コメントも並列実行可能。

5. サマリーを報告

追加したコメントの一覧を報告する：

## Explain Comment 完了

### 追加したコメント
| 行 | 対象 | 説明の要約 |
|----|------|-----------|
| L42 | `process_data()` | データ変換パイプラインの概要 |
| L78-85 | match 式 | エラーリカバリ戦略の説明 |
| ... | ... | ... |

合計: N 件のコメントを追加

重要

• コメントはコードファイルに直接書き込むのではなく、Conductor の code comment 機能（mcp__conductor__create_comment）を使って追加する
• 追加されたコメントは Conductor の Viewer パネルで 💬 マークとして表示される
• 関連する MCP ツール（mcp__conductor__reply_to_comment 等）も必要に応じて活用してよい