openmatrix 0.1.97 → 0.1.99

package/skills/meeting.md

@@ -47,22 +47,17 @@ description: 查看和处理所有待确认的 Meeting（阻塞问题和决策
 
 4. **使用 AskUserQuestion 选择处理哪个 Meeting**
 
-   ```typescript
-   AskUserQuestion({
-     questions: [{
-       question: "请选择要处理的 Meeting:",
-       header: "选择 Meeting",
-       options: [
-         { label: "[1] TASK-001 - 数据库连接失败", description: "阻塞 - 需要信息" },
-         { label: "[2] TASK-003 - API设计决策", description: "决策 - 技术选型" },
-         { label: "[3] TASK-005 - API密钥缺失", description: "阻塞 - 需要信息" },
-         { label: "全部跳过", description: "标记所有 Meeting 为跳过" },
-         { label: "返回", description: "暂不处理" }
-       ],
-       multiSelect: false
-     }]
-   })
-   ```
+   **先在界面展示 Meeting 列表详情，再用简短 AskUserQuestion 让用户选择：**
+
+   AskUserQuestion: `header: "选择 Meeting"`, `multiSelect: false`
+   **question:** 请选择要处理的 Meeting（详情已展示在上方）
+
+   | label | description |
+   |-------|-------------|
+   | [1] TASK-001 - 数据库连接失败 | 阻塞 - 需要信息 |
+   | [2] TASK-003 - API设计决策 | 决策 - 技术选型 |
+   | 全部跳过 | 标记所有 Meeting 为跳过 |
+   | 返回 | 暂不处理 |
 
 5. **处理单个 Meeting**
 
@@ -92,37 +87,25 @@ description: 查看和处理所有待确认的 Meeting（阻塞问题和决策
    [D] ✏️ 修改方案 - 调整任务执行方案
    ```
 
-   **使用 AskUserQuestion:**
-   ```typescript
-   AskUserQuestion({
-     questions: [{
-       question: "请选择操作:",
-       header: "处理阻塞",
-       options: [
-         { label: "💡 提供信息", description: "提供解决问题所需的信息" },
-         { label: "⏭️ 跳过任务", description: "标记为可选，继续执行下游任务" },
-         { label: "🔄 重试", description: "使用新信息重试此任务" },
-         { label: "✏️ 修改方案", description: "调整任务执行方案" },
-         { label: "返回列表", description: "暂不处理" }
-       ],
-       multiSelect: false
-     }]
-   })
-   ```
+   **使用 AskUserQuestion（阻塞详情已展示在上方）：**
+
+   AskUserQuestion: `header: "处理阻塞"`, `multiSelect: false`
+   **question:** 请选择操作
+
+   | label | description |
+   |-------|-------------|
+   | 提供信息 | 提供解决问题所需的信息 |
+   | 跳过任务 | 标记为可选，继续执行下游任务 |
+   | 重试 | 使用新信息重试此任务 |
+   | 修改方案 | 调整任务执行方案 |
+   | 返回列表 | 暂不处理 |
 
 6. **处理具体选择**
 
    **如果选择"提供信息":**
-   ```typescript
-   AskUserQuestion({
-     questions: [{
-       question: "请提供解决此阻塞所需的信息:",
-       header: "详细信息",
-       options: [], // 允许自由输入
-       multiSelect: false
-     }]
-   })
-   ```
+
+   AskUserQuestion: `header: "详细信息"`, `multiSelect: false`
+   **question:** 请提供解决此阻塞所需的信息
 
    然后执行：
    ```bash
@@ -131,19 +114,14 @@ description: 查看和处理所有待确认的 Meeting（阻塞问题和决策
    ```
 
    **如果选择"跳过任务":**
-   ```typescript
-   AskUserQuestion({
-     questions: [{
-       question: "确定要跳过此任务吗？",
-       header: "确认",
-       options: [
-         { label: "确认跳过", description: "标记为可选，继续下游" },
-         { label: "取消", description: "返回" }
-       ],
-       multiSelect: false
-     }]
-   })
-   ```
+
+   AskUserQuestion: `header: "确认"`, `multiSelect: false`
+   **question:** 确定要跳过此任务吗？
+
+   | label | description |
+   |-------|-------------|
+   | 确认跳过 | 标记为可选，继续下游 |
+   | 取消 | 返回 |
 
    然后执行：
    ```bash
@@ -156,16 +134,9 @@ description: 查看和处理所有待确认的 Meeting（阻塞问题和决策
    ```
 
    **如果选择"修改方案":**
-   ```typescript
-   AskUserQuestion({
-     questions: [{
-       question: "请描述修改后的方案:",
-       header: "新方案",
-       options: [], // 允许自由输入
-       multiSelect: false
-     }]
-   })
-   ```
+
+   AskUserQuestion: `header: "新方案"`, `multiSelect: false`
+   **question:** 请描述修改后的方案
 
    然后执行：
    ```bash
