openmatrix 0.2.25 → 0.2.27

package/README.md

@@ -1,595 +1,155 @@
-# OpenMatrix
-
-<div align="center">
-
-**同时实现 TDD + 严格质量门禁 + 全自动执行的 AI 任务编排系统**
-
-*自动化 ≠ 牺牲质量 | 高质量 ≠ 手动操作*
-
-[![npm version](https://img.shields.io/npm/v/openmatrix.svg?color=blue&label=npm)](https://www.npmjs.com/package/openmatrix)
-[![npm downloads](https://img.shields.io/npm/dm/openmatrix.svg?color=green&label=downloads)](https://www.npmjs.com/package/openmatrix)
-[![GitHub stars](https://img.shields.io/github/stars/bigfish1913/openmatrix.svg?style=social&label=Star)](https://github.com/bigfish1913/openmatrix/stargazers)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Node](https://img.shields.io/badge/Node-%3E%3D18.0.0-green.svg)](https://nodejs.org/)
-[![Claude Code](https://img.shields.io/badge/Claude%20Code-Compatible-blue.svg)](https://claude.ai/code)
-
-**[📚 官方文档](https://matrix.laofu.online/docs/)** | **[🚀 快速开始](https://matrix.laofu.online/docs/getting-started/)** | **[💬 GitHub](https://github.com/bigfish1913/openmatrix)**
-
-**[中文](README.md)** | **[English](README_EN.md)**
-
-</div>
-
----
-
-## 一句话介绍
-
-```bash
-/om 实现用户登录
-# 自动启动任务编排，第一个问题选质量级别，然后全自动执行
-```
-
-> `/om` 是 `/om:start` 的快捷方式，功能完全相同
-
-### 🪄 自动调用 (无需输入命令)
-
-安装后，直接输入任务描述即可自动调用:
-
-```
-用户输入: 实现用户登录功能
-     ↓
-自动调用: /om:start 实现用户登录功能
-```
-
-**触发场景:**
-
-| 用户输入 | 触发原因 |
-|---------|---------|
-| `实现用户登录功能` | 功能开发 |
-| `登录页面报错了` | Bug 修复 |
-| `性能太慢需要优化` | 性能优化 |
-| `写个单元测试` | 测试相关 |
-| `做个完整的用户系统` | 多组件任务 |
-| `从零搭建一个后台` | 多步骤项目 |
-| `前端+后端+数据库` | 全栈工作 |
-
-**关键词触发:**
-- `实现...` / `添加...` / `修复...` / `优化...` / `测试...`
-- `支持...` / `需要...` / `想要...` / `要做...`
-- `implement...` / `add...` / `fix...` / `build...`
-- 任务文档路径: `docs/task.md`
-
-**不触发的情况:**
-- 问问题: "怎么实现登录?" / "如何配置?"
-- 查信息: "显示配置" / "列出文件"
-- 导航: "打开目录" / "进入文件夹"
-
----
-
-## 执行流程概览
-
-```
-用户输入 → 质量选择 → 任务规划 → 执行 → 质量门禁 → AI验收 → Meeting处理 → 完成
-```
-
-| 阶段 | 说明 | 关键点 |
-|:----:|------|--------|
-| 0 | 交互问答 | **第一个问题选质量级别** |
-| 1 | 任务规划 | Planner Agent 生成计划 |
-| 2 | 任务执行 | strict/balanced/fast 三种模式 |
-| 3 | 质量门禁 | 7 道质量门禁验证 |
-| 4 | AI 验收 | Reviewer Agent 最终确认 |
-| 5 | Meeting | 阻塞不中断，最后处理并**重新执行** |
-| 6 | 最终报告 | 质量评分 + 产出文件 |
-
-📖 **详细流程图**: [docs/FLOW.md](docs/FLOW.md) (含 Mermaid 图表)
-
----
-
-## 为什么选择 OpenMatrix？
-
-### 与 superpowers / gsd 对比
-
-| 特性 | OpenMatrix | superpowers | gsd |
-|------|:----------:|:-----------:|:---:|
-| **100% 自动化** | ✅ auto 模式 | ❌ 50% | ❌ 60% |
-| **TDD 内置** | ✅ strict 模式 | ❌ 需手动 | ❌ 无 |
-| **覆盖率强制** | ✅ 60-80% | ❌ 无 | ❌ 无 |
-| **安全扫描** | ✅ npm audit | ❌ 无 | ❌ 无 |
-| **AI 验收** | ✅ Reviewer Agent | ❌ 无 | 部分 |
-| **阻塞不中断** | ✅ Meeting 机制 | ❌ 停止 | ❌ 停止 |
-| **质量报告** | ✅ JSON + MD | ❌ 无 | 部分 |
-| **上手难度** | ⚡ 一句话开始 | 中等 | 较高 |
-
----
-
-## 快速开始
-
-### 安装
-
-**方式一: NPM 安装 (推荐)**
-
-```bash
-# 全局安装
-npm install -g openmatrix
-
-# Skills 会自动安装到 ~/.claude/commands/om/
-# 如果自动安装失败，手动执行:
-openmatrix install-skills
-```
-
-**方式二: 从源码安装**
-
-```bash
-# 克隆并安装
-git clone https://github.com/bigfish1913/openmatrix.git
-cd openmatrix && npm install && npm run build && npm link
-
-# 安装 Skills (如果 postinstall 未自动执行)
-openmatrix install-skills
-```
-
-### 验证安装
-
-```bash
-# 检查 CLI 是否可用
-openmatrix --version
-
-# 检查 Skills 是否安装成功
-openmatrix install-skills
-# 或直接查看
-ls ~/.claude/commands/om/
-# 应显示: start.md  auto.md  status.md  approve.md  meeting.md  resume.md  retry.md  report.md
-```
-
-### 第一次使用
-
-```bash
-/om:start 实现用户登录功能
-
-# 系统会先问:
-┌─────────────────────────────────────────────────────────┐
-│ 问题 0: 选择质量级别                                     │
-├─────────────────────────────────────────────────────────┤
-│ 🚀 strict   → TDD + 80%覆盖率 + AI验收 (推荐生产代码)    │
-│ ⚖️ balanced  → 60%覆盖率 + AI验收 (日常开发)            │
-│ ⚡ fast      → 无质量门禁 (快速原型)                     │
-└─────────────────────────────────────────────────────────┘
-```
-
----
-
-## 核心特性
-
-### 1️⃣ 三级质量配置 (第一个问题就让你选)
-
-| 级别 | TDD | 覆盖率 | Lint | 安全 | E2E测试 | AI验收 | 适用场景 |
-|:----:|:---:|:------:|:----:|:----:|:-------:|:------:|---------|
-| **strict** | ✅ | >80% | ✅ 严格 | ✅ | ❓ 可选 | ✅ | 🏭 **生产代码** |
-| **balanced** | ❌ | >60% | ✅ | ✅ | ❓ 可选 | ✅ | 📦 日常开发 |
-| **fast** | ❌ | >20% | ❌ | ❌ | ❌ | ❌ | 🏃 快速原型 |
-
-> E2E 测试耗时较长，建议根据项目需要选择。strict 可配置为 100%。默认 >80% 覆盖核心业务逻辑。
-
-### 2️⃣ 七道质量门禁 (Verify 阶段)
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│                    Verify 阶段 - 质量门禁                     │
-├─────────────────────────────────────────────────────────────┤
-│  🚪 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 7: 验收标准     用户定义         → 必须全部满足   │
-└─────────────────────────────────────────────────────────────┘
-```
-
-### 3️⃣ TDD 模式 (strict 级别)
-
-```
-传统开发:  代码 → 测试 → Bug → 修复 → 回归 → ... (循环多次)
-
-OpenMatrix TDD (strict):
-  🧪 测试阶段: 先写测试 (RED - 测试必须失败)
-  ✨ 开发阶段: 再写代码 (GREEN - 测试必须通过)
-  ✅ 验证阶段: 7道质量门禁
-  🎉 验收阶段: AI Reviewer 最终确认
-
-结果: 第一次就写对，无需返工
-```
-
-### 4️⃣ Meeting 机制 (阻塞不中断)
-
-```
-❌ 其他方案:
-   TASK-001 ✓ → TASK-002 阻塞 ⏸️ → 等用户... (浪费时间)
-
-✅ OpenMatrix:
-   TASK-001 ✓ → TASK-002 阻塞 → 创建Meeting → 跳过 ↷
-   TASK-003 ✓ → TASK-004 ✓ → 完成!
-   → 用户用 /om:meeting 统一处理所有阻塞
-```
-
-### 5️⃣ AI 验收 (Accept 阶段)
-
-```
-Accept 阶段由 Reviewer Agent 执行:
-├── 检查 verify-report.md
-├── 验证所有验收标准
-├── 确认代码可合并
-└── 生成 accept-report.md
-```
-
----
-
-## 执行流程
-
-### strict 模式 (推荐生产代码)
-
-```
-┌─────────┐     ┌─────────┐     ┌─────────┐     ┌─────────┐
-│   TDD   │────▶│ Develop │────▶│  Verify │────▶│ Accept  │
-│ 🧪 RED  │     │ ✨ GREEN│     │ ✅ 7门禁│     │ 🎉 AI   │
-└─────────┘     └─────────┘     └─────────┘     └─────────┘
-```
-
-### balanced 模式 (日常开发)
-
-```
-┌─────────┐     ┌─────────┐     ┌─────────┐
-│ Develop │────▶│  Verify │────▶│ Accept  │
-│ ✨ 编码 │     │ ✅ 4门禁│     │ 🎉 AI   │
-└─────────┘     └─────────┘     └─────────┘
-```
-
----
-
-## Skills 命令
-
-| 命令 | 用途 |
-|------|------|
-| `/om` | **默认入口** - 直接输入任务描述即可启动 |
-| `/om:brainstorm` | 🧠 **头脑风暴** - 先探索需求和设计，再执行任务 |
-| `/om:research` | 📚 **领域调研** - AI 驱动的领域调研和问题探索 |
-| `/om:debug` | 🔧 **系统化调试** - 四阶段根因分析 + 自动修复验证循环 |
-| `/om:feature` | ⚡ **轻量小需求** - 快速迭代小功能，无完整任务追踪 |
-| `/om:start` | 启动新任务 (第一个问题选质量级别) |
-| `/om:auto` | 🚀 **全自动执行** - 无阻塞、无确认、直接完成 |
-| `/check` | 🔍 **项目检查** - 自动检测可改进点并提供升级建议 |
-| `/om:status` | 查看状态 |
-| `/om:approve` | 审批决策 |
-| `/om:meeting` | 处理阻塞问题 |
-| `/om:resume` | **智能恢复** - 自动检测轻量/完整流程并恢复中断任务 |
-| `/om:retry` | 重试失败 |
-| `/om:report` | 生成报告 |
-
-> `/om` 是 `/om:start` 的快捷方式，功能完全相同
-
-### `/om:debug` 系统化调试
-
-**适用场景**: Bug 修复、测试失败、异常行为、构建失败
-
-```bash
-/om:debug                          # 交互式调试
-/om:debug --task TASK-003          # 调试指定失败任务
-/om:debug "API 返回 500 错误"      # 带问题描述调试
-```
-
-**四阶段流程**:
-
-```
-Step 1: 接收问题
-    ↓
-Step 2: CLI 初始化会话
-    ↓
-Step 3: 根因调查（只读，Explore Agent）
-    ↓
-Step 4: 模式分析（只读，Explore Agent）
-    ↓
-Step 5: 展示诊断报告
-    ↓
-    ⛔ 必须等待用户确认是否修复
-    ↓
-Step 6: 用户选择是否修复
-    ├─ "仅查看报告" → 输出报告后结束
-    ├─ "继续深入调查" → 回到 Step 3
-    └─ "需要修复" ↓
-Step 7: 选择修复策略（自动/手动）
-    ↓
-Step 8: 实施修复（Agent）
-    ↓
-Step 9: 自动验证修复（无需用户确认）
-    ├─ 验证通过 → 进入报告阶段 ✅
-    └─ 验证失败 → 自动循环重试（最多3次）
-        ├─ < 3次 → 自动回到 Step 8 重新修复
-        └─ >= 3次 → 暂停，质疑架构 ⚠️
-Step 10: 输出 Debug Report
-```
-
-**铁律**:
-- 不做根因调查，不许提修复方案
-- 验证失败自动循环，无需用户手动确认
-- 最大重试 3 次，超过必须暂停质疑架构
-
-### `/om:feature` 轻量小需求
-
-**适用场景**: 小功能、小改动、快速迭代（≤100字描述，单一功能点）
-
-```bash
-/om:feature 给用户列表页添加搜索功能
-/om:feature 添加一个导出按钮
-/om:feature docs/small-task.md
-```
-
-**触发条件**（从 `/om` 主入口自动路由）:
-- 任务描述 ≤ 100 字
-- 单一功能点（无多个独立子系统）
-- 不涉及架构设计/技术选型
-- 关键词匹配：小需求、小功能、小改动、minor、quick、快速
-
-**与标准流程对比**:
-
-| 特性 | `/om:feature` | `/om:start` |
-|------|---------------|-------------|
-| 任务文件 | ❌ 无 `.openmatrix/tasks/` | ✅ 有完整任务追踪 |
-| 问答确认 | 质量 + E2E | 质量 + E2E + 模式 |
-| 任务拆分 | AI 自动拆分 2-5 块 | Planner Agent 生成计划 |
-| Git 提交 | 分步提交（每块完成后） | 最终统一提交 |
-| 恢复机制 | `/om:resume` (自动检测) | `/om:resume` |
-
-**铁律**:
-- 不验证不得提交，验证失败必须停止
-- 每次只改一个任务块，不得并行修改
-- 验证通过后立即提交，不得积累多个任务块
-
-### `/check` 项目检查
-
-**适用场景**: 代码质量检查、安全审计、AI 项目配置检查
-
-```bash
-/check                    # 自动扫描当前项目
-/check 安全               # 聚焦安全问题
-/check --categories skill,prompt,agent  # 检查 AI 项目配置
-/check --auto             # 自动执行所有改进
-```
-
-**检测维度**:
-
-| 类别 | 说明 | 示例 |
-|------|------|------|
-| 🐛 bug | 代码缺陷 | TODO, FIXME, 潜在bug |
-| 🔧 quality | 代码质量 | 过长函数, 复杂度, 重复代码 |
-| 📦 capability | 缺失能力 | 缺少测试, 文档, 类型定义 |
-| 🔒 security | 安全问题 | 硬编码密钥, SQL注入 |
-| 🤖 prompt | Prompt 问题 | 注入风险, 缺少格式说明 |
-| ⚡ skill | Skill 问题 | 缺少 frontmatter, objective |
-| 🧠 agent | Agent 配置 | CLAUDE.md 缺少构建命令 |
-
-**支持项目类型**: OpenMatrix, AI项目, Node.js, TypeScript, Python, Go, Rust, Java, C#, C/C++, PHP, Dart
-
-### `/om:start` 执行流程 (含 Meeting 机制)
-
-```
-┌──────────────────────────────────────────────────────────────────────────┐
-│                            执行阶段                                       │
-├──────────────────────────────────────────────────────────────────────────┤
-│                                                                          │
-│  TASK-001 ✅ ──→ TASK-002 ⚠️阻塞 ──→ 创建Meeting ──→ 跳过 ↷             │
-│                      │                                                   │
-│                      ↓                                                   │
-│  TASK-003 ✅ ──→ TASK-004 ✅ ──→ TASK-005 ✅ ──→ 所有任务执行完成        │
-│                                                                          │
-└──────────────────────────────────────────────────────────────────────────┘
-                                    │
-                                    ▼
-┌──────────────────────────────────────────────────────────────────────────┐
-│                         Meeting 自动检测                                  │
-├──────────────────────────────────────────────────────────────────────────┤
-│                                                                          │
-│                    ┌─────────────────────┐                               │
-│                    │ 有 pending Meeting? │                               │
-│                    └──────────┬──────────┘                               │
-│                          ╱    \                                          │
-│                        否      是                                        │
-│                        │       │                                         │
-│                        ▼       ▼                                         │
-│                   ┌───────┐ ┌─────────────────────────────┐              │
-│                   │ 完成! │ │  📋 交互式处理 Meeting       │              │
-│                   └───────┘ │  ┌─────────────────────────┐│              │
-│                             │  │ [1] TASK-002: 数据库连接││              │
-│                             │  │     💡提供信息 / ⏭️跳过  ││              │
-│                             │  │ [2] TASK-005: API决策   ││              │
-│                             │  │     🤔选择方案          ││              │
-│                             │  └─────────────────────────┘│              │
-│                             └──────────────┬──────────────┘              │
-│                                            │                              │
-│                                            ▼                              │
-│                             ┌─────────────────────────────┐              │
-│                             │   用户提供信息/选择方案      │              │
-│                             │         ↓                   │              │
-│                             │   🔄 重新执行阻塞任务        │              │
-│                             │   TASK-002 ✅               │              │
-│                             └──────────────┬──────────────┘              │
-│                                            │                              │
-└────────────────────────────────────────────┼──────────────────────────────┘
-                                             │
-                                             ▼
-                                      ┌───────────┐
-                                      │  完成! 🎉  │
-                                      └───────────┘
-```
-
-### `/om:auto` 全自动模式
-
-**适用场景**: CI/CD、自动化脚本、无需人工干预的任务
-
-```bash
-/om:auto 实现用户登录功能              # 默认 strict 模式
-/om:auto --mode=balanced 添加API接口   # 指定 balanced 模式
-/om:auto --fast 创建CLI工具            # 快速原型模式
-```
-
-**特点**:
-- ❌ 无审批点确认
-- ❌ 无 Phase 间暂停
-- ❌ Meeting 自动跳过 (记录但不阻塞)
-- ✅ 默认 strict 质量级别
-- ✅ 适合 CI/CD 集成
-
-**与 `/om:start` 对比**:
-
-| 特性 | `/om:start` | `/om:auto` |
-|------|-------------|------------|
-| 质量级别 | 交互式选择 | 参数指定/默认 strict |
-| 审批确认 | 根据配置 | 全部跳过 |
-| Meeting | 交互式处理 | 自动跳过 |
-| 适用场景 | 日常开发 | CI/CD、自动化 |
-
----
-
-## 质量报告
-
-每个任务完成后生成:
-
-```json
-{
-  "taskId": "TASK-001",
-  "overall": "pass",
-  "tests": { "passed": 15, "failed": 0, "coverage": 82 },
-  "build": { "success": true },
-  "lint": { "errors": 0, "warnings": 3 },
-  "security": { "vulnerabilities": [] },
-  "e2e": { "passed": 5, "failed": 0, "skipped": 0 },
-  "acceptance": { "met": 5, "total": 5 }
-}
-```
-
-## 状态存储
-
-任务状态持久化在 `.openmatrix/` 目录:
-
-```
-.openmatrix/
-├── state.json              # 全局状态 (runId, status, config, statistics)
-├── plan.md                 # AI 生成的执行计划
-├── tasks-input.json        # 任务输入 (goals, constraints, deliverables)
-├── tasks/
-│   └── TASK-001/
-│       ├── task.json       # 任务定义 + 状态 + 阶段信息
-│       ├── context.md      # Agent 上下文 (供后续 Agent 读取)
-│       ├── develop.json    # 开发阶段结果
-│       ├── verify.json     # 验证阶段结果 (质量门禁)
-│       ├── accept.json     # 验收阶段结果
-│       └── artifacts/      # 产出文件 (result.md, quality-report.json 等)
-├── approvals/              # 审批记录
-└── meetings/               # Meeting 记录
-```
-
----
-
-## 多语言支持
-
-OpenMatrix 通过 Claude Code Agent 工具**原生支持所有主流编程语言**：
-
-| 语言 | 测试命令 | 构建命令 |
-|------|---------|---------|
-| TypeScript/JavaScript | `npm test` / `vitest` | `npm run build` |
-| Python | `pytest` | `python -m build` |
-| Go | `go test ./...` | `go build` |
-| Java | `mvn test` | `mvn compile` |
-| Rust | `cargo test` | `cargo build` |
-| 其他 | 任意 CLI 命令 | 任意 CLI 命令 |
-
-**无需额外配置** — Agent 可执行任意 shell 命令，Claude 理解所有主流语言。
-
----
-
-## 常见问题
-
-### Q: 哪种质量级别适合我？
-
-| 你的场景 | 推荐级别 |
-|---------|---------|
-| 🏭 生产代码、核心功能 | **strict** |
-| 📦 日常功能开发 | **balanced** |
-| 🏃 快速原型、POC | **fast** |
-
-### Q: OpenMatrix 和 superpowers 可以一起用吗？
-
-**A**: 可以！OpenMatrix 自动执行任务，superpowers 提供额外技能。
-
-### Q: Meeting 是什么？
-
-**A**: 遇到阻塞时创建记录，但**不停止执行**。最后用 `/om:meeting` 统一处理。
-
----
-
-## 配置
-
-`.openmatrixrc.json`:
-
-```json
-{
-  "quality": {
-    "tdd": false,
-    "minCoverage": 60,
-    "strictLint": true,
-    "securityScan": true,
-    "e2eTests": false
-  },
-  "approvalPoints": ["plan", "merge"],
-  "agents": { "maxConcurrent": 3 }
-}
-```
-
----
-
-## 开发
-
-```bash
-git clone https://github.com/bigfish1913/openmatrix.git
-cd openmatrix && npm install && npm run build && npm test
-```
-
----
-
-## Roadmap
-
-- [x] TDD 模式
-- [x] 7 道质量门禁
-- [x] Meeting 机制
-- [x] 质量报告
-- [x] AI 验收
-- [x] `/om:auto` 全自动模式
-- [x] `/om:brainstorm` 头脑风暴模式
-- [x] 多语言支持 (Python/Go/Java/TypeScript 等)
-- [x] E2E 测试支持 (Web/Mobile/GUI)
-- [x] Agent 上下文共享 (Agent Memory)
-- [x] Task 子目录结构 + Phase 结果持久化
-- [x] 执行循环持久化 (`openmatrix step`/`complete` 防上下文压缩丢失)
-- [x] `/om:research` AI 驱动领域调研
-- [x] Git 自动提交 (任务完成后自动 commit)
-- [x] Brainstorm/Start 智能状态检测
-- [x] AI 目标类型标注 (智能识别开发/测试/文档任务)
-- [x] 系统集成任务 (多模块自动组装)
-- [x] 智能项目检测 (gitignore 根据技术栈自动写入)
-- [x] Git 父级目录支持 (子目录中正常执行 git 操作)
-- [x] `/om:debug` 系统化调试 (四阶段根因分析 + 自动修复验证循环)
-- [x] `/om:feature` 轻量小需求 (快速迭代，分步 Git 提交)
-- [x] `/om:resume` 智能恢复 (自动检测轻量/完整流程)
-- [ ] VSCode 扩展
-- [ ] CI/CD 集成
-
----
-
-<div align="center">
-
-**如果觉得有用，请给个 ⭐ Star！**
-
-[![Star History Chart](https://api.star-history.com/svg?repos=bigfish1913/openmatrix&type=Date)](https://star-history.com/#bigfish1913/openmatrix&Date)
-
-MIT © 2024 | Made by [bigfish1913](https://github.com/bigfish1913)
-
-</div>
+# OpenMatrix
+
+<div align="center">
+
+**你的代码没测试？OpenMatrix 自动帮你补，覆盖率 >80%**
+
+*自动化 ≠ 牺牲质量 | 高质量 ≠ 手动操作*
+
+[![npm version](https://img.shields.io/npm/v/openmatrix.svg?color=blue&label=npm)](https://www.npmjs.com/package/openmatrix)
+[![npm downloads](https://img.shields.io/npm/dm/openmatrix.svg?color=green&label=downloads)](https://www.npmjs.com/package/openmatrix)
+[![GitHub stars](https://img.shields.io/github/stars/bigfish1913/openmatrix.svg?style=social&label=Star)](https://github.com/bigfish1913/openmatrix/stargazers)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Claude Code](https://img.shields.io/badge/Claude%20Code-Compatible-blue.svg)](https://claude.ai/code)
+
+**[中文](README.md)** | **[English](README_EN.md)**
+
+</div>
+
+---
+
+## 30秒演示
+
+```
+/om 实现用户登录功能
+
+# 自动启动任务编排 → 选择质量级别 → 全自动执行 → 质量门禁 → AI验收 → 完成
+```
+
+> `/om` 是 `/om:start` 的快捷方式。直接输入任务描述即可自动触发。
+
+---
+
+## 三种质量模式
+
+| 模式 | 覆盖率 | 测试 | Lint | 安全 | 适用场景 |
+|:----:|:------:|:----:|:----:|:----:|---------|
+| **strict** | >80% | TDD 先写测试 | 严格 | npm audit | 生产代码 |
+| **balanced** | >60% | 后补测试 | 标准 | npm audit | 日常开发 |
+| **fast** | >20% | 可选 | 无 | 无 | 快速原型 |
+
+> E2E 测试可选（Playwright/Cypress/Appium）
+
+---
+
+## 快速开始
+
+```bash
+# 安装
+npm install -g openmatrix
+
+# 验证
+openmatrix --version
+
+# 使用
+/om 实现用户登录
+```
+
+---
+
+## 核心命令
+
+| 命令 | 用途 |
+|------|------|
+| `/om` | 默认入口 - 直接输入任务描述 |
+| `/om:test` | 自动补测试 - 给现有代码补充测试 |
+| `/om:debug` | 系统化调试 - 四阶段根因分析 + 自动修复 |
+| `/om:feature` | 轻量小需求 - 快速迭代，无完整任务追踪 |
+| `/om:brainstorm` | 头脑风暴 - 先探索需求和设计 |
+| `/om:auto` | 全自动执行 - 无阻塞、无确认、适合 CI/CD |
+
+---
+
+## 七道质量门禁
+
+```
+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 7: 验收标准    用户定义         → 必须全部满足
+```
+
+---
+
+## 与 superpowers 配合
+
+OpenMatrix 自动执行任务 + superpowers 提供额外技能 = 完美组合
+
+```bash
+# superpowers 写代码，OpenMatrix 保证质量
+/om 实现用户登录    # 自动 TDD + 质量门禁 + AI 验收
+```
+
+---
+
+## 详细文档
+
+| 文档 | 内容 |
+|------|------|
+| [执行流程图](docs/FLOW.md) | 完整流程图和阶段说明 |
+| [开发路线图](docs/ROADMAP.md) | 功能规划和进度 |
+| [系统架构](docs/ARCHITECTURE.md) | 核心组件和设计 |
+| [术语对照表](docs/TERMINOLOGY.md) | 中英文术语对照 |
+
+---
+
+## 常见问题
+
+**Q: 哪种质量级别适合我？**
+
+| 场景 | 推荐模式 |
+|------|---------|
+| 生产代码、核心功能 | strict |
+| 日常功能开发 | balanced |
+| 快速原型、POC | fast |
+
+**Q: Meeting 是什么？**
+
+A: 遇到阻塞时创建记录，但**不停止执行**。最后用 `/om:meeting` 统一处理所有阻塞。
+
+**Q: 支持哪些语言？**
+
+A: 原生支持 TypeScript/JavaScript、Python、Go、Java、Rust 等所有主流语言。
+
+---
+
+## 配置示例
+
+```json
+{
+  "quality": {
+    "tdd": false,
+    "minCoverage": 60,
+    "strictLint": true,
+    "securityScan": true,
+    "e2eTests": false
+  },
+  "approvalPoints": ["plan", "merge"],
+  "agents": { "maxConcurrent": 3 }
+}
+```
+
+---
+
+<div align="center">
+
+**如果觉得有用，请给个 Star！**
+
+[![Star History Chart](https://api.star-history.com/svg?repos=bigfish1913/openmatrix&type=Date)](https://star-history.com/#/bigfish1913/openmatrix&Date)
+
+MIT | Made by [bigfish1913](https://github.com/bigfish1913)
+
+</div>