openmatrix 0.2.25 → 0.2.26

package/skills/start.md

@@ -57,7 +57,7 @@ Step 1:  初始化 .openmatrix 目录
 Step 2:  验证前置条件（plan.md + tasks-input.json 必须已存在）
 Step 3:  智能分析任务类型（开发/非开发）
 Step 4:  提交文档（git add docs/ + 所有 .md 文件, commit）
-Step 5:  必选问题（开发任务:质量+E2E+模式; 非开发:仅模式）<- 不可跳过
+Step 5:  必选问题（开发任务:质量等级; 严格模式可选E2E; 非开发:跳过）<- 不可跳过
 Step 6:  可选问题（仅复杂开发任务）+ 展示执行计划
 Step 7:  调用 openmatrix start --tasks-json                <- 必须完成，不可跳过
 Step 8:  从 CLI 返回结果中读取 subagentTasks 列表           <- 必须完成
@@ -67,7 +67,7 @@ Step 9:  逐个执行 subagentTasks（调用 Agent 工具）          <- 只有
 **违反以下任一规则将导致任务执行失败：**
 
 - **禁止在 Step 9 之前写任何业务代码** — 所有代码必须在 Step 9 通过 Agent 执行
-- **禁止跳过 Step 5 必选问题** — 开发任务必须选质量/E2E/模式，非开发任务必须选模式
+- **禁止跳过 Step 5 必选问题** — 开发任务必须选质量等级，非开发任务无需问答
 - **禁止跳过 Step 7** — 必须调用 CLI，不能用其他方式代替
 - **禁止自行规划 Phase** — 任务由 CLI 的 TaskPlanner 拆分，AI 只提取 goals
 - **禁止用 Bash/npm/write 直接写业务代码** — 业务代码只能通过 Step 9 的 Agent 执行
@@ -80,12 +80,12 @@ Step 9:  逐个执行 subagentTasks（调用 Agent 工具）          <- 只有
 
 本 Skill 只做执行，不做方案生成。如果 plan.md 或 tasks-input.json 不存在，引导用户先执行 /om:plan。
 
-**Step 5 必选问题不可跳过** — 开发任务必须选择：
-1. 质量等级 (strict/balanced/fast)
-2. E2E 测试 (当选择 strict/balanced 时)
-3. 执行模式 (全自动/关键节点确认/每阶段确认)
+**Step 5 必选问题（开发任务）：**
+1. 质量等级（严格模式/平衡模式/快速模式）
+2. E2E 测试（仅严格模式可选，其他模式自动跳过）
+3. 执行模式根据质量等级自动推断（无需问答）
 
-非开发任务（文档、配置等）只需选择执行模式。
+**非开发任务**（文档、配置等）无需问答，直接使用全自动执行。
 </objective>
 
 <process>
@@ -212,9 +212,9 @@ EOF
 
 | goalTypes | 需要询问 |
 |-----------|---------|
-| `development` | 5.1 质量等级 -> 5.2 E2E -> 5.3 执行模式 |
-| `testing` | 仅 5.3 执行模式 |
-| `documentation` / `other` | 仅 5.3 执行模式 |
+| `development` | 5.1 质量等级 -> 5.2 E2E（仅严格模式可选） |
+| `testing` | 无需问答，直接进入 Step 7 |
+| `documentation` / `other` | 无需问答，直接进入 Step 7 |
 
 #### 5.1 质量等级（仅 `goalTypes: development`）
 
@@ -224,11 +224,21 @@ AskUserQuestion: `header: "质量等级"`, `multiSelect: false`
 
 | label | description |
 |-------|-------------|
-| `strict` | TDD + >80%覆盖率 + 严格Lint + 安全扫描 — 生产级代码 |
-| `balanced (推荐)` | >60%覆盖率 + Lint + 安全扫描 — 日常开发 |
-| `fast` | 无质量门禁 — 快速原型/验证 |
+| `严格模式` | TDD + >80%覆盖率 + 严格Lint + 安全扫描 — 生产级代码 |
+| `平衡模式 (推荐)` | >60%覆盖率 + Lint + 安全扫描 — 日常开发 |
+| `快速模式` | 无质量门禁 — 快速原型/验证 |
 
