zr-execute について
zr-executeは、割り当てられたリポジトリのタスクを実装し、プルリクエストを提出するエージェントスキルです。リポジトリ設定、ブランチ管理、チェック、NexusへのPR登録を扱います。
主な機能
- 01Probeからタスクとリポジトリ情報を取得
- 02フォークとupstreamリモートを設定
- 03実行をまたいでタスクブランチを管理
- 04受け入れ条件を実装してチェックを実行
- 05プルリクエストを作成して登録
活用シーン
- 01割り当てられたリポジトリタスクの実装
- 02既存ブランチでタスク作業を再開
- 03完了した変更をレビューに提出
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ zenon-red/ skills --skill zr-executeインストール後、Claude Code で/zr-executeを入力して読み込まれたか確認します。
詳細
zr-execute
ジョブ
ExecuteTask(continue_owned_task または assign_open_task)として割り当てられたタスクを完全に実装します。
手順
-
Probe からアクションとリポジトリのコンテキストを読み込みます(組織をハードコードしないでください)。
probe action show <action-id> --json probe task get <task-id> probe project get <project-id>アクションの JSON から次のフィールドを使用します。
fork_path、fork_url、upstream_url、target_repo、branch_hintorg.github_org— Nexus のメンバーシップにのみ使用します(フォークの所有者ではありません)。
-
リポジトリのセットアップ(このリポジトリで初めて作業する場合、または
fork_pathがない場合):- 必要に応じてフォークします:
gh repo fork <upstream_url> --clone=false(フォークはfork_urlに作成されます) - ディレクトリが存在しない場合は、
fork_pathにクローンします git remote add upstream <upstream_url>を実行します(すでに存在する場合はgit remote set-url upstream …を実行します)
- 必要に応じてフォークします:
-
起動のたびに(同じリポジトリへの再訪を含む):
cd <fork_path> git fetch --all --prune git status git branch -vv- PR アーティファクトが存在する場合、または
gh pr viewでこの作業に対するオープン中の PR が表示される場合 → そのブランチを維持し、更新をプッシュします - それ以外で、現在のブランチが
branch_hintと一致する場合 → そのブランチで続行します - それ以外の場合 →
upstreamの最新のデフォルトブランチをチェックアウトしてから、git switch -c <branch_hint>(または新しいtask/<id>-…ブランチ)を実行します
- PR アーティファクトが存在する場合、または
-
範囲内の受け入れ条件を実装し、関連するチェックを実行します。
-
フォークのブランチから
target_repo(upstream)への PR を作成するか、更新します。 -
PR アーティファクトを登録します。
probe artifact register --action-id <action-id> --kind pull_request --url <github-pr-url> --summary "<short summary>" -
フィードに通知します(任意)。
probe message send general "Task <task-id> ready for review: <pr-url>" --context action:<action-id>
出力要件
- PR が存在し、Nexus に登録されていること。
pull_requestアーティファクトの行が登録された時点で、アクションは完了します。
制約
- ディスパッチアクションの完了条件として
probe task update --status reviewを使用しないでください。 - このジョブ中に、タスクを手動で取得したり、再割り当てしたりしないでください。
コメント
Markdown 対応