作为一名 开发者，每天都会和 Git Commit 打交道 —— 可能是自己提交的功能，也可能是接手别人的代码。面对一个 Commit，你是否有过这些困惑：

• 看不懂核心原理，只能照抄代码？
• 想写技术文档，但不知道从何下手？
• 想补相关知识点，却不知道该学什么、怎么学？

今天分享一个「万能方法」：给 AI 喂精准的指令，让它帮你把一个 Commit 从「代码片段」拆解成「原理解析 + 标准化文档 + 学习路径」，不管是复盘自己的代码，还是接手别人的工作，都能直接用。

一、找到喂给AI的精准素材

AI 解释的精准度，80% 取决于你给的素材是否完整。首先要整理好 Commit 相关的所有信息：

1. 必准备素材

Commit ID：通过git show 导出完整信息（含代码、备注、作者）；
完整代码 diff：用git diff ^ 导出修改前后的对比；
Commit 核心目的：如果备注太简单，补充一句「这个 Commit 是做什么的」
上下文补充（可选但推荐）：该 Commit 属于哪个模块？用了哪些框架 / 库？解决了什么业务问题？

2. 快速导出素材的 Git 命令

# 导出Commit完整信息（保存到文件，方便复制）
git show <你的Commit-ID> > commit_detail.txt

# 导出Commit代码差异
git diff <你的Commit-ID>^ <你的Commit-ID> > commit_diff.txt

二、给 AI 写「结构化指令模板」

不要只说「解释这个 Commit」，要明确要求 AI 按固定格式输出。下面是我整理的「万能指令模板」:

请你基于以下 commit 信息，完成 3 件事：

### 素材信息
1. commit 核心目的：【比如：修复xxx问题】
2. commit 完整代码 diff：【粘贴你导出的 diff 代码，或直接粘贴 git show 输出的内容】
3. 补充上下文（可选）：【比如：该模块基于xxxx开发，使用了 xxx 框架】

### 要求输出格式
#### 一、原理详细解释
1. 这个 commit 核心实现了什么功能？解决了什么问题？
2. 关键代码的底层原理（比如用到的算法、框架机制、原理），用「新手能懂」的语言解释，不要只说「调用了 XX 方法」。
3. 为什么要这么改？对比修改前的问题，修改后的优化点在哪里？

#### 二、生成标准化文档
按「功能说明+实现原理+使用方式+注意事项」的结构生成技术文档，适配团队内部文档规范（Markdown 格式）。

#### 三、规划学习知识点
1. 核心必学知识点（3-5 个）：必须掌握才能理解/复刻这个 commit 的内容，标注学习优先级（高/中/低）。
2. 拓展学习知识点（可选）：能深化理解，但不影响核心功能的知识点。
3. 学习路径建议：先学什么，再学什么，推荐 1-2 个具体的学习资源（比如官方文档、B站教程、书籍）。

这个方法的核心不是「让AI替你干活」，而是「用AI帮你理清思路」——把碎片化的Commit转化为系统化的知识，既解决了文档撰写的麻烦，又能精准规划学习方向，避免盲目追新。不管是Android开发还是其他技术方向，这个指令模板都能直接套用，希望能帮你高效吃透每一行代码，把控好开发质量～