-#### 5.2 E2E 测试（仅 `development` 且选 strict/balanced，选 `fast` 跳过）
+**质量等级选择后的自动推断规则：**
+
+| 模式 | E2E | AI 验收 | 执行方式 |
+|-----|-----|---------|---------|
+| 严格模式 | 可选问一句（Step 5.2） | 必须 | TDD（先测试后开发） |
+| 平衡模式 | 不需要（自动跳过） | 必须 | 先开发后测试 |
+| 快速模式 | 不需要（自动跳过） | 不需要 | 直接开发 |
+
+#### 5.2 E2E 测试（仅 `严格模式` 可选，其他模式自动跳过）
+
+**只有选择「严格模式」时才询问此问题，平衡模式和快速模式自动推断为「不需要」。**
 
 AskUserQuestion: `header: "E2E 测试"`, `multiSelect: false`
 
@@ -240,17 +250,15 @@ AskUserQuestion: `header: "E2E 测试"`, `multiSelect: false`
 | `视觉验证` | 需要浏览器可视化验证，可检查页面样式和布局 |
 | `不需要` | 仅进行单元测试和集成测试，节省时间 |
 
-#### 5.3 执行模式（所有任务必选）
+#### 执行模式自动推断
 
-AskUserQuestion: `header: "执行模式"`, `multiSelect: false`
+**执行模式不再通过问答选择，而是根据质量等级自动推断：**
 
-**question:** 选择执行模式（控制 AI 执行过程中的审批节点）
+- **严格模式** → 全自动执行 + TDD 流程
+- **平衡模式** → 全自动执行 + 先开发后测试
+- **快速模式** → 全自动执行 + 直接开发
 
-| label | description |
-|-------|-------------|
-| `全自动执行 (推荐)` | 全自动执行，无需人工审批，遇到阻塞自动 Meeting |
-| `关键节点确认` | plan/merge/deploy 时暂停确认 |
-| `每阶段确认` | 每个阶段（develop/verify/accept）完成后暂停 |
+**非开发任务**（testing/documentation/other）默认使用「全自动执行」。
 
 ### Step 6: 可选问题（仅复杂任务）
 
@@ -280,31 +288,37 @@ Goals:
 
 ### Step 7: 调用 CLI 创建任务（不可跳过）
 
-**根据任务类型选择正确的 CLI 调用：**
+**根据质量等级自动设置执行参数：**
+
+| 质量等级 | CLI 参数 | 执行方式 |
+|---------|---------|---------|
+| 严格模式 | `--quality strict --mode auto` | TDD 流程 |
+| 平衡模式 | `--quality balanced --mode auto` | 先开发后测试 |
+| 快速模式 | `--quality fast --mode auto` | 直接开发 |
 
 **开发任务**（有质量等级选择）：
 ```bash
-openmatrix start --tasks-json @.openmatrix/tasks-input.json --quality <质量等级> --mode <执行模式> --json
+openmatrix start --tasks-json @.openmatrix/tasks-input.json --quality <质量等级> --mode auto --json
 ```
 
 如果存在 `.openmatrix/research/context.json`，增加 `--research-context` 参数：
 ```bash
-openmatrix start --tasks-json @.openmatrix/tasks-input.json --research-context @.openmatrix/research/context.json --quality <质量等级> --mode <执行模式> --json
+openmatrix start --tasks-json @.openmatrix/tasks-input.json --research-context @.openmatrix/research/context.json --quality <质量等级> --mode auto --json
 ```
 
 如果启用了 E2E 测试（功能测试），加上 `--e2e-tests`：
 ```bash
-openmatrix start --tasks-json @.openmatrix/tasks-input.json --quality balanced --mode auto --e2e-tests --json
+openmatrix start --tasks-json @.openmatrix/tasks-input.json --quality strict --mode auto --e2e-tests --json
 ```
 
 如果选择了视觉验证，加上 `--e2e-tests --e2e-type visual`：
 ```bash
-openmatrix start --tasks-json @.openmatrix/tasks-input.json --quality balanced --mode auto --e2e-tests --e2e-type visual --json
+openmatrix start --tasks-json @.openmatrix/tasks-input.json --quality strict --mode auto --e2e-tests --e2e-type visual --json
 ```
 