@@ -204,23 +175,18 @@ description: 查看和处理所有待确认的 Meeting（阻塞问题和决策
    [C] 自定义方案
    ```
 
-   **使用 AskUserQuestion:**
-   ```typescript
-   AskUserQuestion({
-     questions: [{
-       question: "请做出决策:",
-       header: "技术决策",
-       options: [
-         { label: "选择方案 1: REST", description: "简单直观，团队熟悉" },
-         { label: "选择方案 2: GraphQL", description: "灵活查询，强类型" },
-         { label: "自定义方案", description: "输入其他方案" },
-         { label: "需要更多信息", description: "暂不决策，等待调研" },
-         { label: "返回列表", description: "返回 Meeting 列表" }
-       ],
-       multiSelect: false
-     }]
-   })
-   ```
+   **使用 AskUserQuestion（方案详情已展示在上方）：**
+
+   AskUserQuestion: `header: "技术决策"`, `multiSelect: false`
+   **question:** 请做出决策
+
+   | label | description |
+   |-------|-------------|
+   | 选择方案 1: REST | 简单直观，团队熟悉 |
+   | 选择方案 2: GraphQL | 灵活查询，强类型 |
+   | 自定义方案 | 输入其他方案 |
+   | 需要更多信息 | 暂不决策，等待调研 |
+   | 返回列表 | 返回 Meeting 列表 |
 
    执行决策：
    ```bash
@@ -257,19 +223,14 @@ description: 查看和处理所有待确认的 Meeting（阻塞问题和决策
 9. **批量处理**
 
    如果选择"全部跳过":
