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 保留原版本及证据。