用途:为当前工作区中未暂存的代码改动生成一条可直接使用的 Git 提交信息,帮助开发者快速完成提交说明的撰写。
主要能力:
- 先阅读项目中的 AGENTS.md,遵循项目通用规范。
- 使用 git diff 查看未暂存改动;必要时用 git diff HEAD 获取当前分支全部改动的额外上下文。
- 参考 git log --oneline -40 中的既有提交信息风格。
- 快速分析改动带来的收益、理由与动机,除非用户另有要求,否则保持快速响应。
- 输出一条紧凑的单行提交信息,作为用户应使用的提交信息。
格式与规则:
- 提交信息为一行;必要时可在首行下以“-”开头的无序列表补充重要信息。
- 当改动与发布说明相关时追加可选的“##”标签;崩溃与内存安全修复标记为“##crash”。
- 不使用 emoji。
- 描述用户现在会注意到什么可用或不再出错。
- 以 Fix、Add、Remove、Keep、Stop、Don't 等直接动词开头。
- 用几个词点明结果,例如避免在损坏的 bflt 中泄漏重定位、一次性生成 Windows 类型 sdb、修复移位溢出与 ASR 符号扩展。
- 避免内部设计术语与含糊行话。
- 使用一条自然语句,长度低于 70 个字符。
- 输出至少低于 70 列。
- 参考主分支中已有提交,采用随意的写作风格。
使用方式:在存在未暂存改动的仓库中调用该技能,按上述步骤读取差异与日志,最终得到一条提交信息。
适用场景:需要为当前未暂存改动快速拟定提交信息、并希望与项目既有提交风格保持一致时。
限制:该技能为只读操作,不修改或触碰任何文件;若发现改动不宜合并到主分支,应向用户说明。