核心概念

Repository 與 Line#

Repository 是某個工作目錄在本地的 AIT 權威。Line 是一個有 名字、可移動的指標，指向已被接納的 Snapshot。main 是常見的初始 Line；每個 Task 會拿到自己的功能 Line 和繫結的工作區。

Plan 條目#

Plan 記錄帶版本的 Markdown 沿革。在 sprint 模式下，一個穩定的 [plan-ref: ...] 標識整份文件，而帶有確切 [ref: ...] 的那個未 勾選清單項，就是可以開成 Task 的單位。

# Password Visibility [plan-ref: login/password-visibility/root]

- [ ] Add the accessible control and focused tests. [ref: login/password-visibility/implement]

條目寫的是要達成的結果，不是讓你順手做幾件互不相干的改動。

Task、Change 與工作區#

Task 是繫結 Plan 意圖的有界工作單元，Change 是它可供評審的 改動沿革。Task 繫結的工作區把實作和目標 Line 隔開，直到結果被 接納為止。

啟動 Task 的那條命令會列印出確切的工作區路徑。agent 必須在那裡 改程式碼，不能在儲存庫的規範根目錄裡改。

Snapshot#

Snapshot 是不可變的儲存庫狀態，帶作者資訊和父級歷史。它記錄的是 完成後的程式碼狀態；它不會為了把文件沿革藏進程式碼歷史，就順帶塞進一處 無關的 Markdown Plan 改動。

Patchset 與證據#

在有遠端支撐的工作流程裡，Patchset 是某個 Change 被選中的評審 候選。CI、attestation、評審和策略這幾類證據，都在最終收尾之前掛到這個候選 上。

純本地的工作不需要遠端基礎設施。但它設定的接納策略照樣決定了完成 之前必須驗證哪些東西。

收尾#

收尾會推進設定好的目標 Line，完成 Task，清理繫結的工作區，並執行 儲存庫的 sprint 清單策略。遠端工作可能要在程式碼收尾之後單獨再做一步： 更新最後那個 Markdown 核取方塊，並同步 Plan。

相關參考#

接著看 並行 Task 隔離， 或者開啟 ait plan、 ait task、 ait snapshot 和 ait workflow 查具體的命令說明。