openmatrix 0.1.0 → 0.1.2

package/skills/om.md

@@ -0,0 +1,124 @@
+---
+name: om
+description: OpenMatrix 默认入口 - 直接输入任务描述即可启动
+---
+
+<NO-OTHER-SKILLS>
+执行此技能时，不得调用 superpowers、gsd 或其他任务编排相关的技能。OpenMatrix 独立运行，不依赖外部任务编排系统。
+</NO-OTHER-SKILLS>
+
+<objective>
+OpenMatrix 的默认入口。用户可以直接输入任务描述，系统会自动启动 /om:start 执行任务编排。
+</objective>
+
+<process>
+1. **解析用户输入**
+
+   用户输入 `$ARGUMENTS` 可能是：
+   - 任务描述 (如 "实现用户登录功能")
+   - 文件路径 (如 "docs/task.md")
+   - 空输入
+
+2. **判断输入类型**
+
+   **如果是任务描述或文件路径**:
+   → 直接调用 `/om:start` 并传递参数
+
+   **如果是空输入**:
+   → 显示帮助信息
+
+3. **自动启动 /om:start**
+
+   无论用户输入什么，都自动转换为 `/om:start` 调用：
+
+   ```
+   用户输入: "实现用户登录"
+   系统执行: /om:start 实现用户登录
+
+   用户输入: "docs/task.md"
+   系统执行: /om:start docs/task.md
+
+   用户输入: (空)
+   系统显示: 帮助信息
+   ```
+
+4. **帮助信息**
+
+   如果用户输入为空或输入 `--help`，显示：
+
+   ```
+   📦 OpenMatrix - AI 任务编排系统
+
+   用法:
+     /om <任务描述>        直接启动任务
+     /om:start <任务>      交互式启动 (可选质量级别)
+     /om:auto <任务>       全自动执行
+
+   示例:
+     /om 实现用户登录功能
+     /om 修复登录页面的样式问题
+     /om 添加 API 接口
+
+   质量级别:
+     🚀 strict   - TDD + 80%覆盖率 (生产代码)
+     ⚖️ balanced - 60%覆盖率 (日常开发)
+     ⚡ fast     - 无质量门禁 (快速原型)
+
+   其他命令:
+     /om:status  - 查看状态
+     /om:meeting - 处理阻塞
+     /om:report  - 生成报告
+   ```
+
+</process>
+
+<arguments>
+$ARGUMENTS
+</arguments>
+
+<examples>
+/om 实现用户登录功能              # 自动启动任务编排
+/om 修复登录页面的样式问题        # 直接描述任务
+/om docs/task.md                 # 从文件读取任务
+/om                              # 显示帮助
+</examples>
+
+<notes>
+## 工作原理
+
+```
+用户输入: /om 实现登录
+     │
+     ▼
+┌─────────────────┐
+│ 检测到任务描述   │
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│ 自动调用        │
+│ /om:start       │
+│ 实现登录        │
+└─────────────────┘
+```
+
+## 与 /om:start 的关系
+
+`/om` 是 `/om:start` 的快捷方式：
+- `/om <任务>` ≡ `/om:start <任务>`
+- 用户体验更简洁
+- 功能完全相同
+
+## 推荐用法
+
+```bash
+# 快速启动 (推荐)
+/om 实现用户登录
+
+# 等价于
+/om:start 实现用户登录
+
+# 全自动模式
+/om:auto 实现用户登录
+```
+</notes>

package/skills/start.md

@@ -12,11 +12,19 @@ description: 启动新的任务执行周期
 </objective>
 
 <process>
-1. **检查当前状态**
+1. **检查并初始化 .openmatrix 目录**
+   - 检查 `.openmatrix/` 目录是否存在
+   - 如果不存在，调用 CLI 初始化:
+     ```bash
+     openmatrix start --init-only
+     ```
+   - 这会创建 `.openmatrix/`、`.openmatrix/tasks/`、`.openmatrix/approvals/` 目录
+
+2. **检查当前状态**
    - 读取 `.openmatrix/state.json`
    - 如果 `status === 'running'`，提示用户先完成或暂停
 
