提交消息生成器

基于您的 git 差异（diff）自动生成符合规范、描述清晰、作用域明确的提交消息——告别“修复 bug”或“更新文件”这类模糊表述。

适用场景

✅ 请在以下情况使用该能力：

• “为我的暂存变更编写提交消息”
• “基于此 diff 生成提交消息”
• “将我上一次的提交消息重写为符合规范的格式”
• “为提交范围 abc..def 生成类似变更日志（changelog）风格的消息”
• “总结当前分支中发生了哪些变更”
• “为所有尚未推送的提交生成提交消息”
• “检查我的提交消息是否符合规范”

❌ 请勿在以下情况使用该能力：

• 需要详细解释大规模重构 → 请使用代码审查（code review）能力
• 需要在版本间生成完整变更日志 → 请使用发布工具（release tool）
• 操作仅含二进制文件的仓库（无有意义的 diff）

工作原理

1. 读取 git diff（暂存区、分支对比，或用户内联提供的 diff）
2. 分析变更涉及的文件、受影响的函数/类，以及每处变更的性质
3. 构造一条符合Conventional Commits规范的提交消息：

   <类型>(<作用域>): <简短摘要>
   
   <正文>
   
   <页脚>
   

4. 附带推理说明，供您在提交前审阅确认

可用操作

write:staged

读取 git diff --staged 并生成提交消息。

Write a commit message for my staged changes

→ 分析暂存区 diff，输出格式化提交消息，包含类型、作用域、描述与正文。

write:diff

读取当前分支与其基线（main/master）之间的变更。

Summarize all changes in this branch as a commit message

write:range

为指定提交范围生成变更日志或多条提交消息。

Generate conventional commit messages for commits HEAD~5..HEAD

write:provided

根据用户内联提供的 diff 或文件列表生成提交消息。

Here's a diff: [...paste diff...]. Write a commit message.

rewrite:last

优化上一次提交消息，使其符合 Conventional Commits 规范。

Rewrite my last commit message in conventional format

validate

校验某条提交消息是否符合 Conventional Commits 规范。

Validate this message: "fix(api): handle null pointer in user lookup"

→ 确认其有效性，或指出需修正的问题。

提交类型参考表

示例

用户：“为我的暂存变更编写提交消息”

助手：（执行 git diff --staged，分析变更）

feat(auth): add OAuth2 refresh token rotation

- Implement refresh token rotation on every token refresh
- Invalidate old refresh tokens immediately after use
- Add TTL config for refresh tokens (default 30 days)
- Update token endpoint to return rotated refresh token

Closes: #452

注意事项

• 始终在建议执行 git commit 前向您展示拟议的提交消息。
• 尊重 .gitignore 配置 — 不会对被忽略的文件尝试生成 diff。
• 对于大体积 diff（超过 500 行），将按代码块（chunk）级别进行概括，而非逐行分析。