mcpField
E
explain-your-changes

explain-your-changes

github.com/aymericderbois开发45 次安装
代码仓库

关于 explain-your-changes

explain-your-changes 是面向编码 Agent 的技能，逐个展示会话中修改文件的差异并说明改动，仅在必要时补充原因。用户要求 HTML 报告时，可通过 report-render 排版说明。

主要功能

  1. 01展示每个修改文件的差异
  2. 02说明改动并酌情解释原因
  3. 03覆盖所有修改文件
  4. 04按需生成 HTML 格式说明

适用场景

  1. 01检查编码 Agent 会话中的改动
  2. 02解释不明显的实现决策
  3. 03整理 HTML 改动报告

安装

复制下面的命令，在终端中运行。

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

安装后在 Claude Code 中输入/explain-your-changes确认已加载。

详细介绍

对于本次会话中修改的每个文件，展示差异，然后说明改了什么，以及必要时说明原因。只有在原因无法从差异中看出来时才补充原因；显而易见的导入或重命名无需解释。

涵盖所有修改过的文件：每项改动都必须有说明。

**`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 技能会将这些说明（差异 + 注释）排版到 .reports/<slug>.report.html 中。

评论

支持 Markdown