Crux：Markdown原生的多智能体工作流框架

Crux是一个Markdown原生的多智能体工作空间框架，核心特点是用纯Markdown文件定义智能体、技能和工作流，无需绑定特定运行时环境。它旨在解决现有多智能体框架配置复杂、学习曲线陡峭、版本控制困难等问题，以'文档即配置'为理念，降低智能体系统的参与门槛和维护成本。

随着AI智能体技术发展，构建多智能体协作系统日益普遍，但现有框架存在诸多配置问题：

• 学习曲线陡峭：需掌握特定配置语法和模型
• 版本控制困难：结构化配置文件难以diff和审查
• 可读性差：配置与文档分离，理解系统需跨文件查阅
• 供应商锁定：依赖特定运行时，迁移成本高

Crux以'Markdown即配置'为核心理念，将智能体定义、技能描述、工作流编排全部写入.md文件，无需特殊运行时即可阅读。其架构采用三层抽象模型：

1. 智能体层：每个智能体为Markdown文件，含角色、能力等（既是文档也是配置）
2. 技能层：技能为Markdown文件，描述输入输出、步骤等，可复用
3. 工作流层：编排智能体协作模式，支持条件分支、并行等 声明式配置带来优势：人类可读、版本友好、工具生态丰富、渐进式采用

Crux适用于多种场景：

• 研究团队知识管理：用智能体定义研究方向，技能定义共享工具，工作流定义研究流程，让新成员快速理解工作方式
• 客服智能体编排：业务人员可直接编辑Markdown调整意图识别、知识检索等智能体的协作流程
• 内容创作流水线：构建选题、研究、写作、编辑、发布的自动化工作流，降低上下文切换成本

Markdown扩展策略

Crux通过以下方式扩展Markdown表达能力：YAML前置元数据、约定式标记、自定义指令、链接语义

执行模型

支持静态生成（编译为JSON/Python）、解释执行（直接读Markdown）、混合模式

与现有框架对比

特性	Crux	LangChain	AutoGen	CrewAI
配置格式	Markdown	Python代码	Python代码	Python/YAML
运行时依赖	无	需要	需要	需要
可读性	高	中	中	中
版本控制	友好	一般	一般	一般
学习曲线	低	高	高	中
Crux更适合配置驱动、文档优先场景，其他框架在编程灵活性上更优。

Crux并非万能，存在以下局限：

• 表达能力天花板：复杂逻辑用Markdown表达可能笨拙
• 性能开销：解析Markdown比结构化格式慢
• 工具成熟度：工具链和调试支持不如成熟框架
• 社区规模：示例、插件等资源较少 需根据场景选择，复杂自定义逻辑场景可能更适合传统框架。

未来方向

• AI原生文档：文档与配置界限模糊，自然语言描述驱动系统
• 协作式开发：非技术角色可参与配置，促进跨职能协作
• 可解释AI：Markdown定义助力理解AI决策

选择建议

若重视配置可读性、版本控制，Crux值得借鉴；若需复杂自定义逻辑和深度集成，传统框架更合适。技术选择需权衡约束条件，理解设计理念差异。