Agent Primitives：Claude Code多智能体工作流的模块化基础架构

agent-primitives项目为Claude Code多智能体开发提供可复用的智能体定义和堆栈配置方案，采用分层架构设计，解决智能体配置分散、难以复用的痛点，助力项目标准化、规模化演进。

随着AI编程助手Claude Code的普及，多智能体协作开发模式兴起，但智能体定义散落在各处，缺乏统一标准和可复用组件。mumoryan开源的agent-primitives项目旨在解决此问题，提供可复用的基础智能体定义和堆栈配置方案，让团队在多个项目间共享核心能力，避免重复造轮子。

agent-primitives采用三层架构：

1. 基础层（base/）：工具链与项目无关，包含身份定义、能力契约、输出模式，是架构基石；
2. 堆栈层（stacks/）：跨项目可复用，包含技术栈特定编码规范、框架最佳实践、通用工具约定；
3. 项目层（.claude/agents/）：个性化定制，包含项目特定路径约束、锁定架构决策、功能化智能体定义。

agent-primitives推荐的使用模式：

• 项目级智能体通过存根文件（/.claude/agents/）扩展基础定义；
• 执行merge-agent.sh脚本，将base+stack+stub合并为完整智能体定义，静态部分优先合并支持提示词缓存优化。

1. 多项目代码规范统一：基础层定义通用审查智能体，堆栈层添加Python/React特定规范，项目层配置路径；
2. SaaS多租户架构：基础层定义租户隔离检查智能体，堆栈层配置数据库访问模式，项目层定制租户验证规则；
3. 企业级开发流程标准化：建立企业级安全审查智能体库，定义合规基础能力，业务线扩展部门规则。

• 可维护性：变更影响范围可控（工具链升级改base层，技术栈迁移换stack层，项目需求变调整stub层）；
• 可复用性：核心能力跨项目共享，已在Loci等项目复用；
• 可扩展性：新智能体按层级创建定义文件，通过merge脚本集成；
• 性能优化：静态合并支持提示词缓存，提升多轮对话响应速度。

agent-primitives为Claude Code多智能体开发提供清晰可扩展的架构蓝图，解决配置分散与复用难题。建议正在或计划使用Claude Code进行多智能体开发的团队，将其作为基础架构参考，它不仅提供现成配置方案，更展示了可持续演进的多智能体工程化方法。