team-arch-opt 是用于架构优化的统一团队技能，采用 team-worker 智能体架构，通过角色目录承载领域逻辑，由协调者（coordinator）编排多智能体流程：分析代码库 → 设计重构方案 → 实施改动 → 验证改进 → 审查代码质量。
使用方式：通过 Skill(skill="team-arch-opt", args="任务描述") 调用。技能以 SKILL.md 作为路由器：未提供 --role 时读取 roles/coordinator/role.md 并执行入口路由；提供 --role <name> 时读取 roles/<name>/role.md 并执行 Phase 2-4。可用角色包括 coordinator、analyzer、designer、refactorer、validator、reviewer，各自带有任务前缀（如 ANALYZE-、DESIGN-、REFACTOR-/FIX-、VALIDATE-、REVIEW-/QUALITY-）。协调者将任务分析后派发并生成 worker。
共享约定：会话前缀 TAO，会话路径为 .workflow/.team/TAO-<slug>-<date>/。CLI 工具有 ccw cli --mode analysis（只读）与 ccw cli --mode write（修改）；消息总线为 mcp__ccw-tools__team_msg。
用户命令包括：check/status 查看状态；resume/continue 推进下一步；revise <TASK-ID> [feedback] 修订任务并级联下游；feedback <text> 分析反馈影响；recheck 重跑质量检查；improve [dimension] 自动改进最弱维度。
会话目录包含 session.json、task-analysis.json、artifacts（含 architecture-baseline.json、architecture-report.md、refactoring-plan.md、validation-results.json、review-report.md 等）、explorations、wisdom、discussions 与 .msg。
限制：技能依赖 ccw cli 与分析/写入模式；CLI 工具失败时 worker 回退为直接实现；未知命令或角色不存在会报错并给出可用列表；分支修复循环达 3 次时仅将该分支升级给用户；max_branches 超限时协调者在 CP-2.5 截断至前 N 个；consensus_blocked HIGH 时协调者创建修订任务或暂停流水线。具体安装命令与收费信息暂未提供。