必须注入真实项目上下文：①技术栈（如vue 3+ts+pinia）；②具体业务域（如【订单中心】优惠券选择环节）；③最近相关提交哈希或描述；④提供diff或人工提炼的“改了什么/为什么改/影响范围”；⑤强制中文conventional commits格式、禁用虚词、subject≤28汉字。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
让Claude生成符合团队规范、语义清晰、可追溯的中文Git提交说明，必须在提示词中注入真实项目上下文，否则它只会输出“修复bug”“添加功能”这类无效信息。
必须提供的项目基础背景
第一步：明确当前项目的技术栈和框架。例如，“这是一个基于Vue 3 + TypeScript + Pinia的前端管理后台，使用Vite构建，API通信通过axios封装的request模块”。没有这句，Claude可能默认用React Hooks语法写变更描述，或把Pinia store误称为Redux slice。
第二步：声明本次变更所处的业务域。直接写明“本次修改属于【订单中心】模块，涉及用户下单流程中的优惠券选择与校验环节”，而不是笼统说“跟订单有关”。【不写具体业务域，Claude会从文件路径猜scope，结果常是src/views/order/OrderConfirm.vue——人类完全看不懂】
第三步：给出最近一次相关提交的哈希或简要描述。比如“上一次对同一逻辑的修改是3天前的提交 a1b2c3d：fix(优惠券): 修复满减门槛未生效问题”。这能让Claude理解演进脉络，避免重复描述或矛盾表述。
必须嵌入的代码变更事实
方法一：提供原始diff片段（最推荐）。把git diff --no-index src/composables/useCoupon.ts src/composables/useCoupon.ts.bak的结果粘贴进去，Claude能据此准确提取出“删除了checkEligibility函数中对couponId === null的兜底判断”这一事实，而不是模糊地说“调整了校验逻辑”。
使用 `gh` CLI 与 GitHub 交互。通过`gh issue`、`gh pr`、`gh run` 和 `gh api` 管理 issue、PR、CI 运行以及高级查询。
方法二：人工提炼三要素。用固定格式写：“【改了什么】删除useCoupon.ts中checkEligibility函数内对couponId === null的手动判空；【为什么改】后端已保证couponId必传，该判断冗余且干扰错误定位；【影响范围】仅影响前端优惠券选择后的实时校验，不影响结算流程”。这比扔一个文件给Claude更可控。
必须声明的提交规范要求
第一步：指定中文 Conventional Commits 格式。明确说“严格按 type(业务域): 中文描述 的格式，type只能从 feat、fix、refactor、chore 中选，括号内必须是中文业务名词如（优惠券）（订单列表）（支付网关），禁止出现文件名、类名、技术术语”。
第二步：禁用AI常见废话。加一句硬约束：“禁止出现‘优化代码’‘提升可维护性’‘遵循最佳实践’等无法验证的虚词；禁止在subject后加英文括号说明如（修复空指针）；每个提交只对应一个独立语义，不得用顿号并列多个改动”。
第三步：设定长度红线。“subject部分不得超过28个汉字，超出则截断并加省略号，不许换行”。这能防止Claude自作主张写成长篇大论。
