Meridian Base：开源Agent编排系统的核心协调原语

Meridian编排系统的基础技能包，提供子任务委派、并行执行、工作项追踪和跨会话协调等核心能力，将Meridian从命令行工具升级为完整的Agent编排平台。

Agent编排：从工具到平台的跃迁\n\n大语言模型Agent的快速发展催生了对编排系统的迫切需求。单个Agent的能力再强，也难以应对复杂的现实世界任务。真正的价值在于让多个Agent协同工作，形成规模效应。然而，协调多个Agent并非易事——任务如何分解、如何并行执行、状态如何追踪、会话如何管理，这些都是编排系统需要解决的核心问题。\n\nMeridian是一个新兴的Agent编排引擎，而meridian-base则是将其从裸命令行工具转化为完整编排系统的关键基础包。\n\n## Meridian Base的定位与价值\n\nmeridian-base提供了Meridian的核心协调原语（Core Coordination Primitives）。它定义了编排器Agent、默认子Agent以及教会它们如何生成工作、追踪状态和跨会话协调的技能集合。简单来说，这是让Meridian"活起来"的灵魂所在。\n\n该包的设计目标是填充项目中的.agents/目录，为运行Meridian的项目提供即插即用的Agent配置。通过约定优于配置的设计理念，Meridian通过目录布局自动发现Agent和技能，无需繁琐的清单文件。\n\n## 核心能力一览\n\n安装meridian-base后，编排器Agent立即获得以下能力：\n\n### 子任务委派与并行执行\n\nbash\n# 将工作拆分为子任务并委派\nmeridian spawn -m codex -p \"实现数据模型\" -f plan/phase-1.md\n\n# 并行运行多个任务\nmeridian spawn -m codex -p \"阶段2a: API端点\"\nmeridian spawn -m codex -p \"阶段2b: CLI处理器\"\n\n\nmeridian spawn命令是编排的核心原语。它支持指定模型、提示词、附件文件，并且能够并行启动多个子任务。每个子任务会阻塞直到完成，而Harness层负责并发调度。这种设计既保证了单个任务的可控性，又实现了多任务的高效并行。\n\n### 工作项生命周期管理\n\nbash\n# 启动工作项\nmeridian work start \"auth-refactor\"\n\n# 更新状态\nmeridian work update --status implementing\n\n\nmeridian work命令族提供了工作项的完整生命周期管理。工作项是跨会话追踪任务状态的关键机制，即使在主会话中断后，工作项的状态和关联产物依然持久化，支持随时恢复和继续。\n\n### 跨会话上下文检索\n\nbash\n# 搜索历史会话\nmeridian session search \"认证设计决策\"\n\n# 搜索报告\nmeridian report search \"token过期\"\n\n\n长期运行的Agent系统必然积累大量历史会话和产物。meridian session search和meridian report search提供了强大的检索能力，让编排器Agent能够从过往经验中学习，避免重复犯错，实现真正的持续改进。\n\n## Agent配置与技能体系\n\nmeridian-base预定义了两个核心Agent：\n\n### meridian-default-orchestrator（默认编排器）\n\n这是主控Agent，负责规划、委派和评估子Agent的工作。它被加载了完整的协调技能集，是用户与Meridian系统交互的主要接口。编排器使用系统默认配置的模型，具备全局视野和决策能力。\n\n### meridian-subagent（子Agent）\n\n这是默认的执行Agent，使用gpt-5.3-codex模型。它接收来自编排器的提示词，执行具体任务，然后报告结果。子Agent的设计原则是专注和可替换——每个子任务可以由最适合的模型或配置来处理。\n\n## 技能（Skills）详解\n\n技能是注入Agent系统提示词的能力模块，让Agent知道如何使用Meridian的CLI。meridian-base包含三个核心技能：\n\n### meridian-cli\n\n教授Agent关于Meridian和Mars CLI的心智模型，包括命令面发现、诊断模式、会话管理和核心原则。这是Agent使用Meridian的基础认知。\n\n### meridian-spawn\n\n专门教授meridian spawn命令的使用，包括如何启动子任务、等待完成、并行执行以及读取报告。这是实现子任务委派的关键技能。\n\n### meridian-work-coordination\n\n教授工作项的生命周期管理，包括创建、切换、更新状态以及放置产物。这是状态持久化和跨会话协调的基础。\n\n## 项目集成：从安装到运行\n\n将meridian-base集成到项目中非常简单：\n\nbash\n# 初始化Mars（如果尚未初始化）\nmeridian mars init\n\n# 添加基础包\nmeridian mars add @meridian-flow/meridian-base\n\n# 同步配置\nmeridian mars sync\n\n\n同步完成后，项目的.agents/目录将自动填充Agent配置文件和技能文档。Meridian通过布局约定自动发现这些资源：\n\n\n.agents/\n├── *.md # Agent配置文件（YAML前置 matter + Markdown）\n└── skills/\n └── */\n └── SKILL.md # 技能文档（可选resources/子目录）\n\n\n## 与Meridian CLI的关系\n\n理解meridian-base与meridian-cli的关系很重要：\n\n- meridian-cli是编排引擎本身，提供命令行界面和核心运行时\n- meridian-base是基于CLI构建的技能包，定义了具体的Agent配置和能力\n\n类比来说，meridian-cli是操作系统内核，而meridian-base是发行版预装的工具套件。用户当然可以自定义Agent配置，但meridian-base提供了一个经过验证的、开箱即用的起点。\n\n## 设计哲学：约定优于配置\n\nmeridian-base体现了Meridian生态的设计哲学：\n\n约定优于配置：通过固定的目录布局和文件命名约定，系统能够自动发现资源，无需显式注册或清单文件。\n\n分层解耦：编排器Agent、子Agent、技能各司其职，通过清晰的接口交互。这种分层使得系统易于扩展和定制。\n\n可组合性：技能是独立的模块，可以根据需要组合到不同的Agent中。这种可组合性支持复杂的能力构建。\n\n持久化优先：工作项和会话的持久化是核心设计考量，确保Agent系统的状态不会因单次会话结束而丢失。\n\n## 应用场景与最佳实践\n\nmeridian-base适用于以下场景：\n\n复杂软件开发：将大型项目拆分为多个子任务，并行开发不同模块，通过工作项追踪整体进度。\n\n多步骤数据分析：委派不同的子Agent处理数据清洗、特征工程、模型训练和结果可视化，编排器协调整个流程。\n\n持续集成/部署：结合CI/CD系统，Meridian可以作为智能编排层，根据代码变更自动触发相应的测试、构建和部署任务。\n\n知识库构建：通过跨会话搜索能力，逐步积累和组织知识，构建可查询的组织记忆。\n\n## 局限与未来方向\n\n作为基础包，meridian-base提供了核心能力，但也存在一些局限：\n\n预定义Agent有限：目前只包含编排器和默认子Agent，特定领域可能需要自定义Agent配置。\n\n技能覆盖范围：当前技能聚焦于核心协调原语，更专业的技能（如代码审查、测试生成）需要额外的技能包。\n\n模型绑定：子Agent默认使用gpt-5.3-codex，虽然可以配置，但更灵活的模型路由策略可能需要进一步开发。\n\n未来，meridian-base可能会扩展更多的Agent模板、更丰富的技能集，以及更智能的模型选择机制。同时，与meridian-dev-workflow等上层包的集成也将进一步完善。\n\n## 总结\n\nmeridian-base是Meridian生态的基石，它将一个简单的CLI工具转化为具备完整编排能力的Agent平台。通过子任务委派、工作项管理和跨会话检索三大核心能力，它为构建复杂的Agent工作流提供了坚实基础。对于希望探索Agent编排潜力的开发者而言，这是一个理想的起点。

