1.2.0 · 開發中 · 尚未發布

初始化與設定 Agent Teams

首次設定、既有儲存庫與等待主機啟用,各有不同結果。

1.2.0 · 開發中 · 尚未發布

本草稿說明 1.2.0 開發契約,不代表已有公開套件、下載、管道或完成的資格驗證。穩定版安裝仍為 1.1.4;僅原始碼具備的行為需要已準備好的現行開發版執行檔。

首次初始化與重新初始化

cd <your-repository>
ait init

首次 init 建立本機儲存庫權威,以及 AGENTS.md、CLAUDE.md 的工作流程區塊;啟用 Teams,並以 Newton 準備作為專案入口,規劃四個角色。它不會安裝套件或設定 Remote。只有 Git、沒有 AIT config 的 clone 屬於首次 init。

既有儲存庫 init 回報重新初始化,保留 config、policy、身分、Line heads 與工作檔案。Teams 的停用或缺省設定都會保留;重複 init 不是啟用開關。它更新受管理的工作流程區塊,保留周圍指引。建立選項不是後續設定工具。

首次 init 在缺少 .aitignore 時建立只有註解的檔案,不匯入 .gitignore。首次建置、測試或擷取 Snapshot 前,在回傳的 Task edit root 檢查確定的產物、快取與本機機密排除規則。重新初始化不會建立缺少的 ignore 檔,也不覆寫既有檔。

啟用、停用與主機啟用

既有儲存庫使用明確設定。下列是兩種選擇,請選所需狀態:

ait config set --agent-teams enabled
ait config set --agent-teams disabled

啟用透過原生 session 主機準備儲存庫角色與 Newton。查看 init 的 agent_team_bootstrap 或 config 的 team_bootstrap:設定可能已儲存,但主機啟用仍待完成。依同一對話提供的 app 動作與確認流程操作。重複 init/enable 沿用有效綁定;其他成員依工作需要準備。Reviewer 準備需要伺服器註冊。確切 ensure 與啟用邊界見聯絡資料與 session 參考。

停用會保留 session、綁定、角色歷史、未完成工作及其擁有權/審查門檻,直到明確交接。它不會重設已儲存的單人作者預設。新團隊候選遵循有效獨立審查路徑;已封存候選保留原作者模式與身分。

三個獨立選擇

選擇現行契約
Teams--agent-teams enabled 或 disabled 控制協作與 session 準備。
Sprint 綁定ait config set --sprint on 要求確切 Plan 項目綁定;--sprint off 使用未綁定 Task,不會選擇操作範圍。
Local / Remote操作範圍預設 Local;在支援的操作使用 --local 或明確 --remote <REMOTE>。已設定遠端或 Teams 不會代為選擇。workflow finish 沒有 Local 形式;本機收尾使用 ait task finish <TASK_ID> --local。

產生的 AGENTS.md 是儲存庫有效流程。歷史 workflow-mode/team-size 預設不是現行設定。設定變更不會移動既有 Task/Plan/Change 譜系,也不改變已封存候選模式;恢復執行時不要新增模式旗標。

讀取結果

ait config show --json
ait team contacts --json

Config 顯示有效設定;contacts 讀取綁定與原生可用性,不會準備 session。已啟用設定、準備好的席位、available/notLoaded 或閒置桌面 session,都不證明工作執行中或完成。PM 另行指派才開始工作;原生 finish 證明完成。依候選身分執行的 ready/finish 與復原見開發指南。

權威與版本邊界

本機草稿依據 Core 已審查的 Agent Teams、init、config、Task 與 workflow 參考,以及 Native 現行 distribution 與 release SOP。這些開發變更尚非已發布手冊。定版的 1.1.4 發布來源僅支持穩定版基準;封存技術手冊與 PDF 保留原版本及證據。