ait task

角色#

通常由 coding agent 运行。用户只说清想要的结果和约束，不用自己 去推 Task 的那套记账。

用途#

ait task 把 sprint 意图、Change 沿革、一条功能 Line、一个受管的 工作区和最终收尾绑在一起。在 sprint 模式下，要从某一个确切的、能开 成 Task 的 Markdown 条目起步。

语法#

ait task start --from <sprint-card>#<exact-ref> --intent <intent>
ait task audit <task-id>
ait task finish <task-or-change-id>
ait task finish <task-or-change-id> --message <message>

示例#

ait task start \
  --from docs/sprints/password_visibility.md#login/password-visibility/implement \
  --intent "Add accessible password visibility control"

最后的输出里有 Task、Change 和确切的 cd 命令。所有代码工作都在 打印出来的那个工作区里做。

审计与收尾#

ait task audit 读取 Task 的就绪状态和收尾状态。ait task finish 按 记录下来的工作流范围执行。Dirty 的本地工作必须带 --message，由该操作 创建最终 Snapshot；干净的本地工作省略这个选项并复用当前 Line head。 远程 Task 拒绝 --message，而且必须已有选定并完成就绪证据的 Patchset。

公开收尾入口使用 ait task finish，评审方使用 ait workflow finish。Land 只保留为内部原子操作及其持久记录的名称， 不是公开命令。

失败与恢复#

启动只成功了一半时，留好打印出来的标识符，先查看 Task 再重试。工作 区不见了，就用 worktree 的恢复入口；除非原来的沿革已经明确处理掉， 否则不要为同一个未勾选的 sprint 条目再建第二个 Task。

相关参考#

• 并行 Task 隔离
• ait plan
• ait snapshot
• ait workflow