用途:审计仓库的分支覆盖、命名、流转关系、保护要求、来源证据与规范漂移。审计为只读;未知与违规分别报告。不代替 CodeGuard 质量、平台保护或部署验收。
主要能力与步骤:发现真实根与状态,加载定义与激活修订;按模型检查长期固定角色,临时类型只检查已有实例;逐分支检验 Git 名称与角色,识别多角色匹配、未识别命名与固定名称冲突;检查 provenance,记录来源 OID 与操作日志,无记录标 unknown,浅历史注明限制;检查 dirty、detached 及 merge/rebase/cherry-pick 中断;本地跟踪与服务端事实分开,配置文件存在不证明平台已阻止直推;输出违规、未知、明确通过与最小修复建议。
使用方式:Git 可用且项目目录明确时,先确认父仓真实根与项目指令,保留用户修改。可运行只读检查脚本(Python 3.11+ 标准库,只读、不初始化): python3 /mnt/skills/user/git-audit/scripts/inspect_repository.py /absolute/project GitFlow 插件可用时调用其实际路径命令;不得把未安装的 CLI 当已存在命令。写操作按用户已有授权范围执行,修改分支或激活规范须独立授权,不在审计中修复。
适用场景:既有规范优先的分支审计、来源与操作日志核验、分支命名与角色冲突检查。
限制:无 Git、无规范、detached、浅历史与未知来源需明确报告;分支模式符合不证明来源正确;远端跟踪与保护配置文字不证明实时远端已落实;不泄露凭据、不上传工作树、不在日志暴露敏感远端 URL;Git 不可用时不自装,不把失败当成功。