Claude写Git提交说明时提示词需含哪些背景信息

```html 写好 Git 提交说明，这件事远不止敲几行字那么简单。尤其是当这部分工作交由 AI（如 Claude）处理时——如果提示词中没有嵌入真实的项目上下文，输出的结果大概率是“修复 bug”、“优化性能”这类看了等于没看的空话。因此，关键在于如何让 Claude 准确理解你到底改动过什么。 举个例子。如果团队使用的是 Vue 3 + TypeScript + Pinia 这套技术栈，但你未明确告知，它可能会默认采用 React Hooks 那一套语法来撰写描述，甚至把 Pinia store 误称为 Redux slice。所以第一步务必明确：这是一个基于 Vue 3 + TypeScript + Pinia 的管理后台，采用 Vite 构建，API 通信依赖 axios 封装的 request 模块。缺少这句话，上下文就会断层。 光说明技术栈还不够。如果你只说“跟订单有关”，Claude 大概率会按文件路径去猜测 scope，最终生成类似 `src/views/order/OrderConfirm.vue` 这样的内容——这谁能看懂？因此必须精确到业务领域，例如“本次修改属于【订单中心】模块，涉及用户下单流程中的优惠券选择与校验环节”。越具体，生成的说明越能直击要害。 还有一个容易被忽视的细节：最近一次相关提交的信息。比如“上一次对同一逻辑的修改是 3 天前的提交 a1b2c3d：fix(优惠券): 修复满减门槛未生效问题”。这能帮助 Claude 理解演进脉络，避免它写出自相矛盾的描述。毕竟 Claude 没有记忆，依赖的就是你提供的信息。 代码变更是最核心的部分。这里有两种方法。一种是直接将 diff 片段扔进去——例如把 `git diff --no-index` 的结果粘贴到提示词中，Claude 就能准确提取出“删除了 checkEligibility 函数中对 couponId === null 的兜底判断”这个事实。另一种是自己提炼三要素：改了什么、为什么改、影响范围。比如“【改了什么】删除 useCoupon.ts 中 checkEligibility 函数内对 couponId === null 的手动判空；【为什么改】后端已保证 couponId 必传，该判断冗余且干扰错误定位；【影响范围】仅影响前端优惠券选择后的实时校验”。这两种方法中，我最推荐第一种，因为它细节更准确、可控性更高。 最后是提交格式的硬性规范。严格遵循中文 Conventional Commits 格式：type 统一使用 feat、fix、refactor、chore 这几个，括号内写中文业务名，例如（优惠券）（订单列表）。禁止出现文件名、类名、技术术语，也不允许写“优化代码”“提升可维护性”这类说了等于没说的话。还有一个常见问题：AI 喜欢用顿号并列多个改动。这不行，一个提交只能对应一个语义，多个改动就拆成多个提交。subject 长度也不能超过 28 个汉字，塞不下的就截断加省略号，不允许换行。这几条规定虽然严格，但实际使用下来你会发现，它倒逼人类作者先把自己的逻辑理清楚，反而节省了大量返工的时间。 ```