核心功能
Agent Swarm Orchestrator 是一个端到端的编码自动化系统，将 Obsidian 笔记作为任务入口，通过 Claude Code 执行开发、Codex 进行代码审查，最终推送到 GitLab 并自动创建合并请求。整个流程支持定时扫描、状态追踪、自动合并与通知闭环。
显著优点
1. 全链路自动化：从任务创建到代码合并无需人工干预，支持无人值守运行
2. 多项目隔离：每个任务使用独立 git worktree 和 tmux 会话，避免冲突
3. 分层审查机制：Codex 分级审查（CRITICAL/HIGH/MEDIUM/LOW），高风险问题自动重试修复
4. Obsidian 原生集成：通过笔记 frontmatter 和任务块状态驱动工作流，适合知识管理用户
5. 完善的通知体系：Telegram 实时推送任务状态变更，支持人工介入触发合并
潜在缺点与局限性
- 环境依赖复杂：需同时配置 Claude CLI、Codex CLI、glab、tmux 等多个工具
- GitLab 锁定：深度绑定 GitLab MR 流程，不支持 GitHub 等其他平台
- 审查质量不确定：Codex 自动审查的准确性取决于提示工程，复杂架构问题可能误判
- 单点故障风险：tmux 会话崩溃或网络中断可能导致任务挂起，依赖 check-agents.sh 的 3 分钟轮询检测
- 安全风险：Claude Code 配置了
skipDangerousModePermissionPrompt: true，需确保 worktree 目录可信
适合人群
- 拥有多个小型项目的独立开发者或技术负责人
- 已使用 Obsidian 作为知识管理工具的用户
- 需要批量处理标准化开发任务（如配置更新、模板生成、文档重构）的场景
- 具备 shell 脚本和 cron 基础运维能力的用户
常规风险
1. 权限提升：自动合并脚本若配置不当可能合并未经充分审查的代码
2. 凭证泄露：registry.json 和 .claude.json 包含敏感配置，需严格限制文件权限
3. 资源耗尽：并发 agent 数量无显式上限，大量任务同时运行可能耗尽系统资源
4. 无限循环：fixing → reviewing 重试机制若遇边缘情况可能死循环（虽有 2 次上限）
5. 数据丢失：worktree 定期清理机制若配置错误可能误删活跃任务数据