核心用法
Swarm Coding Skill 是一个完全自主的多智能体软件开发系统。用户只需用自然语言描述应用需求，系统即可自动完成从设计到交付的端到端开发流程。使用方法极为简单：在主会话中执行 /trigger swarm-code "你的应用描述"，系统将立即启动编排器（Orchestrator），后者以 Planner 角色分析需求、确定技术栈与架构，并生成包含任务与依赖关系的 swarm.yaml 清单。
工作流程采用经典的主从协作模式：编排器作为中央协调者，根据任务依赖关系并行或串行派发子任务；Worker 代理（BackendDev、FrontendDev、QA、DevOps）作为子会话在共享工作空间中独立执行。通过目录分区策略（如 server/ 归后端、client/ 归前端）避免文件冲突，关键文件所有权由清单明确指定。质量关卡确保 QA 测试通过后方可集成，DevOps 负责容器化，所有合并必须通过绿色测试。
显著优点
1. 极致简化开发门槛：无需编写技术规范、无需纠结技术选型、无需协调多人分工，自然语言描述即可驱动完整工程交付。
2. 内置质量保障体系：自动化测试、容器化配置、可选 CI/CD 工作流，产出即具备生产就绪基础。
3. 持续学习与进化：.learnings/ 目录自动记录错误、改进点与功能请求，形成正向反馈循环，使技能随使用次数增加而智能提升。
4. 项目记忆机制：DECISIONS.md 文档化关键架构决策，为后续维护与迭代提供知识锚点。
5. Web3 原生支持：检测到区块链、代币、NFT 或 Privy 相关关键词时，自动集成 Privy 认证与钱包基础设施。
潜在缺点与局限性
1. 模型依赖性：强制使用 openrouter/qwen/qwen3-coder，用户无法更换底层模型，且需自行配置 OpenRouter API 密钥。
2. 黑盒决策风险：技术栈、库选择、架构模式完全由系统自主决定，虽可事后查阅 DECISIONS.md，但事前无法干预。
3. 重试机制单薄：单任务失败仅触发一次重试，复杂场景的容错与恢复能力有限。
4. 资源消耗：多智能体并行会话对磁盘空间、API 调用量有显著要求。
5. 生态锁定：项目结构、依赖管理、部署流程均围绕 Node.js 生态优化，其他语言支持度不明。
适合人群
- 快速原型开发者：需要将想法快速转化为可运行代码的独立开发者或创业团队。
- 全栈能力补全者：具备产品思维但技术栈覆盖不全的"技术产品经理"。
- 自动化爱好者：希望探索多智能体协作范式、积累可复用开发经验的工程师。
- Web3 应用构建者：需要快速集成钱包认证、区块链交互功能的 DApp 开发者。
常规风险
1. 代码质量波动：AI 生成代码的正确性、安全性、性能需人工复核，不建议直接用于生产环境。
2. 密钥泄露风险：.env 文件管理不当可能导致 API 密钥暴露于版本控制。
3. 依赖供应链安全：自动选择的第三方库可能存在未审计漏洞或恶意包。
4. 知识产权模糊：训练数据衍生的代码片段可能涉及许可证兼容性问题。