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