AI 角色越多，项目越像一场失控的群聊？

做 AI 应用时，我曾在自己的项目里给不同模型分了产品经理、程序员和测试员。刚开始配合得很顺，几轮之后却开始失控：目标改了，负责写代码的角色没同步；测试说“通过”，却拿不出判断依据；我只改了一处提示词，之前能跑的流程突然出了问题。想复盘时，连当初为什么这样决定都说不清。

这是我个人使用中的真实感受。后来最近升级了项目，work-by-roles：一个 MIT 开源的 Python 库，用“角色契约 + 会审范式 + 质量门禁 + 全链路审计”来组织 LLM 专家协作。

✅ 角色契约写清职责、禁区、输出格式和证据要求； ✅ 会审时由协调者拆解、专家并行、复核人独立裁决； ✅ 变更后用黄金用例、基线快照和回归检查，验证已有能力是否受影响； ✅ 每次调用、校验和裁决都有 TraceID 关联审计记录，更便于复盘、定位和复现问题。

目前它尚未发布到 PyPI ，安装方式是先克隆 GitHub 仓库，再运行：pip install -e ".[server]"。如果你也在搭多 Agent 流程，可以先去仓库看看，按自己的项目判断是否适合。

https://github.com/puppyfront-web/work-by-roles