maestro-flow 0.3.7 → 0.3.9

package/README.zh-CN.md

@@ -2,9 +2,9 @@
 
 # Maestro-Flow
 
-### 面向 Claude Code & Codex 的多智能体工作流编排
+### 多智能体时代的编排层
 
-**一条命令，多个 AI 智能体，结构化交付。**
+**不仅是执行，更是编排。**
 
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.7-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
 [![Node.js](https://img.shields.io/badge/Node.js-≥18-339933?logo=node.js&logoColor=white)](https://nodejs.org/)
@@ -13,52 +13,32 @@
 
 [English](README.md) | [简体中文](README.zh-CN.md)
 
----
-
-*我不写代码 —— Claude Code 和 Codex 写。但告诉它们做什么、按什么顺序、带什么上下文、然后验证结果 —— 这才是耗时间的地方。Maestro-Flow 把这些编排自动化了。*
-
 </div>
 
 ---
 
-## 背景
-
-这个项目是 [Claude-Code-Workflow (CCW)](https://github.com/catlog22/Claude-Code-Workflow) 的**彻底重写**。CCW 是我之前的多 CLI 编排框架，它证明了通过结构化工作流协调 Claude、Codex、Gemini 等 AI 智能体是可行的 —— 但它越长越复杂。太多层级，太多抽象。
-
-Maestro-Flow 保留了验证过的核心思路，用全新的理念重建：**更少仪式感，更快执行。** 规格驱动的阶段管线设计受 [GET SHIT DONE (GSD)](https://github.com/gsd-build/get-shit-done) 启发 —— 它的上下文工程方法和原子提交纪律确实优雅。Maestro-Flow 采纳了这些设计模式，同时补上 GSD 没有的东西：实时可视化看板、基于 Claude Agent SDK 的多智能体执行、以及自主运行的 Commander 让管线持续推进。
-
-**相比 CCW 改了什么：**
-- 砍掉了重型的 session/beat 编排层 —— 替换为轻量的 skill 路由
-- 终端仪表盘升级为 Linear 风格的 Web 看板 UI
-- 统一所有 CLI 工具调用到 `maestro cli` 单一接口
-- 新增自主 Commander Agent（assess → decide → dispatch 循环）
-- 构建了完整的 Issue 闭环系统（discover → analyze → plan → execute → close）
-
-**保留了什么：**
-- 多 CLI 编排（Claude、Codex、Gemini、Qwen、OpenCode）
-- Markdown 定义的结构化工作流
-- 斜杠命令作为用户界面
-- Agent 定义作为聚焦的角色规格
+Maestro-Flow 是一个面向 Claude Code、Codex、Gemini 等多智能体的工作流编排框架。它将软件工程中最耗时的部分——决定让哪些智能体做什么、按什么顺序、带什么上下文——自动化为一条结构化管线。你只需描述意图，Maestro-Flow 自动路由到最优命令链，驱动多个 AI 智能体并行执行，并通过实时看板、Issue 闭环和知识图谱形成完整的项目交付闭环。
 
 ---
 
 ## 它做什么
 
-你描述你想要什么。Maestro-Flow 决定用哪些智能体、按什么顺序、带什么上下文 —— 然后驱动它完成。
+你描述你想要什么。Maestro-Flow 决定用哪些智能体、按什么顺序、带什么上下文，然后驱动它完成。
 
 ```bash
-# 自然语言 —— Maestro-Flow 路由到最优命令链
+# 自然语言 -- Maestro-Flow 路由到最优命令链
 /maestro "实现基于 OAuth2 的用户认证，带 refresh token"
 
 # 或者一步步来
 /maestro-init                    # 初始化项目工作区
 /maestro-roadmap                 # 交互式创建路线图
-/maestro-plan 1                  # 生成第一阶段执行计划
-/maestro-execute 1               # 波次并行多智能体执行
-/maestro-verify 1                # 目标反推验证
+/maestro-analyze                 # 多维度分析
+/maestro-plan                    # 生成执行计划
+/maestro-execute                 # 波次并行多智能体执行
+/maestro-verify                  # 目标反推验证
 ```
 
-### 阶段管线
+### 里程碑管线
 
 ```mermaid
 graph LR
@@ -69,165 +49,171 @@ graph LR
     E --> F[execute]
     F --> G[verify]
     G --> H[review]
-    H --> I[test]
-    I --> J[transition]
-    J -->|下一阶段| D
+    H --> I[milestone-audit]
+    I --> J[milestone-complete]
+    J -->|下一里程碑| D
 ```
 
-每个阶段有明确的状态跟踪。仪表盘展示正在发生什么、下一步该做什么。
+所有工作产物存放在 `.workflow/scratch/`，通过 `state.json` artifact registry 追踪。Phase 是 roadmap 中的标签，不是目录。
 
 ### 快速通道
 
-不是所有事情都需要走完整管线：
-
 | 通道 | 流程 | 适用场景 |
 |------|------|---------|
-| `/maestro-quick` | analyze → plan → execute | 快速修复、小功能 |
-| Scratch 模式 | `analyze -q` → `plan --dir` → `execute --dir` | 不需要 roadmap，直接干 |
+| `/maestro-quick` | analyze > plan > execute | 快速修复、小功能 |
+| Scratch 模式 | `analyze -q` > `plan --dir` > `execute --dir` | 不需要 roadmap，直接干 |
 | `/maestro "..."` | AI 路由命令链 | 描述意图，让 Maestro-Flow 决定 |
 
 ---
 
-## 看板仪表盘
+## 四大支柱
 
-实时项目控制面板，运行在 `http://127.0.0.1:3001`。React 19 + Tailwind CSS 4 构建，WebSocket 实时更新。
+### 1. 结构化管线
 
-### 四种视图
+基于 Scratch 的里程碑工作流，通过 artifact registry 追踪进度。每个里程碑经历 analyze > plan > execute > verify > review > milestone-audit > milestone-complete。所有产物存放在 `.workflow/scratch/`，`state.json` 是唯一状态源。
 
-| 视图 | 快捷键 | 你看到什么 |
-|------|--------|-----------|
-| **Board** | `K` | 看板列 —— Backlog、In Progress、Review、Done。Phase 卡片和 Issue 卡片并排展示。 |
-| **Timeline** | `T` | 甘特图风格的阶段时间线，带进度条 |
-| **Table** | `L` | 所有阶段和 Issue 的可排序表格 |
-| **Center** | `C` | 指挥中心 —— 活跃执行、Issue 队列、质量指标 |
+49 个斜杠命令覆盖 6 大类别，驱动从项目初始化到质量复盘的每一个环节。
 
-### 你能做什么
+### 2. 自主驾驶
 
-- **选个智能体，点播放** — 在 Issue 卡片上选 Claude / Codex / Gemini，点执行
-- **批量派发** — 多选 Issue，并行发送给智能体
-- **看智能体工作** — 实时 CLI 输出流式面板
-- **Issue 全生命周期** — 创建、分析、规划、执行、关闭 —— 全在看板上
-- **Linear 同步** — 导入/导出 Issue 到 Linear，支持团队协作
-
-### Commander Agent
-
-自主监督者。后台运行 tick 循环：
+**Commander Agent** -- 后台运行的自主监督者:
 
 ```
-评估(assess) → 决策(decide) → 派发(dispatch) → 等待 → 评估 → ...
+评估(assess) -> 决策(decide) -> 派发(dispatch) -> 等待 -> 评估 -> ...
 ```
 
-它读取项目状态（阶段、任务、Issue、智能体工位），判断什么需要处理，自动派发智能体。三档配置：`conservative`、`balanced`、`aggressive`。
-
-Commander 开启后，Issue 从发现到解决全程无需人工干预。
-
----
-
-## Issue 闭环
+读取项目状态（阶段、任务、Issue、智能体工位），判断什么需要处理，自动派发智能体。三档配置: `conservative`、`balanced`、`aggressive`。
 
-Issue 不只是工单 —— 它们是一条自修复管线：
+**Issue 闭环** -- Issue 不只是工单，它们是一条自修复管线:
 
 ```mermaid
 graph LR
-    A[发现] --> B[创建]
-    B --> C[分析]
-    C --> D[规划]
-    D --> E[执行]
-    E --> F[关闭]
+    A[发现] --> B[分析]
+    B --> C[规划]
+    C --> D[执行]
+    D --> E[关闭]
 ```
 
 | 阶段 | 命令 | 做了什么 |
 |------|------|---------|
-| **发现** | `/manage-issue-discover` | 8 视角扫描：Bug、UX、技术债、安全、性能、测试缺口、代码质量、文档 |
-| **分析** | `/manage-issue-analyze` | CLI 探索式根因分析，将结构化 `analysis` 写入 Issue |
-| **规划** | `/manage-issue-plan` | 生成解决方案步骤 —— 目标文件、代码变更、验证条件 |
-| **执行** | `/manage-issue-execute` | 双模式：服务器在线走 Dashboard API 派发，离线走 CLI 直接执行 |
-| **关闭** | 自动 | 验证通过 → `resolved` → `closed` |
+| **发现** | `/manage-issue-discover` | 8 视角扫描: Bug、UX、技术债、安全、性能、测试缺口、代码质量、文档 |
+| **分析** | `/manage-issue-analyze` | CLI 探索式根因分析 |
+| **规划** | `/manage-issue-plan` | 生成解决方案步骤、目标文件、验证条件 |
+| **执行** | `/manage-issue-execute` | Dashboard API 派发或 CLI 直接执行 |
+| **关闭** | 自动 | 验证通过 -> resolved -> closed |
 
-### Issue 如何连接主干管线
+质量命令（`review`、`test`、`verify`）自动为发现的问题创建 Issue。Issue 修复的代码回流到阶段管线。闭环自动关闭。
 
-```mermaid
-graph TB
-    subgraph 阶段管线
-        EX[execute] --> VE[verify]
-        VE --> RE[review]
-        RE --> TE[test]
-    end
-    subgraph Issue 闭环
-        DI[discover] --> AN[analyze]
-        AN --> PL[plan]
-        PL --> IX[execute]
-    end
-    RE -->|critical/high 发现| DI
-    TE -->|测试失败| DI
-    VE -->|验证缺口| DI
-    IX -->|修复代码回流| EX
-```
+### 3. 可视化控制面板
+
+实时项目仪表盘，运行在 `http://127.0.0.1:3001`。React 19 + Tailwind CSS 4 构建，WebSocket 实时更新。
+
+| 视图 | 快捷键 | 你看到什么 |
+|------|--------|-----------|
+| **Board** | `K` | 看板列 -- Backlog、In Progress、Review、Done |
+| **Timeline** | `T` | 甘特图风格的阶段时间线，带进度条 |
+| **Table** | `L` | 所有阶段和 Issue 的可排序表格 |
+| **Center** | `C` | 指挥中心 -- 活跃执行、Issue 队列、质量指标 |
+
+在 Issue 卡片上选个智能体，点播放。批量选择 Issue，并行派发。实时流式面板观察智能体工作。
+
+### 4. 智能知识库
+
+项目随时间积累智能，通过两个系统实现:
+
+**Wiki 知识图谱** -- 结构化条目（specs、phases、decisions、lessons）通过语义链接关联。BM25 搜索、反向链接遍历、健康评分。`/wiki-connect` 发现隐藏连接；`/wiki-digest` 生成主题聚类摘要，带覆盖热力图和缺口分析。
+
+**学习工具箱** -- 5 个命令将代码和历史转化为可复用知识:
+
+| 命令 | 做了什么 |
+|------|---------|
+| `/learn-retro` | 统一复盘 -- Git 活动指标 + 架构决策评估，通过 `--lens git\|decision\|all` 切换 |
+| `/learn-follow` | 引导式跟读，带强制提问 -- 提取模式、构建理解 |
+| `/learn-decompose` | 4 维度并行模式提取，保存到 specs/wiki |
+| `/learn-second-opinion` | 多视角分析: review、challenge、consult 三种模式 |
+| `/learn-investigate` | 系统化问题调查，假设验证 + 3 次上报机制 |
 
-质量命令（`review`、`test`、`verify`）自动为发现的问题创建 Issue。Issue 修复的代码回流到阶段。闭环自动关闭。
+所有学习命令共享 `lessons.jsonl` -- 通过 `/manage-learn` 统一查询的知识库。Specs、复盘和手动洞察全部汇入同一个池。
 
 ---
 
-## 多智能体执行
+## 引擎盖下
 
-Maestro-Flow 不挑一个 AI —— 它让它们一起干：
+### 多智能体引擎
+
+Maestro-Flow 协调多个 AI 智能体并行工作:
 
 ```
-              ┌────────────────────────────────┐
-              │      ExecutionScheduler         │
-              │     （波次并行执行引擎）          │
-              └───────────┬────────────────────┘
-                          │
-           ┌──────────────┼──────────────┐
-           │              │              │
-     ┌─────┴─────┐ ┌─────┴──────┐ ┌────┴──────┐
-     │  Claude    │ │   Codex    │ │  Gemini   │
-     │ Agent SDK  │ │  CLI       │ │  CLI      │
-     └───────────┘ └────────────┘ └───────────┘
+           +--------------------------------+
+           |      ExecutionScheduler        |
+           |    (波次并行执行引擎)            |
+           +---------------+----------------+
+                           |
+            +--------------+--------------+
+            |              |              |
+      +-----+-----+ +-----+------+ +----+------+
+      |  Claude    | |   Codex    | |  Gemini   |
+      | Agent SDK  | |  CLI       | |  CLI      |
+      +-----------+  +------------+ +-----------+
 ```
 
-- **波次执行** — 无依赖任务跨智能体并行，有依赖任务等前置完成
-- **Agent SDK** — 原生 Claude Agent SDK 驱动 Claude Code 进程
-- **CLI 适配器** — Codex、Gemini、Qwen、OpenCode 全部通过 `maestro cli` 调用
-- **工作区隔离** — 每个智能体获得独立执行上下文
+- **波次执行** -- 无依赖任务并行，有依赖任务等前置完成
+- **Agent SDK** -- 原生 Claude Agent SDK 驱动 Claude Code 进程
+- **CLI 适配器** -- Codex、Gemini、Qwen、OpenCode 通过 `maestro delegate` 调用
+- **工作区隔离** -- 每个智能体获得独立执行上下文
 
----
+### Hook 系统
 
-## 命令 Overlay 系统
+9 个上下文感知 Hook，3 级安装:
 
-非侵入式地为 `.claude/commands/*.md` 文件打补丁 —— 增加步骤、阅读要求、质量门禁 —— 无需编辑原始文件。Overlay 在 `maestro install` 升级后自动重新应用。
+| Hook | 用途 |
+|------|------|
+| `context-monitor` | 监控上下文用量，接近上限时注入警告 |
+| `spec-injector` | 按智能体类型自动注入项目规范到子 Agent 提示词 |
+| `delegate-monitor` | 跟踪异步 delegate 任务完成状态 |
+| `team-monitor` | 团队协作消息感知 |
+| `telemetry` | 执行遥测收集 |
+| `session-context` | 会话启动时注入工作流状态 |
+| `skill-context` | 调用工作流 Skill 时注入工作流状态 |
+| `coordinator-tracker` | 跟踪协调器链进度 |
+| `workflow-guard` | 保护关键文件、约束工作流行为 |
+
+`spec-injector` 按类型路由项目规范 -- 执行 Agent 获取编码约定，规划 Agent 获取架构约束。4 级上下文预算（full > reduced > minimal > skip）自适应注入量。
 
 ```bash
-# 自然语言创建
-/maestro-overlay "在 maestro-execute 执行后增加 CLI 验证"
+maestro hooks install --level minimal    # context-monitor + spec-injector
+maestro hooks install --level standard   # + delegate/team/telemetry + session/skill-context + coordinator-tracker
+maestro hooks install --level full       # + workflow-guard
+```
+
+### Overlay 系统
 
-# 手动操作
-maestro overlay add my-overlay.json    # 安装 + 应用
+非侵入式地为 `.claude/commands/*.md` 打补丁 -- 增加步骤、阅读要求、质量门禁，无需编辑原始文件。Overlay 在 `maestro install` 升级后自动保留。
+
+```bash
+/maestro-overlay "在 maestro-execute 执行后增加 CLI 验证"
 maestro overlay list                   # 交互式 TUI 管理
 maestro overlay bundle -o team.json    # 打包分享
-maestro overlay import-bundle team.json # 解包 + 应用
 ```
 
-每个 overlay 声明目标命令和补丁列表（section + mode + content）。Patcher 使用哈希 HTML 注释标记包裹注入内容，实现幂等应用和精准移除。
-
-详见 **[Overlay 系统指南](guide/overlay-guide.md)**。
-
 ---
 
-## 36 个命令，21 个 Agent
+## 49 个命令，21 个 Agent
 
-### 命令（Claude Code 斜杠命令）
+### 命令
 
-| 类别 | 数量 | 用途 |
-|------|------|------|
-| `maestro-*` | 15 | 全生命周期 — init、brainstorm、roadmap、analyze、plan、execute、verify、phase-transition |
-| `manage-*` | 9 | Issue CRUD、发现、分析、规划、执行、代码库文档、记忆管理 |
-| `quality-*` | 7 | review、test、debug、test-gen、integration-test、refactor、sync |
-| `spec-*` | 4 | 规格说明 — setup、add、load、map |
+| 类别 | 数量 | 前缀 | 用途 |
+|------|------|------|------|
+| **核心工作流** | 20 | `maestro-*` | 全生命周期 -- init、brainstorm、roadmap、analyze、plan、execute、verify、coordinate、milestones、overlays、UI design |
+| **管理** | 12 | `manage-*` | Issue 生命周期、代码库文档、知识捕获、记忆管理、harvest、status |
+| **质量** | 9 | `quality-*` | review、test、debug、test-gen、integration-test、business-test、refactor、retrospective、sync |
+| **学习** | 5 | `learn-*` | 统一复盘、跟读学习、模式拆解、系统探究、多视角分析 |
+| **规范** | 3 | `spec-*` | setup、add、load |
+| **知识图谱** | 2 | `wiki-*` | 连接发现、知识摘要 |
 
 ### Agent
 
-`.claude/agents/` 下 21 个专业化 Agent 定义 —— 每个是聚焦的 Markdown 文件，Claude Code 按需加载。包括 `workflow-planner`、`workflow-executor`、`issue-discover-agent`、`workflow-debugger`、`workflow-verifier`、`team-worker` 等。
+`.claude/agents/` 下 21 个专业化 Agent 定义 -- 每个是聚焦的 Markdown 文件，Claude Code 按需加载。包括 `workflow-planner`、`workflow-executor`、`issue-discover-agent`、`workflow-debugger`、`workflow-verifier`、`team-worker` 等。
 
 ---
 
@@ -237,12 +223,10 @@ maestro overlay import-bundle team.json # 解包 + 应用
 
 - Node.js >= 18
 - [Claude Code](https://claude.com/code) CLI
-- （可选）Codex CLI、Gemini CLI 用于多智能体工作流
+- (可选) Codex CLI、Gemini CLI 用于多智能体工作流
 
 ### 安装
 
-#### npm（推荐）
-
 ```bash
 npm install -g maestro-flow
 
@@ -250,22 +234,6 @@ npm install -g maestro-flow
 maestro install
 ```
 
-#### 从源码编译
-
-```bash
-git clone https://github.com/catlog22/Maestro-Flow.git
-cd Maestro-Flow
-npm install && npm run build && npm install -g .
-maestro install
-```
-
-#### 启动仪表盘
-
-```bash
-cd dashboard && npm install && npm run dev
-# → http://127.0.0.1:3001
-```
-
 ### 第一次运行
 
 ```bash
@@ -274,16 +242,32 @@ cd dashboard && npm install && npm run dev
 /maestro-plan 1                # 规划第一阶段
 /maestro-execute 1             # 多智能体执行
 
-# 或者直接：
+# 或者直接:
 /maestro "搭建用户管理的 REST API"
 ```
 
+### 仪表盘
+
+```bash
+maestro serve                  # -> http://127.0.0.1:3001
+maestro view                   # 终端 TUI 替代方案
+```
+
 ### MCP 服务器
 
-将 Maestro-Flow 工具暴露给 Claude Desktop 和其他 MCP 客户端：
+```bash
+# Claude Code -- 加载为开发 MCP 服务器
+claude --dangerously-load-development-channels server:maestro --dangerously-skip-permissions
+
+# stdio 传输 (Claude Desktop 和其他 MCP 客户端)
+npm run mcp
+```
+
+### 工作流启动器
 
 ```bash
-npm run mcp  # stdio 传输
+maestro launcher               # 交互式工作流 + 设置选择器
+maestro launcher list           # 查看已注册的工作流
 ```
 
 ---
@@ -292,27 +276,25 @@ npm run mcp  # stdio 传输
 
 ```
 maestro/
-├── bin/                     # CLI 入口
-├── src/                     # 核心 CLI（Commander.js + MCP SDK）
-│   ├── commands/            # 11 个 CLI 命令（serve, run, cli, ext, tool, ...）
-│   ├── mcp/                 # MCP 服务器（stdio 传输）
-│   └── core/                # 工具注册、扩展加载器
-├── dashboard/               # 实时 Web 仪表盘
-│   └── src/
-│       ├── client/          # React 19 + Zustand + Tailwind CSS 4
-│       │   └── components/
-│       │       └── kanban/  # 19 个看板组件
-│       ├── server/          # Hono API + WebSocket + SSE
-│       │   ├── agents/      # AgentManager + 适配器（Claude SDK, Codex CLI, OpenCode）
-│       │   ├── commander/   # 自主 Commander Agent
-│       │   └── execution/   # ExecutionScheduler + WaveExecutor
-│       └── shared/          # 共享类型
-├── .claude/
-│   ├── commands/            # 36 个斜杠命令（.md）
-│   └── agents/              # 21 个 Agent 定义（.md）
-├── workflows/               # 36 个工作流实现（.md）
-├── templates/               # JSON 模板（task, plan, issue, ...）
-└── extensions/              # 插件系统
++-- bin/                     # CLI 入口
++-- src/                     # 核心 CLI (Commander.js + MCP SDK)
+|   +-- commands/            # 11 个 CLI 命令 (serve, run, cli, ext, tool, ...)
+|   +-- mcp/                 # MCP 服务器 (stdio 传输)
+|   +-- core/                # 工具注册、扩展加载器
++-- dashboard/               # 实时 Web 仪表盘
+|   +-- src/
+|       +-- client/          # React 19 + Zustand + Tailwind CSS 4
+|       +-- server/          # Hono API + WebSocket + SSE
+|       |   +-- agents/      # AgentManager + 适配器
+|       |   +-- commander/   # 自主 Commander Agent
+|       |   +-- execution/   # ExecutionScheduler + WaveExecutor
+|       +-- shared/          # 共享类型
++-- .claude/
+|   +-- commands/            # 49 个斜杠命令 (.md)
+|   +-- agents/              # 21 个 Agent 定义 (.md)
++-- workflows/               # 47 个工作流实现 (.md)
++-- templates/               # JSON 模板 (task, plan, issue, ...)
++-- extensions/              # 插件系统
 ```
 
 ### 技术栈
@@ -320,7 +302,7 @@ maestro/
 | 层级 | 技术 |
 |------|------|
 | CLI | Commander.js, TypeScript, ESM |
-| MCP | @modelcontextprotocol/sdk（stdio） |
+| MCP | @modelcontextprotocol/sdk (stdio) |
 | 前端 | React 19, Zustand, Tailwind CSS 4, Framer Motion, Radix UI |
 | 后端 | Hono, WebSocket, SSE |
 | 智能体 | Claude Agent SDK, Codex CLI, Gemini CLI, OpenCode |
@@ -330,20 +312,20 @@ maestro/
 
 ## 文档
 
-- **[命令使用指南](guide/command-usage-guide.md)** — 全部 36 个命令，含工作流图表、管线衔接、Issue 闭环、快速通道
-- **[Delegate 异步执行指南](guide/delegate-async-guide.md)** — 异步任务委派：CLI & MCP 用法、消息注入、链式调用、Broker 生命周期、delegate vs cli 对比
-- **[Overlay 系统指南](guide/overlay-guide.md)** — 非侵入式命令扩展：overlay 格式、section 注入、bundle 打包/导入、交互式 TUI 管理
-- **[Team Lite — 使用指南](guide/team-lite-guide.md)** — 2-8 人小团队日常协作：加入、同步、队友活跃、冲突预飞检
+- **[命令使用指南](guide/command-usage-guide.md)** -- 全部 49 个命令，含工作流图表、管线衔接、Issue 闭环、快速通道
+- **[Delegate 异步执行指南](guide/delegate-async-guide.md)** -- 异步任务委派: CLI & MCP 用法、消息注入、链式调用、Broker 生命周期
+- **[Overlay 系统指南](guide/overlay-guide.md)** -- 非侵入式命令扩展: overlay 格式、section 注入、bundle 打包/导入、交互式 TUI 管理
+- **[Hook 系统指南](guide/hooks-guide.md)** -- Hook 系统架构、9 个 Hook、Spec 注入、上下文预算、配置
+- **[Worktree 并行开发指南](guide/worktree-guide.md)** -- 里程碑级 worktree 并行: fork、sync、merge、scope 保护、Dashboard 集成
+- **[Team Lite -- 使用指南](guide/team-lite-guide.md)** -- 2-8 人小团队日常协作: 加入、同步、队友活跃、冲突预飞检
+- **[Team Lite -- 设计文档](guide/team-lite-design.md)** -- 架构、数据模型、人机协作与智能体管线的命名空间边界
 
 ---
 
 ## 致谢
 
-Maestro-Flow 站在两个项目的肩膀上：
-
-- **[GET SHIT DONE](https://github.com/gsd-build/get-shit-done)** by TACHES — 规格驱动开发模型、上下文工程理念、原子提交纪律，塑造了 Maestro-Flow 的管线设计。GSD 证明了结构化的 meta-prompting 才是大规模驱动 AI 智能体的正确方式。
-
-- **[Claude-Code-Workflow](https://github.com/catlog22/Claude-Code-Workflow)** — Maestro-Flow 的前身。CCW 开创了多 CLI 编排（Gemini + Codex + Qwen + Claude）、skill 路由工作流、team agent 架构。Maestro-Flow 是 CCW 从零重建 —— 更快、更精简，加上可视化看板和自主 Commander。
+- **[GET SHIT DONE](https://github.com/gsd-build/get-shit-done)** by TACHES -- 规格驱动开发模型和上下文工程理念，塑造了 Maestro-Flow 的管线设计。
+- **[Claude-Code-Workflow](https://github.com/catlog22/Claude-Code-Workflow)** -- 前身项目，开创了多 CLI 编排和 skill 路由工作流。
 
 ## 贡献者
 
@@ -351,7 +333,7 @@ Maestro-Flow 站在两个项目的肩膀上：
   <img src="https://github.com/catlog22.png" width="60px" alt="catlog22" style="border-radius:50%"/>
 </a>
 
-**[@catlog22](https://github.com/catlog22)** — 创建者 & 维护者
+**[@catlog22](https://github.com/catlog22)** -- 创建者 & 维护者
 
 ## 友情链接
 

package/bin/maestro-mcp.js

@@ -1,2 +1,2 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 import '../dist/src/mcp/server.js';

package/chains/_intent-map.json

@@ -117,16 +117,10 @@
       "route": { "graph": "singles/sync" }
     },
     {
-      "type": "phase_transition",
-      "regex": "phase.*transit|next.*phase|推进|切换.*阶段",
+      "type": "milestone_close",
+      "regex": "phase.*transit|next.*phase|推进|切换.*阶段|close.*milestone|结束.*里程碑",
       "flags": "i",
-      "route": { "graph": "singles/phase-transition" }
-    },
-    {
-      "type": "phase_add",
-      "regex": "phase.*add|add.*phase|添加.*阶段",
-      "flags": "i",
-      "route": { "graph": "singles/phase-add" }
+      "route": { "graph": "milestone-close" }
     },
     {
       "type": "milestone_audit",
@@ -254,6 +248,24 @@
       "flags": "i",
       "route": { "graph": "singles/team-tech-debt" }
     },
+    {
+      "type": "learn",
+      "regex": "\\blearn|capture.*insight|eureka|记录.*洞察",
+      "flags": "i",
+      "route": { "graph": "singles/memory-capture" }
+    },
+    {
+      "type": "fork",
+      "regex": "\\bfork|worktree.*creat|parallel.*milestone|分叉|并行.*里程碑",
+      "flags": "i",
+      "route": { "graph": "milestone-fork-merge" }
+    },
+    {
+      "type": "merge",
+      "regex": "merge.*worktree|merge.*milestone|合并.*工作树",
+      "flags": "i",
+      "route": { "graph": "milestone-fork-merge" }
+    },
     {
       "type": "quick",
       "regex": "quick|small.*task|ad.?hoc|简单|快速",