技能介绍

为什么需要自动化提交说明生成

在日常开发中，Git 提交记录（Commit Message）是团队协作和代码审查的重要依据。然而，手动编写符合 Conventional Commits 规范的提交说明往往耗费精力，且容易因为主观疏忽导致格式不统一或描述模糊。开发者经常面临“代码改完了，但不知道如何精准概括这次改动”的困境，劣质的提交信息会让后续的 git log 和自动化版本生成变得混乱。

核心工作流与能力

该技能专注于分析暂存区（Staging Area）的代码差异，并自动生成符合规范的提交说明。其核心工作流包含以下关键步骤：

差异分析：通过 git diff --cached --stat 快速评估变更文件范围，随后执行 git diff --cached 深入查看具体的代码改动内容。
类型判定：根据 diff 内容，准确识别本次提交的类型（如 feat、fix、refactor、docs 等）。
规范输出：撰写不超过 72 个字符的祈使句主题行（Subject Line），并补充说明“为什么做此改动”的正文段落（Body）。
纯文本交付：最终输出为纯净的文本格式，直接适配 git commit -m 命令，无需任何代码块包裹。

适用边界与安全注意

作为开发者的辅助工具，该技能严格遵循只读分析和建议原则。它不会自动安装依赖、修改系统权限或创建持久化后台任务。涉及代码执行时，命令仅作为参考，必须在用户明确要求且目标范围清晰时才可运行。此外，对于涉及发送、发布、删除或部署等外部写入操作，技能会先展示目标与潜在影响，并强制要求用户明确确认，确保开发流程的安全可控。