用途:该技能按照远程仓库的最新状态执行 git pull,并向使用者说明本次拉取带来的提交与文件改动位置。它适用于需要让 AI 智能体安全地更新本地仓库、同时保留本地未提交修改并汇报变更的场景。
主要能力:
- 执行前检查当前目录、所在分支、remote / upstream 配置,以及 pull.rebase、branch.<name>.rebase、pull.ff 的有效设置。
- 遇到目标不明确、upstream 未设置,或正处于 merge、rebase、冲突解消过程中时,停止操作且不修改仓库。
- 用 git rev-parse HEAD 记录拉取前的 HEAD,并通过 git status --short、git diff、git diff --cached、git stash list --format=%H 记录本地修改、暂存状态、未跟踪文件和已有 stash 的 OID。资料明确说明未跟踪文件不被视为 autostash 的保护对象。
- 在不改变既有拉取设置的前提下执行 git pull --autostash,并记录退出代码与输出。若未配置方式且历史已分叉,则提示确认并停止,不自动改用其他方式重试。
- 拉取后不只看退出码,还检查 git status、冲突文件列表、拉取后差异与 stash 的 OID,分别验证拉取完成、无未解决冲突、执行前的本地修改已恢复,并报告暂存状态变化。恢复判断不只看差异字符串完全一致或变更路径,而要核对记录的编辑内容是否保留或反映到拉取后的文件中。
- 失败、冲突或无法确认恢复时停止;报告是拉取还是恢复环节中断、merge/rebase 是否仍在进行、HEAD 变化、冲突路径、遗留 stash 的 OID 及后续需确认的事项。未经批准不执行 stash 重新应用或删除、reset、abort、重新 pull。
- 确认拉取与恢复均成功后,取得拉取后的 HEAD,用 git log --oneline <before>..<after>、git diff --stat <before> <after> 和 git diff <before> <after> 汇总本次提交与文件差异。rebase 时被改写的本地提交也在范围内,因此不把所有提交都称作远程来源。HEAD 未变化则报告没有拉取到变更。
使用方式:资料以指令形式描述该技能的步骤,未提供安装命令、调用接口或配置示例,暂未提供。
适用场景:需要由智能体在保留本地未提交改动的前提下同步远程仓库,并输出本次拉取提交与文件改动摘要的 Git 工作流。
限制:目标不明、upstream 未设置或处于 merge/rebase/冲突中途时不执行;未跟踪文件不受 autostash 保护;方式未设置且历史分叉时停止而不自动重试;失败或恢复无法确认时停止,且未经批准不执行 stash 重应用或删除、reset、abort、重新 pull。