zr-execute

zr-execute

工作内容

完成作为 ExecuteTask 路由的任务（continue_owned_task 或 assign_open_task）。

步骤

1. 从 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_hint
   • org.github_org——仅用于 Nexus 成员身份验证（不是 fork 所有者）

2. 仓库设置（首次处理此仓库，或缺少 fork_path 时）：

   • 如有需要，创建 fork：gh repo fork <upstream_url> --clone=false（fork 将位于 fork_url）
   • 如果目录不存在，则克隆到 fork_path
   • git remote add upstream <upstream_url>（如果已存在，则使用 git remote set-url upstream …）

3. 每次唤醒时（包括返回处理同一仓库时）：

   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>-… 分支）

4. 实现范围内的验收标准；运行相关检查。

5. 从 fork 分支向 target_repo（上游）创建或更新 PR。

6. 注册 PR 工件：

   probe artifact register --action-id <action-id> --kind pull_request --url <github-pr-url> --summary "<short summary>"
   

7. 通知信息流（可选）：

   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 用作调度操作的完成门槛。
• 不要在此任务中手动认领或重新分配任务。