第十一章：最佳实践
本章介绍使用 OpenMatrix 的最佳实践。
11.1 质量等级选择
选择指南
| 场景 | 推荐等级 | 原因 |
|---|---|---|
| 核心功能开发 | strict | 需要高质量保障 |
| 安全敏感模块 | strict | 安全要求高 |
| 常规功能开发 | balanced | 平衡质量和效率 |
| 快速原型验证 | fast | 速度优先 |
| Bug 修复 | balanced | 需要测试但不一定需要 TDD |
11.2 任务指令编写
好的指令特点
- 明确的目标
- 清晰的范围
- 可验证的结果
指令示例对比
不好的指令：
做一个用户系统
好的指令：
实现用户认证系统，包括：
1. 用户注册（邮箱验证）
2. 用户登录（JWT token）
3. 密码重置功能
技术要求：
- 使用 bcrypt 加密密码
- JWT 有效期 7 天
11.3 项目配置建议
.openmatrix 配置
{
"defaultQuality": "balanced",
"defaultMode": "semi-auto",
"gates": {
"coverage": { "threshold": 70 },
"lint": { "config": ".eslintrc.js" },
"security": { "ignore": [] }
},
"git": {
"autoCommit": true
}
}
11.4 CI/CD 集成
GitHub Actions 配置
name: OpenMatrix Quality Gate
on:
pull_request:
branches: [main]
jobs:
quality-gate:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- name: Install dependencies
run: npm ci
- name: Install OpenMatrix
run: npm install -g openmatrix
- name: Run quality checks
run: openmatrix auto --quality strict --bypass-approvals
- name: Upload report
uses: actions/upload-artifact@v3
with:
name: quality-report
path: .openmatrix/report.md
11.5 Meeting 处理建议
减少 Meeting 的方法
- 详细的任务指令 - 减少信息型 Meeting
- 明确的技术选型 - 减少决策型 Meetings
- 完整的依赖准备 - 减少依赖型 Meetings
批量处理
# 查看所有 Meeting
/om:meeting
# 优先处理关键路径
/om:meeting MEETING-001 --answer '{"decision": "..."}'
11.6 团队协作
分支策略
main
├── develop
│ ├── feature/user-auth
│ ├── feature/payment
│ └── bugfix/session-issue
└── hotfix/critical-bug
提交规范
<type>(TASK-XXX): <subject>
<body>
Co-Authored-By: OpenMatrix https://github.com/bigfish1913/openmatrix
11.7 故障排查
常见问题
| 问题 | 原因 | 解决方案 |
|---|---|---|
| 状态丢失 | Context 压缩 | 使用 /om:resume |
| 任务阻塞 | 缺少信息 | 处理 Meeting |
| 质量门禁失败 | 测试不足 | 修复代码后重试 |
日志分析
# 查看执行日志
cat .openmatrix/logs/execution.log
# 查看任务上下文
cat .openmatrix/tasks/TASK-XXX/context.md
下一章将介绍 扩展开发。