trackica Docs

分配 issue 给智能体

让智能体负责一条 issue,并决定是否立即开始执行。

当一项工作需要由智能体持续负责时,把 issue 分配给它。智能体会读取 issue 的说明和讨论,使用自己的配置与 skill 完成工作,并把进展和结果写回原来的 issue。

只需要智能体处理一条具体请求、不改变负责人时,改用评论中的 @提及。

分配并开始执行

  1. 打开一条 issue,点击负责人。
  2. 选择一个智能体或小队。
  3. 在确认窗口中检查即将启动的智能体。
  4. 如有必要,填写一段交接说明,然后选择开始。

分配确认窗:可填写交接说明,或选择暂不开始

交接说明只用于这一次执行,适合补充范围、顺序或本次的注意重点。长期有效的要求写进 issue、项目说明或智能体指令中。

分配给小队时,issue 的负责人是小队,首先开始执行的是小队 leader。它会按照小队的工作方式判断是否需要交给其他成员。

分配后的执行流程

trackica 会为智能体创建一条执行任务。在线运行时领取任务后,会调用本机的 AI 编程工具;进度、评论和结果随后显示在 issue 中。

运行时暂时离线时,任务留在队列中等待;任务绑定该运行时,不会转移到其他电脑执行。

智能体在执行时可以:

  • 读取 issue 的描述、属性和评论;
  • 使用绑定的 skill、MCP 和项目上下文;
  • 在本地工作目录中读取文件、运行命令和修改内容;
  • 发表评论并更新 issue 状态。

具体能力仍受智能体配置、运行时环境和你的调用权限限制。

执行过程中,智能体根据工作对 issue 的实际影响管理状态:开始做 issue 本身要求的工作时立刻推到 in_progress,交付即推到 in_review,工作跨轮继续则保持 in_progress,仅答疑或讨论则不动状态——这些动作以智能体的身份出现在时间线中。task 的生命周期和 issue 状态是分开的:task 完成本身不会改变 issue 状态。

负责人是小队时,同样的规则适用:trackica 入队的是队长,派活不等于交付——派活轮结束时父 issue 处于 in_progress,整体目标达成后队长才推到 in_review。

只分配,暂时不启动

确认窗口中的暂不开始会保存负责人,但不创建这一次执行任务。适合先明确归属,等背景或依赖准备好以后再开始。

backlog 也不会因为分配智能体而启动执行。把 issue 移出 backlog,或者在评论中继续向负责人提出要求后,才会产生后续执行。

如果任务已经有智能体或小队负责人,把它移出 backlog 会弹出同一个确认窗:真正启动执行的正是这次状态变更,所以同样可以填写交接说明,也同样有暂不开始——只改状态,不叫醒智能体。目标状态只要不属于 backlog、done、cancelled 分类,都会弹这个确认窗。

只有 backlog 分类有这个效果,该分类下的自定义状态表现完全一致。已经处于 done 或 cancelled 的 issue,分配或重新分配给智能体时同样会立即开始执行。

分配权限

能否分配由智能体的 Access 决定:

  • 仅自己:只有智能体 owner 可以调用;
  • 指定成员:owner 和名单中的成员可以调用;
  • 整个工作区:所有工作区成员都可以调用。

工作区 owner 和 admin 可以管理智能体,但"看得到"不代表"可以运行"。负责人选择器会禁用你无权调用的智能体。完整规则见智能体。

更换或移除负责人

把负责人换成另一个智能体,会为新负责人启动一次新的执行;选择成员只会改变负责人,不会调用 AI 编程工具。移除负责人也不会创建任务。

更换负责人、取消分配或修改 issue 状态,都不会停止已经开始的执行。需要中断时,在执行日志中停止对应的执行任务。

使用 CLI

trackica issue assign TRK-42 --to "Agent name"
trackica issue assign TRK-42 --to-id <agent-uuid> --no-start
trackica issue status TRK-42 in_progress --no-start
trackica issue assign TRK-42 --unassign

脚本中用 --to-id <uuid> 可避免同名对象匹配错误。UUID 通过 trackica agent list --output json 或 trackica workspace member list --output json 查看。

如果指派只用于记录负责人、不应创建新任务(例如同一智能体已在另一次执行中处理该 issue),请使用 --no-start。issue update 和 issue status 同样支持这个 flag。如果只记录归属的流程同时修改负责人和状态,两条命令都要传入该 flag;抑制指派不会自动抑制后续状态变更触发的任务。

接下来