openmatrix 0.1.0

package/skills/approve.md

@@ -0,0 +1,253 @@
+---
+name: om:approve
+description: 审批待处理项（包括计划、合并、部署、Meeting）
+---
+
+<NO-OTHER-SKILLS>
+执行此技能时，不得调用 superpowers、gsd 或其他任务编排相关的技能。OpenMatrix 独立运行，不依赖外部任务编排系统。
+</NO-OTHER-SKILLS>
+
+<objective>
+处理所有需要人工决策的待审批项，包括阻塞问题、技术决策、计划审批等。
+</objective>
+
+<process>
+1. **获取待审批列表**
+   ```bash
+   openmatrix approve --list
+   ```
+
+2. **如果没有待审批项**
+   ```
+   ✅ 没有待审批项
+
+   当前执行状态:
+   - 运行中任务: X
+   - 已完成: Y
+   - 总计: Z
+
+   使用 /om:status 查看详情
+   ```
+   如果有多个，让用户选择要处理的审批
+
+3. **展示审批内容** (根据类型区分)
+
+   **Plan 审批:**
+   ```
+   🔔 待审批: APPR-001
+
+   📋 类型: 📝 Plan 审批
+   🎯 任务: TASK-XXX
+
+   ## 执行计划
+
+   ### Phase 1: 设计阶段
+   └─ TASK-001: 架构设计 (15min)
+
+   ### Phase 2: 开发阶段
+   ├─ TASK-002: 数据模型 (20min)
+   └─ TASK-003: API 接口 (30min)
+
+   📊 统计
+   - 总任务: 3
+   - 预计耗时: ~1小时
+
+   ## 选项
+
+   [A] ✅ 批准 - 按此计划执行
+   [B] ✏️ 修改 - 需要调整计划
+   [C] ❌ 拒绝 - 重新规划
+
+   请选择: _
+   ```
+
+   **Meeting 审批 (阻塞问题):**
+   ```
+   🔔 待审批: APPR-002
+
+   📋 类型: 🔴 Meeting (阻塞)
+   🎯 任务: TASK-XXX
+
+   ## 阻塞问题描述
+
+   **原因**: [阻塞原因]
+   **时间**: [发生时间]
+
+   ## 影响范围
+
+   - TASK-XXX: 下游任务1
+   - TASK-YYY: 下游任务2
+
+   ## 可选操作
+
+   [A] 💡 提供信息 - 提供解决阻塞所需的信息
+   [B] ⏭️ 跳过任务 - 标记为可选，继续执行
+   [C] 🔄 修改方案 - 调整任务方案
+   [D] ❌ 取消执行 - 停止整个流程
+
+   请选择: _
+   ```
+
+   **Meeting 审批 (技术决策):**
+   ```
+   🔔 待审批: APPR-003
+
+   📋 类型: 🤔 Meeting (决策)
+   🎯 任务: TASK-XXX
+
+   ## 决策点
+
+   **问题**: [需要决策的技术问题]
+
+   ## 可选方案
+
+   1. 方案A - [描述] (推荐)
+      - 优点: ...
+      - 缺点: ...
+
+   2. 方案B - [描述]
+      - 优点: ...
+      - 缺点: ...
+
+   ## 选项
+
+   [A] 选择方案1 (推荐)
+   [B] 选择方案2
+   [C] 自定义方案 - 输入您自己的方案
+   [D] 需要更多信息 - 暂不决策，先获取更多信息
+
+   请选择: _
+   ```
+
+4. **处理用户选择**
+
+   使用 `AskUserQuestion` 工具进行交互:
+
+   ```typescript
+   AskUserQuestion({
+     questions: [{
+       question: "请选择审批操作:",
+       header: "审批",
+       options: [
+         { label: "批准", description: "批准并继续执行" },
+         { label: "修改", description: "需要修改后重新提交" },
+         { label: "拒绝", description: "拒绝此请求" }
+       ],
+       multiSelect: false
+     }]
+   })
+   ```
+
+   如果选择"提供信息"或"自定义方案"，追加问题:
+
+   ```typescript
+   AskUserQuestion({
+     questions: [{
+       question: "请输入详细信息:",
+       header: "详情",
+       options: [] // 允许自由输入
+     }]
+   })
+   ```
+
+5. **执行审批**
+   ```bash
+   openmatrix approve <approvalId> --action <approve|reject|modify> [--message "备注"]
+   ```
+
+6. **更新状态**
+
+   - 写入审批结果到 `approvals/{id}.json`
+   - 更新状态: approved / rejected
+   - 记录决策时间、决策人、决策理由
+
+7. **后续处理**
+
+   **如果批准:**
+   - 更新关联任务状态
+   - 如果是 Meeting，解决 Meeting 并记录解决方案
+   - 自动继续执行
+
+   **如果拒绝/修改:**
+   - 任务进入相应状态
+   - 显示后续操作建议
+
+</process>
+
+<arguments>
+$ARGUMENTS
+
+如果提供审批ID，直接处理指定审批。
+如果无参数，列出所有待审批项供选择。
+</arguments>
+
+<examples>
+/om:approve              # 列出所有待审批
+/om:approve APPR-001     # 直接处理指定审批
+</examples>
+
+<notes>
+## 审批类型说明
+
+| 类型 | 图标 | 触发条件 | 处理方式 |
+|------|------|---------|---------|
+| plan | 📝 | 任务拆解完成 | 批准/修改/拒绝 |
+| merge | 🔀 | 开发完成 | 批准/拒绝 |
+| deploy | 🚀 | 部署前确认 | 批准/拒绝 |
+| meeting | 🔴/🤔 | 阻塞/决策 | 交互式解决 |
+
+## Meeting 审批特殊处理
+
+Meeting 审批需要更细致的交互:
+
+1. **阻塞问题**
+   - 提供信息 → 记录到任务，恢复执行
+   - 跳过任务 → 标记可选，继续下游
+   - 修改方案 → 调整参数，重新执行
+   - 取消执行 → 停止流程
+
+2. **技术决策**
+   - 选择方案 → 记录决策，继续执行
+   - 自定义方案 → 记录新方案，继续执行
+   - 需要更多信息 → 暂停，等待调研
+
+## CLI 命令
+
+```bash
+# 列出待审批
+openmatrix approve --list
+
+# 处理审批
+openmatrix approve APPR-001 --action approve --message "同意此方案"
+openmatrix approve APPR-001 --action reject --message "需要重新设计"
+openmatrix approve APPR-001 --action modify --message "增加测试覆盖率要求"
+
+# Meeting 专用
+openmatrix approve APPR-002 --action provide-info --info "数据库连接字符串是..."
+openmatrix approve APPR-002 --action skip --message "此任务可选"
+openmatrix approve APPR-002 --action cancel --message "需求变更，停止执行"
+```
+
+## 与执行循环的集成
+
+```
+执行循环检测到 pending approval
+       │
+       ▼
+  调用 /om:approve
+       │
+       ▼
+  用户审批决策
+       │
+       ▼
+  更新审批状态
+       │
+       ▼
+  如果是 Meeting:
+    ├─ 解决 Meeting
+    └─ 恢复任务状态
+       │
+       ▼
+  继续执行循环
+```
+</notes>

