AI Agent Workstation：多代理协作的本地工作流框架

AI Agent Workstation是一个本地多代理协作工作空间，旨在解决多代理协作中的上下文管理、任务交接、质量控制和记忆管理等核心痛点。它通过分层目录架构、Markdown文件传递机制，实现Hermes（协调审查）与Codex（执行实现）的协同工作，并支持质量门禁（MCP辅助层）和知识沉淀，为复杂开发场景提供结构化协作方案。

随着大模型能力提升，多代理协同完成复杂任务成为趋势，但存在四大痛点：

1. 上下文管理：确保各代理获取必要信息且避免过载；
2. 任务交接：高效传递成果，保证执行一致性；
3. 质量控制：建立有效审查机制；
4. 记忆管理：提取可复用经验。 AI Agent Workstation为此设计，提供结构化本地工作空间支持多代理按协议协作。

分层目录结构

• templates/：通用可复用模板；
• tasks/：Codex任务交接文件；
• results/：Codex执行输出；
• reviews/：Hermes审查文件；
• memory/：知识沉淀；
• workflows/：多代理工作流定义。

核心协作角色

• Hermes：规划、协调、审查、上下文与记忆管理；
• Codex：代码编辑、测试、构建与结果报告；
• Human：产品方向、审批、最终决策（AI辅助而非替代）。

Markdown文件传递流程

代理间通过结构化Markdown文件交接，流程为： AGENT_CONTEXT.md → CODEX_TASK.md → AGENT_RESULT.md → AGENT_REVIEW.md → MEMORY_CANDIDATES.md 各文件分别承载上下文、任务定义、执行结果、审查意见、知识候选。

MCP辅助层（可选）

当my-agents-mcp可用时，提供工件模板验证与质量门禁：

• 验证CODEX_TASK.md后执行；
• 验证AGENT_RESULT.md后审查；
• 验证AGENT_REVIEW.md后响应；
• 验证MEMORY_CANDIDATES.md后沉淀记忆。 MCP不替代核心Markdown工作流，仅为辅助工具。

AI Agent Workstation适用于以下场景：

1. 复杂功能开发：Hermes负责架构设计，Codex实现模块；
2. 代码重构：Hermes制定策略，Codex执行重构，Hermes审查结果；
3. 测试驱动开发：Hermes定义测试用例，Codex实现代码并运行测试；
4. 知识沉淀：通过MEMORY_CANDIDATES.md系统性记录最佳实践与经验教训。

项目遵循严格安全与隐私原则：

1. 不存储敏感信息于记忆候选、模板等文件；
2. 执行破坏性命令或外部集成前暂停，等待人类确认；
3. 保持工作流工件透明，避免隐藏自动化逻辑。 这些原则确保AI协作的安全性与可控性。

AI Agent Workstation代表结构化多代理协作方法论，并非简单代理聊天，而是通过明确职责划分、规范文件传递机制、严格质量门禁实现有效协作。它为希望集成AI代理到开发工作流的团队提供深思熟虑的参考框架，证明AI协作需强大模型能力+清晰协议与治理机制。 项目地址：https://github.com/agenticnoob/ai-agent-workstation