- 我的帖子已经打上 开源推广 标签： 是
- 我的开源项目完整开源，无未开源部分： 是
- 我的开源项目已链接认可 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 Maestro Ralph 链类型 静态链，确定后不变 活链，decision 节点动态扩展 循环 无 闭环（失败 → debug → fix → 重试） Decision 节点 无 post-verify、post-review、post-test、post-milestone 适用场景 单次任务、明确意图 完整 milestone 生命周期推进 知识规范管理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>
相较于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能力反复执行。
-
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
项目地址：
文档站：
安装方式：
npm install -g maestro-flow
maestro install ## 安装工作流
maestro view
下面以图片介绍主要内容，具体的环节，命令可以参考文档站：
项目总体介绍
workflow执行链
知识管理体系
worktree 并行开发
Maestro 智能路由详解
如果你觉得项目不错，请点上
，感谢佬们的支持！！
5 个帖子 - 3 位参与者