-   ```typescript
-   AskUserQuestion({
-     questions: [{
-       question: "确定要跳过所有 Meeting 吗？",
-       header: "批量操作",
-       options: [
-         { label: "确认全部跳过", description: "标记所有为可选" },
-         { label: "取消", description: "返回列表" }
-       ],
-       multiSelect: false
-     }]
-   })
-   ```
+
+   AskUserQuestion: `header: "批量操作"`, `multiSelect: false`
+   **question:** 确定要跳过所有 Meeting 吗？
+
+   | label | description |
+   |-------|-------------|
+   | 确认全部跳过 | 标记所有为可选 |
+   | 取消 | 返回列表 |
 
    ```bash
    openmatrix meeting --skip-all --message "批量跳过"

package/skills/start.md

@@ -124,92 +124,50 @@ git init
 
 ---
 
-## ⚠️⚠️⚠️ 以下 Step 4 不可跳过 ⚠️⚠️⚠️
+### Step 4: 必选问题（不可跳过，不可使用默认值，必须通过 AskUserQuestion 让用户选择）
 
-**无论任务类型、复杂度、大小 — Step 4 必须执行。**
-**不允许使用任何默认值。必须通过 AskUserQuestion 让用户选择。**
-**如果没有执行 Step 4 就进入 Step 5+，任务执行失败。**
+根据 `goalTypes` 字段判断需要询问哪些问题：
 
-### Step 4: 必选问题（不可跳过）
+| goalTypes | 需要询问 |
+|-----------|---------|
+| `development` | 4.1 质量等级 → 4.2 E2E → 4.3 执行模式 |
+| `testing` | 仅 4.3 执行模式 |
+| `documentation` / `other` | 仅 4.3 执行模式 |
 
-**根据任务类型选择需要询问的问题：**
+#### 4.1 质量等级（仅 `goalTypes: development`）
 
-| 任务类型 | 需要询问的问题 |
-|---------|---------------|
-| **开发任务**（新功能、Bug修复、重构） | 4.1 质量等级 + 4.2 E2E + 4.3 执行模式 |
-| **测试任务**（纯测试、写测试用例） | 仅 4.3 执行模式 |
-| **非开发任务**（文档、配置、纯阅读） | 仅 4.3 执行模式 |
+AskUserQuestion: `header: "质量等级"`, `multiSelect: false`
 
-**判断依据：** 查看 Step 6 生成的 `tasks-input.json` 中的 `goalTypes` 字段：
-- `development` → 开发任务 → 问 4.1 + 4.2 + 4.3
-- `testing` → 测试任务 → 仅问 4.3
-- `documentation` / `other` → 非开发任务 → 仅问 4.3
+**question:** 选择质量等级（决定测试覆盖、Lint、安全扫描等要求）
 
-**⚠️ 以下问题不可跳过，不可使用默认值：**
+| label | description |
+|-------|-------------|
+| `strict` | TDD + >80%覆盖率 + 严格Lint + 安全扫描 — 生产级代码 |
+| `balanced (推荐)` | >60%覆盖率 + Lint + 安全扫描 — 日常开发 |
+| `fast` | 无质量门禁 — 快速原型/验证 |
 
-#### 4.1 质量等级（仅开发任务，测试/文档任务跳过）
+#### 4.2 E2E 测试（仅 `development` 且选 strict/balanced，选 `fast` 跳过）
 
-如果是代码开发任务（`goalTypes` 包含 `development`），必须询问：
+AskUserQuestion: `header: "E2E 测试"`, `multiSelect: false`
 
-```typescript
-AskUserQuestion({
-  questions: [
-    {
-      question: "选择质量等级（决定测试覆盖、Lint、安全扫描等要求）:",
-      header: "质量等级",
-      options: [
-        { label: "strict", description: "TDD + >80%覆盖率 + 严格Lint + 安全扫描 — 生产级代码" },
-        { label: "balanced (推荐)", description: ">60%覆盖率 + Lint + 安全扫描 — 日常开发" },
-        { label: "fast", description: "无质量门禁 — 快速原型/验证" }
-      ],
-      multiSelect: false
-    }
-  ]
-})
-```
-
-#### 4.2 E2E 测试（仅开发任务且选 strict/balanced 时）
-
-如果开发任务且用户选择了 `strict` 或 `balanced`，继续询问:
-
-```typescript
-AskUserQuestion({
-  questions: [
-    {
-      question: "是否启用端到端 (E2E) 测试？（适用于 Web/Mobile/GUI 项目，耗时较长）",
-      header: "E2E 测试",
-      options: [
-        { label: "启用 E2E 测试", description: "使用 Playwright/Cypress 等框架进行端到端测试" },
-        { label: "不启用 (推荐)", description: "仅进行单元测试和集成测试，节省时间" }
-      ],
-      multiSelect: false
-    }
-  ]
-})
-```
+**question:** 是否启用端到端 (E2E) 测试？（适用于 Web/Mobile/GUI 项目，耗时较长）
 
-**注意:** 如果用户选择 `fast` 质量等级，跳过 E2E 问题（fast 模式不启用 E2E）。
+| label | description |
+|-------|-------------|
+| `不启用 (推荐)` | 仅进行单元测试和集成测试，节省时间 |
+| `启用 E2E 测试` | 使用 Playwright/Cypress 等框架进行端到端测试 |
 
 #### 4.3 执行模式（所有任务必选）
 
-**无论开发还是非开发任务，都必须询问：**
+AskUserQuestion: `header: "执行模式"`, `multiSelect: false`
 
-```typescript
-AskUserQuestion({
-  questions: [
-    {
-      question: "选择执行模式（控制 AI 执行过程中的审批节点）:",
-      header: "执行模式",
-      options: [
-        { label: "全自动执行 (推荐)", description: "全自动执行，无需人工审批，遇到阻塞自动 Meeting" },
-        { label: "关键节点确认", description: "plan/merge/deploy 时暂停确认" },
-        { label: "每阶段确认", description: "每个阶段（develop/verify/accept）完成后暂停" }
-      ],
-      multiSelect: false
-    }
-  ]
-})
-```
+**question:** 选择执行模式（控制 AI 执行过程中的审批节点）
+
+| label | description |
+|-------|-------------|
+| `全自动执行 (推荐)` | 全自动执行，无需人工审批，遇到阻塞自动 Meeting |
+| `关键节点确认` | plan/merge/deploy 时暂停确认 |
+| `每阶段确认` | 每个阶段（develop/verify/accept）完成后暂停 |
 
 ### Step 5: 可选问题（仅复杂任务）
 
@@ -376,31 +334,16 @@ openmatrix step --json
 
 **交互式审批流程（非全自动模式）:**
 
-当到达审批点时，使用 `openmatrix approve --json`（不带 ID）查看待审批项，然后通过 AskUserQuestion 请求用户确认:
+当到达审批点时，使用 `openmatrix approve --json`（不带 ID）查看待审批项，**先在界面展示审批内容摘要**，再用简短 AskUserQuestion 请求确认:
 
-```typescript
-// 检查是否有待审批项
-// 通过 CLI: openmatrix approve --json  (不带 approvalId 时返回列表)
-
-AskUserQuestion({
-  questions: [
-    {
-      question: "审批请求: [审批类型]
-
-[审批内容摘要]
-
-是否批准?",
-      header: "审批",
-      options: [
-        { label: "批准", description: "同意继续执行" },
-        { label: "拒绝", description: "拒绝并停止执行" },
-        { label: "查看详情", description: "查看完整审批内容后再决定" }
-      ],
-      multiSelect: false
-    }
-  ]
-})
-```
+AskUserQuestion: `header: "审批"`, `multiSelect: false`
+**question:** 是否批准此审批请求？（详情已展示在上方）
+
+| label | description |
+|-------|-------------|
+| 批准 | 同意继续执行 |
+| 拒绝 | 拒绝并停止执行 |
+| 查看详情 | 查看完整审批内容后再决定 |
 
 用户选择后，执行对应命令:
 - 批准: `openmatrix approve <approval-id> -d approve --json`