SuperAPI AI 工具集

commit-staged

通用与其它

查看项目

更新于 10-16 06:19

技能介绍

用途:分析已暂存的 git 变更,生成规范的提交信息并执行提交。

主要能力:读取暂存区状态与差异(含 --stat),支持用户附加说明;按 Conventional Commits 格式输出 <type>(<scope>): <description>,可选正文,破坏性变更使用 footer。类型包括 feat、fix、docs、style、refactor、test、chore。

使用方式:技能会先运行 uv run prek run,失败则执行 git add -u;随后查看状态、暂存差异与统计。生成信息后以 git commit -m "<commit-message>" 提交,不使用 --no-verify。支持 git add -p 选择性暂存、git commit --amend 修改。

规范要点:scope 必须标识代码位置(模块、组件、目录),不得使用 docs、tests、types、refactor、bugfix 等描述变更类型的词;摘要使用祈使语气、首字母大写、50 字符内、结尾不加句号;正文解释原因而非仅描述内容;破坏性变更需明确标注。

适用场景:已暂存变更需要提交;多文件相关变更合并提交;需要符合规范的提交信息。

限制:若被 pre-commit 或 prek 钩子阻止,应停止并说明拟定的提交信息及被阻止情况,需运行 linting-agent 处理发现的问题;不提供绕过验证的方式。其他细节资料未提供。