用途:在需要查找权威 Git 工作流、比较 GitFlow、GitHub Flow、GitLab Flow、主干开发与维护者模型、解释术语或追踪来源时使用。它不代替 CodeGuard 质量、平台保护或部署验收,也不自动修改仓库。
主要能力:提供权威资料导航与比较,区分官方模型、模板选择和项目扩展;比较分支角色、创建基线、传播方向、生命周期、版本维护与协作远端,并输出选择依据。可单独安装,无 GitFlow 插件时使用只读 Git 观察与逐条规则核验。
使用方式:前置条件为 Git 可用且项目目录明确,先确认父仓真实根与项目指令,保留用户修改。只读观察和预览可执行;初始化、分支创建/切换、提交、推送、集成、清理、安装 Hook 与规则激活按用户已有授权范围执行。可定位本技能 scripts/inspect_repository.py,按契约命令读取状态,Python 3.11+ 标准库,只读且不初始化,示例:python3 /mnt/skills/user/git-awesome/scripts/inspect_repository.py /absolute/project。GitFlow 插件可用时调用其实际路径命令,不得把未安装的 CLI 名称当已存在命令。
适用场景:比较一个月发布一次、同时维护两个版本的库与每天部署的服务,前者评估 Classic Git Flow,后者评估 GitHub Flow/主干开发。
限制:既有规范优先;无 Git、无规范、detached、浅历史与未知来源需明确报告。输出须区分事实、规则来源、建议、用户授权和未验证项,写操作后核对 refs/HEAD/status。不泄露凭据,不上传工作树。规则缺失、漂移、损坏、身份不明或来源证据不足时停止相关写动作并报告 unverified。Git 不可用或网络失败时不自动安装,不把失败当成功。其他职责按名称调用,不假定已安装,例如 Install: npx skills add full-stack-skills/git-skills --skill git-workflow。