commit-messages

此技能为软件开发人员提供了一个标准化工作流程，用于创建高质量、具描述性且一致的 git 提交信息。通过分析 git diff --staged 的暂存变更，代理程序能识别修改的性质（例如功能新增、错误修复、重构或性能改进），并将其对应至 Conventional Commits 规范。这能确保存储库历史保持简洁、易读，并可供自动化变更日志生成与版本控制工具解析。

此技能专为需要在专业环境中遵守严格版本控制规范、且希望减轻手动起草信息负担的开发人员所设计。它能根据分析的代码上下文，智慧地建议适当的类型 (type) 与范围 (scope)，有效弥补原始代码变更与专业项目文档之间的差距。

• 自动分析已暂存的 git diff 以总结代码变更。

• 强制执行 Conventional Commits 格式，包含类型、范围、主旨行、内文与页尾。

• 支持标准提交类型，如 feat, fix, docs, style, refactor, perf, test, build, ci, chore 及 revert。

• 遵守各项最佳实践，例如祈使句语气、最大行长度限制 (72 字符) 以及重大变更的适当格式。

• 支持议题引用，允许用户将提交直接链接至 GitHub Issues 或 Jira 等追踪系统。

• 提供互动式反馈机制，代理程序会显示摘要、提议信息，并允许用户在最终提交前进行检阅或修改。

• 使用说明：在触发技能前，请务必先暂存您的文件 (git add)，以确保代理程序能完整检视变更。

• 适用于预提交阶段 (pre-commit)、检阅变更时或准备发布版本时。

• 输入：Git 暂存变更；输出：准备执行且格式化后的提交信息字符串。

• 实用建议：若代理程序建议的范围不正确，请在后续提示中提供正确的上下文以提高准确性。

• 此工具是 Claude Code Mastery 工具包的核心组件，强调确定性的质量门槛与存储库标准强制执行。