📦 Commit Message Generator — 提交信息生成器

Commit Message Writer 根据 git diff 生成符合规范、带作用域且描述清晰的提交信息——告别 “fixed bug” 或 “updated files”。

何时使用 ✅ 用此技能： “为已暂存的改动写提交信息” “根据这个 diff 生成提交信息” “把上次提交信息改写成规范格式” “为 commits abc..def 生成 changelog 风格信息” “总结本分支的变更” “为所有未推送的提交生成信息” “检查我的提交信息是否合规”

❌ 勿用： 需要解释大规模重构 → 用代码审查技能 需要完整的版本间 changelog → 用发布工具 仅二进制仓库（无有效 diff）

工作原理 读取 git diff（已暂存、分支或内联提供） 分析变更文件、受影响函数/类及变更性质 构建 Conventional Commits 格式： (): <简短摘要>

可用动作 write:staged 读取 git diff --staged 并生成提交信息。 “为已暂存的改动写提交信息” → 分析暂存 diff，输出带类型、作用域、描述、正文的规范信息。

write:diff 对比当前分支与基分支（main/master）。 “将本分支所有变更总结为一条提交信息”

write:range 为一段提交范围生成 changelog 或多条提交信息。 “为 HEAD~5..HEAD 生成规范提交信息”

write:provided 给定内联 diff 或文件列表，生成提交信息。 “这是一段 diff：[…粘贴 diff…]，写提交信息”

rewrite:last 将最近一条提交信息改写成规范格式。 “把上次提交信息改写成规范格式”

validate 检查信息是否符合 Conventional Commits。 “验证这条信息：‘fix(api): handle null pointer in user lookup’” → 确认有效或指出需修正处。

提交类型参考 Type 用途 feat 新功能 fix 修复 bug docs 仅文档变更 style 格式、漏分号等（无逻辑改动） refactor 既不修复 bug 也不新增功能的代码调整 perf 性能优化 test 新增或修正测试 chore 构建、CI、依赖、工具 ci CI/CD 配置变更

示例 用户：“为已暂存的改动写提交信息” 助手：（运行 git diff --staged 并分析） feat(auth): add OAuth2 refresh token rotation

• 每次刷新令牌时执行轮换
• 用后立即作废旧刷新令牌
• 新增刷新令牌 TTL 配置（默认 30 天）
• 更新令牌端点以返回轮换后的刷新令牌

备注 始终在建议 git commit 前展示拟用信息。 尊重 .gitignore，不 diff 被忽略文件。 大 diff（>500 行）按块级变更汇总，而非逐行。