push

推送技能

在确定性检查通过后，执行目标仓库选定的 Git 交付路径。 推送是可选的驱动适配器，不是第五个生命周期总括环节，也不负责发布授权。

约束

• 以仓库策略为准。 阅读目标仓库的交付说明或操作员的明确选择。直接推送、PR 和用户自有 CI 都有效；此技能不会用 AgentOps 队列取代它们。
• 仅运行确定性检查。 运行已声明的测试、代码检查、构建和门禁。Validate 给出证明后，推送不需要再经过一次 LLM 上线判定。
• 证明是输入，不是许可。 仓库可以归档或引用不可变的 Validate 结果，但 Push 不能更改该判定，也不能将其用作 Git 授权令牌。
• 不变更生命周期。 不要关闭跟踪项、运行 Learn、修改阶段回执或宣布目标已完成。将交付证据返回给调用方。
• 限制写入范围。 仅暂存请求中涉及的文件，绝不包含凭据或私有账本。

交付边界

Discovery -> Crank -> Validate -> Learn -> orchestrator
                                      |
                                      +-- immutable proof may be consumed here

repository/operator -> Push adapter -> direct push | PR | user-owned CI

这两条路径仅通过不可变输入衔接。交付不能追溯性地完成或重写生命周期。

工作流

1. 确定仓库策略。 阅读仓库本地说明和操作员的明确请求。如果没有获准的交付路径，则返回已准备的提交和确定性证据；不要自行选择路径。
2. 固定载荷。 记录源 SHA、目标远程仓库/引用或 PR 分支，以及确切的暂存路径。拒绝凭据、_beads 和无关更改。
3. 运行确定性检查。 执行仓库声明的命令。在 AgentOps 中，常规的快速检查是 ao gate check --fast --scope head；其他仓库可以使用自己的 CI、 测试脚本或推送前钩子。任何命令失败都会中止交付。
4. 按需提交。 遵循仓库的消息约定，并报告生成的 SHA。提交不等于验证，也不会变更现有的 Validate 判定。
5. 使用选定的适配器。 直接推送的仓库使用常规 Git； PR 仓库推送分支并交由其 PR 工具处理；用户自有 CI 仓库遵循其文档说明的触发方式。不要创建或管理全局队列。
6. 报告证据。 返回源 SHA、目标位置、确定性命令及其退出状态，以及创建的远程仓库/PR 标识。然后停止。

输出规范

• 产物： 一份交付结果，包含源 SHA、选定的适配器、目标标识和确定性命令结果。
• 序列化： 由调用方选择文本或 JSON；不得嵌入或变更 Validate 判定。
• 验证器： bash skills/push/scripts/validate.sh 用于验证此适配器契约。仓库检查由各仓库自行负责。
• 下游： 将结果返回给调用方。跟踪项关闭和生命周期状态不属于此技能的范围。

防护规则

• 绝不暂存匹配以下模式的文件：.env*、*credentials*、*secret*、*.key、*.pem。
• 仅暂存与工作相关的文件。绝不暂存 _beads。
• 除非操作员和仓库策略明确授权针对该确切引用执行，否则绝不强制推送。
• 绝不以 AgentOps 交付策略替代目标仓库的策略。

质量检查清单

• 已明确指定仓库/操作员选定的适配器。
• 已明确列出载荷 SHA、路径和目标位置。
• 交付载荷通过了所有必需的确定性命令。
• 未引入 LLM 上线判定、AgentOps Git 队列、跟踪项变更或生命周期完成声明。

参考文档

• references/push.feature — 可执行的确定性适配器场景。