openmatrix 0.2.4 → 0.2.6

package/dist/orchestrator/debug-reporter.js

@@ -0,0 +1,167 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DebugReporter = void 0;
+// src/orchestrator/debug-reporter.ts
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * 生成和保存诊断报告
+ */
+class DebugReporter {
+    debugDir;
+    constructor(basePath) {
+        this.debugDir = path.join(basePath, 'debug');
+        this.ensureDir();
+    }
+    /**
+     * 生成诊断报告文件
+     */
+    async generateReport(session) {
+        const report = session.report;
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+        const fileName = `${report.id}-report-${timestamp}.md`;
+        const filePath = path.join(this.debugDir, fileName);
+        const content = this.formatReport(session);
+        fs.writeFileSync(filePath, content, 'utf-8');
+        return filePath;
+    }
+    /**
+     * 格式化报告内容为 Markdown
+     */
+    formatReport(session) {
+        const { report, fixResult, verifyResult } = session;
+        let md = `# Debug Report\n\n`;
+        md += `**会话 ID**: ${session.id}\n`;
+        md += `**日期**: ${session.createdAt}\n`;
+        md += `**状态**: ${session.status}\n`;
+        if (session.completedAt) {
+            md += `**完成时间**: ${session.completedAt}\n`;
+        }
+        md += `\n---\n\n`;
+        // 问题描述
+        md += `## 问题描述\n\n${report.description}\n\n`;
+        // 问题类型
+        md += `## 问题类型\n\n\`${report.problemType}\`\n\n`;
+        if (report.relatedTaskId) {
+            md += `**关联任务**: ${report.relatedTaskId}\n\n`;
+        }
+        // 诊断结果
+        md += `## 诊断结果\n\n`;
+        md += `### 根因\n\n${report.rootCause}\n\n`;
+        if (report.errorInfo) {
+            md += `### 错误信息\n\n`;
+            md += `\`\`\`\n${report.errorInfo.message}\n\`\`\`\n\n`;
+            if (report.errorInfo.stack) {
+                md += `### 错误栈\n\n\`\`\`\n${report.errorInfo.stack}\n\`\`\`\n\n`;
+            }
+        }
+        // 影响范围
+        if (report.impactScope.length > 0) {
+            md += `### 影响范围\n\n`;
+            report.impactScope.forEach((item) => { md += `- ${item}\n`; });
+            md += `\n`;
+        }
+        // 相关文件
+        if (report.relatedFiles && report.relatedFiles.length > 0) {
+            md += `### 相关文件\n\n`;
+            report.relatedFiles.forEach((file) => { md += `- \`${file}\`\n`; });
+            md += `\n`;
+        }
+        // 修复建议
+        md += `## 修复建议\n\n${report.suggestedFix}\n\n`;
+        // 修复操作
+        if (fixResult) {
+            md += `## 修复操作\n\n`;
+            if (fixResult.success) {
+                md += `✅ 修复成功\n\n`;
+            }
+            else {
+                md += `❌ 修复未完全生效\n\n`;
+            }
+            if (fixResult.modifiedFiles.length > 0) {
+                md += `### 修改文件\n\n`;
+                fixResult.modifiedFiles.forEach((file) => { md += `- \`${file}\`\n`; });
+                md += `\n`;
+            }
+            if (fixResult.operations.length > 0) {
+                md += `### 执行操作\n\n`;
+                fixResult.operations.forEach((op) => { md += `- ${op}\n`; });
+                md += `\n`;
+            }
+        }
+        // 验证结果
+        if (verifyResult) {
+            md += `## 验证结果\n\n`;
+            if (verifyResult.passed) {
+                md += `✅ 验证通过\n\n`;
+            }
+            else {
+                md += `❌ 验证未通过\n\n`;
+            }
+            md += `${verifyResult.details}\n\n`;
+        }
+        // 重试信息
+        if (session.retryCount > 0) {
+            md += `## 重试信息\n\n已尝试 ${session.retryCount} 次修复\n\n`;
+            if (session.retryCount >= 3) {
+                md += `⚠️ **已尝试 3 次以上修复，建议暂停并质疑架构**\n\n`;
+            }
+        }
+        return md;
+    }
+    /**
+     * 列出所有诊断报告
+     */
+    listReports() {
+        if (!fs.existsSync(this.debugDir))
+            return [];
+        const files = fs.readdirSync(this.debugDir)
+            .filter(f => f.endsWith('-report.md') || f.includes('-report-'))
+            .sort()
+            .reverse();
+        return files.map(f => ({
+            id: f.split('-')[0],
+            path: path.join(this.debugDir, f),
+            createdAt: f
+        }));
+    }
+    ensureDir() {
+        if (!fs.existsSync(this.debugDir)) {
+            fs.mkdirSync(this.debugDir, { recursive: true });
+        }
+    }
+}
+exports.DebugReporter = DebugReporter;

