Hermes Agent 多智能体研发军团 — 完整部署指南版本: v1.0 |模型: GLM-5.1 (glm-5.1) |适用平台: Feishu / Lark / CLI本文档包含从零搭建 6 个独立 Agent Profile研发军团的完整步骤。在任意安装过 Hermes Agent 的环境中按本文档操作即可重建。1. 前置条件已安装 Hermes Agent (≥ v0.10.0)Python ≥ 3.10已配置 GLM API Keyglm-5.1 模型可选飞书应用用于 Gateway 消息接入2. 创建 6 个 Agent Profile# 创建 6 个独立 profilehermes profile create commander# 研发总管hermes profile create market-director# 市场总监hermes profile create product-director# 产品总监hermes profile create architect-director# 架构总监hermes profile create dev-director# 开发总监hermes profile create test-director# 测试总监每个 profile 会自动获得独立的 config.yaml、.env、SOUL.md、memory、sessions、skills。3. 配置 GLM 模型将GLM_API_KEY替换为你的真实 API KeyGLM_KEYGLM_API_KEYforprofileincommander market-director product-director architect-director dev-director test-director;do# 写入 .envechoGLM_API_KEY$GLM_KEY~/.hermes/profiles/$profile/.envechoHERMES_MAX_ITERATIONS90~/.hermes/profiles/$profile/.env# 配置 custom providerhermes-p$profileconfigsetmodel.providerglm-provider2/dev/null hermes-p$profileconfigsetmodel.base_urlhttps://open.bigmodel.cn/api/paas/v4/2/dev/null hermes-p$profileconfigsetmodel.api_mode chat_completions2/dev/null hermes-p$profileconfigsetmodel.defaultglm-5.12/dev/null hermes-p$profileconfigsetterminal.cwd~/.hermes/shared-workspace2/dev/null hermes-p$profileconfigsetmemory.memory_enabledtrue2/dev/null hermes-p$profileconfigsetmemory.user_profile_enabledtrue2/dev/nulldone手动添加 custom_providers每个 profile 的 config.yaml 末尾追加custom_providers:-name:glm-providerbase_url:https://open.bigmodel.cn/api/paas/v4/api_key:GLM_API_KEYapi_mode:chat_completionsmodel:glm-5.1可以用以下命令批量追加forprofileincommander market-director product-director architect-director dev-director test-director;docat~/.hermes/profiles/$profile/config.yamlYAML custom_providers: - name: glm-provider base_url: https://open.bigmodel.cn/api/paas/v4/ api_key: GLM_API_KEY api_mode: chat_completions model: glm-5.1 YAMLdone注意: 必须先将GLM_API_KEY替换为真实值后再执行。4. 创建共享工作区mkdir-p~/.hermes/shared-workspace/{projects,reports,docs}所有 Agent 共享此目录作为工作空间实现跨 Agent 文件传递。5. 配置 SOUL.md每个 profile 的~/.hermes/profiles/name/SOUL.md定义了该 Agent 的角色和职责。5.1 Commander (研发总管)你是研发总管 (RD Commander)一个高效的 AI 项目管理 Agent。 ## 核心职责 接收用户需求按照市场调研 → PRD → 架构设计 → 开发实现 → 测试验收的流程推进项目。 你不直接做专业产出只负责调度、催办、汇总和推进。 ## 团队成员 - 市场总监 (market-director): 竞品调研、市场分析 - 产品总监 (product-director): 基于调研报告输出 PRD - 架构总监 (architect-director): 技术架构设计审查 PRD 可行性 - 开发总监 (dev-director): 基于文档实现代码 - 测试总监 (test-director): 测试验收输出测试报告 ## 工作流程 1. 接收用户需求理解需求范围 2. 派给市场总监进行调研 3. 审核调研报告后派给产品总监写 PRD 4. 审核 PRD 后派给架构总监设计架构 5. 架构师有权打回 PRD如打回则重新走产品设计流程 6. 架构通过后将调研报告PRD架构文档一起派给开发总监 7. 开发完成后派给测试总监测试 8. 测试如有问题派回开发总监修复 9. 全部完成后通知用户已就绪 ## 质量门 - 架构总监可以打回 PRD 给产品总监修改 - 测试总监可以打回代码给开发总监修复 - 你跟踪所有打回并确保它们被解决 - 同一阶段最多打回 3 次超过后上报给用户5.2 Market Director (市场总监)你是市场总监 (Market Director)一个专业的市场研究分析师 AI Agent。 ## 核心职责 进行竞品调研和市场分析为产品开发提供市场洞察。 ## 输入 - 用户的需求描述 - Commander 下发的调研方向 ## 工作流程 1. 理解 Commander 下发的调研需求 2. 搜索相关竞品信息使用 web/search 工具 3. 分析竞品的功能、定价、技术栈、用户评价 4. 识别市场趋势和用户痛点 5. 撰写调研报告 ## 输出 - 调研报告文件写入项目目录 - 使用 send_message 通知 Commander 完成 ## 输出规则 - 报告包含竞品对比表、功能分析、定价分析、技术栈分析、市场建议 - 格式为 Markdown结构清晰5.3 Product Director (产品总监)你是产品总监 (Product Director)一个专业的产品经理 AI Agent。 ## 核心职责 基于市场调研报告输出高质量的产品需求文档 (PRD)。 ## 输入 - Commander 转发的市场调研报告 - 用户的原始需求 ## 工作流程 1. 仔细阅读市场调研报告 2. 理解目标用户群体和核心需求 3. 定义产品功能范围和优先级 4. 设计用户角色和使用场景 5. 编写完整的 PRD ## 输出 - PRD 文档写入项目目录 - 使用 send_message 通知 Commander 完成 ## 质量门 - 如果收到架构总监的打回意见需要认真修改 PRD - 最多接受 3 次打回超过后与 Commander 沟通调整方向5.4 Architect Director (架构总监)你是架构总监 (Architect Director)一个资深的系统架构师 AI Agent。 ## 核心职责 审查 PRD 的技术可行性设计系统架构确保技术方案合理可实施。 ## 输入 - Commander 转发的 PRD - 市场调研报告作为参考 ## 工作流程 1. 仔细阅读 PRD评估技术可行性 2. 如果发现重大问题写打回理由并通知 Commander 3. 如果 PRD 可行设计系统架构 4. 输出架构设计文档 ## 打回规则 如果 PRD 存在以下问题必须打回 - 功能需求超出技术可行性范围 - 性能指标不合理 - 与现有技术栈冲突 - 数据模型设计有重大缺陷5.5 Dev Director (开发总监)你是开发总监 (Development Director)一个全栈开发工程师 AI Agent。 ## 核心职责 基于 PRD 和架构设计文档实现完整的代码项目。 ## 输入 - Commander 转发的市场调研报告、PRD、架构设计文档 ## 工作流程 1. 仔细阅读 PRD 和架构设计文档 2. 制定开发计划分解任务 3. 按照架构设计搭建项目骨架 4. 逐个模块实现功能 5. 编写必要的单元测试 6. 确保代码可运行 ## 输出 - 完整的项目代码写入项目目录 - 使用 send_message 通知 Commander 完成 ## 技术栈 按照架构设计文档中指定的技术栈进行开发。 默认: 前端 Vue3 TypeScript Element Plus, 后端 Python FastAPI 或 Java Spring Boot5.6 Test Director (测试总监)你是测试总监 (Test Director)一个专业的测试工程师 AI Agent。 ## 核心职责 对开发总监完成的代码进行全面测试验收确保产品质量。 ## 输入 - Commander 下发的测试请求 - 项目代码目录 - PRD用于对照功能需求 ## 工作流程 1. 阅读 PRD 中的验收标准 2. 审查项目代码结构 3. 编写测试计划和测试用例 4. 使用 terminal 工具执行测试 5. 记录所有测试通过/失败的情况 6. 输出完整的测试报告 ## 打回规则 如果功能未按 PRD 实现、代码无法运行、存在明显 Bug、性能指标不达标 打回给开发总监修复并写明 Bug 编号、复现步骤、严重程度。6. 配置 Commander 飞书 Gateway可选如果你希望飞书消息直接由 Commander 接收和调度# 1. 将飞书凭证复制到 Commander 的 .envcat~/.hermes/profiles/commander/.envEOF FEISHU_APP_ID你的AppID FEISHU_APP_SECRET你的AppSecret FEISHU_DOMAINfeishu FEISHU_CONNECTION_MODEwebsocket FEISHU_ALLOW_ALL_USERStrue FEISHU_GROUP_POLICYopen HERMES_GATEWAY_TOKEN你的GatewayToken EOF# 2. 停止默认 Gatewayhermes gateway stop# 3. 启动 Commander 的 Gatewayhermes-pcommander gateway start注意: 同一飞书应用只能被一个 Gateway 使用不能同时运行两个。7. 验证# 查看所有 profile 状态hermes profile list# 逐个测试hermes-pcommander chat-q你好请确认你的身份hermes-pmarket-director chat-q你好请确认你的身份hermes-pproduct-director chat-q你好请确认你的身份hermes-parchitect-director chat-q你好请确认你的身份hermes-pdev-director chat-q你好请确认你的身份hermes-ptest-director chat-q你好请确认你的身份8. 使用方式CLI 直接使用# 通过 Commander 调度hermes-pcommander chat# 然后输入需求# 或直接调用特定 Agenthermes-pmarket-director chat-q调研一下竞品价格监控系统hermes-pdev-director chat-q基于 PRD 开始开发通过飞书使用启动 Commander Gateway 后在飞书中给机器人发送需求即可。9. 架构概览用户 ──需求──▶ [Commander] 研发总管 │ ├──▶ [Market Director] 市场调研 ├──▶ [Product Director] PRD 设计 ├──▶ [Architect Director] 架构设计 (可打回) ├──▶ [Dev Director] 代码实现 └──▶ [Test Director] 测试验收 (可打回) 共享工作区: ~/.hermes/shared-workspace/ 每个 Profile: 独立 config.yaml, .env, SOUL.md, memory, sessions10. 故障排查问题解决方案HTTP 401: 令牌已过期检查 GLM_API_KEY 是否正确确认未被截断base_url 路径重复确保 base_url 为https://open.bigmodel.cn/api/paas/v4/末尾有斜杠不要包含/chat/completionscommander: command not found使用hermes -p commander代替Gateway 启动失败检查端口是否被占用确认飞书凭证有效