SuperAPI AI 工具集

git-commit

通用与其它

查看项目

更新于 10-15 21:40

技能介绍

用途:从实际代码变更生成 Conventional Commits 风格的提交信息。核心流程是先查看变更集:已暂存时优先用 git diff --staged,无暂存变更或用户询问未暂存改动时用 git diff,并可用 git status --short 了解文件范围。若仓库存在提交规范文件需先阅读,常见为 COMMIT_CONVENTION.md、CONTRIBUTING.md、.github/COMMIT_CONVENTION.md、.github/CONTRIBUTING.md。随后用 git log --format=%s -n 20 查看近期提交主题,按历史主流语言决定输出语言;语言混杂或无历史时默认英文。

能力:支持单意图提交信息生成;若变更包含不相关意图,建议拆分提交,用户坚持单条时选主导意图并简要说明取舍。头部格式为 <type>(<scope>): <subject>,类型涵盖 feat、fix、perf、refactor、style、test、docs、chore、ci、types、revert、wip;正文仅在有助于说明意图、影响、兼容性或迁移时添加。scope 依据仓库自身约定或变更路径中的稳定模块名推导,无合适 scope 时按本地风格可省略。主题应简短、具体、面向动作,避免 update、fix bug、optimize code 之类含糊表述。

限制:scope 不得照搬参考文件中的示例;混合类型变更需拆分或在正文用类型前缀标注。以 references/commit-convention.md 为基线规则,但 scope 示例需按当前仓库结构覆盖。