package/dist/orchestrator/problem-detector.d.ts

@@ -0,0 +1,15 @@
+import type { ProblemType } from '../types/index.js';
+export interface ProblemDetectionConfig {
+    description?: string;
+    taskId?: string;
+    taskError?: string | null;
+}
+/**
+ * 判断问题类型的检测器
+ */
+export declare class ProblemDetector {
+    /**
+     * 根据配置判断问题类型
+     */
+    detect(config: ProblemDetectionConfig): Promise<ProblemType>;
+}

package/dist/orchestrator/problem-detector.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProblemDetector = void 0;
+/**
+ * 判断问题类型的检测器
+ */
+class ProblemDetector {
+    /**
+     * 根据配置判断问题类型
+     */
+    async detect(config) {
+        // 有任务 ID 且任务失败
+        if (config.taskId && config.taskError) {
+            return 'task_failure';
+        }
+        // 根据描述判断
+        if (config.description) {
+            const desc = config.description.toLowerCase();
+            // 环境相关关键词
+            const envKeywords = [
+                '依赖', '安装', '环境', '配置', 'npm install', 'node_modules',
+                'env', 'environment', 'dependency', 'install', 'config',
+                'path', '版本', 'version', '权限', 'permission'
+            ];
+            // 项目代码相关关键词
+            const projectKeywords = [
+                '接口', 'api', '函数', 'function', '返回', 'response',
+                '数据', 'data', '逻辑', 'logic', '页面', 'page',
+                '组件', 'component', '样式', 'style', '渲染', 'render'
+            ];
+            // 系统/OpenMatrix 相关关键词
+            const systemKeywords = [
+                'openmatrix', 'cli', '命令', 'command', '状态', 'state',
+                '任务', 'task', '编排', 'orchestrat', 'agent', '技能', 'skill'
+            ];
+            const hasEnvKeyword = envKeywords.some(kw => desc.includes(kw));
+            const hasProjectKeyword = projectKeywords.some(kw => desc.includes(kw));
+            const hasSystemKeyword = systemKeywords.some(kw => desc.includes(kw));
+            // 优先级：环境 > 项目 > 系统
+            if (hasEnvKeyword)
+                return 'environment';
+            if (hasProjectKeyword)
+                return 'project_bug';
+            if (hasSystemKeyword)
+                return 'system_bug';
+        }
+        // 默认：系统 bug
+        return 'system_bug';
+    }
+}
+exports.ProblemDetector = ProblemDetector;

package/dist/types/index.d.ts

@@ -267,3 +267,47 @@ export interface ResearchSession {
     createdAt: string;
     completedAt?: string;
 }
+/** 问题类型 */
+export type ProblemType = 'task_failure' | 'project_bug' | 'system_bug' | 'environment';
+/** 诊断报告 */
+export interface DiagnosisReport {
+    id: string;
+    problemType: ProblemType;
+    trigger: 'explicit' | 'auto';
+    description: string;
+    errorInfo?: {
+        message: string;
+        stack?: string;
+        timestamp: string;
+    };
+    relatedTaskId?: string;
+    relatedFiles?: string[];
+    rootCause: string;
+    impactScope: string[];
+    suggestedFix: string;
+    diagnosedAt: string;
+    diagnosisDuration?: number;
+}
+/** 调试会话状态 */
+export type DebugStatus = 'initialized' | 'diagnosing' | 'awaiting_fix' | 'fixing' | 'verifying' | 'completed' | 'cancelled';
+/** 调试会话 */
+export interface DebugSession {
+    id: string;
+    status: DebugStatus;
+    report: DiagnosisReport;
+    fixDecision?: 'approve' | 'skip' | 'manual';
+    fixResult?: {
+        success: boolean;
+        operations: string[];
+        modifiedFiles: string[];
+        output: string;
+    };
+    verifyResult?: {
+        passed: boolean;
+        details: string;
+    };
+    retryCount: number;
+    createdAt: string;
+    updatedAt: string;
+    completedAt?: string;
+}

