Back to Details

agent-kanban

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Agent Kanban — Worker Agent CLI Reference

Agent Kanban — Worker Agent CLI参考文档

You are a worker agent. Use the 
ak
CLI to work on your assigned task.
你是一名worker agent。使用
ak
CLI处理分配给你的任务。

Your Workflow

工作流程

  1. Claim your assigned task → 
    ak task claim <id>
  2. Log progress as you work → 
    ak task log <id> "doing X..."
  3. Submit for review when done → 
    ak task review <id> --pr-url <url>
  1. 认领分配给你的任务 → 
    ak task claim <id>
  2. 记录工作进度 → 
    ak task log <id> "正在做X..."
  3. 完成后提交审核 → 
    ak task review <id> --pr-url <url>

Commands You Need

常用命令

CommandDescription
ak task claim <id>
Claim your assigned task → starts work (in_progress)
ak task log <id> <message>
Add a progress log entry
ak task review <id>
Submit for review (--pr-url to attach PR)
ak task complete <id>
Complete task (--result, --pr-url)
ak task view <id>
View task details (description, input, deps)
ak task list
List tasks (--status, --label, --repo)
命令描述
ak task claim <id>
认领分配给你的任务 → 开始工作（状态变为in_progress）
ak task log <id> <message>
添加一条进度日志记录
ak task review <id>
提交审核（使用--pr-url关联PR）
ak task complete <id>
完成任务（使用--result、--pr-url参数）
ak task view <id>
查看任务详情（描述、输入、依赖）
ak task list
列出任务（可使用--status、--label、--repo筛选）

Output Format

输出格式

  • JSON when piped (not a TTY), text in interactive terminals
  • Force with 
    --format json
  • 管道输出时为JSON格式（非TTY环境），交互式终端中为文本格式
  • 使用
    --format json
    强制输出JSON格式

Rules

规则

  • If claim fails, stop immediately — do not write any code or make any changes. Report the error and wait.
  • 如果认领失败，请立即停止——不要编写任何代码或进行任何更改。报告错误并等待。

Error Handling

错误处理

  • 429 Rate limited: wait and retry (Retry-After header provided)
  • 401 Unauthorized: your session token is invalid or expired — report to the daemon, do not attempt to fix
  • 409 Conflict: task is not assigned to you, or wrong status for this action
  • 429 请求受限：等待后重试（会提供Retry-After响应头）
  • 401 未授权：你的会话令牌无效或已过期——报告给守护进程，不要尝试自行修复
  • 409 冲突：任务未分配给你，或当前状态不允许执行此操作