-2. **检查 Git 仓库**
+3. **检查 Git 仓库**
    - 检查当前目录是否存在 `.git` 文件夹
    - 如果没有：
      - 询问用户是否初始化 Git 仓库 (使用 AskUserQuestion)
@@ -25,12 +33,12 @@ description: 启动新的任务执行周期
    - 检查是否有远程仓库配置:
      - 如果没有远程仓库，提示用户添加: `git remote add origin <url>`
 
-3. **解析任务输入**
+4. **解析任务输入**
    - 如果 `$ARGUMENTS` 提供文件路径 → 读取文件内容
    - 如果 `$ARGUMENTS` 是任务描述 → 直接使用
    - 如果无参数 → **使用 AskUserQuestion 询问用户要执行的任务**
 
-4. **⚠️ 交互式问答 (必须执行)**
+5. **⚠️ 交互式问答 (必须执行)**
 
    **重要**: 除非用户明确指定 `--skip-questions`，否则必须执行交互式问答。
 
@@ -156,7 +164,7 @@ description: 启动新的任务执行周期
   审批点: plan, merge
 ```
 
-6. **执行模式确认** (使用 AskUserQuestion)
+7. **执行模式确认** (使用 AskUserQuestion)
 
 ```typescript
 AskUserQuestion({
@@ -182,7 +190,7 @@ AskUserQuestion({
 })
 ```
 
-7. **开始执行** (⚠️ 严格模式)
+8. **开始执行** (⚠️ 严格模式)
 
 **重要**: 从此步骤开始，除非遇到 meeting 审批或失败，否则**不得暂停询问用户**。
 
@@ -201,8 +209,21 @@ c) **执行循环** (由 Skill 驱动):
 while (有待执行任务) {
   1. 读取状态文件获取 SubagentTask
   2. 调用 Agent 工具执行 Subagent
-  3. Subagent 完成后，更新状态文件
-  4. Git 提交 (如果配置了自动提交)
+  3. Subagent 完成后，更新状态文件:
+     ```bash
+     openmatrix complete <taskId> --success/--failed
+     ```
+  4. **Git 自动提交** (每个子任务完成后):
+     ```bash
+     git add -A
+     git commit -m "feat(task-id): 任务标题
+
+     - 修改内容1
+     - 修改内容2
+
+     任务ID: TASK-XXX
+     RunID: run-XXX"
+     ```
   5. Phase 验收测试 (verify phase)
   6. **检查是否需要审批**:
      - 如果配置了 auto 模式 (`approvalPoints` 为空):
@@ -219,15 +240,88 @@ while (有待执行任务) {
 ├── 任务C 完成 ✓
 └── 任务D 阻塞 → 创建Meeting → **跳过任务，继续执行** ↷
 
-执行完成!
-📋 有待处理的 Meeting (2个):
-  - APPR-001: 数据库连接失败 (TASK-B)
-  - APPR-002: API设计决策 (TASK-D)
+所有任务执行完成!
+```
+
+d) **执行完成后自动处理 Meeting**:
+
+```bash
+# 检查是否有 pending 的 Meeting
+openmatrix meeting --list --pending
+```
+
+**如果有 pending 的 Meeting，立即进入交互式处理**:
+
+```
+📋 检测到待处理的 Meeting (2个)
+
+┌─────────────────────────────────────────┐
+│ [1] 🔴 TASK-001 - 数据库连接失败          │
+│     阻塞原因: 无法连接到远程数据库         │
+│                                         │
+│ [2] 🤔 TASK-003 - API设计决策             │
+│     问题: 选择 REST 还是 GraphQL         │
+└─────────────────────────────────────────┘
+```
+
+**使用 AskUserQuestion 逐个处理**:
+
+```typescript
+// 1. 先选择要处理的 Meeting
+AskUserQuestion({
+  questions: [{
+    question: "请选择要处理的 Meeting:",
+    header: "Meeting",
+    options: [
+      { label: "[1] TASK-001 - 数据库连接失败", description: "阻塞 - 需要信息" },
+      { label: "[2] TASK-003 - API设计决策", description: "决策 - 技术选型" },
+      { label: "全部跳过", description: "标记所有 Meeting 为跳过" }
+    ],
+    multiSelect: false
+  }]
+})
+
+// 2. 根据类型展示处理选项
+// 阻塞型:
+AskUserQuestion({
+  questions: [{
+    question: "如何处理此阻塞?",
+    header: "处理方式",
+    options: [
+      { label: "💡 提供信息", description: "提供解决问题所需的信息后重试" },
+      { label: "⏭️ 跳过任务", description: "标记为可选，继续执行" },
+      { label: "🔄 重试", description: "直接重试此任务" }
+    ],
+    multiSelect: false
+  }]
+})
+
+// 决策型:
+AskUserQuestion({
+  questions: [{
+    question: "请做出决策:",
+    header: "决策",
+    options: [
+      { label: "方案 A", description: "方案A描述" },
+      { label: "方案 B", description: "方案B描述" }
+    ],
+    multiSelect: false
+  }]
+})
+```
 
-请使用 /om:meeting 查看并处理
+**处理完成后，如果用户提供了信息或选择重试，重新执行阻塞任务**:
+```bash
+openmatrix meeting APPR-001 --action provide-info --info "..."
+# 或
+openmatrix meeting APPR-001 --action retry
+
+# 然后重新执行阻塞的任务
+openmatrix resume TASK-001
 ```
 
-Meeting 保持 `pending` 状态，用户最后使用 `/om:meeting` 以交互式方式处理
+**⚠️ 重要**: Meeting 处理是执行流程的一部分，必须在任务结束前完成。不要让用户手动调用 /om:meeting。
+
   7. 继续下一个任务
 }
 ```
@@ -263,11 +357,16 @@ Agent({
 - 只有遇到 **meeting** 类型的审批时才暂停
 - 其他情况下，让 Agent 完整执行任务并在完成后自动返回结果
 
-8. **状态更新**
+9. **执行完成 - 最终 Git 提交**
 
-每个 Subagent 完成后，更新任务状态:
+所有任务完成后，执行最终提交:
 ```bash
