SuperAPI AI 工具集

ac-commit

通用与其它

查看项目

更新于 10-16 09:29

技能介绍

用途:分析当前 Git 改动,生成 Conventional Commits 风格的提交信息,并可自动归档上下文。

主要能力:仓库校验、改动检测、拆分建议、按需并行分析、生成提交信息、Context 自动归档与执行提交。提交格式为 [emoji] <type>(<scope>): <subject>,首行不超过 72 字符,使用祈使语气;语言根据最近提交风格与仓库习惯判断采用中文或英文。内置 type 与 emoji 映射,如 feat/✨、fix/🐛、docs/📝、refactor/♻️ 等。

主要选项:--no-verify 跳过 Git 钩子(仅显式指定时)、--all 暂存所有改动、--amend 修补上次提交(仅显式指定时)、--signoff 附加签名、--emoji 包含 emoji 前缀、--scope <scope> 指定作用域、--type <type> 指定提交类型。

使用方式:命令为 /ac-commit [options],例如 /ac-commit、/ac-commit --all、/ac-commit --emoji、/ac-commit --scope ui --type feat --emoji、/ac-commit --amend --signoff。参考资料为 references/conventional-commits.md。

角色分工:主线程执行 Git 检查、收集 diff、决定是否启用 subagents、生成 commit message、执行提交;subagents 为只读,仅分析大 diff 的聚类结果、拆分建议与风险点,不执行 Git 写操作。所有 Git 写操作(git add、git commit、写 .git/COMMIT_EDITMSG、写 .context/history/*)只由主线程执行。

subagents 适用条件:diff 很大、跨多个顶级目录、混合多类关注点(源码/测试/文档/配置);小改动或单一功能点由主线程直接判断,已委托内容不重复分析。

执行流程:阶段 1 仓库校验;阶段 2 改动检测;阶段 3 拆分建议与按需并行分析;阶段 4 生成提交信息;阶段 5 若 .context/ 存在则自动归档(不存在则创建 .context/history/、.context/current/branches/ 并初始化 commits.jsonl 与 commits.md),对 token/key/password/secret 等模式脱敏替换为 [REDACTED],追加 ContextEntry 并添加 Context-Id trailer;阶段 6 执行 git commit [-S] [--no-verify] [-s] -F .git/COMMIT_EDITMSG。

限制:默认尊重 Git hooks,只有显式传入 --no-verify 才可跳过;只有显式传入 --amend 才允许修补上次提交;原子提交,一次只做一件事;不改源码;归档失败时降级为 minimal ContextEntry,不阻断提交。