marblo：AI Agent 工具实践指南

在项目中评估marblo，可以先看清用途边界：marblo — AI-native 团队的现场协调器。一旦进入日常自动化环节，输入边界、依赖和失败处理如果不清楚就很难稳定复用会直接影响交付，这也是我最关心的风险。我建议用一项范围明确的真实任务完成最小试跑，重点记录配置时间、输出质量、异常信息和维护痕迹，再与现有方案比较。我会把它列入愿意先做小范围验证并复查原始文档的团队的候选清单，而不是仅凭项目介绍直接纳入生产。

马布罗

The AI-native teams. 的现场编排器 描述一个目标。一个编排器将其分解为票据，为每个票据生成一个真正的编码代理 —

Claude、Codex、Grok 等 — 并并行运行它们，每个都在自己的 worktree. 中 您可以在一块板上观察它的发生，看看它的成本，然后决定合并什么。

⬇下载marblo · ⚡ 30秒 install · Catalog · Privacy · Guide

_{marblo 不是另一种编码剂。它是 them 之上的层——您想要 more 而不是 one 代理同时工作的那一刻的四个东西：}

_{a board，不是聊天日志，因此您可以看到他们所有人都在做什么  ·  a 每个 ticket 都有不同的模型，根据作业选择而不是锁定到一个vendor}

_{worktree-per-ticket isolation，因此并行代理不会互相覆盖  ·  ✅ safe merge，因此如果没有您的操作，任何内容都不会落在 main 上review}

_{Every 卡将代理命名为 and 实际运行它的模型 - claude-opus-5、gpt-5.6-sol、grok-4.5、glm-5.2、MiniMax-M3.}

有关 LLM 基础、代理、RAG、评估和操作的经过源验证的学习路径，请参阅 LLM 研究 精选。

问题优先演示：单独的 Claude Code 与 marblo

如果 marblo 看起来像“代理看板”，请从这里开始。板子为显示面；不同之处在于，当多个代理同时接触同一个存储库并且工作流程必须保持可恢复时会发生什么。

该演示从故障模式开始，而不是功能列表：

• 单独的克劳德代码： 一次结帐混合分支、索引、未提交的编辑和审查差异中的多个流。
• 5 个代理端到端： 五个代理创建共享类型冲突、依赖漂移、PM 反馈更改、合并歧义和 merged ≠ done 状态。
• marblo： 工作树隔离、代理依赖性、实时重新规划、REVIEW 门、安全合并和 AI 审核时间线将这些问题转化为可见、可审查的场景。

场景、脚本和故事板草稿位于 docs/demo/problem-first-demo.md 中。

30 秒内安装 — 无需应用程序

此存储库中的所有内容都是一个普通文件，可在您已经运行的 CLI 中工作。 从这里开始 - 安装应用程序是顶部升级，而不是大门。

舰队操作 — 旗舰知识包。 在生产中运行代理 CLIs 的异构舰队实际上教会了什么：哪些供应商订阅打开了一个与 Anthropic 兼容的端点（以及为什么“运送自己的 CLI”是错误的测试），每个线束恢复合同会终止进程在错误的标志上，为什么 PTY 输出在两个方向上都是错误的代理活跃度信号，其中成本归因默默地中断，并且每个工单的工作树卫生。测量的，不是推断的。

# Keep it where your agents can find it
mkdir -p ~/.claude/skills/fleet-operations && curl -sL \
  https://raw.githubusercontent.com/marblo-app/marblo/main/knowledge/fleet-operations/KNOWLEDGE.md \
  -o ~/.claude/skills/fleet-operations/SKILL.md

阅读即可 →  ·  更多技能、代理和 MCP 服务器 ↓  ·  完整目录 ↓

想要舰队，而不仅仅是文件？ 下载适用于 macOS 或 Windows 的 marblo，然后连接您已付费的 CLIs。 marblo 生成并追踪它们； AI 使用量仍记入这些帐户。

✨ 现场编排

marblo 能做到单个聊天窗口无法做到的事情：实时运行整个舰队。

一个协调器会分解您的任务，为每个任务生成正确的代理，自行修复卡住的代理，判断每次合并，并在任何内容落地之前与您进行检查。

任务→自动故障单→每个模型生成→看门狗自我修复→合并判断→您的确认。

1 · 描述目标。 marblo 将其分成多个标签，为每个标签选择一个模型，并将它们放在板上。

2 · 观察其运行，然后确认。 代理在单独的工作树中并行工作。您检查差异并合并——没有您，什么都无法实现。

游览——一次一个标签

董事会

AI 代理的看板。创建一张票证，然后正确的代理领取它，在自己的工作树中工作，并随着卡的移动而移动卡。每张卡片都带有具体模型，所以“这是谁写的？”从来都不是猜测。

代理商

每个代理一个实时终端。观察标准输出流，发送后续内容而不终止会话，重用或在运行中切换。看门狗重生并恢复停止运行的代理，需要做出决定的代理会这样说，而不是保持沉默。

