用 WorkSwarm 跑通「AI 面试天团」：多 Agent 项目一键部署的 5 个易错点

本文基于华为云 AI Agent 开发实践中心开源仓库 agent-best-practices/ai-interview-swarm 的 README 与 Skills 结构整理，所有结论都可以在仓库里逐条核对。

一、为什么从模板开始

自己从零写一个多 Agent 系统，难点通常不在「调用大模型」，而在角色怎么拆、消息怎么流转、状态怎么收敛。华为云的 AI 办公实践中心把「AI 面试天团」这类项目做成了可直接复用的模板：5 个 Agent 分工协作，破冰 → 技术面试 → HR 面试 → 生成评估报告，全流程自动化。

它的架构很朴素：

综合得分 = 技术平均分 × 0.7 + HR 平均分 × 0.3。整套能力落在 5 个 SKILL.md + 4 份 PDF 知识库 + 1 个 HTML 报告模板上，这正是模板类项目的价值：你能看到一份可运行的多 Agent 约定。

二、一键部署指令本质是 Prompt，不是文档

仓库 README 的「一键部署」章节给了一段指令，让你粘贴到 WorkSwarm 对话框里，由 AI 自己改配置、建目录。很多同学把它当普通文档扫一眼就粘过去，结果第一轮就跑偏。建议把它当代码对待：有入参、有前置条件、有可验证的断言。

原始指令的骨架是：

1. 建目录：/var/interview_Lab（知识库）与 /var/interview_Log（日志，含技术面试/HR 面试/综合评估三级子目录）
2. 全仓替换路径：D:\zhishiku\ → /var/interview_Lab/，D:\面试记录\ → /var/interview_Log/
3. 自查：grep -rn 'D:\\' Skills/ 应无输出；grep -rn "/var/interview" Skills/ 应有 14 处命中
4. 所有 Agent 统一使用当前已配置的主模型

三、五个容易被忽略的坑

坑 1：替换是 14 处、跨 5 个 SKILL.md，不是一处

路径在 Skill 里既出现在「读知识库」也出现在「写报告、写日志」的位置，还散落在信号示例里。只改 D:\zhishiku\ 会留下一半 D:\面试记录\，运行时表现是面试能跑、报告写不出来。所以第 3 步的 grep 断言必须执行，而且要看命中数是 14 而不是「差不多」。

坑 2：Windows 与 Linux 的路径口径不能混用

一键部署走的是 Linux 口径（/var/...），本地手动部署走的是 Windows 口径（D:\zhishiku\）。两种方式二选一。混用最典型的症状是：环境里存在两套目录，Agent 一会儿读得到知识库、一会儿读不到。

坑 3：部署指令自身的编号会「断」，让 AI 合并步骤

README 里这段指令的编号是 1、2、3、4、3：第 3 条其实是「路径口径」说明，却顶着「替换后自查」的标题，与第 4 条真正的自查命令撞名，最后一条「统一模型」又回到 3。对直接执行的模型来说，这是指令层面的歧义——很容易把「统一模型」并入第 3 条一起跳过。

我已在仓库提交 issue #956：https://gitcode.com/agent-best-practices/ai-interview-swarm/issues/956 ，建议的改法是把口径说明降级为第 2 步下的注释，自查单独成一条，模型配置收尾成最后一条。

坑 4：grep 的转义在 Windows 终端里会失效

grep -rn 'D:\\' Skills/ 在 Git Bash / WSL 下正常，在 PowerShell 里反斜杠不是转义符，命令会变成另一个意思。稳妥写法是用单引号包住模式，或在 PowerShell 里改用 Select-String -Pattern 'D:\\' -Path Skills -Recurse。

坑 5：部署完成≠能面试，还要切「团队模式」

模板创建完只代表 Agent 齐了。要进入面试，需要切到团队模式（与《快速部署指南》一致），然后输入「我要面试」由 Leader 接管对话。这一步在 README 里只有一句备注，但恰恰是新手最容易卡住的地方。

四、把「一键部署」做成可回归的检查清单

如果同一个模板要部署给多人用，建议在指令末尾追加可判定的断言，让 AI 必须逐条回答「通过 / 不通过 + 证据」：

1. 目录断言：ls -d /var/interview_Lab /var/interview_Log 均有输出
2. 残留断言：grep -rn 'D:\\' Skills/ 无输出
3. 覆盖断言：grep -rn '/var/interview' Skills/ | wc -l 等于 14
4. 知识库断言：4 份 PDF 全部落在 /var/interview_Lab/ 下
5. 模型断言：5 个 SKILL.md 中的模型名一致，且等于当前主模型
6. 冒烟断言：团队模式下输入「我要面试」，Leader 能正常发起破冰

断言化之后，部署从「看得懂就行」变成「跑得过才算」，多人协作时的返工率会明显下降。

五、小结

多 Agent 模板的难点往往不在模型能力，而在约定与工程细节：路径、目录层级、编号、转义、入口状态。把这些当成代码来管理——版本化、可复现、有断言——模板才真正变成生产力，而不是一份看起来很美、跑起来处处漏的示例。

仓库地址：https://gitcode.com/agent-best-practices/ai-interview-swarm