package/package.json

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

package/skills/approve.md

@@ -1,6 +1,6 @@
 ---
 name: om:approve
-description: 审批待处理项（包括计划、合并、部署、Meeting）
+description: "Use when handling pending approvals including plan review, merge confirmation, deploy approval, and blocked task decisions during OpenMatrix execution. Triggers on: 审批, approve, 批准, plan review, merge conflict resolution, deploy confirmation, 阻塞处理, technical decision, pending approval, waiting for approval, 待确认."
 ---
 
 <NO-OTHER-SKILLS>

package/skills/auto.md

@@ -1,6 +1,6 @@
 ---
 name: om:auto
-description: 全自动执行任务指令 - AI 拆分，无阻塞，bypass permissions
+description: "Use when the user wants fully automated task execution with zero manual approvals. Triggers on: 全自动, 无人值守, hands-free, non-stop, don't ask me, 直接执行, skip all confirmations, batch refactor, large migration, bulk changes. Use for multi-task execution where the user doesn't want to be interrupted at any approval point (plan/merge/deploy)."
 ---
 
 <NOTE>
@@ -9,7 +9,9 @@ description: 全自动执行任务指令 - AI 拆分，无阻塞，bypass permis
 - **`/om:auto`** 是一个 **Skill 指令**，为 Agent 无障碍执行准备
 - **「全自动执行」**是 `/om:start` 中用户选择的 **执行模式选项**
 
-**关键区别**：`/om/auto` 不创建 Meeting 记录，直接跳过阻塞任务。
+**关键区别**：`/om:auto` 不创建 Meeting 记录，直接跳过阻塞任务。
+
+**相关技能**: `/om:start` (交互式) | `/om:status` (状态查看) | `/om:report` (报告)
 </NOTE>
 
 <NO-OTHER-SKILLS>
@@ -283,16 +285,21 @@ $ARGUMENTS
 ## 执行流程
 
 ```
-Step 1: 初始化 .openmatrix
-    ↓
-Step 2: AI 提取 goals + 生成 plan
-    ↓
-Step 3: 写入 tasks-input.json
-    ↓
-Step 4: openmatrix start --tasks-json   ← 必须执行
-    ↓
-Step 5: 读取 subagentTasks
-    ↓
-Step 6: Agent 逐个执行                  ← 只有这里写代码
+Step 1: 初始化 .openmatrix → Step 2: 提取 goals + plan → Step 3: 写入 tasks-input.json
+→ Step 4: openmatrix start --tasks-json (必须) → Step 5: 读取 subagentTasks
+→ Step 6: Agent 逐个执行 (只有这里写代码)
+```
+
+## Git 提交格式
+
 ```
+<type>(TASK-XXX): 简短描述
+
+改动点1 / 改动点2
+影响范围: 模块名
+文件改动: 文件1, 文件2
+Co-Authored-By: OpenMatrix https://github.com/bigfish1913/openmatrix
+```
+
+type: feat/fix/test/refactor/docs。禁止 emoji。
 </notes>

package/skills/brainstorm.md

@@ -1,6 +1,6 @@
 ---
 name: om:brainstorm
-description: 头脑风暴 - 深入探索需求和设计，提出多种方案，确认后再执行任务
+description: "Use when the user wants to explore requirements, design alternatives, or validate ideas before implementation. Triggers on: 头脑风暴, 设计方案, 需求分析, 技术选型, architecture design, 'how should I build', multi-module features, new projects from scratch, unclear requirements, complex system design. Use even if the user just says 'implement X' and the task involves multiple modules or unclear requirements — brainstorm first, don't jump straight to coding."
 ---
 
 <NO-OTHER-SKILLS>
@@ -9,6 +9,8 @@ description: 头脑风暴 - 深入探索需求和设计，提出多种方案，
 - ❌ superpowers:* → 全部被 OpenMatrix 替代
 - ❌ gsd:* → 全部被 OpenMatrix 替代
 - ❌ 任何其他任务编排相关的技能
+
+**相关技能**: `/om:research` (领域调研) | `/om:start` (任务执行) | `/om:auto` (全自动)
 </NO-OTHER-SKILLS>
 
 <HARD-GATE>