OpenMatrix

你的代码没测试？OpenMatrix 自动帮你补，覆盖率 >80%

自动化 ≠ 牺牲质量 | 高质量 ≠ 手动操作

中文 | English

30秒演示

/om 实现用户登录功能

# 自动启动任务编排 → 选择质量级别 → 全自动执行 → 质量门禁 → AI验收 → 完成

/om 是 /om:start 的快捷方式。直接输入任务描述即可自动触发。

三种质量模式

| 模式 | 覆盖率 | 测试 | 集成测试 | Lint | 安全 | 适用场景 | |:----:|:------:|:----:|:--------:|:----:|:----:|---------| | strict | >80% | TDD 先写测试 | ✅ 必需 | 严格 | npm audit | 生产代码 | | balanced | >60% | 后补测试 | ⭕ 可选 | 标准 | npm audit | 日常开发 | | fast | >20% | 可选 | 无 | 无 | 无 | 快速原型 |

集成测试验证组件交互链路（--integration-tests 开启 / --no-integration-tests 关闭）；E2E 测试可选（Playwright/Cypress/Appium）

快速开始

# 安装
npm install -g openmatrix

# 验证
openmatrix --version

# 使用
/om 实现用户登录

核心命令

| 命令 | 用途 | |------|------| | /om | 默认入口 - 直接输入任务描述启动完整工作流 | | /om:start | 启动任务编排 - 完整的 Plan → Code → Test → Review 流程 | | /om:plan | 生成执行计划 - 任务拆解和步骤规划 | | /om:step | 单步执行 - 按 plan 逐步执行，每步确认 | | /om:auto | 全自动执行 - 无阻塞、无确认、适合 CI/CD | | /om:feature | 轻量小需求 - 快速迭代，无完整任务追踪 | | /om:test | 自动补测试 - 给现有代码补充单元测试，自动跑覆盖率 | | /om:debug | 系统化调试 - 四阶段根因分析 + 自动修复 | | /om:review | 代码审查 - AI 自动 review 并提供修改建议 | | /om:research | 技术研究 - 自动调研技术方案和最佳实践 | | /om:brainstorm | 头脑风暴 - 先探索需求和设计方案 | | /om:wiki | 项目Wiki - 根据项目结构自动生成项目文档 | | /om:gate | 质量门禁 - 关键节点检查产出与需求对齐 | | /om:deploy | 部署发布 - 自动化部署流程 | | /om:meeting | 会议模式 - 处理阻塞和待决策事项 | | /om:approve | 审批确认 - 通过质量门禁检查点 | | /om:resume | 恢复任务 - 从断点继续执行 | | /om:retry | 重试失败 - 重新执行失败的任务 | | /om:report | 生成报告 - 任务执行统计和质量报告 | | /om:status | 查看状态 - 当前任务和 Agent 状态 | | /om:complete | 标记完成 - 手动标记任务已完成 | | /om:check | 检查配置 - 验证项目和环境配置 | | /om:check-gitignore | 检查 gitignore - 验证并补充 .gitignore 配置 |

七道质量门禁

Gate 1: 编译检查    npm run build    → 必须通过
Gate 2: 测试运行    npm test         → 必须通过
Gate 3: 覆盖率检查  >20%/60%/80%     → 可配置
Gate 4: Lint 检查   无 error         → 可配置
Gate 5: 安全扫描    npm audit        → 无高危漏洞
Gate 6: E2E 测试    Playwright 等    → 可选
Gate 6b: 集成测试   组件交互链路     → 可选(strict 必需)
Gate 7: 验收标准    用户定义         → 必须全部满足

验收强制执行：没有产物 = 没有验收

质量门禁不是"提示词建议"，而是运行时强制。任务只有在磁盘上存在通过验证的产物时才能被标记完成——Agent 的口头汇报不算数。

Layer 1  提示词       verify 阶段要求生成 quality-report.json
Layer 2  进程内代码   openmatrix complete 硬门控 + 状态机转换条件
Layer 3  运行时 Hook  插件自带 PreToolUse / PostToolUse / Stop 钩子

• 完成门控：balanced/strict 级别下，openmatrix complete <id> 必须存在且通过 artifacts/quality-report.json（overall: pass），否则被拒绝。--force 可显式豁免；fast 级别自动跳过。
• 证据记录：每次真实执行 test/build/lint 命令，运行时 Hook 会写入带 SHA-256 的 test-truth.jsonl——Agent 无法伪造。
• 结束拦截：verify/accept 阶段的任务若缺少通过的报告，Stop 钩子会阻止 Agent 就此结束。

Agent 团队

OpenMatrix 采用多 Agent 协作模式：

| Agent | 职责 | |-------|------| | Planner | 需求分析、任务拆解、执行计划制定 | | Coder | 代码实现、重构、bug 修复 | | Tester | 编写测试用例、跑测试、覆盖率检查 | | Reviewer | 代码审查、质量把关、最佳实践建议 | | Researcher | 技术调研、方案对比、文档整理 | | Executor | 执行命令、运行脚本、CI/CD 集成 |

与 superpowers 配合

OpenMatrix 自动执行任务 + superpowers 提供额外技能 = 完美组合

# superpowers 写代码，OpenMatrix 保证质量
/om 实现用户登录    # 自动 TDD + 质量门禁 + AI 验收

详细文档

| 文档 | 内容 | |------|------| | 执行流程图 | 完整流程图和阶段说明 | | 开发路线图 | 功能规划和进度 | | 系统架构 | 核心组件和设计 | | 术语对照表 | 中英文术语对照 |

常见问题

Q: 哪种质量级别适合我？

| 场景 | 推荐模式 | |------|---------| | 生产代码、核心功能 | strict | | 日常功能开发 | balanced | | 快速原型、POC | fast |

Q: Meeting 是什么？

A: 遇到阻塞时创建记录，但不停止执行。最后用 /om:meeting 统一处理所有阻塞。

Q: 支持哪些语言？

A: 原生支持 TypeScript/JavaScript、Python、Go、Java、Rust 等所有主流语言。

Q: Agent 如何协作？

A: Planner 制定计划后，各 Agent 按顺序或并行执行任务，Reviewer 在每个阶段把关质量。

配置示例

{
  "quality": {
    "tdd": false,
    "minCoverage": 60,
    "strictLint": true,
    "securityScan": true,
    "e2eTests": false,
    "integrationTests": false
  },
  "approvalPoints": ["plan", "merge"],
  "agents": { "maxConcurrent": 3 }
}

如果觉得有用，请给个 Star！

MIT | Made by bigfish1913