代码

在合并之前，在工作树中浏览并比较每个代理的工作。单击一行即可将评论意见直接发送给协调器 - main 上没有神秘补丁。

工作树

每张票证都有一个独立的分支和结账，因此并行代理永远不会在同一文件上发生冲突。合并状态、冲突、ahead/behind 和清理都位于一个列表中。

More 选项卡 — 通道、用途、History

⚡ 车道

_现在_需要并行工作，但没有任务吗？一次解雇几个代理并为每个代理选择模型。与协调器一起运行，而不是通过它。

用法

按模型、代理和日期划分的成本和令牌使用情况。它还显示每个代理_实际_运行的模型以及证据是什么（观察到的计费会话或生成 argv），并在没有证据时将该字段留空。

历史

一个仅附加的分类帐，记录每张票所做的事情：问题、方法、更改、验证、成本和合并决策。它在票证被删除后仍然存在。

盒子里也有

• 多模型车队 — Claude Code、Codex、Grok、GLM、Kimi、MiniMax 和并排的本地模型 (Ollama) — 带上您自己的钥匙 (BYOM)
• 任务 — 自然语言目标变成一张工单图，在您的车队中生成，而不是锁定到一个供应商
• 利用 - 每个代理的技能和 MCP 工具，包括您自己的 GitHub 存储库：连接一次，每个代理都可以使用它
• 安全合并 — 在任何内容到达您的主分支之前进行审查和验证
• 桌面优先 — 本地执行、您的密钥、您的存储库

为什么选择马布罗

代理起步很便宜。 了解舰队在做什么是困难的部分。这就是产品。

隐私——什么会离开你的机器

您将把它指向您的存储库，因此它属于首屏，而不是在没有人读的策略页面中。完整详细信息：docs/privacy.md。

阅读完整正策 - 包括不讨人喜欢的部分 →

生态系统 — 这些资产在您已有的 CLI 中运行

您不需要 marblo 即可使用此存储库中的任何内容。

这里的每个第一方资产都是一个普通的标准本机文件：一个 SKILL.md 放入 ~/.claude/skills/ 中，一个 Claude Code 和 Codex 格式的代理定义，已经阅读过，一个只是 markdown 的知识包。复制一个，它会在你的下一个会话中起作用。安装 marblo 是顶部的一键升级，而不是大门。

更多单行本

旗舰 舰队操作 包是 ，位于 README 的顶部。其余的安装方法相同：

代码审查技能 — 审查差异的正确性、安全性和简单性；结果按严重程度排名，每个结果都有具体的故障场景。

# Claude Code
mkdir -p ~/.claude/skills/code-review && curl -sL \
  https://raw.githubusercontent.com/marblo-app/marblo/main/skills/code-review/SKILL.md \
  -o ~/.claude/skills/code-review/SKILL.md

# Codex — same file, different directory
mkdir -p ~/.codex/skills/code-review && cp ~/.claude/skills/code-review/SKILL.md ~/.codex/skills/code-review/

审核代理 — 一个只读子代理，用于根据合并基础审核差异并返回 BLOCK 或 APPROVE。

mkdir -p ~/.claude/agents && curl -sL \
  https://raw.githubusercontent.com/marblo-app/marblo/main/agents/reviewer/AGENT.md \
  -o ~/.claude/agents/reviewer.md

LLM 学习包 — 来源验证的学习路径（基础 → 代理和 MCP → RAG → 评估 → 可观察性）。在GitHub上阅读；没有什么可安装的。

韩国覆盖范围——全球登记所没有的部分

韩语-英语和韩语市场。联系我们 community 层 - 上市并固定，不可一键安装 - 每个项目的 README 都是可以入海入海记为；伯爵住在那里而不是这里，所以不会稀疏陈旧。

我们发现并未列出的两个韩国项目，因为原因比数量更重要：一个 221 星的精选列表根本没有 LICENSE 文件，而一个 261 星的插件市场则获得非商业、无衍生品的许可。两者都不属于人们在工作时安装的商店。

这里的一些项目不是独立的，我们宁愿这样说，也不愿假装：marblo-control在应用程序内部提供，review-and-merge加上tf-*工作流程是 marblo 自己写下来的编排流程 - 它们加载到您的 CLI 中，但每个步骤都会调用 marblo MCP 服务器，因此在 marblo 之外它们没有什么可调用的。 github MCP 服务器是一个仅限清单的参考 - 从上游自己的固定标记处的指令安装它。

完整目录 - 存储库中的每个项目

其中大部分不是我们的，也没有复制到这里。 每个引用的项目都是一个 marblo.yaml，指向固定标签处的上游存储库或提交 SHA，因此许可证、所有权和维护都归作者所有。每一项都是在一次测试中挑选出来的：它可以在您已经运行的 CLI 中运行，无论有没有 marblo。 每一项的 README 都带有一个在写下之前执行的安装片段。

