专为Claude Code设计的开发工作流插件，涵盖规划、实现、质量检查、传统提交、端到端测试和多智能体团队协作，提供从任务开始到发布的完整工具链。

mx-workflow：覆盖完整开发生命周期的Claude Code插件\n\n在AI辅助编程日益普及的今天，开发者需要的不只是代码补全，而是一套覆盖完整开发生命周期的系统化工具。mx-workflow正是为此而生——它是一个专为Claude Code设计的插件，提供从规划到发布的全流程支持。\n\n## 什么是mx-workflow\n\nmx-workflow是一个开发工作流插件，覆盖完整的开发生命周期：规划、实现、质量检查、传统提交、端到端测试和多智能体团队协作。它的设计理念是提供从任务开始到发布的完整工具链，让开发者无需在多个工具之间切换。\n\n与单一功能的AI工具不同，mx-workflow提供结构化的工作流，每个命令都有明确的输入、处理和输出，确保开发过程的一致性和可预测性。\n\n## 核心工作流\n\nmx-workflow提供以下核心命令，覆盖开发的主要阶段：\n\n### 会话启动\n\n| 命令 | 描述 |\n|------|------|\n| /mx:prime | 预热代码库上下文（读取关键文件、运行质量检查） |\n\n这是每个会话开始时应该运行的第一个命令。它让Claude了解项目结构、代码风格和现有模式，为后续工作奠定基础。\n\n### 实现（最常用路径）\n\n| 命令 | 描述 |\n|------|------|\n| /mx:rca <错误或症状> | 深度根因分析（5Why + Git历史） |\n| /mx:plan | 创建实现计划，包含代码库分析 |\n| /mx:implement | 执行计划，包含验证循环和智能体审查 |\n| /mx:validate | 运行质量检查（lint、类型检查、测试） |\n| /mx:deps [--security\|--outdated\|--unused] | 审计依赖的安全问题、过期版本和未使用包 |\n| /mx:e2e [url] | 基于浏览器的端到端测试（截图、数据库验证、Bug修复） |\n| /mx:check-ignores | 审计类型/lint抑制注释 |\n| /mx:branch <ticket> <desc> | 创建分支，使用票证编码的命名规范 |\n| /mx:commit | 传统提交（自动推断范围/类型/票证） |\n| /mx:shipit [desc] | 修复+检查+提交+推送一步到位 |\n| /mx:pr [--draft] | 创建PR，包含自动生成的摘要和智能体发现 |\n\n这些命令构成了日常开发的核心循环。典型的工作流是：prime → plan → implement → validate → commit → pr。\n\n## 详细功能解析\n\n### /mx:prime — 代码库预热\n\n这是最重要的启动命令。它读取关键配置文件（如package.json、tsconfig.json、.eslintrc等），运行初始质量检查，让Claude理解项目结构和代码风格。这避免了每个会话开始时重复询问项目上下文。\n\n### /mx:rca — 根因分析\n\n当遇到难以解决的Bug时使用。它采用系统化的5Why分析方法，结合Git历史追溯问题引入点。这比试错调试更高效，特别适合生产环境问题。\n\n### /mx:plan — 智能规划\n\n创建实现计划时，它会分析代码库，识别相关文件和模式，生成结构化的实施步骤。计划包含验收标准和测试策略，确保实现方向正确。\n\n### /mx:implement — 执行与验证\n\n这是核心实现命令。它不仅执行计划，还包含内置验证循环：\n\n- 每完成一个步骤，自动运行相关测试\n- 智能体审查代码质量和风格\n- 发现问题时自动修复或提示\n\n这种验证循环确保代码质量，减少回归风险。\n\n### /mx:validate — 质量守门\n\n运行完整的质量检查套件：\n\n- Lint检查（代码风格）\n- 类型检查（TypeScript等）\n- 单元测试\n- 集成测试\n\n这是提交前的必要步骤，确保代码符合项目标准。\n\n### /mx:e2e — 端到端测试\n\n基于Playwright的浏览器测试，可以：\n\n- 截取页面截图进行对比\n- 验证数据库状态\n- 自动修复发现的Bug\n- 测试用户流程完整性\n\n这确保了功能在真实浏览器环境中的正确性。\n\n### /mx:shipit — 一键发布\n\n将多个步骤合并为一个命令：\n\n1. 自动修复可自动修复的问题\n2. 运行质量检查\n3. 创建传统提交\n4. 推送到远程\n\n适合小改动和快速迭代。\n\n### /mx:pr — 智能PR创建\n\n自动生成PR摘要，包含：\n\n- 变更概述\n- 智能体审查发现\n- 测试覆盖情况\n- 潜在风险提醒\n\n使用--draft标记可以创建草稿PR，适合需要进一步审查的改动。\n\n## 配置选项\n\nmx-workflow使用环境变量进行配置，所有设置都有合理的默认值，只需覆盖需要的选项。\n\n可以在shell配置文件（~/.bashrc、~/.zshrc）或~/.claude/settings.json的env部分设置：\n\njson\n{\n \"env\": {\n \"MX_TICKET_PREFIX\": \"PROJ\",\n \"MX_BRANCH_PATTERN\": \"feature/[^/]+/\"\n }\n}\n\n\n### 配置变量\n\n| 变量 | 用途 | 默认值 |\n|------|------|--------|\n| MX_TICKET_PREFIX | 提交中的票证引用前缀（如PROJ） | 无（可选） |\n| MX_BRANCH_PATTERN | /mx:branch的分支命名模板 | {type}/{ticket}-{description} |\n| MX_CO_AUTHOR | AI提交的合著者行 | Claude <noreply@anthropic.com> |\n\n这些配置让mx-workflow能够适应不同团队的工作流规范。\n\n## 安装方式\n\n### 选项A：市场安装（推荐）\n\nbash\n# 1. 添加市场（一次性）\n/plugin marketplace add https://github.com/joshtune/mx-workflow.git\n\n# 2. 安装插件\n/plugin install mx@joshtune-mx-workflow\n\n# 选择范围：\n# user → 所有项目可用（~/.claude/settings.json）\n# project → 通过.claude/settings.json与团队共享\n# local → gitignored，仅本机\n\n\n### 选项B：克隆+每会话加载\n\nbash\n# 克隆仓库\ngit clone https://github.com/joshtune/mx-workflow.git ~/mx-workflow\n\n# 当前会话加载\nclaude --plugin-dir ~/mx-workflow\n\n\n这是临时的——插件仅对该会话可用。\n\n### 选项C：克隆+永久手动配置\n\nbash\n# 克隆仓库\ngit clone https://github.com/joshtune/mx-workflow.git ~/mx-workflow\n\n\n然后编辑~/.claude/settings.json：\n\njson\n{\n \"plugins\": [\"~/mx-workflow\"]\n}\n\n\n### 验证安装\n\n安装完成后，输入/mx:应该能在自动完成中看到所有命令。\n\n测试命令：\n\n/mx:help\n\n\n这会显示完整的命令参考卡片。\n\n## 快速开始指南\n\n安装完成后，典型的首次会话流程：\n\n1. 加载代码库上下文 —— 运行/mx:prime预热。这会读取关键文件并运行初始质量检查，让Claude理解项目。\n\n2. 检查项目就绪状态 —— 运行/mx:status或/mx:validate查看lint、类型检查和测试是否通过。在编写代码前修复任何阻塞问题。\n\n3. 选择任务并规划 —— 运行/mx:plan创建实现计划。如果有票证，先用/mx:branch <ticket> <desc>创建分支。\n\n4. 实现 —— 运行/mx:implement执行计划。这包含内置验证循环和智能体审查。\n\n5. 验证 —— 运行/mx:validate确认lint、类型检查和测试在变更后仍然通过。\n\n6. 提交 —— 运行/mx:commit创建传统提交，自动推断范围、类型和票证引用。\n\n7. 创建PR —— 运行/mx:pr创建拉取请求，包含自动生成的摘要。如果尚未准备好审查，使用/mx:pr --draft。\n\n这是核心循环。更复杂的工作流可以参考官方文档。\n\n## 设计哲学\n\nmx-workflow的设计体现了几个关键理念：\n\n结构化流程：每个命令都有明确的输入、处理和输出，避免了AI辅助开发中常见的随意性。这种结构化确保了可重复性和团队协作的一致性。\n\n验证优先：内置的验证循环确保代码质量。implement命令在每一步后都进行验证，validate命令作为质量守门，e2e命令确保端到端正确性。\n\n自动化：从分支命名到提交消息，从PR摘要到质量检查，大量自动化减少了开发者的认知负担，让他们专注于核心逻辑。\n\n可配置性：通过环境变量，mx-workflow可以适应不同团队的工作流规范，无论是分支命名约定还是票证引用格式。\n\n渐进式：开发者可以从核心命令开始，根据需要逐步探索更多功能。没有强制使用所有功能的负担。\n\n## 与其他工具的对比\n\n与Uatu等AI编排框架相比，mx-workflow更专注于Claude Code的特定工作流，提供更细粒度的命令。与AgentKit等插件市场相比，mx-workflow是一个统一的插件，提供连贯的体验而非模块化组合。\n\n这种专注让它在Claude Code生态系统中具有独特价值——为那些希望有结构化、可预测开发流程的团队提供了现成解决方案。\n\n## 实际应用价值\n\n对于开发团队，mx-workflow提供了：\n\n- 一致性：所有团队成员使用相同的工作流，减少风格差异\n- 效率：自动化重复任务，如提交消息生成、PR摘要编写\n- 质量：内置验证循环确保代码质量\n- 可追溯性：传统提交和票证集成提供了完整的变更历史\n- 协作：结构化的PR流程促进代码审查和知识共享\n\n对于个人开发者，它提供了：\n\n- 专注：减少上下文切换，让开发者专注于解决问题\n- 学习：通过观察AI的工作方式，学习更好的开发实践\n- 信心：自动化测试和验证提供了修改代码的信心\n\n## 结语\n\nmx-workflow代表了AI辅助开发工具的成熟方向——从单一功能的代码补全，到覆盖完整开发生命周期的系统化工具。通过提供结构化、可验证、可配置的工作流，它让AI真正成为开发团队的得力助手，而非仅仅是代码生成器。随着AI在软件开发中扮演越来越重要的角色，这类全生命周期工具将成为开发者的标准配置。

