【开源自荐】详解Maestro-Flow中的知识管理系统---约束和沉淀

历史回顾：

【开源自荐】Maestro-FLow 工作流-实现Claude code&&Codex 自动推进/闭环治理/知识复用/团队协作/worktree并行/多cli调用 - 开发调优 - LINUX DO
Maestro-FLow codex 焚诀~~~配合/goal 闭环长时多agent推进 - 开发调优 - LINUX DO
【开源自荐】助我迭代，我将Maestro-Flow打包到一个skill，Maestro-Flow-One——软件全生命周期自动推进 - 开发调优 - LINUX DO

Maestro-FLow的知识管理系统详解

Maestro-FLow经过多个版本的迭代，现已经完善定型，向大家分享设计及使用说明。

Maestro-FLow中的知识沉淀主要分两种：约束 和积累 。约束是编码规范、架构决策、质量规则——规定"不能做什么"。积累是操作步骤、设计资产、调试经验——记录"怎么做过"。前者需要强制加载，后者需要按需检索,典型产物结构如下:

.workflow/
├── specs/                          # 约束层：基于角色绑定/流程的规则索引
│   ├── coding-conventions.md       # → implement
│   ├── architecture-constraints.md # → plan
│   ├── quality-rules.md            # → review
│   ├── debug-notes.md              # → analyze
│   ├── test-conventions.md         # → test
│   ├── review-standards.md         # → review
│   ├── learnings.md                # → implement（经验教训）
│   └── tools.md                    # → per-entry（可执行流程定义）
├── knowhow/                        # 积累层：完整知识文档
│   ├── KNW-*.md                    # 会话压缩记录
│   ├── RCP-*.md                    # 操作配方（步骤指南）
│   ├── TPL-*.md                    # 代码/配置模板
│   ├── REF-*.md                    # 外部文档摘要
│   ├── DCS-*.md                    # 架构决策记录
│   ├── TIP-*.md                    # 快速提示
│   ├── AST-*.md                    # 代码资产（API 契约、数据模型）
│   ├── BLP-*.md                    # 架构蓝图
│   └── DOC-*.md                    # 长文档（通用兜底）
└── wiki-index.json                 # 统一索引（WikiIndexer 自动生成）

相关命令

写入类

读取类

分析类

初始化

Tool Spec

Tool Spec 是一种特殊的 spec-entry，存储在 tools.md 中，定义可执行的业务流程。

简单来说：Tool Spec 可以理解为轻量化的workflow （针对业务需求，沉淀在项目目录下，具有自发现自使用特性）

注册时机

通过 /maestro-tools-register 注册：

示例：

业务需求 ──→ 规划阶段注册 tool spec ──→ test agent 自动发现 ──→ 执行验证
                   ↑                                           │
                   └──── 执行后优化 ←── 发现新 edge case ←────────┘

Maestro-FLow知识沉淀特点

知识流转全景

执行产物                    提取                      存储                    消费
─────────                  ─────                    ─────                  ─────
分析会话 ─────┐                              ┌─→ specs/     ─→ spec-injector → agent
调试记录 ─────┼──→ /manage-harvest ──────────┼─→ knowhow/   ─→ wiki load → 按需
规划文档 ─────┤    /quality-retrospective    ├─→ issues/    ─→ manage-issue → 追踪
代码变更 ─────┘    /learn-decompose          └─→ learnings  ─→ keyword-injector → 上下文
                                                    ↑
                                     /manage-learn ─┘  (原子洞察直写)

Progressive Fill

Spec 内容由流水线各阶段逐步丰富：

maestro-init       → spec-setup（骨架 + 扫描）
maestro-analyze    → 锁定决策 → plan，代码模式 → implement
maestro-plan       → 设计约定 → implement/plan，测试策略 → test
maestro-execute    → 经验教训 → implement，根因 → analyze
maestro-verify     → 质量发现 → review

每个阶段执行完毕，产生的知识自动沉淀到对应的 spec 文件中，下一阶段的 agent 即可通过 role 加载获取前序阶段的积累。

6 个帖子 - 4 位参与者

阅读完整话题