mcpField
E
explain

explain

github.com/entireio開発233564 回インストール8 週間前に更新
リポジトリ

explain について

コード履歴を調べ、関数、ファイル、行の変更意図を作成時の会話までたどるスキルです。Entire の履歴とトランスクリプトを利用し、CLI とコミットの追跡可否も確認します。

主な機能

  1. 01コードの意図を元の会話まで追跡
  2. 02関数、ファイル、行変更の説明
  3. 03git 履歴から導入コミットを特定
  4. 04Entire CLI による会話記録の参照

活用シーン

  1. 01関数が追加された理由の把握
  2. 02ファイル作成時の要件の確認
  3. 03特定のコード変更の背景調査

インストール

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

$npx skills add https://github.com/entireio/skills --skill explain

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

詳細

意図を説明

ソースコードが作成された元の会話をたどり、コードの意図を説明します。対象は次のとおりです。

  • 関数 — この関数はなぜ存在するのでしょうか？どのような問題を解決するためのものでしょうか？
  • ファイル — このファイルの目的は何でしょうか？作成のきっかけとなった要件は何でしょうか？
  • 行の変更 — この特定の行はなぜ追加または変更されたのでしょうか？

応答形式

このスキルの呼び出しに対する最初の応答は、次の行から始めてください。

Entire Explain:

その後に空行を入れてから、内容を記述してください。

  • この見出しは、呼び出しに対する最初の応答にのみ適用してください。同じ呼び出し内での後続のターン（たとえば、ユーザーが確認質問に回答した後）では、再度表示しないでください。
  • エラーや早期終了の応答（たとえば、「Entire CLI is required but not installed」、「this file is not tracked by git」、「no session transcript was found for this commit」）には、この見出しを含めないでください。見出しがある場合は、スキルが実行され、実際の出力が生成されたことを示す必要があります。

手順

  1. entire version を実行して、entire CLI がインストールされていることを確認します。
    • コマンドが見つからない場合は、処理を中止し、次のようにユーザーに伝えます。「Entire CLI はインストールされていません。https://entire.io/docs/cli からインストールして、もう一度お試しください。」
  2. Haiku エージェントを使用して、git blame または git log からコードを導入したコミットを特定します。
    • ファイルが git で追跡されていない場合は、処理を中止し、次のようにユーザーに伝えます。「このファイルは git で追跡されていないため、履歴をたどることができません。」
    • git blame で有用な結果が得られない場合（たとえば、コードが未コミットの場合）は、処理を中止し、次のようにユーザーに伝えます。「このコードはまだコミットされていないため、たどれる履歴がありません。」
  3. Sonnet エージェントを使用して、entire checkpoint explain --no-pager --commit COMMIT_SHA からセッショントランスクリプトを読み取ります。
    • コマンドが失敗するか、トランスクリプトが返されない場合は、処理を中止し、次のようにユーザーに伝えます。「このコミットのセッショントランスクリプトが見つかりませんでした。Entire のセッション外で作成された可能性があります（例：手動でのコミット）。」

コメント

Markdown 対応