feat(teams): teammateMode 默认翻转为 "iterm2" + 隐式团队余波同步 [v6.6.0]#8
Merged
Conversation
…1.186) v6.5.1 (PATCH). CC v2.1.186 新增 teammateMode "iterm2"(强制 iTerm2 原生分屏,硬依赖 it2 CLI,缺失即报错)并放宽 auto 语义至 tmux 会话内或 iTerm2 终端。模板默认维持 "tmux"(iterm2 硬 it2 依赖会破坏跨平台优雅降级 + 把 min 版本抬到 v2.1.186),iterm2 作 用户级 opt-in 文档化(ADR-004 备选 D + team-mode.md + FIRST_RUN.md)。 本机核验(claude v2.1.186 / macOS): it2 v0.2.3 已装 + iTerm2 Python API 已启用 (it2 ls 通), backendType:iterm2 通路实证存活(并发 team 5 teammate 均 iterm2); Warp 终端下 "tmux" 按预期降级 in-process。官方事实经 agent-teams 文档 + CHANGELOG v2.1.186 两源交叉核验。lint-all.sh 全过(44 文件/测试套)。
maintainer 复议：模板默认 teammateMode "tmux" → "iterm2"（fail-loud——缺 it2 报错而非静默退回 in-process，正解 ADR-004 "以为开了分屏其实没开" 痛点）。 "tmux"/"auto" 降为推荐 fallback；模板 min 维持 v2.1.154 不上抬（Agent Teams 实验 flag、不构成 min 下限）。ADR-004 决策内修订（备选 D 采纳作默认 / 备选 A 降 fallback / §版本与查证 翻转回填 + 本机核验）；team-mode.md + FIRST_RUN.md 对齐。 同批：隐式团队余波同步（v2.1.178 移除 TeamCreate/TeamDelete）——agf-team-stop.md 删手动 TeamDelete 指引、team-capability-map.md 删 5 处恒 ❌ TeamCreate 行、 team-mode.md 加隐式团队运行时说明。 MINOR（实验性 Teams 默认变更，stable 模板契约 agents/skills/commands/hooks/ standards 未动）。本机核验：it2 v0.2.3 + iTerm2 Python API + backendType:iterm2 通路存活。lint-all.sh 全过（44 文件/测试套）。
pcliangx
changed the title
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
teammateMode 默认翻转为
"iterm2"（跟进 CC v2.1.186）+ 隐式团队余波同步（v2.1.178）决策：模板默认
"tmux"→"iterm2"本模板主用场景为 macOS + iTerm2 +
it2（本机已核验 it2 v0.2.3 + Python API +backendType:"iterm2"通路存活）。显式"iterm2"相对"tmux"自动判别的关键增量：缺 it2 / 非 iTerm2 时显式报错（fail-loud）而非静默退回 in-process——正解 ADR-004 当初"以为开了分屏其实没开"的痛点。"tmux"/"auto"降为推荐 fallback（无 it2 / 跨平台用户改设即恢复优雅降级）。版本 & 兼容
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS），默认显示模式翻转不动 stable 模板契约（agents/skills/commands/hooks/standards 未改）。team-mode.md§已启用的运行时配置）。改动
.claude/settings.json：teammateMode"tmux"→"iterm2"docs/adr/004-*.md：ADR-004 决策内修订（"当前生效决策"框 + 备选 D 采纳作默认 + 备选 A 降 fallback + §版本与查证 翻转回填 + 本机核验；2026-06-17 tmux 决策保留为沿革）.claude/rules/team-mode.md：iterm2 升默认 / tmux 降 fallback / 启动协议第 5 条；含隐式团队（v2.1.178）运行时说明docs/FIRST_RUN.md：split-pane 段 + 前置表对齐 iterm2 默认 + it2 前置 + fallbackCLAUDE.md：版本号 → v6.6.0（min 维持 v2.1.154）TeamCreate/TeamDelete）：agf-team-stop.md删手动TeamDelete指引、team-capability-map.md删 5 处恒 ❌TeamCreate行Migration（仅影响启用 Teams 且无 it2 / 非 iTerm2 的 fork）
teammateMode设回"tmux"/"auto"（项目级或用户级）pip install it2+ iTerm2 Enable Python API + CC ≥ v2.1.186teammateMode不生效，无影响Verification
min-version: 2.1.186）+ CHANGELOG v2.1.186it2 ls通）、backendType:"iterm2"通路存活（并发 team 5 teammate 均 iterm2）；Warp 下旧 tmux 默认按预期降级 in-processlint-all.sh全过（44 文件/测试套）claude --teammate-mode iterm2确认显式值产backendType:"iterm2"（下次从 iTerm2 spawn team 自验，回填 ADR-004）