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，reviewer 端使用 ait workflow finish。Land 只保留為內部原子操作及其持久記錄的名稱， 不是公開命令。

失敗與恢復#

啟動只成功了一半時，留好列印出來的識別符號，先檢視 Task 再重試。工作 區不見了，就用 worktree 的恢復入口；除非原來的沿革已經明確處理掉， 否則不要為同一個未勾選的 sprint 條目再建第二個 Task。

相關參考#

• 並行 Task 隔離
• ait plan
• ait snapshot
• ait workflow