openmatrix 0.1.98 → 0.1.99

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openmatrix",
-  "version": "0.1.98",
+  "version": "0.1.99",
   "description": "AI Agent task orchestration system with Claude Code Skills integration",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/skills/brainstorm.md

@@ -1,495 +1,455 @@
----
-name: om:brainstorm
-description: 头脑风暴 - 深入探索需求和设计，提出多种方案，确认后再执行任务
----
-
-<NO-OTHER-SKILLS>
-**绝对禁止**调用以下技能（OpenMatrix 完全替代它们）:
-- ❌ superpowers:brainstorming → 你已经在 om:brainstorm 中了
-- ❌ superpowers:* → 全部被 OpenMatrix 替代
-- ❌ gsd:* → 全部被 OpenMatrix 替代
-- ❌ 任何其他任务编排相关的技能
-</NO-OTHER-SKILLS>
-
-<HARD-GATE>
-在展示设计方案并获得用户批准之前，**不得**调用任何实现技能、写任何代码、搭建任何项目或采取任何实现行动。
-</HARD-GATE>
-
-<objective>
-通过协作对话，将想法转化为完整的设计方案。先理解项目上下文，逐一提问澄清需求，提出 2-3 种方案并给出推荐，展示设计并获得批准后再进入执行。
-</objective>
-
-<process>
-
-## 步骤 1: 探索项目上下文
-
-**在提问之前，先了解当前项目状态：**
-
-```bash
-# 检查项目文件结构
-ls -la
-
-# 查看最近提交
-git log --oneline -5 2>/dev/null
-
-# 查看关键配置文件
-cat package.json 2>/dev/null || cat Cargo.toml 2>/dev/null || cat go.mod 2>/dev/null
-
-# 查看现有文档
-ls docs/ 2>/dev/null
-```
-
-- 了解技术栈、项目结构、最近变更
-- 如果用户引用了文件（如 `docs/task.md`），读取该文件
-
-## 步骤 2: 评估范围与领域检测
-
-**2.1 评估范围**
-
-**如果任务涉及多个独立子系统**（如"构建一个包含聊天、文件存储、计费和分析的平台"），立即提出分解：
-
-```typescript
-AskUserQuestion({
-  questions: [{
-    question: "这个任务涉及多个独立子系统，建议分步执行。先做哪个？",
-    header: "范围",
-    options: [
-      { label: "子系统A", description: "描述..." },
-      { label: "子系统B", description: "描述..." },
-      { label: "全部一起做", description: "不推荐，但可以尝试" }
-    ],
-    multiSelect: false
-  }]
-})
-```
-
-**2.2 领域检测与 Research 集成**
-
-**如果任务涉及不熟悉的垂直领域**（如游戏开发、支付系统、区块链、AI 应用等），主动建议调用研究：
-
-```typescript
-AskUserQuestion({
-  questions: [{
-    question: `这个任务涉及「${domain}」领域，建议先进行领域调研。\n研究可以帮助我们:\n• 了解行业标准和最佳实践\n• 识别关键技术选型\n• 发现常见陷阱和解决方案`,
-    header: "领域调研",
-    options: [
-      { label: "先调研 (推荐)", description: "调用 /om:research 深入了解领域" },
-      { label: "直接头脑风暴", description: "我对这个领域比较熟悉" }
-    ],
-    multiSelect: false
-  }]
-})
-```
-
-用户选择「先调研」后：
-```
-Skill 工具: skill = "om:research", args = "任务描述"
-```
-
-研究完成后，研究结论会作为头脑风暴的输入上下文，继续后续步骤。
-
-## 步骤 3: 逐一澄清需求
-
-**核心原则：一次只问一个问题。每条消息只有一个问题。**
-
-**问题不是预定义的，而是根据具体任务动态生成。** 先检查项目上下文，再针对性地提问。
-
-**问题应聚焦三个方面：**
-
-### 3.1 目的（Purpose）— 为什么做这个？
-```typescript
-// 好的问题：深入理解动机
-AskUserQuestion({
-  questions: [{
-    question: "这个功能解决的核心痛点是什么？",
-    header: "目的",
-    options: [
-      { label: "提升效率", description: "自动化现有手动流程" },
-      { label: "新增能力", description: "目前完全不具备的功能" },
-      { label: "替代方案", description: "替换现有的第三方服务" }
-    ],
-    multiSelect: false
-  }]
-})
-```
-
-### 3.2 约束（Constraints）— 有什么限制？
-```typescript
-// 好的问题：理解边界条件
-AskUserQuestion({
-  questions: [{
-    question: "客户管理的数据需要关联哪些实体？",
-    header: "数据模型",
-    options: [
-      { label: "仅客户信息", description: "独立的客户 CRUD" },
-      { label: "客户 + 邀请人", description: "需要追踪推荐关系" },
-      { label: "客户 + 合作历史", description: "需要记录历史合作者" }
-    ],
-    multiSelect: true
-  }]
-})
-```
-
-### 3.3 成功标准（Success Criteria）— 怎样算完成？
-```typescript
-// 好的问题：明确验收条件
-AskUserQuestion({
-  questions: [{
-    question: "这个功能的 MVP 最小可用版本包含什么？",
-    header: "MVP",
-    options: [
-      { label: "基础 CRUD", description: "增删改查 + 列表" },
-      { label: "CRUD + 搜索", description: "支持按名称/邮箱搜索" },
-      { label: "完整功能", description: "包含关联、分组、导出等" }
-    ],
-    multiSelect: false
-  }]
-})
-```
-
-**提问策略：**
-- **优先选择题** — 比开放式更容易回答
-- **根据上下文定制** — 不是固定问题列表，而是基于项目状态和任务类型动态调整
-- **每个问题只关注一个方面** — 需要深入就拆成多个问题
-- **YAGNI** — 主动建议去掉不必要的功能
-- **深入追问** — 如果用户选"其他"，用开放式问题跟进
-
-## 步骤 4: 提出 2-3 种方案
-
-理解需求后，提出不同实现方案：
-
-```typescript
-AskUserQuestion({
-  questions: [{
-    question: `基于需求分析，有以下实现方案：
-
-**方案 A（推荐）: 组件化架构**
-- 每个模块独立，通过接口通信
-- 优点: 可测试性强、易维护
-- 缺点: 初始代码量较多
-
-**方案 B: 单体架构**
-- 所有功能在一个模块内
-- 优点: 开发快
-- 缺点: 难以扩展
-
-**方案 C: 微服务架构**
-- 每个功能独立服务
-- 优点: 高度解耦
-- 缺点: 复杂度高，当前规模不需要
-
-推荐方案 A，因为...`,
-    header: "技术方案",
-    options: [
-      { label: "方案 A (推荐)", description: "组件化架构" },
-      { label: "方案 B", description: "单体架构" },
-      { label: "方案 C", description: "微服务架构" }
-    ],
-    multiSelect: false
-  }]
-})
-```
-
-## 步骤 5: 分步展示设计
-
-**逐节展示设计方案，每节确认一次：**
-
-每次展示一个设计方面：
-
-```
-📐 设计方案 - 第 1 部分: 架构
-
-┌─────────┐     ┌─────────┐     ┌─────────┐
-│  输入层  │ ──→ │  业务层  │ ──→ │  数据层  │
-└─────────┘     └─────────┘     └─────────┘
-
-- 输入层: REST API + WebSocket
-- 业务层: 核心逻辑处理
-- 数据层: PostgreSQL + Redis 缓存
-
-这部分设计是否合理？
-```
-
-**设计覆盖：**
-1. 架构设计
-2. 数据模型 / 核心实体
-3. 关键接口 / API
-4. 错误处理策略
-5. 测试策略
-
-**每个部分都使用 AskUserQuestion 确认：**
-```typescript
-AskUserQuestion({
-  questions: [{
-    question: "架构设计是否合理？",
-    header: "确认",
-    options: [
-      { label: "继续", description: "设计合理，继续下一部分" },
-      { label: "修改", description: "我有调整建议" }
-    ],
-    multiSelect: false
-  }]
-})
-```
-
-## 步骤 6: 总结确认
-
-所有设计部分确认后，展示完整总结：
-
-```
-🧠 头脑风暴总结
-
-📋 任务: 实现客户管理系统
-
-🎯 核心目标
-   - 客户信息管理（姓名、邮箱、邀请人）
-   - 历史合作记录追踪
-
-📐 架构
-   - 组件化设计，每个模块独立可测
-
-🔧 技术方案
-   - 数据库: PostgreSQL
-   - 缓存: Redis
-   - API: RESTful
-
-⚠️ 风险
-   - 数据迁移: 需要兼容旧格式
-
-✅ 验收标准
-   - CRUD 接口完整
-   - 测试覆盖率 > 80%
-```
-
-```typescript
-AskUserQuestion({
-  questions: [{
-    question: "头脑风暴完成，是否开始执行任务？",
-    header: "下一步",
-    options: [
-      { label: "开始执行 (推荐)", description: "写入 tasks-input.json 并调用 /om:start" },
-      { label: "继续探索", description: "还有问题需要进一步讨论" },
-      { label: "仅生成计划", description: "生成详细计划但不执行" }
-    ],
-    multiSelect: false
-  }]
-})
-```
-
-## 步骤 7: 输出设计文档
-
-总结确认后，将设计写入文档，便于后续执行时参考：
-
-```bash
-# 确保目录存在
-mkdir -p docs/openmatrix
-```
-
-**写入设计文档到 `docs/openmatrix/YYYY-MM-DD-<topic>-design.md`：**
-
-```markdown
-# 设计方案: 任务标题
-
-日期: YYYY-MM-DD
-
-## 核心目标
-- 目标 1
-- 目标 2
-
-## 架构设计
-(从步骤 5 确认的内容)
-
-## 数据模型 / 核心实体
-(从步骤 5 确认的内容)
-
-## 关键接口 / API
-(从步骤 5 确认的内容)
-
-## 技术方案
-- 方案选择: 方案 X
-- 理由: ...
-
-## 错误处理策略
-(从步骤 5 确认的内容)
-
-## 测试策略
-(从步骤 5 确认的内容)
-
-## 约束与风险
-- 约束 1
-- 风险 1 及应对
-
-## 验收标准
-- 标准 1
-- 标准 2
-```
-
-```typescript
-AskUserQuestion({
-  questions: [{
-    question: `设计文档已写入 docs/openmatrix/${filename}\n\n下一步？`,
-    header: "下一步",
-    options: [
-      { label: "开始执行 (推荐)", description: "写入 tasks-input.json 并调用 /om:start" },
-      { label: "修改设计", description: "需要调整设计方案" }
-    ],
-    multiSelect: false
-  }]
-})
-```
-
-## 步骤 8: 写入 tasks-input.json 并调用 /om:start
-
-用户选择"开始执行"后：
-
-1. **检测状态:**
-```bash
-ls .openmatrix/state.json 2>/dev/null
-```
-
-2. **初始化（如需要）:**
-```bash
-openmatrix start --init-only
-```
-
-3. **写入 `.openmatrix/tasks-input.json`:**
-```json
-{
-  "title": "任务标题",
-  "description": "基于头脑风暴的整体描述",
-  "goals": ["目标1: 独立功能模块", "目标2: 独立功能模块"],
-  "constraints": ["约束"],
-  "deliverables": ["交付物"],
-  "plan": "## 技术方案\n..."
-}
-```
-
-> **注意**: `quality`、`mode`、`e2eTests` 不在此写入，由 `/om:start` 的必选问题决定。
-
-4. **⚠️ 必须执行（不可跳过）：使用 Skill 工具调用 `/om:start`**
-
-```
-Skill 工具: skill = "om:start"
-```
-
-这不是可选的 — 如果不调用 `/om:start`，任务不会开始执行。
-`/om:start` 会检测到已存在的 `tasks-input.json`，然后询问必选问题（质量等级、E2E、执行模式）。
-
-</process>
-
-<arguments>
-$ARGUMENTS
-</arguments>
-
-<examples>
-/om:brainstorm                      # 交互式头脑风暴
-/om:brainstorm docs/task.md         # 基于任务文件头脑风暴
-/om:brainstorm "实现用户登录功能"    # 基于描述头脑风暴
-</examples>
-
-<notes>
-## 关键原则
-
-- **一次只问一个问题** — 不要一次问多个
-- **优先选择题** — 比开放式更容易回答
-- **YAGNI** — 主动建议去掉不必要的设计
-- **提出 2-3 种方案** — 带权衡和推荐
-- **分步确认** — 每部分设计确认后再继续
-- **为隔离而设计** — 每个模块应有清晰的边界和接口
-- **问题要贴合任务** — 不问泛泛的问题，而是针对具体任务深入
-- **理解目的 > 理解实现** — 先搞清楚为什么做，再讨论怎么做
-
-## 领域调研集成
-
-- 检测到垂直领域（游戏、支付、区块链等）时，主动建议 `/om:research`
-- 研究完成后，研究结论作为后续提问和设计的输入上下文
-- 如果用户对领域熟悉，可以跳过研究直接进入头脑风暴
-- 研究产出的文档可引用在设计文档中
-
-## 设计文档
-
-- 每次头脑风暴都会输出设计文档到 `docs/openmatrix/YYYY-MM-DD-<topic>-design.md`
-- 文档包含：核心目标、架构、数据模型、接口、技术方案、错误处理、测试策略、风险、验收标准
-- 设计文档是 `/om:start` 执行时的重要参考
-- 文档内容来自步骤 5 逐节确认的设计
-
-## 在已有代码库中工作
-
-- 提出变更前，先探索现有结构，遵循现有模式
-- 如果现有代码有问题（文件太大、边界不清、职责混乱），在设计中有针对性地改进
-- 不要提出无关的重构建议，聚焦当前目标
-
-## 问题深度示例
-
-**不好的问题（太泛）：**
-- "你的技术栈是什么？"
-- "你需要测试吗？"
-
-**好的问题（贴合具体任务）：**
-- "客户管理的邀请人字段，是只记录最近一个邀请人，还是需要完整的邀请链？"
-- "站内信需要支持已读/未读状态吗？还是只需要通知推送？"
-- "物流追踪是实时推送还是定时轮询？这影响 API 设计。"
-
-## 流程图
-
-```
-┌─────────────────┐
-│  探索项目上下文  │
-└────────┬────────┘
-         │
-         ▼
-┌─────────────────┐
-│  评估范围       │
-│ (是否需要分解)  │
-└────────┬────────┘
-         │
-         ▼
-┌─────────────────┐
-│  领域检测       │     YES → /om:research → 研究结论作为上下文
-│ (是否需要调研)  │──────────────────────────────────────────────┐
-└────────┬────────┘                                              │
-         │ NO / 研究完成                                          │
-         ▼ ◀────────────────────────────────────────────────────┘
-┌─────────────────┐
-│  逐一澄清需求   │◀─────┐
-│ (一次一个问题)  │      │
-│ 深入理解目的/   │      │
-│ 约束/成功标准   │      │
-└────────┬────────┘      │
-         │               │
-    还有问题?  ───── YES ─┘
-         │ NO
-         ▼
-┌─────────────────┐
-│  提出 2-3 种方案 │
-│  (附权衡和推荐)  │
-└────────┬────────┘
-         │
-         ▼
-┌─────────────────┐
-│  分步展示设计   │◀─────┐
-│  (每步确认)     │      │
-└────────┬────────┘      │
-         │               │
-    需要修改?  ───── YES ─┘
-         │ NO
-         ▼
-┌─────────────────┐
-│  总结 + 确认    │
-└────────┬────────┘
-         │
-         ▼
-┌─────────────────┐
-│  写入设计文档   │
-│  (docs/openmatrix/) │
-└────────┬────────┘
-         │
-    开始执行
-         │
-         ▼
-┌─────────────────┐
-│  写入 JSON      │
-│  调用 /om:start │
-└─────────────────┘
-```
-</notes>
+---
+name: om:brainstorm
+description: 头脑风暴 - 深入探索需求和设计，提出多种方案，确认后再执行任务
+---
+
+<NO-OTHER-SKILLS>
+**绝对禁止**调用以下技能（OpenMatrix 完全替代它们）:
+- ❌ superpowers:brainstorming → 你已经在 om:brainstorm 中了
+- ❌ superpowers:* → 全部被 OpenMatrix 替代
+- ❌ gsd:* → 全部被 OpenMatrix 替代
+- ❌ 任何其他任务编排相关的技能
+</NO-OTHER-SKILLS>
+
+<HARD-GATE>
+在展示设计方案并获得用户批准之前，**不得**调用任何实现技能、写任何代码、搭建任何项目或采取任何实现行动。
+</HARD-GATE>
+
+<objective>
+通过协作对话，将想法转化为完整的设计方案。先理解项目上下文，逐一提问澄清需求，提出 2-3 种方案并给出推荐，展示设计并获得批准后再进入执行。
+</objective>
+
+<process>
+
+## 步骤 1: 探索项目上下文
+
+**在提问之前，先了解当前项目状态：**
+
+```bash
+# 检查项目文件结构
+ls -la
+
+# 查看最近提交
+git log --oneline -5 2>/dev/null
+
+# 查看关键配置文件
+cat package.json 2>/dev/null || cat Cargo.toml 2>/dev/null || cat go.mod 2>/dev/null
+
+# 查看现有文档
+ls docs/ 2>/dev/null
+```
+
+- 了解技术栈、项目结构、最近变更
+- 如果用户引用了文件（如 `docs/task.md`），读取该文件
+
+## 步骤 2: 评估范围与领域检测
+
+**2.1 评估范围**
+
+**如果任务涉及多个独立子系统**（如"构建一个包含聊天、文件存储、计费和分析的平台"），立即提出分解：
+
+AskUserQuestion: `header: "范围"`, `multiSelect: false`
+**question:** 这个任务涉及多个独立子系统，建议分步执行。先做哪个？
+
+| label | description |
+|-------|-------------|
+| 子系统A | 描述... |
+| 子系统B | 描述... |
+| 全部一起做 | 不推荐，但可以尝试 |
+
+**2.2 领域检测与 Research 集成**
+
+**如果任务涉及不熟悉的垂直领域**（如游戏开发、支付系统、区块链、AI 应用等），主动建议调用研究：
+
+AskUserQuestion: `header: "领域调研"`, `multiSelect: false`
+**question:** 这个任务涉及新领域，建议先进行领域调研。研究可以帮助了解行业标准、识别关键技术选型、发现常见陷阱。
+
+| label | description |
+|-------|-------------|
+| 先调研 (推荐) | 调用 /om:research 深入了解领域 |
+| 直接头脑风暴 | 我对这个领域比较熟悉 |
+
+用户选择「先调研」后，调用 `Skill: skill = "om:research", args = "任务描述"`。研究完成后，研究结论会作为头脑风暴的输入上下文。
+
+## 步骤 3: 逐一澄清需求
+
+**核心原则：一次只问一个问题。每条消息只有一个问题。**
+
+**问题不是预定义的，而是根据具体任务动态生成。** 先检查项目上下文，再针对性地提问。
+
+**问题应聚焦三个方面：**
+
+### 3.1 目的（Purpose）— 为什么做这个？
+
+根据任务动态生成选择题，示例：
+
+AskUserQuestion: `header: "目的"`, `multiSelect: false`
+**question:** 这个功能解决的核心痛点是什么？
+
+| label | description |
+|-------|-------------|
+| 提升效率 | 自动化现有手动流程 |
+| 新增能力 | 目前完全不具备的功能 |
+| 替代方案 | 替换现有的第三方服务 |
+
+### 3.2 约束（Constraints）— 有什么限制？
+
+根据任务动态生成选择题，示例：
+
+AskUserQuestion: `header: "数据模型"`, `multiSelect: true`
+**question:** 客户管理的数据需要关联哪些实体？
+
+| label | description |
+|-------|-------------|
+| 仅客户信息 | 独立的客户 CRUD |
+| 客户 + 邀请人 | 需要追踪推荐关系 |
+| 客户 + 合作历史 | 需要记录历史合作者 |
+
+### 3.3 成功标准（Success Criteria）— 怎样算完成？
+
+根据任务动态生成选择题，示例：
+
+AskUserQuestion: `header: "MVP"`, `multiSelect: false`
+**question:** 这个功能的 MVP 最小可用版本包含什么？
+
+| label | description |
+|-------|-------------|
+| 基础 CRUD | 增删改查 + 列表 |
+| CRUD + 搜索 | 支持按名称/邮箱搜索 |
+| 完整功能 | 包含关联、分组、导出等 |
+
+**提问策略：**
+- **优先选择题** — 比开放式更容易回答
+- **根据上下文定制** — 不是固定问题列表，而是基于项目状态和任务类型动态调整
+- **每个问题只关注一个方面** — 需要深入就拆成多个问题
+- **YAGNI** — 主动建议去掉不必要的功能
+- **深入追问** — 如果用户选"其他"，用开放式问题跟进
+
+## 步骤 4: 提出 2-3 种方案
+
+理解需求后，**先在界面输出方案详情**（不放在 AskUserQuestion 里），再让用户选择。
+
+**输出方案到界面（普通文本）：**
+
+```
+基于需求分析，有以下实现方案：
+
+**方案 A（推荐）: 组件化架构**
+- 每个模块独立，通过接口通信
+- 优点: 可测试性强、易维护
+- 缺点: 初始代码量较多
+
+**方案 B: 单体架构**
+- 所有功能在一个模块内
+- 优点: 开发快
+- 缺点: 难以扩展
+
+**方案 C: 微服务架构**
+- 每个功能独立服务
+- 优点: 高度解耦
+- 缺点: 复杂度高，当前规模不需要
+```
+
+**然后用简短的 AskUserQuestion 让用户选择：**
+
+AskUserQuestion: `header: "技术方案"`, `multiSelect: false`
+
+**question:** 推荐方案 A，因为...。选择哪个方案？
+
+| label | description |
+|-------|-------------|
+| 方案 A (推荐) | 组件化架构 |
+| 方案 B | 单体架构 |
+| 方案 C | 微服务架构 |
+
+## 步骤 5: 分步展示设计
+
+**逐节展示设计方案，每节确认一次：**
+
+每次展示一个设计方面：
+
+```
+📐 设计方案 - 第 1 部分: 架构
+
+┌─────────┐     ┌─────────┐     ┌─────────┐
+│  输入层  │ ──→ │  业务层  │ ──→ │  数据层  │
+└─────────┘     └─────────┘     └─────────┘
+
+- 输入层: REST API + WebSocket
+- 业务层: 核心逻辑处理
+- 数据层: PostgreSQL + Redis 缓存
+
+这部分设计是否合理？
+```
+
+**设计覆盖：**
+1. 架构设计
+2. 数据模型 / 核心实体
+3. 关键接口 / API
+4. 错误处理策略
+5. 测试策略
+
+**每个部分先在界面展示设计内容，再用简短 AskUserQuestion 确认：**
+
+AskUserQuestion: `header: "确认"`, `multiSelect: false`
+**question:** 这部分设计是否合理？
+
+| label | description |
+|-------|-------------|
+| 继续 | 设计合理，继续下一部分 |
+| 修改 | 我有调整建议 |
+
+## 步骤 6: 总结确认
+
+所有设计部分确认后，**先在界面展示完整总结**，再用简短 AskUserQuestion 确认：
+
+**输出总结到界面（普通文本）：**
+
+```
+头脑风暴总结
+
+任务: 实现客户管理系统
+
+核心目标
+   - 客户信息管理（姓名、邮箱、邀请人）
+   - 历史合作记录追踪
+
+架构
+   - 组件化设计，每个模块独立可测
+
+技术方案
+   - 数据库: PostgreSQL / 缓存: Redis / API: RESTful
+
+风险
+   - 数据迁移: 需要兼容旧格式
+
+验收标准
+   - CRUD 接口完整 / 测试覆盖率 > 80%
+```
+
+**然后让用户选择下一步：**
+
+AskUserQuestion: `header: "下一步"`, `multiSelect: false`
+**question:** 头脑风暴完成，是否开始执行任务？
+
+| label | description |
+|-------|-------------|
+| 开始执行 (推荐) | 写入 tasks-input.json 并调用 /om:start |
+| 继续探索 | 还有问题需要进一步讨论 |
+| 仅生成计划 | 生成详细计划但不执行 |
+
+## 步骤 7: 输出设计文档
+
+总结确认后，将设计写入文档，便于后续执行时参考：
+
+```bash
+# 确保目录存在
+mkdir -p docs/openmatrix
+```
+
+**写入设计文档到 `docs/openmatrix/YYYY-MM-DD-<topic>-design.md`：**
+
+```markdown
+# 设计方案: 任务标题
+
+日期: YYYY-MM-DD
+
+## 核心目标
+- 目标 1
+- 目标 2
+
+## 架构设计
+(从步骤 5 确认的内容)
+
+## 数据模型 / 核心实体
+(从步骤 5 确认的内容)
+
+## 关键接口 / API
+(从步骤 5 确认的内容)
+
+## 技术方案
+- 方案选择: 方案 X
+- 理由: ...
+
+## 错误处理策略
+(从步骤 5 确认的内容)
+
+## 测试策略
+(从步骤 5 确认的内容)
+
+## 约束与风险
+- 约束 1
+- 风险 1 及应对
+
+## 验收标准
+- 标准 1
+- 标准 2
+```
+
+**先在界面告知文档已写入，再让用户选择：**
+
+（输出到界面：设计文档已写入 `docs/openmatrix/YYYY-MM-DD-<topic>-design.md`）
+
+AskUserQuestion: `header: "下一步"`, `multiSelect: false`
+**question:** 设计文档已写入，下一步？
+
+| label | description |
+|-------|-------------|
+| 开始执行 (推荐) | 写入 tasks-input.json 并调用 /om:start |
+| 修改设计 | 需要调整设计方案 |
+
+## 步骤 8: 写入 tasks-input.json 并调用 /om:start
+
+用户选择"开始执行"后：
+
+1. **检测状态:**
+```bash
+ls .openmatrix/state.json 2>/dev/null
+```
+
+2. **初始化（如需要）:**
+```bash
+openmatrix start --init-only
+```
+
+3. **写入 `.openmatrix/tasks-input.json`:**
+```json
+{
+  "title": "任务标题",
+  "description": "基于头脑风暴的整体描述",
+  "goals": ["目标1: 独立功能模块", "目标2: 独立功能模块"],
+  "constraints": ["约束"],
+  "deliverables": ["交付物"],
+  "plan": "## 技术方案\n..."
+}
+```
+
+> **注意**: `quality`、`mode`、`e2eTests` 不在此写入，由 `/om:start` 的必选问题决定。
+
+4. **⚠️ 必须执行（不可跳过）：使用 Skill 工具调用 `/om:start`**
+
+```
+Skill 工具: skill = "om:start"
+```
+
+这不是可选的 — 如果不调用 `/om:start`，任务不会开始执行。
+`/om:start` 会检测到已存在的 `tasks-input.json`，然后询问必选问题（质量等级、E2E、执行模式）。
+
+</process>
+
+<arguments>
+$ARGUMENTS
+</arguments>
+
+<examples>
+/om:brainstorm                      # 交互式头脑风暴
+/om:brainstorm docs/task.md         # 基于任务文件头脑风暴
+/om:brainstorm "实现用户登录功能"    # 基于描述头脑风暴
+</examples>
+
+<notes>
+## 关键原则
+
+- **一次只问一个问题** — 不要一次问多个
+- **优先选择题** — 比开放式更容易回答
+- **YAGNI** — 主动建议去掉不必要的设计
+- **提出 2-3 种方案** — 带权衡和推荐
+- **分步确认** — 每部分设计确认后再继续
+- **为隔离而设计** — 每个模块应有清晰的边界和接口
+- **问题要贴合任务** — 不问泛泛的问题，而是针对具体任务深入
+- **理解目的 > 理解实现** — 先搞清楚为什么做，再讨论怎么做
+
+## 领域调研集成
+
+- 检测到垂直领域（游戏、支付、区块链等）时，主动建议 `/om:research`
+- 研究完成后，研究结论作为后续提问和设计的输入上下文
+- 如果用户对领域熟悉，可以跳过研究直接进入头脑风暴
+- 研究产出的文档可引用在设计文档中
+
+## 设计文档
+
+- 每次头脑风暴都会输出设计文档到 `docs/openmatrix/YYYY-MM-DD-<topic>-design.md`
+- 文档包含：核心目标、架构、数据模型、接口、技术方案、错误处理、测试策略、风险、验收标准
+- 设计文档是 `/om:start` 执行时的重要参考
+- 文档内容来自步骤 5 逐节确认的设计
+
+## 在已有代码库中工作
+
+- 提出变更前，先探索现有结构，遵循现有模式
+- 如果现有代码有问题（文件太大、边界不清、职责混乱），在设计中有针对性地改进
+- 不要提出无关的重构建议，聚焦当前目标
+
+## 问题深度示例
+
+**不好的问题（太泛）：**
+- "你的技术栈是什么？"
+- "你需要测试吗？"
+
+**好的问题（贴合具体任务）：**
+- "客户管理的邀请人字段，是只记录最近一个邀请人，还是需要完整的邀请链？"
+- "站内信需要支持已读/未读状态吗？还是只需要通知推送？"
+- "物流追踪是实时推送还是定时轮询？这影响 API 设计。"
+
+## 流程图
+
+```
+┌─────────────────┐
+│  探索项目上下文  │
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│  评估范围       │
+│ (是否需要分解)  │
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│  领域检测       │     YES → /om:research → 研究结论作为上下文
+│ (是否需要调研)  │──────────────────────────────────────────────┐
+└────────┬────────┘                                              │
+         │ NO / 研究完成                                          │
+         ▼ ◀────────────────────────────────────────────────────┘
+┌─────────────────┐
+│  逐一澄清需求   │◀─────┐
+│ (一次一个问题)  │      │
+│ 深入理解目的/   │      │
+│ 约束/成功标准   │      │
+└────────┬────────┘      │
+         │               │
+    还有问题?  ───── YES ─┘
+         │ NO
+         ▼
+┌─────────────────┐
+│  提出 2-3 种方案 │
+│  (附权衡和推荐)  │
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│  分步展示设计   │◀─────┐
+│  (每步确认)     │      │
+└────────┬────────┘      │
+         │               │
+    需要修改?  ───── YES ─┘
+         │ NO
+         ▼
+┌─────────────────┐
+│  总结 + 确认    │
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│  写入设计文档   │
+│  (docs/openmatrix/) │
+└────────┬────────┘
+         │
+    开始执行
+         │
+         ▼
+┌─────────────────┐
+│  写入 JSON      │
+│  调用 /om:start │
+└─────────────────┘
+```
+</notes>

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`