push について
pushは、決定論的なチェック後にリポジトリが選んだGitのデリバリーパスを実行するスキルです。リポジトリまたはオペレーターの方針に従い、検証結果やライフサイクル状態を変更せずにデリバリーの証跡を返します。
主な機能
- 01リポジトリ指定のデリバリーパス
- 02実行前の決定論的チェック
- 03ペイロードと宛先の明示
- 04認証情報と無関係なファイルの除外
- 05呼び出し元へのデリバリー証跡の返却
活用シーン
- 01方針で許可された変更の直接プッシュ
- 02プルリクエスト用ブランチの準備
- 03文書化されたユーザー管理CIの起動
- 04未承認時に準備済みコミットを返却
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ boshu2/ agentops --skill pushインストール後、Claude Code で/pushを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/push.featurescripts/test-verify-landed.shvalidate.shverify-landed.sh詳細
プッシュスキル
決定論的なチェックの実行後、対象リポジトリで選択された Git のデリバリーパスを実行します。 プッシュは任意の駆動アダプターであり、5 つ目のライフサイクル上位概念でも、リリース権限でもありません。
制約
- リポジトリのポリシーを優先します。 対象リポジトリのデリバリー手順、またはオペレーターの明示的な選択を確認します。 直接プッシュ、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
2 つのパスが交わるのは、不変の入力を介する場合のみです。デリバリーによってライフサイクルを遡って完了させたり、書き換えたりすることはできません。
ワークフロー
- リポジトリのポリシーを確認します。 リポジトリ内の手順と、オペレーターの明示的な要求を確認します。デリバリーパスが承認されていない場合は、準備済みのコミットと決定論的な証拠を返し、独自にパスを決めないでください。
- ペイロードを固定します。 ソース SHA、対象のリモート/ref または PR ブランチ、ステージするパスを正確に記録します。認証情報、
_beads、無関係な変更があれば拒否します。 - 決定論的なチェックを実行します。 リポジトリで定義されているコマンドを実行します。
AgentOps 自体では通常、
ao gate check --fast --scope headが高速チェックです。他のリポジトリでは、独自の CI、テストスクリプト、pre-push フックを使用する場合があります。コマンドが失敗した場合は、デリバリーを中止します。 - 要求された場合はコミットします。 リポジトリのメッセージ規約に従い、生成された SHA を報告します。コミットは検証ではなく、既存の Validate 判定も変更しません。
- 選択されたアダプターを使用します。 直接プッシュを行うリポジトリでは通常の Git を使用します。PR を使うリポジトリではブランチをプッシュし、PR ツールに引き継ぎます。ユーザー所有の CI を使うリポジトリでは、文書化されたトリガーに従います。グローバルキューを作成または管理しないでください。
- 証拠を報告します。 ソース SHA、宛先、決定論的なコマンドと終了コード、作成した場合はリモート/PR の識別情報を返します。ここで終了します。
出力仕様
- 成果物: ソース SHA、選択されたアダプター、宛先の識別情報、決定論的なコマンド結果を含むデリバリー結果。
- シリアライズ: 呼び出し元が選択するテキストまたは JSON。Validate 判定を埋め込んだり変更したりしてはなりません。
- バリデーター:
bash skills/push/scripts/validate.shはこのアダプター契約を検証します。リポジトリのチェックは引き続きリポジトリが管理します。 - 後続処理: 結果を呼び出し元に返します。トラッカーのクローズ処理とライフサイクルの状態は、このスキルの対象外です。
ガードレール
.env*、*credentials*、*secret*、*.key、*.pemに一致するファイルは絶対にステージしないでください。- 作業に関係するファイルのみをステージします。
_beadsは絶対にステージしないでください。 - オペレーターとリポジトリのポリシーがその ref を明示的に承認していない限り、絶対に force-push しないでください。
- 対象リポジトリのポリシーを AgentOps のデリバリーポリシーで置き換えないでください。
品質チェックリスト
- リポジトリ/オペレーターが選択したアダプターが明記されています。
- ペイロードの SHA、パス、宛先が明確です。
- 必須の決定論的なコマンドがすべて、デリバリー対象のペイロードに対して成功しています。
- LLM によるランディング判定、AgentOps の Git キュー、トラッカーの変更、ライフサイクル完了の主張が追加されていません。
参考ドキュメント
- references/push.feature — 実行可能な決定論的アダプターのシナリオ。
コメント
Markdown 対応