用途:在 AI 或开发者提交代码前,检查当前 Git 分支角色、名称、项目提交消息与允许提交策略,作为提交前的分支与消息门禁。它不代替 CodeGuard 质量检查、平台保护或部署验收。
主要能力:发现真实分支、HEAD 与状态;验证分支名称是否匹配唯一角色与已激活规则;检查 allow_commit,按项目约定阻止在 main、develop 等分支日常直接提交;检查完整提交消息与项目模式;对首次空历史提交单独说明 bootstrap 边界;提交前检查暂存范围,提交后核验 SHA、branch、status,不自动推送。
使用方式:Git 可用且项目目录明确,先确认父仓真实根与项目指令,保留用户修改。只读观察和预览可执行;初始化、分支创建/切换、提交、推送、集成、清理、安装 Hook 与规则激活按用户已有授权范围执行。可定位本技能 scripts/inspect_repository.py,按契约命令读取状态,Python 3.11+ 标准库,只读且不初始化,示例:python3 /mnt/skills/user/git-commit/scripts/inspect_repository.py /absolute/project。GitFlow 插件可用时调用其实际路径命令,不得把未安装的 CLI 名称当已存在命令。
适用场景:提交前分支与消息门禁、受保护分支防误提交、提交消息格式核验、空历史初始提交方案确认。
限制:无 Git、无规范、detached、浅历史与未知来源需明确报告;规则缺失/漂移/损坏、身份不明、操作中断或来源证据不足时停止相关写动作并报告 unverified;不泄露凭据,不上传工作树;分支 gate 通过仅指分支规则,不代替质量检查与测试;不自动安装、不自动推送。