mx-workflow：覆盖完整开发生命周期的Claude Code插件\n\n在AI辅助编程日益普及的今天，开发者需要的不只是代码补全，而是一套覆盖完整开发生命周期的系统化工具。mx-workflow正是为此而生——它是一个专为Claude Code设计的插件，提供从规划到发布的全流程支持。\n\n什么是mx-workflow\n\nmx-workflow是一个开发工作流插件，覆盖完整的开发生命周期：规划、实现、质量检查、传统提交、端到端测试和多智能体团队协作。它的设计理念是提供从任务开始到发布的完整工具链，让开发者无需在多个工具之间切换。\n\n与单一功能的AI工具不同，mx-workflow提供结构化的工作流，每个命令都有明确的输入、处理和输出，确保开发过程的一致性和可预测性。\n\n核心工作流\n\nmx-workflow提供以下核心命令，覆盖开发的主要阶段：\n\n会话启动\n\n| 命令 | 描述 |\n|------|------|\n| /mx:prime | 预热代码库上下文（读取关键文件、运行质量检查） |\n\n这是每个会话开始时应该运行的第一个命令。它让Claude了解项目结构、代码风格和现有模式，为后续工作奠定基础。\n\n实现（最常用路径）\n\n| 命令 | 描述 |\n|------|------|\n| /mx:rca <错误或症状> | 深度根因分析（5Why + Git历史） |\n| /mx:plan | 创建实现计划，包含代码库分析 |\n| /mx:implement | 执行计划，包含验证循环和智能体审查 |\n| /mx:validate | 运行质量检查（lint、类型检查、测试） |\n| /mx:deps [--security\|--outdated\|--unused] | 审计依赖的安全问题、过期版本和未使用包 |\n| /mx:e2e [url] | 基于浏览器的端到端测试（截图、数据库验证、Bug修复） |\n| /mx:check-ignores | 审计类型/lint抑制注释 |\n| /mx:branch <ticket> <desc> | 创建分支，使用票证编码的命名规范 |\n| /mx:commit | 传统提交（自动推断范围/类型/票证） |\n| /mx:shipit [desc] | 修复+检查+提交+推送一步到位 |\n| /mx:pr [--draft] | 创建PR，包含自动生成的摘要和智能体发现 |\n\n这些命令构成了日常开发的核心循环。典型的工作流是：prime → plan → implement → validate → commit → pr。\n\n详细功能解析\n\n/mx:prime — 代码库预热\n\n这是最重要的启动命令。它读取关键配置文件（如package.json、tsconfig.json、.eslintrc等），运行初始质量检查，让Claude理解项目结构和代码风格。这避免了每个会话开始时重复询问项目上下文。\n\n/mx:rca — 根因分析\n\n当遇到难以解决的Bug时使用。它采用系统化的5Why分析方法，结合Git历史追溯问题引入点。这比试错调试更高效，特别适合生产环境问题。\n\n/mx:plan — 智能规划\n\n创建实现计划时，它会分析代码库，识别相关文件和模式，生成结构化的实施步骤。计划包含验收标准和测试策略，确保实现方向正确。\n\n/mx:implement — 执行与验证\n\n这是核心实现命令。它不仅执行计划，还包含内置验证循环：\n\n- 每完成一个步骤，自动运行相关测试\n- 智能体审查代码质量和风格\n- 发现问题时自动修复或提示\n\n这种验证循环确保代码质量，减少回归风险。\n\n/mx:validate — 质量守门\n\n运行完整的质量检查套件：\n\n- Lint检查（代码风格）\n- 类型检查（TypeScript等）\n- 单元测试\n- 集成测试\n\n这是提交前的必要步骤，确保代码符合项目标准。\n\n/mx:e2e — 端到端测试\n\n基于Playwright的浏览器测试，可以：\n\n- 截取页面截图进行对比\n- 验证数据库状态\n- 自动修复发现的Bug\n- 测试用户流程完整性\n\n这确保了功能在真实浏览器环境中的正确性。\n\n/mx:shipit — 一键发布\n\n将多个步骤合并为一个命令：\n\n1. 自动修复可自动修复的问题\n2. 运行质量检查\n3. 创建传统提交\n4. 推送到远程\n\n适合小改动和快速迭代。\n\n/mx:pr — 智能PR创建\n\n自动生成PR摘要，包含：\n\n- 变更概述\n- 智能体审查发现\n- 测试覆盖情况\n- 潜在风险提醒\n\n使用--draft标记可以创建草稿PR，适合需要进一步审查的改动。\n\n配置选项\n\nmx-workflow使用环境变量进行配置，所有设置都有合理的默认值，只需覆盖需要的选项。\n\n可以在shell配置文件（~/.bashrc、~/.zshrc）或~/.claude/settings.json的env部分设置：\n\njson\n{\n \"env\": {\n \"MX_TICKET_PREFIX\": \"PROJ\",\n \"MX_BRANCH_PATTERN\": \"feature/[^/]+/\"\n }\n}\n\n\n配置变量\n\n| 变量 | 用途 | 默认值 |\n|------|------|--------|\n| MX_TICKET_PREFIX | 提交中的票证引用前缀（如PROJ） | 无（可选） |\n| MX_BRANCH_PATTERN | /mx:branch的分支命名模板 | {type}/{ticket}-{description} |\n| MX_CO_AUTHOR | AI提交的合著者行 | Claude <noreply@anthropic.com> |\n\n这些配置让mx-workflow能够适应不同团队的工作流规范。\n\n安装方式\n\n选项A：市场安装（推荐）\n\nbash\n1. 添加市场（一次性）\n/plugin marketplace add https://github.com/joshtune/mx-workflow.git\n\n2. 安装插件\n/plugin install mx@joshtune-mx-workflow\n\n选择范围：\nuser → 所有项目可用（~/.claude/settings.json）\nproject → 通过.claude/settings.json与团队共享\nlocal → gitignored，仅本机\n\n\n选项B：克隆+每会话加载\n\nbash\n克隆仓库\ngit clone https://github.com/joshtune/mx-workflow.git ~/mx-workflow\n\n当前会话加载\nclaude --plugin-dir ~/mx-workflow\n\n\n这是临时的——插件仅对该会话可用。\n\n选项C：克隆+永久手动配置\n\nbash\n克隆仓库\ngit clone https://github.com/joshtune/mx-workflow.git ~/mx-workflow\n\n\n然后编辑~/.claude/settings.json：\n\njson\n{\n \"plugins\": [\"~/mx-workflow\"]\n}\n\n\n验证安装\n\n安装完成后，输入/mx:应该能在自动完成中看到所有命令。\n\n测试命令：\n\n/mx:help\n\n\n这会显示完整的命令参考卡片。\n\n快速开始指南\n\n安装完成后，典型的首次会话流程：\n\n1. 加载代码库上下文 —— 运行/mx:prime预热。这会读取关键文件并运行初始质量检查，让Claude理解项目。\n\n2. 检查项目就绪状态 —— 运行/mx:status或/mx:validate查看lint、类型检查和测试是否通过。在编写代码前修复任何阻塞问题。\n\n3. 选择任务并规划 —— 运行/mx:plan创建实现计划。如果有票证，先用/mx:branch <ticket> <desc>创建分支。\n\n4. 实现 —— 运行/mx:implement执行计划。这包含内置验证循环和智能体审查。\n\n5. 验证 —— 运行/mx:validate确认lint、类型检查和测试在变更后仍然通过。\n\n6. 提交 —— 运行/mx:commit创建传统提交，自动推断范围、类型和票证引用。\n\n7. 创建PR —— 运行/mx:pr创建拉取请求，包含自动生成的摘要。如果尚未准备好审查，使用/mx:pr --draft。\n\n这是核心循环。更复杂的工作流可以参考官方文档。\n\n设计哲学\n\nmx-workflow的设计体现了几个关键理念：\n\n结构化流程：每个命令都有明确的输入、处理和输出，避免了AI辅助开发中常见的随意性。这种结构化确保了可重复性和团队协作的一致性。\n\n验证优先：内置的验证循环确保代码质量。implement命令在每一步后都进行验证，validate命令作为质量守门，e2e命令确保端到端正确性。\n\n自动化：从分支命名到提交消息，从PR摘要到质量检查，大量自动化减少了开发者的认知负担，让他们专注于核心逻辑。\n\n可配置性：通过环境变量，mx-workflow可以适应不同团队的工作流规范，无论是分支命名约定还是票证引用格式。\n\n渐进式：开发者可以从核心命令开始，根据需要逐步探索更多功能。没有强制使用所有功能的负担。\n\n与其他工具的对比\n\n与Uatu等AI编排框架相比，mx-workflow更专注于Claude Code的特定工作流，提供更细粒度的命令。与AgentKit等插件市场相比，mx-workflow是一个统一的插件，提供连贯的体验而非模块化组合。\n\n这种专注让它在Claude Code生态系统中具有独特价值——为那些希望有结构化、可预测开发流程的团队提供了现成解决方案。\n\n实际应用价值\n\n对于开发团队，mx-workflow提供了：\n\n- 一致性：所有团队成员使用相同的工作流，减少风格差异\n- 效率：自动化重复任务，如提交消息生成、PR摘要编写\n- 质量：内置验证循环确保代码质量\n- 可追溯性：传统提交和票证集成提供了完整的变更历史\n- 协作：结构化的PR流程促进代码审查和知识共享\n\n对于个人开发者，它提供了：\n\n- 专注：减少上下文切换，让开发者专注于解决问题\n- 学习：通过观察AI的工作方式，学习更好的开发实践\n- 信心：自动化测试和验证提供了修改代码的信心\n\n结语\n\nmx-workflow代表了AI辅助开发工具的成熟方向——从单一功能的代码补全，到覆盖完整开发生命周期的系统化工具。通过提供结构化、可验证、可配置的工作流，它让AI真正成为开发团队的得力助手，而非仅仅是代码生成器。随着AI在软件开发中扮演越来越重要的角色，这类全生命周期工具将成为开发者的标准配置。