-**非开发任务**（无质量等级）：
+**非开发任务**（无质量等级，默认全自动执行）：
 ```bash
-openmatrix start --tasks-json @.openmatrix/tasks-input.json --mode <执行模式> --json
+openmatrix start --tasks-json @.openmatrix/tasks-input.json --mode auto --json
 ```
 
 此命令返回 JSON 包含 `subagentTasks` 列表。
@@ -390,6 +404,53 @@ AskUserQuestion: `header: "歧义确认"`, `multiSelect: false`
 
 #### 9.3 执行 Agent 任务
 
+**Skill 感知执行：**
+
+执行每个任务前，AI 应根据任务内容判断是否需要调用相关 skill 来增强执行质量。
+
+可用 skill 列表（AI 自行判断是否适用）：
+- `om:test` — 测试生成与验证循环
+- `frontend-design` — 前端/UI 设计与实现
+- `om:research` — 领域研究
+- 其他已安装的 skill
+
+**判断流程：**
+1. 读取任务的 `agentType`、`title`、`description`
+2. AI 自行判断该任务是否匹配某个 skill 的触发条件
+3. 如果匹配，在 Agent prompt 中注入该 skill 的核心指令或先调用对应 CLI 获取上下文数据
+4. 如果不匹配任何 skill，直接执行
+
+**tester 任务验证循环（om:test 逻辑）：**
+
+当 AI 判断任务需要 om:test 流程时：
+
+1. 先调用 CLI 获取项目测试配置：
+```bash
+openmatrix test --json
+```
+
+2. 调用 Agent 生成测试（prompt 中已包含原始扫描数据）：
+```typescript
+Agent({
+  subagent_type: task.subagent_type,
+  description: task.description,
+  prompt: task.prompt + "\n\n⚠️ 完成后请输出简短摘要（不超过3行）：\n1. 关键决策\n2. 创建/修改的文件\n3. 对后续任务的建议\n\n🚫 **禁止执行以下 Git 命令**：\n- ❌ git commit\n- ❌ git checkout/merge/pull/push/rebase/branch\n\n✅ 允许：git status, git diff, git log",
+  run_in_background: true
+})
+```
+
+3. Agent 完成后，自动验证测试：
+```bash
+npm test -- --run 2>&1
+```
+
+4. 验证失败时自动重试（最多 3 次）：
+   - 将失败输出传给新 Agent 修复测试
+   - 重新验证
+   - 3 次失败后标记为 blocked，创建 Meeting
+
+**默认执行方式（无特殊 skill 匹配时）：**
+
 ```typescript
 Agent({
   subagent_type: task.subagent_type,
@@ -523,11 +584,11 @@ start 和 auto 在同一位置，区别在于 start 有交互审批，auto 零
 
 ## 质量级别
 
-| 级别 | TDD | 覆盖率 | Lint | 安全 |
-|------|:---:|:------:|:----:|:----:|
-| strict | Y | >80% | Y | Y |
-| balanced | N | >60% | Y | Y |
-| fast | N | 无 | N | N |
+| 级别 | TDD | 覆盖率 | Lint | 安全 | 执行方式 |
+|------|:---:|:------:|:----:|:----:|:--------:|
+| 严格模式 | Y | >80% | Y | Y | TDD |
+| 平衡模式 | N | >60% | Y | Y | 先开发后测试 |
+| 快速模式 | N | 无 | N | N | 直接开发 |
 
 ## 执行流程
 
@@ -537,6 +598,14 @@ Step 1-2: 初始化 + 验证前置条件 -> Step 3-4: 分析类型 + 提交文
 -> Step 9: Agent 逐个执行 (只有这里写代码)
 ```
 
+## 自动推断规则
+
+| 质量等级 | E2E 问题 | AI 验收 | 执行模式 |
+|---------|---------|---------|---------|
+| 严格模式 | 可选问一句 | 必须 | 全自动 + TDD |
+| 平衡模式 | 不需要 | 必须 | 全自动 + 先开发后测试 |
+| 快速模式 | 不需要 | 不需要 | 全自动 + 直接开发 |
+
 ## Git 提交格式
 
 ```