SuperAPI AI 工具集

commit-sentinel

通用与其它

查看项目

更新于 10-16 08:11

技能介绍

用途:commit-sentinel 用于守护仓库健康与提交历史清晰度,在多 AI 代理每日生成大量代码的场景下防止“历史污染”与“类型衰减”,确保只有合格的代码进入主分支。

主要能力:一是四步校验协议——提交前必须执行 git diff --cached 逐行审查、移除 console.log/TODO/调试残留;bun x tsc --noEmit 严格类型审计(工作区零类型错误);bun run lint 执行格式与安全规则;并确保提交在逻辑上只做一件事,若涉及多个功能或修复用 git add -p 拆分。二是维护反模式清单,禁止使用 --no-verify、无意义的 commit -m "update"、已推送后的变基、巨型清理提交、以及假定 SHA-1。三是约定式提交规范,使用 feat/fix/refactor/perf/chore/docs 等类型加 scope,标题不超过 50 字符,正文说明原因并按 72 字符换行,支持 BREAKING CHANGE 与 Resolves #123。四是历史整形,通过 git rebase -i HEAD~3 等交互式变基合并本地小提交,仅在本地分支操作。五是取证式校验,用 git bisect start、git bisect bad HEAD、git bisect good [tag] 配合 git bisect run bun test 二分定位回归。六是面向 Git 3.0 的准备,包括 SHA-256 迁移、Rust 内核与推送保护式密钥检测。

使用方式:按上述四步协议在每次提交前执行对应命令;需要清理本地历史时运行交互式变基;出现缺陷时按二分法流程定位。自动化钩子编排可参考 Husky、Lefthook、Pre-commit。

适用场景:需要维护高完整性提交历史的团队、使用 AI 代理批量产码的项目、需要二分定位回归或严格类型与 lint 约束的仓库。

限制:资料未提供具体收费、价格、平台支持范围与实测效果数据;部分内容如 Git 3.0、SHA-256、Rust 内核、推送保护属于前瞻性描述,资料未说明其当前可用状态与具体实现细节。

本技能版本为 v2.1.0。