SuperAPI AI 工具集

git-sync

编程与开发

查看项目

更新于 10-15 21:48

技能介绍

用途:在需要按项目策略执行 Git 同步与集成时使用,包括 fetch、pull、push、merge 或 rebase,并确认源目标分支与远端映射。不猜测上游,不强推。不适用于代替 CodeGuard 质量、平台保护或部署验收。

主要能力:读取已激活策略,发现当前仓库、分支、HEAD 与远端名称;明确动作、单一 source/target/ref、remote 与合并方式;fetch 默认预览;pull 明确来源后 fetch+ff-only,非快进交给显式集成方案;merge 检查来源 merge_into 是否包含当前目标角色;rebase 检查 create_from,拒绝重写已有远端引用包含的提交;push 限定同名映射与单一分支。强推、删除、mirror、多 ref 操作不自动放行。

使用方式:Git 可用且项目目录明确,先确认父仓真实根与项目指令,保留用户修改。只读观察和预览可执行;初始化、分支创建/切换、提交、推送、集成、清理、安装 Hook 与规则激活按用户已有授权范围执行。可定位本技能 scripts/inspect_repository.py,按契约命令读取状态,Python 3.11+ 标准库,只读且不初始化,示例:python3 /mnt/skills/user/git-sync/scripts/inspect_repository.py /absolute/project。GitFlow 插件可用时调用其实际路径命令,不得把未安装的 CLI 名称当已存在命令。

适用场景:feature 合入 develop 等按策略的同步与集成;Fork 模式分别确认个人 origin 与权威 upstream。

限制:无 Git、无规范、detached、浅历史与未知来源需明确报告;规则缺失、漂移、损坏、身份不明、操作中断或来源证据不足时停止相关写动作并报告 unverified;冲突保留现场;不泄露凭据,不上传工作树;网络超时可能已发生远端副作用,需查询实际 ref 再决定恢复;计划和预览不是完成证据。