【开源自荐】Maestro-FLow 工作流-实现Claude code&&Codex 自动推进/闭环治理/知识复用/团队协作/worktree并行/多cli调用

本帖使用社区开源推广，符合推广要求。我申明并遵循社区要求的以下内容：

• 我的帖子已经打上 开源推广 标签： 是


• 我的开源项目完整开源，无未开源部分： 是


• 我的开源项目已链接认可 LINUX DO 社区： 是


• 我帖子内的项目介绍，AI生成、润色内容部分已截图发出： 是


• 以上选择我承诺是永久有效的，接受社区和佬友监督： 是

以下为项目介绍正文内容，AI生成、润色内容已使用截图方式发出

项目介绍

• Maestro-FLow 是我对复杂软件系统开发的思考产物，项目开发借鉴了gsd的里程碑思想，同时将CCW中主要命令循环抽离出来，重新设计了产物体系及命令，深度优化每个命令流程衔接，形成从头脑风暴-路线图-分析-规划-执行-测试整个环境的闭环。此外，Maestro-FLow还包含wiki，spec，知识管理(学习，复盘),完整hook系统。前期介绍：
  
  [开源]CCW(claude-code-workflow)V7.X版本新增Cadence team和 codex csv spawn 工作流&&下一代工作流(maestro-flow)展望 - 开发调优 - LINUX DO
  
  【长期贴】 Claude-code-workflow(CCW) --使用技巧分享-自认为最工程化的harness workflow - 开发调优 - LINUX DO

核心功能介绍

闭环自动推进

Maestro 的闭环推进系统是本项目的核心及特点。在项目开发前，我对每个命令衔接流程深入进行优化设计。创新采用结对skill设计，实现workflow，局部chain稳定推进（支持codex和claude，codex单独优化），具体内容参考下述文档：

Maestro 协调器 — 意图解析 → 静态命令链选择 → 分发执行，40+ 预定义链。

Maestro-Ralph — 闭环自适应推进，decision 节点动态扩展收缩，失败自动 debug → fix→ 重试，Passed Gates 跨重试跳过已通过质量门，full/standard/quick 三级质量管线。

知识规范管理

Maestro 的知识管理分四层，spec，wiki，knowhow，learn。

• spec 区别现有其他工作流，采用工作流及关键词双路径注入。主流程无需hook，基于Maestro 闭环工作流调用方式注入，按照coding/arch/quality/debug/test/review/learning阶段划分。关键词模式基于hook和subagent hook触发。


• spec规范系统支持渐进式补充，在workflow推进流程下，各个环节命令针对分析，探讨结果，渐进式完善注入规范。


• Wiki是将Maestro知识碎片（工作流产物）串成图谱，用 BM25做全文检索，能自动发现孤立节点和潜在关联，通过命令清理产物文件并生成摘要。


• Knowhow偏实操经验，记录的是 session压缩、小贴士、可复用模板、操作配方、外部参考和关键决策等。


• learn-*是一系列command，通过cc或codex调用，复盘看做过什么、跟读看AI怎么写、模式拆解看代码背后的设计意图、探究带着假设去验证。

针对双规注入设计了spec格式，spec中每个条目使用 闭合标签格式，keywords定义hook触发关键词：

<spec-entry category="coding" keywords="auth,token,rotation" date="2026-04-21">



### Token rotation needs email carried through refresh flow



Revoked column must be set rather than deleting tokens.

Refresh token generation must carry email from stored user data.



</spec-entry>

多cli协作

相较于CCW，Maestro的命令流中的多cli调用采用基于角色形式嵌入方式，类似前述spec系统。调用分配固定角色并嵌入analyze，plan，execute等命令中，用户可以针对角色分配不同tool。支持通过绑定settings配置文件实现新工具注册，将workflow各个阶段映射到不同模型中。

maestro delegate-config        # 启动 TUI

maestro dc                     # 短别名



# 子命令（非交互）

maestro delegate-config show          # 文本输出当前配置

maestro delegate-config show --json   # JSON 格式

maestro delegate-config roles         # 查看角色映射

其他功能介绍

• 
  

  Overlay 扩展 提供非侵入式的命令扩展机制 —— 在不修改原始 命令或者skill文件的前提下，注入自定义步骤、阅读要求、质量门禁等内容，Maestro升级后仍然可以保留。此外，Maestro 提供更自由工作流定义以及元skill（workflow-designer-skill），通过 Composer + Player 组合，可将自然语言描述转化为可复用，定制化的工作流模板，借助Maestro Ralph能力反复执行。

  
  


• 
  

  Worktree 里程碑级分支并行开发

  
  


• 
  

  Statusline 状态栏,行实时显示（模型/协调器进度/任务/团队/Git/Tokens/上下文），工作流时间线按artifact 类型着色（9 种）

  
  


• 
  

  Team Lite 协作2-8 人 Git-native 协作，心跳记录 + preflight 冲突预扫描 + 快速 sync，Spec三层加载（baseline + team + personal），Overlay 团队共享。

  
  


• 
  

  Hooks 系统 9 个 Hook，minimal/standard/full 三级累积安装。含上下文监控（四级 budget策略）、规范注入（按 agent-type 匹配）、Delegate监控、团队心跳及遥测采集、会话状态注入、Skill上下文注入、协调器追踪、关键文件保护

  
  

快速入门

CLaude：

/maestro-ralph -y [复杂系统的完整描述,推荐使用文档形式引用]



codex：

$maestro-ralph -y [复杂系统的完整描述,推荐使用文档形式引用]

注意：codex 必须设置以下参数：

[features]

enable_fanout = true

multi_agent_v2=true

default_mode_request_user_input = true

项目地址：

catlog22/maestro-flow: Workflow orchestration CLI with MCP endpoint support and multi-agent dashboard

文档站：

Maestro Documentation

命令介绍

核心协调

项目生命周期

里程碑与并行

扩展与维护

质量保障

项目管理

知识体系

学习系统

Skills

在 Claude Code 会话内以技能形式调用，支持多 Agent 协作。

团队协作

工具与元技能

安装方式：

npm install -g maestro-flow



maestro install ## 安装工作流



maestro view

下面以图片介绍主要内容，具体的环节，命令可以参考文档站：

项目总体介绍

workflow执行链

知识管理体系

worktree 并行开发

Maestro 智能路由详解

如果你觉得项目不错，请点上^-^^-^，感谢佬们的支持！！