openmatrix 0.1.81 → 0.1.83

package/dist/orchestrator/git-commit-manager.d.ts

@@ -58,13 +58,11 @@ export declare class GitCommitManager {
      * 格式规范:
      * <type>: (TASK-XXX) 简短描述
      *
-     * - 改动点1
-     * - 改动点2
+     * <phase 描述>
      *
      * 影响范围: 模块/功能
-     * 文件改动: 文件1, 文件2
      *
-     * Run: run-xxx (可选)
+     * Run: run-xxx
      * Co-Authored-By: OpenMatrix <https://github.com/bigfish1913/openmatrix>
      */
     generateCommitMessage(info: CommitInfo): string;

package/dist/orchestrator/git-commit-manager.js

@@ -157,13 +157,11 @@ class GitCommitManager {
      * 格式规范:
      * <type>: (TASK-XXX) 简短描述
      *
-     * - 改动点1
-     * - 改动点2
+     * <phase 描述>
      *
      * 影响范围: 模块/功能
-     * 文件改动: 文件1, 文件2
      *
-     * Run: run-xxx (可选)
+     * Run: run-xxx
      * Co-Authored-By: OpenMatrix <https://github.com/bigfish1913/openmatrix>
      */
     generateCommitMessage(info) {
@@ -173,43 +171,32 @@ class GitCommitManager {
             tdd: 'test',
             develop: 'feat',
             verify: 'test',
-            accept: 'feat'
+            accept: 'chore'
         };
         const commitType = phaseToType[info.phase] || 'feat';
-        // 标题行 - 限制 50 字符
+        // 标题行 - 限制 72 字符
         let title = info.taskTitle;
-        if (title.length > 50) {
-            title = title.slice(0, 47) + '...';
+        if (title.length > 60) {
+            title = title.slice(0, 57) + '...';
         }
-        // 格式: feat: (TASK-001) 简短描述
-        lines.push(`${commitType}: (${info.taskId}) ${title}`);
+        // 格式: feat(TASK-001): 简短描述
+        lines.push(`${commitType}(${info.taskId}): ${title}`);
         lines.push('');
-        // 修改内容 - 使用文件名作为改动点
-        if (info.changes.length > 0) {
-            for (const change of info.changes.slice(0, 10)) {
-                lines.push(`- ${change}`);
-            }
-            if (info.changes.length > 10) {
-                lines.push(`- ... 及其他 ${info.changes.length - 10} 项修改`);
-            }
-            lines.push('');
-        }
+        // Phase 描述
+        const phaseDescriptions = {
+            tdd: '编写测试用例',
+            develop: '实现功能代码',
+            verify: '运行测试验证',
+            accept: '验收检查通过'
+        };
+        lines.push(phaseDescriptions[info.phase] || '代码变更');
         // 影响范围
         if (info.impactScope.length > 0) {
+            lines.push('');
             lines.push(`影响范围: ${info.impactScope.join('、')}`);
         }
-        // 文件改动 - 简化显示
-        const changedFiles = info.changes.slice(0, 5).map(f => {
-            const parts = f.split('/');
-            return parts.length > 2 ? parts.slice(-2).join('/') : f;
-        });
-        if (changedFiles.length > 0) {
-            const fileSummary = changedFiles.join(', ');
-            const suffix = info.changes.length > 5 ? ` 等 ${info.changes.length} 个文件` : '';
-            lines.push(`文件改动: ${fileSummary}${suffix}`);
-        }
         lines.push('');
-        // Run ID (可选)
+        // Run ID
         if (info.runId) {
             lines.push(`Run: ${info.runId}`);
         }

package/package.json

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

package/skills/auto.md

@@ -152,7 +152,7 @@ openmatrix complete TASK-XXX --success       # 标记完成 + 更新统计（含
 # 提交验证（防止 commit 静默失败）:
 git status --porcelain                        # 检查是否有未提交的文件
 # 如果有未提交文件 → 必须手动提交:
-git add -A && git commit -m "feat: (TASK-XXX) 任务标题"
+git add -A && git commit -m "feat(TASK-XXX): 任务标题"
 
 openmatrix step --json                       # 获取下一个任务 + 检查是否全部完成
 ```
@@ -227,13 +227,9 @@ Agent-1 完成 → 写入 context.md → Agent-2 读取 Agent-1 的上下文 →
 ```
 ```bash
 git add -A && git commit -m "$(cat <<'EOF'
-feat: (TASK-XXX) 任务标题
-
-- 改动点1
-- 改动点2
+feat(TASK-XXX): 任务标题
 
 影响范围: 模块名
-文件改动: 文件1, 文件2
 
 Run: run-XXX
 Co-Authored-By: OpenMatrix <https://github.com/bigfish1913/openmatrix>
@@ -246,13 +242,9 @@ EOF
 **Git 提交格式规范（所有提交必须遵守）:**
 
 ```
-<type>: (TASK-XXX) 简短描述
-
-- 改动点1
-- 改动点2
+<type>(TASK-XXX): 简短描述
 
 影响范围: 模块名
-文件改动: 文件1, 文件2
 
 Run: run-XXX
 Co-Authored-By: OpenMatrix <https://github.com/bigfish1913/openmatrix>

package/skills/brainstorm.md

@@ -42,7 +42,9 @@ ls docs/ 2>/dev/null
 - 了解技术栈、项目结构、最近变更
 - 如果用户引用了文件（如 `docs/task.md`），读取该文件
 
-## 步骤 2: 评估范围
+## 步骤 2: 评估范围与领域检测
+
+**2.1 评估范围**
 
 **如果任务涉及多个独立子系统**（如"构建一个包含聊天、文件存储、计费和分析的平台"），立即提出分解：
 
@@ -61,6 +63,31 @@ AskUserQuestion({
 })
 ```
 
+**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: 逐一澄清需求
 
 **核心原则：一次只问一个问题。每条消息只有一个问题。**
@@ -249,7 +276,69 @@ AskUserQuestion({
 })
 ```
 
-## 步骤 7: 写入 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
+```
+
+```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
 
 用户选择"开始执行"后：
 
@@ -310,6 +399,20 @@ $ARGUMENTS
 - **问题要贴合任务** — 不问泛泛的问题，而是针对具体任务深入
 - **理解目的 > 理解实现** — 先搞清楚为什么做，再讨论怎么做
 
+## 领域调研集成
+
+- 检测到垂直领域（游戏、支付、区块链等）时，主动建议 `/om:research`
+- 研究完成后，研究结论作为后续提问和设计的输入上下文
+- 如果用户对领域熟悉，可以跳过研究直接进入头脑风暴
+- 研究产出的文档可引用在设计文档中
+
+## 设计文档
+
+- 每次头脑风暴都会输出设计文档到 `docs/openmatrix/YYYY-MM-DD-<topic>-design.md`
+- 文档包含：核心目标、架构、数据模型、接口、技术方案、错误处理、测试策略、风险、验收标准
+- 设计文档是 `/om:start` 执行时的重要参考
+- 文档内容来自步骤 5 逐节确认的设计
+
 ## 在已有代码库中工作
 
 - 提出变更前，先探索现有结构，遵循现有模式
@@ -342,6 +445,12 @@ $ARGUMENTS
          │
          ▼
 ┌─────────────────┐
+│  领域检测       │     YES → /om:research → 研究结论作为上下文
+│ (是否需要调研)  │──────────────────────────────────────────────┐
+└────────┬────────┘                                              │
+         │ NO / 研究完成                                          │
+         ▼ ◀────────────────────────────────────────────────────┘
+┌─────────────────┐
 │  逐一澄清需求   │◀─────┐
 │ (一次一个问题)  │      │
 │ 深入理解目的/   │      │
@@ -367,6 +476,12 @@ $ARGUMENTS
          ▼
 ┌─────────────────┐
 │  总结 + 确认    │
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│  写入设计文档   │
+│  (docs/openmatrix/) │
 └────────┬────────┘
          │
     开始执行

package/skills/start.md

@@ -297,7 +297,7 @@ openmatrix complete TASK-XXX --success --summary "决策: xxx; 文件: xxx"
 # 提交验证（防止 commit 静默失败）:
 git status --porcelain                        # 检查是否有未提交的文件
 # 如果有未提交文件 → 必须手动提交:
-git add -A && git commit -m "feat: (TASK-XXX) 任务标题"
+git add -A && git commit -m "feat(TASK-XXX): 任务标题"
 
 openmatrix step --json                       # 获取下一个任务 + 检查是否全部完成
 ```
@@ -420,14 +420,9 @@ openmatrix meeting --list
 所有任务完成后，执行最终 Git 提交（**必须使用 HEREDOC 格式**）:
 ```bash
 git add -A && git commit -m "$(cat <<'EOF'
-feat: 完成所有任务
-
-- 任务1标题
-- 任务2标题
-- ...
+feat: 完成所有任务 - 任务总标题
 
 影响范围: 全部模块
-文件改动: 统计变更文件数
 
 Run: run-XXX
 Co-Authored-By: OpenMatrix <https://github.com/bigfish1913/openmatrix>
@@ -438,13 +433,11 @@ EOF
 **Git 提交格式规范（所有提交必须遵守）:**
 
 ```
-<type>: (TASK-XXX) 简短描述
+<type>(TASK-XXX): 简短描述
 
-- 改动点1
-- 改动点2
+实现/修改内容一句话描述
 
 影响范围: 模块名
-文件改动: 文件1, 文件2
 
 Run: run-XXX
 Co-Authored-By: OpenMatrix <https://github.com/bigfish1913/openmatrix>