1.2.0 · 開發中 · 尚未發布
Agent Teams:聯絡資料與 session
讀取綁定、準備正確的 session,並區分執行狀態與工作完成。
1.2.0 · 開發中 · 尚未發布
本草稿說明 1.2.0 開發契約,不代表已有公開套件、下載、管道或完成的資格驗證。穩定版安裝仍為 1.1.4;僅原始碼具備的行為需要已準備好的現行開發版執行檔。
唯讀聯絡資料
ait team contacts --json
此命令讀取本機綁定與原生可用性,不建立、替換或重新載入 session。Teams 停用時,team_enabled: false 與空的 members 不代表保留的名單遭刪除。
| 欄位 | 意義與限制 |
|---|---|
planned_seat_count | 基準席位數,不是可用或執行中 session 數。四個規劃角色涵蓋 PM、產品規劃者、Developer 與獨立 Reviewer。 |
actual_member_count / bound_session_count | 列出成員數/非空 session 綁定數,都不是執行中工作數。 |
agent_index / session_id | 成員身分與原生 session 綁定。查詢桌面狀態時,同時核對指定 session 與 host ID。 |
角色路徑/revision、loaded_role_revision_index、role_reload_status、role_state | 指定角色與投遞觀察。載入角色的中繼資料只記錄投遞,不證明仍保有上下文。 |
availability / host_status | 原生可用性與主機觀察。available 可包含 notLoaded,都不證明工作執行中。 |
未綁定、封存、缺漏、不相符與未知觀察都不能證明 session 可用。另以桌面 list_threads 工具查詢 running/idle,並同時比對 session 與 host ID。Contacts 無法權威判定另一桌面主機的執行狀態。篩除無關資料;有限列表可能漏掉 session,缺漏、失敗觀察與 notLoaded 應維持未知。Idle 不證明 Task 完成;原生 Task/workflow finish 才能證明。
準備既有成員
以下為語法,請以指定成員與編號角色替換參數。不要為了查執行狀態而呼叫 ensure。
ait team session ensure --agent <AGENT> --json
ait team session ensure --agent <AGENT> --role <ROLE> --json
Ensure 建立、沿用或復原既有成員的 session,並投遞編號的 docs/roles/ Plan。額外成員需要明確角色。沿用有效綁定,只有證明原始原生儲存中不存在時才能替換。主機證據不確定時,保留綁定並回報阻礙;執行中的 session 不代表不存在。準備 Reviewer 需要伺服器註冊。
原生輸出提供啟用要求時,在同一對話完成必要 app 動作,再確認只屬於該對話的 token:
ait team session acknowledge --activation <ACTIVATION> --json
確認會核對標題、專案、綁定與角色收件,不會指派工作。準備回傳 work_started: false;PM 另行指派意圖、範圍、卡片與 Reviewer。準備好的席位不代表工作執行中或 Task 完成。
角色投遞與繼續工作
Plan sync 記錄角色修改,不會自動重新載入 session。需要投遞變更角色時使用受保護的準備流程。新 Task 本身不需要重新載入。壓縮上下文後,恢復完整適用指引與目前工作單。停用 Teams 保留 session、綁定、角色歷史與未完成 Task;明確交接前,既有擁有權與門檻仍有效。
歷史 workflow-mode 與 team-size 預設不是現行命令。Task 啟動、獨立審查與 finish 以產生的 AGENTS.md 為準;獨立的 Teams、sprint 與範圍設定見初始化與設定參考。
權威與版本邊界
本機草稿依據 Core 已審查的 Agent Teams、init、config、Task 與 workflow 參考,以及 Native 現行 distribution 與 release SOP。這些開發變更尚非已發布手冊。定版的 1.1.4 發布來源僅支持穩定版基準;封存技術手冊與 PDF 保留原版本及證據。