mcpField
P
push

push

github.com/boshu2開発451130 回インストール今日更新
リポジトリ

push について

pushは、決定論的なチェック後にリポジトリが選んだGitのデリバリーパスを実行するスキルです。リポジトリまたはオペレーターの方針に従い、検証結果やライフサイクル状態を変更せずにデリバリーの証跡を返します。

主な機能

  1. 01リポジトリ指定のデリバリーパス
  2. 02実行前の決定論的チェック
  3. 03ペイロードと宛先の明示
  4. 04認証情報と無関係なファイルの除外
  5. 05呼び出し元へのデリバリー証跡の返却

活用シーン

  1. 01方針で許可された変更の直接プッシュ
  2. 02プルリクエスト用ブランチの準備
  3. 03文書化されたユーザー管理CIの起動
  4. 04未承認時に準備済みコミットを返却

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/boshu2/agentops --skill push

インストール後、Claude Code で/pushを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
push.feature
scripts/
test-verify-landed.sh
validate.sh
verify-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 つのパスが交わるのは、不変の入力を介する場合のみです。デリバリーによってライフサイクルを遡って完了させたり、書き換えたりすることはできません。

ワークフロー

  1. リポジトリのポリシーを確認します。 リポジトリ内の手順と、オペレーターの明示的な要求を確認します。デリバリーパスが承認されていない場合は、準備済みのコミットと決定論的な証拠を返し、独自にパスを決めないでください。
  2. ペイロードを固定します。 ソース SHA、対象のリモート/ref または PR ブランチ、ステージするパスを正確に記録します。認証情報、_beads、無関係な変更があれば拒否します。
  3. 決定論的なチェックを実行します。 リポジトリで定義されているコマンドを実行します。 AgentOps 自体では通常、ao gate check --fast --scope head が高速チェックです。他のリポジトリでは、独自の CI、テストスクリプト、pre-push フックを使用する場合があります。コマンドが失敗した場合は、デリバリーを中止します。
  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 は絶対にステージしないでください。
  • オペレーターとリポジトリのポリシーがその ref を明示的に承認していない限り、絶対に force-push しないでください。
  • 対象リポジトリのポリシーを AgentOps のデリバリーポリシーで置き換えないでください。

品質チェックリスト

  • リポジトリ/オペレーターが選択したアダプターが明記されています。
  • ペイロードの SHA、パス、宛先が明確です。
  • 必須の決定論的なコマンドがすべて、デリバリー対象のペイロードに対して成功しています。
  • LLM によるランディング判定、AgentOps の Git キュー、トラッカーの変更、ライフサイクル完了の主張が追加されていません。

参考ドキュメント

コメント