seanswarm

seanswarm 是一套面向主流 AI 编程工具（Claude Code、Codex、Cursor、ZCode 等）的多智能体工作流技能包。它将单一 AI 编程工具扩展为受监督的小型团队：研究任务广播式分发、双通道文档阅读、开发交付含独立审查、UI 验收含截图证据链——全流程可验证、可追溯。

技能简介

seanswarm 是一款轻量级多智能体工作流技能包，通过角色模板和工作流协议，将单一 AI 编程工具转化为多人协作的团队模式。每个角色（研究者、审查者、开发者、视觉裁判）各司其职，证据驱动决策，冲突通过仲裁机制解决，而非简单投票。

核心能力

seanswarm 包含四大核心工作场景：

• Web 研究（web-research-fanout）：广播式分发研究任务 → 主张表格 → 对抗性审查通道 → 跨家族仲裁 → 反爬取阶梯（L0-L4）
• 双通道文档阅读（dual-read）：两个独立通道读取同一文档后交叉对比，结果分为匹配、补充、冲突三类
• 开发交付（dev-delivery）：QA 优先验收清单 → 单一写手 → 独立只读审查（仅 diff） → 失败闭环接受机制 → 修复返回写手
• 视觉验收（visual-judge）：渲染 → 截图 → 逐页判决 → 修复 → 重新渲染；UI 文件变更但无截图证据时自动打回

安装配置

手动安装

cp -r skills/* /
cp agents/*.md /

常见路径：ZCode ~/.agents/skills + ~/.zcode/agents；Claude Code ~/.claude/skills + ~/.claude/agents；Codex ~/.codex/skills。

ZCode 插件方式

仓库包含 .zcode-plugin/plugin.json 清单，可作为插件源添加。

可选 Hook

hooks/ui-screenshot-gate.mjs 是 Stop 事件钩子：当 UI 文件被编辑但该轮未产出截图证据时，自动打回重新收集。

使用步骤

1. 安装：将 skills 和 agents 目录内容分别复制到对应目录
2. 研究场景：向 agent 描述研究任务，触发 web-research-fanout 工作流，agent 自动广播分发、汇总主张、触发对抗审查
3. 文档阅读：提供文档路径，触发 dual-read 工作流，两个通道独立阅读后交叉对比
4. 开发交付：描述功能需求，触发 dev-delivery 工作流，QA 清单 → 写手实现 → 审查者验证
5. 视觉验收：要求 agent 渲染 UI 并进行截图验证，触发 visual-judge 工作流

适用场景

• 深度技术调研：多角度、多来源的技术调研任务，需要交叉验证
• 代码审查：重要代码变更需要独立审查者验证，而非作者自审
• 复杂文档分析：重要文档需要两种独立视角对比阅读，避免单一理解的盲区
• UI 质量把控：自动化 UI 验收，确保每次「完成」都有截图证据

适用人群

• 在团队环境中使用 AI 编程工具的开发者
• 需要高质量研究输出的研究员和分析师
• 对代码审查和 UI 验收有标准化流程要求的工程团队

工作原理

seanswarm 的设计原则：

• 证据优于共识：主张必须有来源；冲突通过仲裁而非投票解决
• 角色分离：零写作的审查者、单一写手、专职对抗性审查通道
• 干净上下文：审查者只接收 diff + 需求，从不接收对话历史
• 失败闭环：未知状态视为失败；空 diff 需要明确豁免声明
• 验证先于完成：没有新运行输出就不算「完成」

官方链接

• GitHub：https://github.com/ccai40359-wq/seanswarm