package/skills/meeting.md

@@ -0,0 +1,346 @@
+---
+name: om:meeting
+description: 查看和处理所有待确认的 Meeting（阻塞问题和决策点）
+---
+
+<NO-OTHER-SKILLS>
+执行此技能时，不得调用 superpowers、gsd 或其他任务编排相关的技能。OpenMatrix 独立运行，不依赖外部任务编排系统。
+</NO-OTHER-SKILLS>
+
+<objective>
+查看所有执行过程中记录的 Meeting，以交互式方式让用户确认或提供解决方案。
+</objective>
+
+<process>
+1. **获取 Meeting 列表**
+   ```bash
+   openmatrix meeting --list
+   ```
+
+2. **如果没有待处理 Meeting**
+   ```
+   ✅ 没有待处理的 Meeting
+
+   当前状态:
+   - 已解决: X
+   - 总计: Y
+   ```
+
+3. **展示 Meeting 列表**
+   ```
+   📋 待处理 Meeting (X个)
+
+   ┌─────────────────────────────────────────┐
+   │ [1] 🔴 TASK-001 - 数据库连接失败          │
+   │     阻塞原因: 无法连接到远程数据库         │
+   │     影响: 2个下游任务                     │
+   │                                         │
+   │ [2] 🤔 TASK-003 - API设计决策             │
+   │     问题: 选择 REST 还是 GraphQL         │
+   │     方案: 待决策                          │
+   │                                         │
+   │ [3] 🔴 TASK-005 - 第三方API密钥缺失        │
+   │     阻塞原因: 需要申请 API Key           │
+   │     影响: 1个下游任务                     │
+   └─────────────────────────────────────────┘
+   ```
+
+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
+     }]
+   })
+   ```
+
+5. **处理单个 Meeting**
+
+   根据 Meeting 类型展示不同的选项：
+
+   **🔴 阻塞问题 Meeting:**
+   ```
+   📋 Meeting: APPR-001
+   🎯 任务: TASK-001 - 数据库连接失败
+
+   ## 阻塞详情
+
+   **原因**: 无法连接到远程数据库
+   **尝试**: 已检查网络连通性，防火墙已放行
+   **时间**: 2024-03-25 10:30:00
+
+   ## 影响范围
+
+   - TASK-002: 用户数据同步 (依赖 TASK-001)
+   - TASK-004: 数据备份任务 (依赖 TASK-001)
+
+   ## 可用操作
+
+   [A] 💡 提供信息 - 提供解决问题所需的信息
+   [B] ⏭️ 跳过任务 - 标记此任务为可选，继续下游
+   [C] 🔄 重试 - 使用新信息重试此任务
+   [D] ✏️ 修改方案 - 调整任务执行方案
+   ```
+
+   **使用 AskUserQuestion:**
+   ```typescript
+   AskUserQuestion({
+     questions: [{
+       question: "请选择操作:",
+       header: "处理阻塞",
+       options: [
+         { label: "💡 提供信息", description: "提供解决问题所需的信息" },
+         { label: "⏭️ 跳过任务", description: "标记为可选，继续执行下游任务" },
+         { label: "🔄 重试", description: "使用新信息重试此任务" },
+         { label: "✏️ 修改方案", description: "调整任务执行方案" },
+         { label: "返回列表", description: "暂不处理" }
+       ],
+       multiSelect: false
+     }]
+   })
+   ```
+
+6. **处理具体选择**
+
+   **如果选择"提供信息":**
+   ```typescript
+   AskUserQuestion({
+     questions: [{
+       question: "请提供解决此阻塞所需的信息:",
+       header: "详细信息",
+       options: [], // 允许自由输入
+       multiSelect: false
+     }]
+   })
+   ```
+
+   然后执行：
+   ```bash
+   openmatrix meeting APPR-001 --action provide-info \
+     --info "数据库连接字符串是: postgresql://user:pass@host/db"
+   ```
+
+   **如果选择"跳过任务":**
+   ```typescript
+   AskUserQuestion({
+     questions: [{
+       question: "确定要跳过此任务吗？",
+       header: "确认",
+       options: [
+         { label: "确认跳过", description: "标记为可选，继续下游" },
+         { label: "取消", description: "返回" }
+       ],
+       multiSelect: false
+     }]
+   })
+   ```
+
+   然后执行：
+   ```bash
+   openmatrix meeting APPR-001 --action skip --message "任务可选，跳过执行"
+   ```
+
+   **如果选择"重试":**
+   ```bash
+   openmatrix meeting APPR-001 --action retry
+   ```
+
+   **如果选择"修改方案":**
+   ```typescript
+   AskUserQuestion({
+     questions: [{
+       question: "请描述修改后的方案:",
+       header: "新方案",
+       options: [], // 允许自由输入
+       multiSelect: false
+     }]
+   })
+   ```
+
+   然后执行：
+   ```bash
+   openmatrix meeting APPR-001 --action modify \
+     --new-plan "使用本地 SQLite 替代 PostgreSQL"
+   ```
+
+7. **处理决策型 Meeting**
+
+   **🤔 技术决策 Meeting:**
+   ```
+   📋 Meeting: APPR-002
+   🎯 任务: TASK-003 - API 设计决策
+
+   ## 决策问题
+
+   **问题**: 选择 REST 还是 GraphQL?
+
+   ## 可选方案
+
+   **方案 1: REST API** (推荐)
+   - ✅ 简单直观，团队熟悉
+   - ✅ 调试方便
+   - ❌ 可能需要多次请求
+
+   **方案 2: GraphQL**
+   - ✅ 灵活查询，一次请求
+   - ✅ 强类型
+   - ❌ 学习成本较高
+   - ❌ 需要额外工具
+
+   ## 操作
+
+   [A] 选择方案 1 - REST (推荐)
+   [B] 选择方案 2 - GraphQL
+   [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
+     }]
+   })
+   ```
+
+   执行决策：
+   ```bash
+   openmatrix meeting APPR-002 --action decide \
+     --decision "REST" --reason "团队熟悉，快速开发"
+   ```
+
+8. **处理完成**
+
+   处理一个 Meeting 后：
+   ```
+   ✅ Meeting APPR-001 已解决
+
+   操作: 提供信息
+   状态: 任务已恢复执行
+
+   📋 剩余 Meeting (2个):
+   - APPR-002: API设计决策
+   - APPR-003: API密钥缺失
+
+   是否继续处理? [Y/n]: _
+   ```
+
+   如果是 "跳过" 或 "取消"：
+   ```
+   ⏭️ Meeting APPR-001 已跳过
+
+   任务 TASK-001 标记为可选
+   下游任务可继续执行
+
+   📋 剩余 Meeting (2个): ...
+   ```
+
+9. **批量处理**
+
+   如果选择"全部跳过":
+   ```typescript
+   AskUserQuestion({
+     questions: [{
+       question: "确定要跳过所有 Meeting 吗？",
+       header: "批量操作",
+       options: [
+         { label: "确认全部跳过", description: "标记所有为可选" },
+         { label: "取消", description: "返回列表" }
+       ],
+       multiSelect: false
+     }]
+   })
+   ```
+
+   ```bash
+   openmatrix meeting --skip-all --message "批量跳过"
+   ```
+
+</process>
+
+<arguments>
+$ARGUMENTS
+
+- 无参数: 列出所有待处理 Meeting
+- Meeting ID: 直接处理指定 Meeting
+</arguments>
+
+<examples>
+/om:meeting              # 查看所有待处理 Meeting
+/om:meeting APPR-001     # 直接处理指定 Meeting
+</examples>
+
+<notes>
+## Meeting 类型
+
+| 类型 | 图标 | 说明 |
+|------|------|------|
+| 阻塞 | 🔴 | 任务执行遇到阻塞，需要信息或决策 |
+| 决策 | 🤔 | 技术选型或设计方案决策 |
+
+## 操作类型
+
+| 操作 | 说明 | 后续 |
+|------|------|------|
+| provide-info | 提供解决信息 | 任务恢复执行 |
+| skip | 跳过任务 | 标记可选，下游继续 |
+| retry | 重试任务 | 重新执行当前任务 |
+| modify | 修改方案 | 更新任务后重试 |
+| decide | 做出决策 | 记录决策并继续 |
+| cancel | 取消任务 | 停止相关下游任务 |
+
+## CLI 命令
+
+```bash
+# 列出所有 Meeting
+openmatrix meeting --list
+
+# 处理指定 Meeting
+openmatrix meeting APPR-001 --action provide-info --info "..."
+openmatrix meeting APPR-001 --action skip --message "..."
+openmatrix meeting APPR-001 --action retry
+openmatrix meeting APPR-001 --action modify --new-plan "..."
+
+# 批量操作
+openmatrix meeting --skip-all --message "批量跳过"
+```
+
+## 与执行循环的关系
+
+```
+执行任务中...
+├── 任务A 完成 ✓
+├── 任务B 阻塞 → 创建Meeting → 跳过，继续
+└── 任务C 完成 ✓
+
+执行完成!
+📋 有待处理的 Meeting (1个)
+        ↓
+用户执行 /om:meeting
+        ↓
+交互式处理 Meeting
+├── 提供信息 / 跳过 / 重试
+└── 解决阻塞
+        ↓
+恢复执行或标记完成
+```
+</notes>

package/skills/report.md

@@ -0,0 +1,100 @@
+---
+name: om:report
+description: 生成任务执行报告
+---
+
+<NO-OTHER-SKILLS>
+执行此技能时，不得调用 superpowers、gsd 或其他任务编排相关的技能。OpenMatrix 独立运行，不依赖外部任务编排系统。
+</NO-OTHER-SKILLS>
+
+<objective>
+生成当前运行周期的完整执行报告。
+</objective>
+
+<process>
+1. **收集数据**
+   - 全局状态 (state.json)
+   - 所有任务 (tasks/)
+   - 审批历史 (approvals/)
+   - Agent 执行日志 (agents/)
+
+2. **生成报告**
+
+```
+📊 OpenMatrix 执行报告
+=====================
+
+🆔 Run ID: run-20240323-abc1
+📅 时间: 2024-03-23 10:00 - 12:30
+⏱️ 总耗时: 2小时30分钟
+
+## 📈 任务统计
+
+| 状态 | 数量 | 占比 |
+|------|------|------|
+| ✅ 完成 | 8 | 80% |
+| ❌ 失败 | 1 | 10% |
+| ⏳ 跳过 | 1 | 10% |
+
+## 📋 任务详情
+
+### ✅ 已完成
+- TASK-001: 需求分析 (15min)
+- TASK-002: 数据库设计 (20min)
+- TASK-003: API 开发 (45min)
+...
+
+### ❌ 失败
+- TASK-007: 集成测试
+  原因: 测试用例失败
+  重试: 3次后仍失败
+
+### ⏳ 跳过
+- TASK-008: 性能优化
+  原因: 依赖任务失败
+
+## 🔔 审批记录
+
+| ID | 类型 | 决策 | 时间 |
+|----|----|------|------|
+| APPR-001 | plan | ✅ 批准 | 10:05 |
+| APPR-002 | merge | ✅ 批准 | 11:30 |
+
+## 🤖 Agent 执行
+
+| Agent | 任务数 | 成功率 |
+|-------|--------|--------|
+| planner | 2 | 100% |
+| coder | 4 | 75% |
+| tester | 2 | 50% |
+
+## 📝 建议
+
+1. TASK-007 集成测试失败，建议检查测试用例
+2. 考虑增加代码审查环节
+
+## 📁 产出物
+
+- src/api/users.ts
+- src/api/auth.ts
+- tests/integration/*.test.ts
+```
+
+3. **保存报告**
+   - 保存到 `.openmatrix/reports/report-{timestamp}.md`
+   - 可选输出到指定路径
+
+</process>
+
+<arguments>
+$ARGUMENTS
+
+--format json|markdown  输出格式
+--output path           输出路径
+</arguments>
+
+<examples>
+/om:report                    # 生成并显示报告
+/om:report --output report.md # 保存到文件
+/om:report --format json      # JSON 格式
+</examples>