核心能力
Agent Swarm Orchestrator 是一套面向多项目的自动化编码工作流系统，采用"任务驱动 + 代理执行"的架构设计。用户通过 Obsidian 笔记标记任务状态，系统通过定时脚本扫描触发完整的开发流水线：从代码生成、智能审查到自动合并与状态同步。
显著优点
1. 全流程自动化闭环：从任务创建（Obsidian）→ 代码实现（Claude Code）→ 质量审查（OpenAI Codex）→ 提交合并（GitLab MR），无需人工介入中间环节。
2. 多项目隔离与并发：利用 Git worktree 为每个任务创建独立工作空间，配合 tmux 会话实现多任务并行，互不干扰。
3. 分级审查策略：Critical/High 级别自动修复并重试，Medium 级别非阻塞处理，Low 级别仅记录，文档变更智能降级，兼顾质量与效率。
4. 状态机驱动的任务生命周期：明确的 7 阶段状态流转（starting → running → reviewing → ready_to_merge → done），支持超时检测与异常兜底。
5. Obsidian 原生集成：通过 frontmatter 和任务块语法实现零摩擦的任务录入，支持项目初始化、去重与防抖机制。
潜在局限与风险
- 权限与信任边界：要求
skipDangerousModePermissionPrompt: true且预先信任工作目录，削弱交互式安全确认。 - 单点依赖：Claude Code 与 Codex CLI 的认证状态、API 可用性直接影响流水线连续性。
- 审查黑盒化：Codex 作为封闭模型，其审查标准的稳定性与可解释性难以保障。
- 自动合并风险：
glab mr create --yes配合分级策略可能在边缘场景下引入未经充分验证的代码。 - 通知链路：Telegram 通知依赖外部 CLI 工具，故障时可能静默丢失状态变更。
适用人群
- 需要同时维护多个代码仓库的技术负责人
- 追求"定义任务即完成"极致效率的资深开发者
- 已建立 GitLab 工作流、具备 CLI 工具链成熟使用经验的团队
常规风险
| 风险类别 | 说明 |
|---------|------|
| 凭证泄露 | `~/.claude.json` 与 GitLab token 需严格限制文件权限 |
| 无限循环 | 自动修复最大 2 次重试，但仍需监控异常模式 |
| 分支污染 | worktree 未正确清理可能导致残留分支堆积 |
| 模型幻觉 | Claude/Codex 可能基于上下文生成不符合预期的代码 |
部署建议
建议先在非生产仓库验证完整周期，确认通知通道可达、审查策略符合团队标准后，再接入核心项目。定期执行 cleanup.sh 避免日志与 worktree 膨胀。