ak-worker

AK Worker 用于在 Agent Kanban 中处理分配给 Agent 的任务，整个流程通过 Realmroot Toolbox 完成，并沿用现有的 Realmroot Agent 身份。

用途

该技能适用于 Agent 需要查看、认领、更新或提交一个已分配 Task 的场景。它围绕任务生命周期展开，强调在改动目标仓库前先读取任务当前的指令和验收检查，再完成认领。

主要能力

读取任务：通过通用 Toolbox 资源操作获取任务详情，命令为 realmroot toolbox get agent-kanban/tasks/<task-id> --include --json。
认领任务：在变更目标仓库前认领，命令为 realmroot toolbox post agent-kanban/tasks/<task-id>/claims --json。若认领被拒绝，应停止且不修改仓库。
记录进展：以 Task Note 资源记录有用进度，例如 realmroot toolbox post agent-kanban/tasks/<task-id>/notes --content-type application/json '{"detail":"Implemented the parser and verified malformed input."}' --json。
执行并验证：在可审查的分支上完成仓库工作，并运行能证明变更行为和边界的最小检查集。
提交评审：发布包含结果、确切检查项和剩余阻塞的最终笔记，然后将任务提交评审。
失败处理：针对 401/403、409、429/503 以及未知 PATCH 结果给出明确应对策略。

使用方式

任务的生命周期按以下顺序推进：

读取任务。使用 realmroot toolbox get agent-kanban/tasks/<task-id> --include --json 获取任务，先阅读当前任务指令与验收检查再行动。
认领任务。在修改目标仓库前执行 realmroot toolbox post agent-kanban/tasks/<task-id>/claims --json。只有当前被指派且经过验证的 Realmroot Agent 操作者才能认领。若认领被拒绝，停止且不修改仓库。
记录进展。用 Task Note 资源记录有用进度：
```
realmroot toolbox post agent-kanban/tasks/<task-id>/notes \
  --content-type application/json \
  '{"detail":"Implemented the parser and verified malformed input."}' --json
```
Realmroot Toolbox 会生成所需的幂等键，并在本次调用的瞬时重试中复用它。仅当需要从一次结果未知的早期调用中恢复、且已知该键时，才显式提供 Idempotency-Key。
执行工作。完成工作并运行能证明变更行为和边界的最小检查集。将仓库工作放在可审查的分支上。对于需要认证的 GitHub 命令，使用 Realmroot 的 GitHub Resource，例如 realmroot exec github -- git push 或 realmroot exec github -- gh ...。

提交评审。发布包含结果、确切检查项和任何剩余阻塞的最终笔记，然后提交任务评审：

realmroot toolbox get agent-kanban/tasks/<task-id> --include --json
realmroot toolbox patch agent-kanban/tasks/<task-id> \
  --content-type application/merge-patch+json \
  '{"status":"in-review","pullRequestUrl":"https://github.com/owner/repo/pull/123"}' --json

当任务没有拉取请求时，省略 pullRequestUrl：

realmroot toolbox patch agent-kanban/tasks/<task-id> \
  --content-type application/merge-patch+json \
  '{"status":"in-review"}' --json

在本次工作 Session 停止前，其已认领的 Task 必须已提交评审。若工作无法继续，在最终 Task Note 中说明阻塞原因并提交当前状态；不要将已停止的 Session 表示为进行中。

任务上下文与命令发现

若请求字段不清晰，可查看被接受的请求体：

realmroot toolbox patch agent-kanban/tasks/<task-id> --generate-body

Session 的初始提示会提供 Task ID 和确切的 AK Context ID。对每一次 Toolbox 操作都使用该 Context，然后在行动前读取任务。使用现有的 Agent 身份认领任务。

当评审被拒绝时，重新阅读任务和 Notes，在现有 Claim 下继续，完成后提交新的评审。完成和取消会结束工作 Session。

失败处理

401 或 403：停止并报告认证或权限阻塞。
409：重新读取受影响的资源，并依据其当前状态决策；不要盲目重放冲突的状态转换。
429 或 503：遵守 Retry-After。在出现未知的 Task PATCH 结果后，先重新读取其当前表示，再决定是否重试。

适用场景

适用于 Agent 在被分配 Agent Kanban 任务后，需要以受控流程查看、认领、记录、执行与提交任务的场景，尤其强调认领前置、最小检查集验证、可审查分支以及评审提交的闭环。

限制

该技能依赖 Realmroot Toolbox 与现有的 Realmroot Agent 身份；仅有当前被指派且经过验证的 Agent 操作者可以认领任务。文档未提供关于收费、价格、平台版本或其他未列明细节的信息。