下表由 scripts/gen-catalog.mjs 从清单生成 — 每个 id、描述、层、许可证和 pin 都是在该项目的 marblo.yaml 中提交的值。添加一个item就意味着添加一个manifest；没有人编辑此表，并且 CI 使任何 PR 失败，其中两者已经分开。

173 项 · 56 个 MCP 服务器 · 26 项技能 · 42 个代理 · 23 个工作流程 · 26 个知识包

层 — official 30 由 marblo 维护 · verified 20 外部，经过审核并固定源 · ⚪ community 123 外部，列出并固定但未经审核。

安装 — ⚡ 在应用程序中一键点击 15 个已审核的项目 · 同意门控 52 个社区项目 - 他们的安装合同是根据固定的上游编写和摘要验证的，但应用程序仅在确认明确的“未经审核的内容”警告后才安装它们（为什么）。其他一切都是 — 参考：列出、链接和固定，并按照该项目自己的 README 进行安装。

标志着涵盖韩语和韩国市场工作的 22 项。

MCP 服务器 (56)

技能 (26)

代理 (42)

工作流程 (23)

知识包 (26)

值得了解的 Anthropic 技能：anthropics/skills 存储库根目录没有 LICENSE 文件，因此 GitHub API 将其报告为未经许可。许可证是针对每个技能的 - 上面的每个 anthropic-* 文件夹在固定提交处都带有自己的 Apache-2.0 LICENSE.txt，并且它随安装一起移动。我们检查了每一项而不是假设，每一项的 README 都是如此说明的。

什么是开放的，什么是不开放的

明确这一点，因为将自己呈现为开放生态系统的封闭核心比诚实标记的任何一个都更糟糕：

编排引擎是我们的产品，它是封闭的。 面板、实时编排器、工作树隔离、成本归因和安全合并是付费应用程序。 代理_使用_的所有内容都是开放且可移植的 — 技能、代理、工作流程、MCP 清单和知识包，无论您是否安装 marblo，所有这些都可以使用。第一方资产为 MIT 或 CC- 许可；引用的社区项目保留其上游许可证（今天的 MIT 和 Apache-2.0），并在每个清单中声明。

资产在设计上是可移植的。如果您停止使用 marblo，此存储库中的所有内容都会继续工作。

无需我们的来源即可验证的内容。 封闭引擎意味着“阅读代码”不是我们可以给出的答案，因此我们可以：

• 代理消耗的所有内容 — 每个技能、代理、工作流程、MCP 清单和知识包都是一个纯文件，您可以在加载到模型上下文之前读取它，并且每个引用的项目都固定到上游标签或 SHA。目录表是从这些清单生成的，并且 CI 在两者发生偏差的任何 PR 中失败。
• 应用程序发送的内容 — docs/privacy.md 命名字段、清理器的精确转换、交换机和出站主机，因此网络监视器足以检查我们。
• 我们自己的数字 - docs/benchmark/ 中的每个数字都会打印其样本大小并跟踪到您可以重新运行的提交的 SQL。它直接表明我们的样本无法对任何内容进行排名。
• 我们错了什么 — SECURITY.md 对早期版本的声明进行了更正，并列出了“尚不正确的内容”列表。隐私页面也是如此。

我们宁愿在开放的表面上进行检查，也不愿在封闭的表面上寻求信任。

存储库布局

knowledge/    # Knowledge Packs — fleet-operations (flagship), curated-llm-resources
skills/       # first-party skills (e.g. code-review) + pinned community references
agents/       # agent definitions (e.g. reviewer) + pinned community references
workflows/    # multi-step flows — review-and-merge is Marblo-specific; community ones are portable
mcp-servers/  # official + referenced MCP servers (e.g. marblo-control, github, kordoc)
registry/     # manifests + manifest.schema.json (additive Store metadata)
docs/         # getting-started, concepts, harness-store, orchestration, troubleshooting
scripts/      # repo tooling — gen-catalog.mjs generates the README catalog from the manifests
packages/     # registry-validator, the pre-merge manifest checks CI runs

每件物品旁边都有一个 marblo.yaml。它是附加存储元数据，而不是容器——资产无需它即可工作。

• 计划和路线图： ROADMAP.md · 注册表： 注册表/ · 文档： 文档/
• 贡献一个项目： CONTRIBUTING.md。社区提交的内容被视为列表 - 可发现和可链接，不可一键安装 - 直到应用程序提供权限门和审核工作流程。 为什么 →
• 安全： SECURITY.md · SECURITY-ADVISORIES.md

⭐ 对存储库加注星标，以跟踪生态系统的发展。

链接

• 产品网站 — marblo.app
• 新功能 — 发行说明（每个版本，自动镜像）
• 隐私和遥测 — docs/privacy.md · 安全 — SECURITY.md
• ⬇ 发布 — github.com/melocream/marblo-releases
• ✉ 联系方式 — 团队@marblo.app
• 创始人 — @melocream

_{Maintained 作者：@melocream · [email protected]}