Matz Swarm

核心功能

Agent Swarm Orchestrator 是一套面向多项目开发的智能体自动化编排系统，通过脚本化流水线将 Obsidian 任务录入、Claude Code 自动编码、Codex 代码审查、GitLab MR 管理串联为闭环工作流。

显著优点

• 端到端自动化：从 Obsidian 笔记触发到 MR 合并完成，全程无人值守
• 双智能体架构：Claude 专职编码、Codex 专职审查，角色分离降低认知偏差
• 健壮的状态机：任务生命周期包含 8+ 状态节点，支持重试、超时、降级策略
• 工作树隔离：每个任务独立 git worktree + tmux 会话，避免污染主分支
• 多项目并行：registry.json 配置驱动，支持跨仓库并发调度
• Obsidian 原生集成：frontmatter 状态控制、SHA1 去重、1分钟防抖

潜在局限

• 高度依赖外部 CLI：需同时维护 claude、codex、glab、tmux、jq 等工具链版本兼容性
• 审查策略硬编码：CRITICAL/HIGH/MEDIUM/LOW 分级规则内嵌脚本，调整需修改源码
• 无 Web UI：纯命令行 + cron 运维，状态查询依赖 tmux attach 或 tail 日志
• 单点故障风险：~/.claude.json OAuth 凭证丢失或 ANTHROPIC_* 环境变量污染可导致整个 swarm 瘫痪
• Codex 审查黑盒：codex exec review 输出格式未标准化，解析可靠性存疑

适合人群

• 维护 3-10 个中小型代码仓库的独立开发者或技术负责人
• 追求 "inbox zero" 式开发流程、愿用 Markdown 管理任务的 Obsidian 重度用户
• 具备 shell 脚本调试能力、能接受 cron 运维模式的 DevOps 实践者

常规风险

• 凭证泄露：OAuth token 明文存储于 ~/.claude.json，需严格设置文件权限 600
• 无限循环：fixing → reviewing 重试上限为 2 次，但复杂缺陷可能反复触发人工介入
• MR 泛滥：高频任务可能产生大量未合并 MR，需配合 cleanup.sh 定期归档
• 网络中断：tmux 会话内网络波动导致 push 失败，依赖 check-agents.sh 3 分钟轮询兜底
• 提示词注入：Obsidian 任务描述未经充分转义直接写入 prompt 文件，存在潜在注入风险