mcpField
E
explain-your-changes

explain-your-changes

github.com/aymericderbois開発45 回インストール
リポジトリ

explain-your-changes について

explain-your-changesは、コーディングエージェント向けのスキルです。セッションで変更した各ファイルの差分を示し、必要な場合だけ理由を添えて説明します。依頼があればreport-renderでHTMLレポートに整形できます。

主な機能

  1. 01変更ファイルごとの差分表示
  2. 02変更内容と必要な理由の説明
  3. 03全変更ファイルの網羅
  4. 04依頼に応じたHTML形式への整形

活用シーン

  1. 01コーディングエージェントの変更確認
  2. 02明らかでない実装判断の説明
  3. 03HTML変更レポートの作成

インストール

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

$npx skills add https://github.com/aymericderbois/skills --skill explain-your-changes

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

詳細

セッション中に変更された各ファイルについて、diffを示してから、変更内容と、必要であればその理由を説明してください。理由はdiffから読み取れない場合にのみ追加してください。明らかなインポートや名前変更については、理由を説明する必要はありません。

変更されたすべてのファイルを対象にしてください。説明のない変更を残さないでください。

**`blog/constants.py:5`** ```diff +WORDS_PER_MINUTE = 200 ```

読了時間の推定に使用する平均読書速度です。計算でマジックナンバーを使わないようにします。

blog/models.py:24

+    def reading_time(self) -> int:
+        return max(1, round(len(self.body.split()) / WORDS_PER_MINUTE))

モデルに新しいメソッドを追加します。単語数をもとに読了時間を分単位で推定し、非常に短い記事でも最低1分とします。

templates/blog/detail.html:8

 <link rel="stylesheet" href="/static/css/article.css">
+<link rel="stylesheet" href="/static/css/meta.css">

メタデータの行（著者、日付、読了時間）のスタイルシートを読み込みます。

templates/blog/detail.html:21

-    <div class="meta">{{ post.published_at|date:"d/m/Y" }}</div>
+    <div class="meta">
+      {{ post.published_at|date:"d/m/Y" }} · {{ post.reading_time }} min de lecture
+    </div>

公開日の横に読了時間を追加します。値はモデルの reading_time メソッドから取得します。

ユーザーが変更内容のHTMLレポートを作成してほしいと依頼した場合（「HTMLレポートを作って」など）、report-render スキルでこの説明（diffとコメント）を .reports/<slug>.report.html に整形します。

コメント

Markdown 対応