-openmatrix complete <taskId> --success/--failed
+git add -A
+git commit -m "feat: 完成所有任务
+
+RunID: run-XXX
+任务数: N
+完成时间: YYYY-MM-DD HH:mm:ss"
 ```
 
 </process>
@@ -287,9 +386,11 @@ $ARGUMENTS
 
 | 级别 | TDD | 覆盖率 | Lint | 安全扫描 | AI验收 | 适用场景 |
 |------|:---:|:------:|:----:|:--------:|:------:|---------|
-| **strict** | ✅ | 80% | ✅ 严格 | ✅ | ✅ | 生产代码、核心功能 |
-| **balanced** | ❌ | 60% | ✅ | ✅ | ✅ | 日常开发 (默认) |
-| **fast** | ❌ | 0% | ❌ | ❌ | ❌ | 快速原型、POC |
+| **strict** | ✅ | >80% | ✅ 严格 | ✅ | ✅ | 生产代码、核心功能 |
+| **balanced** | ❌ | >60% | ✅ | ✅ | ✅ | 日常开发 (默认) |
+| **fast** | ❌ | >20% | ❌ | ❌ | ❌ | 快速原型、POC |
+
+> strict 可配置为 100%。80% 覆盖核心业务逻辑，100% 成本高收益低。
 
 ### strict 模式 (推荐生产代码)
 ```
@@ -367,7 +468,38 @@ $ARGUMENTS
 ┌─────────────────┐
 │    开始执行     │
 │  (应用质量配置)  │
-└─────────────────┘
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│  所有任务完成?   │
+└────────┬────────┘
+         │
+    ┌────┴────┐
+    │         │
+   否        是
+    │         │
+    ▼         ▼
+┌───────┐ ┌─────────────────┐
+│继续执行│ │有 pending       │
+└───────┘ │Meeting?         │
+          └────────┬────────┘
+                   │
+              ┌────┴────┐
+              │         │
+             否        是
+              │         │
+              ▼         ▼
+          ┌───────┐ ┌─────────────┐
+          │  完成  │ │ 交互式处理  │
+          └───────┘ │ Meeting     │
+                    └──────┬──────┘
+                           │
+                           ▼
+                    ┌─────────────┐
+                    │ 重新执行    │
+                    │ 阻塞任务    │
+                    └─────────────┘
 ```
 
 ## 执行模式对比