name: mpm-workflow version: “1.0.0” description: 通过本地覆盖管理和自定义MPM工作流配置 when_to_use: 工作流定制、阶段配置、验证门控、代理路由 category: pm配置 tags: [工作流, 配置, 定制, 阶段, 验证]

MPM工作流配置

概述

MPM工作流系统支持可定制的工作流配置，具有基于优先级的覆盖系统。这允许项目自定义标准的5阶段工作流，同时保持合理的默认设置。

优先级系统

工作流文件按以下优先级加载（从高到低）：

项目级：.claude-mpm/WORKFLOW.md - 项目特定自定义
用户级：~/.claude-mpm/WORKFLOW.md - 用户跨所有项目的偏好
系统默认：内置框架 WORKFLOW.md

命令

`/mpm-workflow status`

显示当前工作流配置和来源：

工作流配置状态：
  来源：项目 (.claude-mpm/WORKFLOW.md)
  阶段：5
  验证门控：已启用
  自定义覆盖：阶段 2 (代码分析器) 跳过

`/mpm-workflow init`

初始化本地工作流配置文件：

# 使用默认值创建 .claude-mpm/WORKFLOW.md
/mpm-workflow init

# 使用最小模板创建
/mpm-workflow init --minimal

`/mpm-workflow reset`

重置为默认工作流配置：

# 移除本地覆盖，使用系统默认
/mpm-workflow reset

`/mpm-workflow validate`

验证当前工作流配置：

验证工作流配置...
  [OK] 阶段定义完整
  [OK] 验证门控已定义
  [OK] 代理路由有效
  [WARN] 自定义阶段 6 定义 - 确保代理存在

工作流文件结构

必需部分

# PM工作流配置

## 强制阶段序列

### 阶段 1: 研究 (始终第一)
**代理**: 研究
**输出**: 需求、约束、成功标准
**模板**: ...

### 阶段 2: 代码分析器审查
**代理**: 代码分析器
**输出**: 批准/需改进/阻塞
**决策**: ...

### 阶段 3: 实施
**代理**: 通过委托矩阵选择
**要求**: 完整代码、错误处理、测试

### 阶段 4: QA (强制)
**代理**: qa/api-qa/web-qa
**要求**: 实际测试并附带证据

### 阶段 5: 文档
**代理**: 文档
**时机**: 代码变更后

## 验证门控

| 阶段 | 验证要求 | 证据格式 |
|-------|----------------------|-----------------|
| ... | ... | ... |

## 覆盖命令

- “跳过工作流” - 绕过序列
- “直接前往 [阶段]” - 跳转到阶段

自定义示例

为受信任项目跳过代码分析器

### 阶段 2: 代码分析器审查
**代理**: 代码分析器
**状态**: 可选
**跳过时机**: 小修复、仅文档

添加自定义阶段

### 阶段 6: 安全扫描 (自定义)
**代理**: 安全
**时机**: 认证、API 或数据处理变更
**输出**: 安全报告

修改验证要求

## 验证门控

| 阶段 | 验证要求 | 证据格式 |
|-------|----------------------|-----------------|
| 实施 | 测试通过 + 覆盖率 > 80% | pytest 输出附带覆盖率 |

与指令构建器的集成

工作流加载器自动将工作流配置注入 PM 指令：

检查项目级 WORKFLOW.md
如果未找到，回退到用户级
最后使用系统默认
注入到 workflow_instructions 内容字段

最佳实践

从默认开始：仅覆盖所需部分
文档变更：添加注释解释阶段修改原因
测试工作流：变更后使用 /mpm-workflow validate
版本控制：将 .claude-mpm/WORKFLOW.md 提交到项目
团队对齐：确保团队同意工作流自定义

故障排除

工作流未加载

检查文件存在：ls -la .claude-mpm/WORKFLOW.md
验证语法：/mpm-workflow validate
检查优先级：/mpm-workflow status

阶段未执行

验证阶段在 workflow 中定义
检查自定义阶段的代理是否存在
审查验证门控要求

重置为默认

/mpm-workflow reset