SuperAPI AI 工具集

commit-smart

通用与其它

查看项目

更新于 10-15 20:34

技能介绍

用途:commit-smart 帮助开发者基于实际代码改动生成有意义的约定式提交信息,并让提交正文解释改动的“为什么”,而不仅是“改了什么”。

主要能力:先用 git status、git diff --stat、git diff --cached --stat 评估工作区状态;若没有暂存内容,会展示已变更文件并按逻辑分组建议暂存,经用户确认后用 git add <files> 暂存;随后读取完整暂存差异 git diff --cached 并分析。它可根据改动信号自动判定提交类型,如新增功能为 feat、新增测试为 test、修复行为为 fix、结构重构为 refactor、依赖或 CI 配置为 chore、构建配置为 build、文档为 docs、格式为 style、性能优化为 perf。作用范围从主要目录或模块推断,如 src/api 对应 api、src/components/auth 对应 auth、tests 对应 tests,根配置或跨多个无关区域时省略范围。

使用方式:支持通过 $ARGUMENTS 覆盖自动判定,单个词作为提交类型,两个词作为类型与范围,否则使用自动检测结果。提交信息格式为 type(scope): 祈使句简短描述,主题行不超过 72 字符,使用祈使语气、结尾不加句号;正文说明原因,琐碎改动可省略正文。生成后先向用户展示提议信息并请求确认,确认后执行 git commit -m "<message>",再用 git log --oneline -1 验证并显示提交哈希与信息。破坏性变更可在范围后加 !,如 feat(api)!: change response format。

适用场景与限制:适合在完成一个逻辑工作单元后使用,不建议每改一个文件就提交;若差异过大,应建议拆分为多次提交。具体集成方式、安装要求、平台支持及费用等信息暂未提供。