mcpField
D
diffity-resolve-tree

diffity-resolve-tree

github.com/nilbuild開発8951.5k 回インストール1 日前に更新
リポジトリ

diffity-resolve-tree について

diffity-resolve-treeは、コーディングエージェント向けのスキルです。diffityのファイルツリーブラウザーに寄せられたコメントを確認し、依頼された変更を行ってスレッドを解決します。特定または未解決のコメントを対象にできます。

主な機能

  1. 01未解決のファイルコメントを確認
  2. 02依頼に応じてコードや文書を変更
  3. 03概要を付けてスレッドを解決
  4. 04解決前に質問へ返信
  5. 05スレッドIDで対象を指定

活用シーン

  1. 01リポジトリファイルへのフィードバックを反映
  2. 02ファイルに関する質問に回答
  3. 03コード変更後にコメントを解決

MCP 対応

このスキルはdiffityコマンドラインでファイルコメントを確認・管理します。MCPとの直接連携については入力に記載されていません。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/nilbuild/diffity --skill diffity-resolve-tree

インストール後、Claude Code で/diffity-resolve-treeを入力して読み込まれたか確認します。

詳細

Diffity Resolve Tree スキル

diffity tree ブラウザーでリポジトリのファイルに残された未解決のコメントを確認し、依頼されたコード変更を行って解決します。

引数

  • thread-id（任意）：すべての未解決スレッドではなく、IDを指定して特定のスレッドを解決します。例：/diffity-resolve-tree abc123

CLI リファレンス

diffity agent list [--status open|resolved|dismissed] [--json]
diffity agent comment --file <path> --line <n> [--end-line <n>] --body "<text>"
diffity agent resolve <id> [--summary "<text>"]
diffity agent dismiss <id> [--reason "<text>"]
diffity agent reply <id> --body "<text>"
  • comment には --file、--line、--body が必須です
  • --end-line のデフォルト値は --line です（1行のコメント）
  • <id> には完全な UUID または8文字のプレフィックスを指定できます

前提条件

  1. diffity が利用可能か確認します。which diffity を実行してください。見つからない場合は、npm install -g diffity でインストールします。
  2. ツリーセッションが存在するか確認します。diffity agent list を実行してください。「No active review session」というエラーが発生した場合は、先に diffity tree を開始するようユーザーに伝えます（例：diffity tree）。

手順

  1. 詳細情報を含め、未解決のコメントスレッドを一覧表示します。 
    diffity agent list --status open --json
    thread-id 引数が指定されている場合は、そのスレッドだけに絞り込みます。JSON 出力には、各スレッドのコメント本文、ファイルパス、行番号、サイドが含まれます。
  2. 未解決のスレッドがない場合は、解決するものがないことをユーザーに伝えます。
  3. 未解決のスレッドごとに、次の手順を行います。 a. 一般コメント（filePath が __general__ のもの）はスキップします。これらは要約であり、対応が必要なコード変更ではありません。 b. 最後のコメントが、ユーザーに質問をしていてユーザーがまだ回答していないエージェントの返信であるスレッドはスキップします。エージェントはユーザーの入力を待っています。 c. ユーザーからの [question] コメントの場合は、質問を読み、該当するコードを確認して回答します。 
    diffity agent reply <thread-id> --body "Your answer here"
    その後、回答の要約を添えてスレッドを解決します。 d. 明示的な [question] タグがなく、質問形式で書かれたコメント（例：「Xを追加すべきですか？」や「これを改名できますか？」）は提案です。対応が必要な依頼として扱い、変更を行います。 e. JSON 出力からコメント本文を読み、依頼されている変更を把握します。コメントは特定のファイルと行範囲に紐付いています。背景を理解するため、ファイル全体を読みます。
    • コメントがコード変更、リファクタリング、または改善を提案している場合は、変更を行います。
    • コメントがドキュメントの追加を提案している場合は、該当するドキュメントを追加または更新します。
    • コメントの内容が本当に不明瞭な場合は、説明を求める返信をします。 
      diffity agent reply <thread-id> --body "Could you clarify what change you'd like here?"
    f. 変更後、要約を添えてスレッドを解決します。 
    diffity agent resolve <thread-id> --summary "Fixed: <brief description of what was changed>"
  4. 対応可能なスレッドをすべて解決した後、diffity agent list を実行して状態を確認します。
  5. ブラウザーを確認するようユーザーに伝えます。ポーリングにより、2秒以内に解決済みの状態が表示されます。

コメント

Markdown 対応