git-operations

Git Operations

本 Skill 是 buildr.git-operations/v1 的默认 provider。它只帮助 Agent 安全执行 consumer 已经选定的一次 Git Operation；不讲解完整 Git 命令集，不选择交付目标或顺序，不拥有任务验证、任务结果或 workspace sync 状态。

任务工作树（Worktree）的跨库统一命名、创建和复用检查由任务工作树技能（Task Worktree Skill）承接，实际动作遵守当前有效能力绑定（Capability Binding）。本技能（Skill）核对已选操作（Operation）的真实代码库（Repository）、分支（Branch）及授权，不按名称推断任务关联或自动重命名已有对象。

能力名称使用复数 Git Operations；一次具体动作称为一个 Git Operation。

1. 先取得完整调用边界

写入前必须明确并核验：

• 实际 repository；
• 本次 operation；
• 相关 source/local ref，以及远端动作适用时的 remote 与 destination ref；
• 精确 owned paths/hunks 或已授权 commit scope；
• 获准改变 working tree、local history 和 remote 的具体 effects。

直接用户指令、task-finish 或其他上游智能体（Agent）/consumer可以提供这些输入。用户明确要求“收尾”时，task-finish 提供的当前任务范围内常规提交、集成和普通推送授权就是明确授权；本提供者（Provider）不得仅因用户未逐项重述 Git 操作而重复询问。智能体拥有交付策略、动作、目标和顺序。同一任务已明确的写入授权，在repository、operation、ref、scope与effects未变且未被撤回时继续适用；每次写入仍重验当前事实。其他任务或范围变化不能沿用旧授权，也不得自行补选repository、ref、remote或策略。任何输入与当前事实不一致时，在零Git写入状态返回blocked。

2. 保持 operation 单一

• fetch：只更新 consumer 明确提供的 remote/ref，不改变 working tree 或 local branch history。
• rebase：只把 consumer 明确提供的 clean local branch rebase 到已核验 target ref，不隐含 push、merge、stash 或其他 branch/remote 选择。
• commit：只创建或安全 amend local commit，不 push。
• push：只发布已有 commit，不把 dirty 自动 commit。
• commit+push：caller 依次执行一次 commit 和一次 push，保留两个独立 Result；不是原子 transaction。
• delete-remote-ref：只删除 consumer 明确提供的 remote/ref，并以 consumer 已观察的精确远端提交为删除条件，不动其他引用。
• workspace update：只有 Buildr Skill 等 consumer 已明确 workspace、upstream、update operation 与授权时才执行；dirty、divergence、冲突、缺失 upstream 或策略不唯一时 blocked，不自动 rebase、merge 或继续 sync。

直接 Git 收尾由智能体（Agent）选择已授权的动作，可在同一次工具调用内顺序执行。每项操作（Operation）分别核验并保留结果（Result），后一步消费已成功动作返回的真实身份；推送前新观察远端并核对完整范围。独立结果不要求独立的模型往返，批量编排不扩大授权。失败时停止相关后续动作，返回已成功部分与诊断；provider不自动stash，rebase冲突、目标歧义、已共享历史或需要force push时停止。Git Operations自身不写Task lifecycle evidence，任务登记交回原应用。

本版不预扩 checkout、reset、cherry-pick、stash、本地 branch deletion 等完整命令路由。rebase、merge、revert 或其他动作只有被 consumer 明确选为当前 operation 时才可能进入；不得作为发现分叉或失败后的自动替代策略。