/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 就此结束。
OpenMatrix 采用多 Agent 协作模式：
| Agent | 职责 |
|---|---|
| Planner | 需求分析、任务拆解、执行计划制定 |
| Coder | 代码实现、重构、bug 修复 |
| Tester | 编写测试用例、跑测试、覆盖率检查 |
| Reviewer | 代码审查、质量把关、最佳实践建议 |
| Researcher | 技术调研、方案对比、文档整理 |
| Executor | 执行命令、运行脚本、CI/CD 集成 |
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 }
}