Agent编排：从工具到平台的跃迁\n\n大语言模型Agent的快速发展催生了对编排系统的迫切需求。单个Agent的能力再强，也难以应对复杂的现实世界任务。真正的价值在于让多个Agent协同工作，形成规模效应。然而，协调多个Agent并非易事——任务如何分解、如何并行执行、状态如何追踪、会话如何管理，这些都是编排系统需要解决的核心问题。\n\nMeridian是一个新兴的Agent编排引擎，而meridian-base则是将其从裸命令行工具转化为完整编排系统的关键基础包。\n\nMeridian Base的定位与价值\n\nmeridian-base提供了Meridian的核心协调原语（Core Coordination Primitives）。它定义了编排器Agent、默认子Agent以及教会它们如何生成工作、追踪状态和跨会话协调的技能集合。简单来说，这是让Meridian"活起来"的灵魂所在。\n\n该包的设计目标是填充项目中的.agents/目录，为运行Meridian的项目提供即插即用的Agent配置。通过约定优于配置的设计理念，Meridian通过目录布局自动发现Agent和技能，无需繁琐的清单文件。\n\n核心能力一览\n\n安装meridian-base后，编排器Agent立即获得以下能力：\n\n子任务委派与并行执行\n\nbash\n将工作拆分为子任务并委派\nmeridian spawn -m codex -p \"实现数据模型\" -f plan/phase-1.md\n\n并行运行多个任务\nmeridian spawn -m codex -p \"阶段2a: API端点\"\nmeridian spawn -m codex -p \"阶段2b: CLI处理器\"\n\n\nmeridian spawn命令是编排的核心原语。它支持指定模型、提示词、附件文件，并且能够并行启动多个子任务。每个子任务会阻塞直到完成，而Harness层负责并发调度。这种设计既保证了单个任务的可控性，又实现了多任务的高效并行。\n\n工作项生命周期管理\n\nbash\n启动工作项\nmeridian work start \"auth-refactor\"\n\n更新状态\nmeridian work update --status implementing\n\n\nmeridian work命令族提供了工作项的完整生命周期管理。工作项是跨会话追踪任务状态的关键机制，即使在主会话中断后，工作项的状态和关联产物依然持久化，支持随时恢复和继续。\n\n跨会话上下文检索\n\nbash\n搜索历史会话\nmeridian session search \"认证设计决策\"\n\n搜索报告\nmeridian report search \"token过期\"\n\n\n长期运行的Agent系统必然积累大量历史会话和产物。meridian session search和meridian report search提供了强大的检索能力，让编排器Agent能够从过往经验中学习，避免重复犯错，实现真正的持续改进。\n\nAgent配置与技能体系\n\nmeridian-base预定义了两个核心Agent：\n\nmeridian-default-orchestrator（默认编排器）\n\n这是主控Agent，负责规划、委派和评估子Agent的工作。它被加载了完整的协调技能集，是用户与Meridian系统交互的主要接口。编排器使用系统默认配置的模型，具备全局视野和决策能力。\n\nmeridian-subagent（子Agent）\n\n这是默认的执行Agent，使用gpt-5.3-codex模型。它接收来自编排器的提示词，执行具体任务，然后报告结果。子Agent的设计原则是专注和可替换——每个子任务可以由最适合的模型或配置来处理。\n\n技能（Skills）详解\n\n技能是注入Agent系统提示词的能力模块，让Agent知道如何使用Meridian的CLI。meridian-base包含三个核心技能：\n\nmeridian-cli\n\n教授Agent关于Meridian和Mars CLI的心智模型，包括命令面发现、诊断模式、会话管理和核心原则。这是Agent使用Meridian的基础认知。\n\nmeridian-spawn\n\n专门教授meridian spawn命令的使用，包括如何启动子任务、等待完成、并行执行以及读取报告。这是实现子任务委派的关键技能。\n\nmeridian-work-coordination\n\n教授工作项的生命周期管理，包括创建、切换、更新状态以及放置产物。这是状态持久化和跨会话协调的基础。\n\n项目集成：从安装到运行\n\n将meridian-base集成到项目中非常简单：\n\nbash\n初始化Mars（如果尚未初始化）\nmeridian mars init\n\n添加基础包\nmeridian mars add @meridian-flow/meridian-base\n\n同步配置\nmeridian mars sync\n\n\n同步完成后，项目的.agents/目录将自动填充Agent配置文件和技能文档。Meridian通过布局约定自动发现这些资源：\n\n\n.agents/\n├── *.md Agent配置文件（YAML前置 matter + Markdown）\n└── skills/\n └── */\n └── SKILL.md 技能文档（可选resources/子目录）\n\n\n与Meridian CLI的关系\n\n理解meridian-base与meridian-cli的关系很重要：\n\n- meridian-cli是编排引擎本身，提供命令行界面和核心运行时\n- meridian-base是基于CLI构建的技能包，定义了具体的Agent配置和能力\n\n类比来说，meridian-cli是操作系统内核，而meridian-base是发行版预装的工具套件。用户当然可以自定义Agent配置，但meridian-base提供了一个经过验证的、开箱即用的起点。\n\n设计哲学：约定优于配置\n\nmeridian-base体现了Meridian生态的设计哲学：\n\n约定优于配置：通过固定的目录布局和文件命名约定，系统能够自动发现资源，无需显式注册或清单文件。\n\n分层解耦：编排器Agent、子Agent、技能各司其职，通过清晰的接口交互。这种分层使得系统易于扩展和定制。\n\n可组合性：技能是独立的模块，可以根据需要组合到不同的Agent中。这种可组合性支持复杂的能力构建。\n\n持久化优先：工作项和会话的持久化是核心设计考量，确保Agent系统的状态不会因单次会话结束而丢失。\n\n应用场景与最佳实践\n\nmeridian-base适用于以下场景：\n\n复杂软件开发：将大型项目拆分为多个子任务，并行开发不同模块，通过工作项追踪整体进度。\n\n多步骤数据分析：委派不同的子Agent处理数据清洗、特征工程、模型训练和结果可视化，编排器协调整个流程。\n\n持续集成/部署：结合CI/CD系统，Meridian可以作为智能编排层，根据代码变更自动触发相应的测试、构建和部署任务。\n\n知识库构建：通过跨会话搜索能力，逐步积累和组织知识，构建可查询的组织记忆。\n\n局限与未来方向\n\n作为基础包，meridian-base提供了核心能力，但也存在一些局限：\n\n预定义Agent有限：目前只包含编排器和默认子Agent，特定领域可能需要自定义Agent配置。\n\n技能覆盖范围：当前技能聚焦于核心协调原语，更专业的技能（如代码审查、测试生成）需要额外的技能包。\n\n模型绑定：子Agent默认使用gpt-5.3-codex，虽然可以配置，但更灵活的模型路由策略可能需要进一步开发。\n\n未来，meridian-base可能会扩展更多的Agent模板、更丰富的技能集，以及更智能的模型选择机制。同时，与meridian-dev-workflow等上层包的集成也将进一步完善。\n\n总结\n\nmeridian-base是Meridian生态的基石，它将一个简单的CLI工具转化为具备完整编排能力的Agent平台。通过子任务委派、工作项管理和跨会话检索三大核心能力，它为构建复杂的Agent工作流提供了坚实基础。对于希望探索Agent编排潜力的开发者而言，这是一个理想的起点。