openmatrix 0.1.13 → 0.1.15

package/dist/cli/commands/auto.js

@@ -41,6 +41,7 @@ const task_parser_js_1 = require("../../orchestrator/task-parser.js");
 const task_planner_js_1 = require("../../orchestrator/task-planner.js");
 const approval_manager_js_1 = require("../../orchestrator/approval-manager.js");
 const executor_js_1 = require("../../orchestrator/executor.js");
+const gitignore_js_1 = require("../../utils/gitignore.js");
 const index_js_1 = require("../../types/index.js");
 const fs = __importStar(require("fs/promises"));
 const path = __importStar(require("path"));
@@ -56,6 +57,8 @@ exports.autoCommand = new commander_1.Command('auto')
     await fs.mkdir(omPath, { recursive: true });
     await fs.mkdir(path.join(omPath, 'tasks'), { recursive: true });
     await fs.mkdir(path.join(omPath, 'approvals'), { recursive: true });
+    // 确保 .openmatrix 被 git 忽略
+    await (0, gitignore_js_1.ensureOpenmatrixGitignore)(basePath);
     const stateManager = new state_manager_js_1.StateManager(omPath);
     await stateManager.initialize();
     const state = await stateManager.getState();

package/dist/cli/commands/start.js

@@ -41,15 +41,23 @@ const task_parser_js_1 = require("../../orchestrator/task-parser.js");
 const task_planner_js_1 = require("../../orchestrator/task-planner.js");
 const approval_manager_js_1 = require("../../orchestrator/approval-manager.js");
 const executor_js_1 = require("../../orchestrator/executor.js");
+const gitignore_js_1 = require("../../utils/gitignore.js");
+const index_js_1 = require("../../types/index.js");
 const fs = __importStar(require("fs/promises"));
 const path = __importStar(require("path"));
 exports.startCommand = new commander_1.Command('start')
     .description('启动新的任务执行周期')
     .argument('[input]', '任务文件路径或描述')
     .option('-c, --config <path>', '配置文件路径')
+    .option('--init-only', '仅初始化 .openmatrix 目录，不执行任务')
     .option('--skip-questions', '跳过澄清问题')
     .option('--mode <mode>', '执行模式 (confirm-all|confirm-key|auto)')
     .option('--json', '输出 JSON 格式 (供 Skill 解析)')
+    .option('--title <title>', '任务标题')
+    .option('--description <desc>', '任务描述')
+    .option('-q, --quality <level>', '质量级别 (strict|balanced|fast)')
+    .option('-t, --tech-stack <stack>', '技术栈 (逗号分隔，如 "TypeScript,Vue.js,PostgreSQL")')
+    .option('--docs <level>', '文档级别 (full|basic|minimal|none)')
     .action(async (input, options) => {
     const basePath = process.cwd();
     const omPath = path.join(basePath, '.openmatrix');
@@ -57,6 +65,23 @@ exports.startCommand = new commander_1.Command('start')
     await fs.mkdir(omPath, { recursive: true });
     await fs.mkdir(path.join(omPath, 'tasks'), { recursive: true });
     await fs.mkdir(path.join(omPath, 'approvals'), { recursive: true });
+    // 确保 .openmatrix 被 git 忽略
+    await (0, gitignore_js_1.ensureOpenmatrixGitignore)(basePath);
+    // --init-only 模式：仅初始化目录后返回
+    if (options.initOnly) {
+        if (options.json) {
+            console.log(JSON.stringify({
+                status: 'initialized',
+                message: '.openmatrix 目录已初始化',
+                path: omPath
+            }));
+        }
+        else {
+            console.log('✅ .openmatrix 目录已初始化');
+            console.log(`   路径: ${omPath}`);
+        }
+        return;
+    }
     const stateManager = new state_manager_js_1.StateManager(omPath);
     await stateManager.initialize();
     const state = await stateManager.getState();
@@ -76,10 +101,18 @@ exports.startCommand = new commander_1.Command('start')
         }
         return;
     }
-    // 获取任务内容
+    // 构建任务内容
     let taskContent = input;
+    // 如果提供了 --title 和 --description，构建任务内容
+    if (options.title || options.description) {
+        const title = options.title || '未命名任务';
+        const description = options.description || '';
+        const techStack = options.techStack ? `\n\n技术栈: ${options.techStack}` : '';
+        const docs = options.docs ? `\n文档要求: ${options.docs}` : '';
+        taskContent = `# ${title}\n\n${description}${techStack}${docs}`;
+    }
+    // 如果没有任务内容，尝试读取默认文件
     if (!taskContent) {
-        // 尝试读取默认任务文件
         const defaultPath = path.join(basePath, 'TASK.md');
         try {
             taskContent = await fs.readFile(defaultPath, 'utf-8');
@@ -98,6 +131,7 @@ exports.startCommand = new commander_1.Command('start')
                 console.log('❌ 请提供任务文件路径或描述');
                 console.log('   用法: openmatrix start <task.md>');
                 console.log('   或创建 TASK.md 文件');
+                console.log('   或使用 --title 和 --description 选项');
             }
             return;
         }
@@ -155,9 +189,6 @@ exports.startCommand = new commander_1.Command('start')
     const executionMode = options.mode || 'confirm-key';
     let approvalPoints = [];
     // 根据模式设置审批点
-    // auto 模式: 空数组，不暂停任何审批点
-    // confirm-key 模式: 仅在关键节点暂停
-    // confirm-all 模式: 每个阶段都暂停
     switch (executionMode) {
         case 'confirm-all':
             approvalPoints = ['plan', 'phase', 'merge', 'deploy'];
@@ -166,18 +197,27 @@ exports.startCommand = new commander_1.Command('start')
             approvalPoints = ['plan', 'merge', 'deploy'];
             break;
         case 'auto':
-            approvalPoints = []; // 全自动模式：无任何审批点
+            approvalPoints = [];
             break;
         default:
             approvalPoints = ['plan', 'merge'];
     }
+    // 处理质量配置
+    let qualityConfig;
+    if (options.quality) {
+        const qualityLevel = options.quality.toLowerCase();
+        if (['strict', 'balanced', 'fast'].includes(qualityLevel)) {
+            qualityConfig = index_js_1.QUALITY_PRESETS[qualityLevel];
+        }
+    }
     // 更新状态
     await stateManager.updateState({
         status: 'running',
         currentPhase: 'execution',
         config: {
             ...state.config,
-            approvalPoints: approvalPoints
+            approvalPoints: approvalPoints,
+            quality: qualityConfig || state.config.quality
         }
     });
     // 创建审批请求（如果有审批点）
@@ -195,7 +235,15 @@ exports.startCommand = new commander_1.Command('start')
                     index: i + 1,
                     title: t.title,
                     priority: t.priority
-                }))
+                })),
+                // 额外信息供 Skill 使用
+                taskInfo: {
+                    title: options.title || parsedTask.title,
+                    description: options.description,
+                    quality: options.quality,
+                    techStack: options.techStack,
+                    docs: options.docs
+                }
             }));
         }
         else {
@@ -205,6 +253,12 @@ exports.startCommand = new commander_1.Command('start')
             });
             console.log(`\n🎯 执行模式: ${executionMode}`);
             console.log(`   审批点: ${approvalPoints.join(', ')}`);
+            if (options.quality) {
+                console.log(`   质量级别: ${options.quality}`);
+            }
+            if (options.techStack) {
+                console.log(`   技术栈: ${options.techStack}`);
+            }
             console.log(`\n⏸️  等待计划审批`);
             console.log(`   审批ID: ${approval.id}`);
             console.log(`   使用 /om:approve ${approval.id} 审批`);
@@ -239,7 +293,15 @@ exports.startCommand = new commander_1.Command('start')
                 taskId: t.taskId,
                 agentType: t.agentType,
                 timeout: t.timeout
-            }))
+            })),
+            // 额外信息供 Skill 使用
+            taskInfo: {
+                title: options.title || parsedTask.title,
+                description: options.description,
+                quality: options.quality,
+                techStack: options.techStack,
+                docs: options.docs
+            }
         }));
     }
     else {
@@ -249,6 +311,12 @@ exports.startCommand = new commander_1.Command('start')
         });
         console.log(`\n🎯 执行模式: ${executionMode}`);
         console.log(`   审批点: ${approvalPoints.length > 0 ? approvalPoints.join(', ') : '无 (全自动)'}`);
+        if (options.quality) {
+            console.log(`   质量级别: ${options.quality}`);
+        }
+        if (options.techStack) {
+            console.log(`   技术栈: ${options.techStack}`);
+        }
         console.log('\n🚀 开始执行...');
         console.log('   使用 /om:status 查看进度');
     }

package/dist/utils/gitignore.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 确保指定目录被 git 忽略
+ * @param basePath 项目根目录
+ * @param ignorePattern 要忽略的模式 (默认 .openmatrix/)
+ */
+export declare function ensureGitignore(basePath: string, ignorePattern?: string): Promise<void>;
+/**
+ * 确保 .openmatrix 目录被 git 忽略
+ */
+export declare function ensureOpenmatrixGitignore(basePath: string): Promise<void>;

package/dist/utils/gitignore.js

@@ -0,0 +1,78 @@
+"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.ensureGitignore = ensureGitignore;
+exports.ensureOpenmatrixGitignore = ensureOpenmatrixGitignore;
+// src/utils/gitignore.ts
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+/**
+ * 确保指定目录被 git 忽略
+ * @param basePath 项目根目录
+ * @param ignorePattern 要忽略的模式 (默认 .openmatrix/)
+ */
+async function ensureGitignore(basePath, ignorePattern = '.openmatrix/') {
+    const gitignorePath = path.join(basePath, '.gitignore');
+    try {
+        const content = await fs.readFile(gitignorePath, 'utf-8');
+        // 检查是否已经包含该模式
+        const lines = content.split('\n');
+        const patternBase = ignorePattern.replace(/\/$/, '');
+        const hasPattern = lines.some(line => {
+            const trimmed = line.trim();
+            return trimmed === patternBase ||
+                trimmed === `${patternBase}/` ||
+                trimmed === `/${patternBase}` ||
+                trimmed === `/${patternBase}/`;
+        });
+        if (!hasPattern) {
+            // 添加模式到 .gitignore
+            const newContent = content.endsWith('\n')
+                ? `${content}${ignorePattern}\n`
+                : `${content}\n\n# Auto-added by OpenMatrix\n${ignorePattern}\n`;
+            await fs.writeFile(gitignorePath, newContent);
+        }
+    }
+    catch {
+        // .gitignore 不存在，创建一个新的
+        await fs.writeFile(gitignorePath, `# OpenMatrix state\n${ignorePattern}\n`);
+    }
+}
+/**
+ * 确保 .openmatrix 目录被 git 忽略
+ */
+async function ensureOpenmatrixGitignore(basePath) {
+    await ensureGitignore(basePath, '.openmatrix/');
+}

package/package.json

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

package/skills/om-check.md

@@ -1,6 +1,6 @@
 ---
 name: om:check
-description: 自动检测项目可改进点并提供升级建议，支持交互式确认
+description: 自动检测项目可改进点并提供升级建议，支持交互式确认后自动执行
 ---
 
 <NO-OTHER-SKILLS>
@@ -8,7 +8,7 @@ description: 自动检测项目可改进点并提供升级建议，支持交互
 </NO-OTHER-SKILLS>
 
 <objective>
-自动扫描项目代码，检测可改进点，生成升级建议列表供用户确认后执行。支持用户提示聚焦检测方向。
+自动扫描项目代码，检测可改进点，用户确认后自动调用 /om:start 执行改进。
 </objective>
 
 <trigger-conditions>
@@ -47,8 +47,6 @@ description: 自动检测项目可改进点并提供升级建议，支持交互
    {
      "projectType": "openmatrix|ai-project|nodejs|typescript|python|go|rust|java|csharp|cpp|php|dart",
      "projectName": "项目名称",
-     "scanPath": "/path/to/project",
-     "timestamp": "2025-01-01T00:00:00.000Z",
      "suggestions": [
        {
          "id": "UPG-001",
@@ -56,81 +54,80 @@ description: 自动检测项目可改进点并提供升级建议，支持交互
          "priority": "critical|high|medium|low",
          "title": "建议标题",
          "description": "详细描述",
-         "location": {
-           "file": "src/example.ts",
-           "line": 42
-         },
-         "suggestion": "改进建议",
-         "autoFixable": true|false,
-         "impact": "影响说明",
-         "effort": "trivial|small|medium|large"
+         "location": { "file": "src/example.ts", "line": 42 },
+         "suggestion": "改进建议"
        }
      ],
-     "summary": {
-       "total": 10,
-       "byCategory": { ... },
-       "byPriority": { ... },
-       "autoFixable": 3
-     }
+     "summary": { "total": 10, "byCategory": {...}, "autoFixable": 3 }
    }
    ```
 
-3. **展示检测结果**
-
-   使用 AskUserQuestion 展示结果并询问用户选择:
+3. **展示检测结果并询问用户**
 
+   如果没有发现问题，提示用户并结束:
    ```
-   📋 检测到 X 个改进建议
-
-   🚨 关键问题 (Y 个)
-   ─────────────────────
-   [UPG-001] 🔒 硬编码密钥
-       位置: src/config.ts:15
-       建议: 使用环境变量存储敏感信息
-
-   ⚠️ 高优先级 (Z 个)
-   ─────────────────────
-   ...
-
-   💡 请选择要执行的改进:
+   ✅ 未发现问题，项目状态良好！
    ```
 
-4. **用户选择** (使用 AskUserQuestion)
-
-   **选择模式:**
+   如果发现问题，使用 AskUserQuestion 展示结果:
    ```typescript
    AskUserQuestion({
      questions: [{
-       question: "请选择要执行的改进:",
-       header: "改进选择",
+       question: "检测到 X 个改进建议，请选择执行方式:",
+       header: "执行方式",
        options: [
-         { label: "🔴 全部执行", description: "执行所有检测到的改进" },
-         { label: "🟡 仅关键+高优先级", description: "执行 critical 和 high 优先级" },
+         { label: "🔴 全部执行 (推荐)", description: "自动执行所有检测到的改进" },
+         { label: "🟡 仅关键+高优先级", description: "只执行 critical 和 high 优先级" },
          { label: "🟢 仅可自动修复", description: "只执行 autoFixable=true 的改进" },
-         { label: "📋 逐项确认", description: "每个改进单独确认" }
+         { label: "📋 查看详情后决定", description: "逐项查看后手动选择" }
        ],
        multiSelect: false
      }]
    })
    ```
 
-5. **执行改进**
+4. **用户选择后自动执行**
+
+   **重要**: 用户选择后，**立即自动调用 /om:start 执行**，无需再次确认。
 
-   根据用户选择，生成任务并调用 `/om:start` 执行:
+   根据用户选择筛选建议:
+   - "全部执行" → 使用所有 suggestions
+   - "仅关键+高优先级" → 过滤 priority 为 critical/high
+   - "仅可自动修复" → 过滤 autoFixable 为 true
+   - "查看详情" → 逐项展示，用户选择后执行
 
-   **方式一: 批量执行**
-   - 将选中的改进转换为任务列表
-   - 调用 `/om:start` 并传递任务
+5. **调用 /om:start 执行改进**
 
-   **方式二: 逐项确认**
-   - 使用 AskUserQuestion 逐个询问
-   - 用户确认后执行
+   将选中的建议转换为任务描述，调用 /om:start:
 
-6. **BYPASS 模式支持**
+   ```typescript
+   // 生成任务描述
+   const taskDescription = `
+## 项目改进任务
+
+根据检测结果，需要修复以下问题:
+
+${selectedSuggestions.map((s, i) => `
+### ${i + 1}. ${s.title}
+- 类别: ${s.category}
+- 优先级: ${s.priority}
+- 位置: ${s.location.file}${s.location.line ? `:${s.location.line}` : ''}
+- 建议: ${s.suggestion}
+`).join('\n')}
+
+请逐一修复这些问题。
+   `;
+
+   // 调用 /om:start
+   // 使用 Skill 工具调用 /om:start
+   Skill({ skill: "om:start", args: taskDescription });
+   ```
+
+6. **BYPASS 模式**
 
    如果用户选择了"全部执行"，进入 BYPASS 模式:
-   - 不再请求用户确认
    - 自动批准所有操作
+   - 不再请求用户确认
    - 快速完成所有改进
 
 </process>
@@ -140,98 +137,57 @@ $ARGUMENTS
 </arguments>
 
 <examples>
-/om:check                    # 自动扫描当前项目
-/om:check 性能优化           # 聚焦性能相关改进
-/om:check 安全问题           # 聚焦安全相关改进
-/om:check --auto             # 全自动执行 (无需确认)
+/om:check                    # 自动扫描 → 用户确认 → 自动执行
+/om:check 安全               # 聚焦安全问题 → 用户确认 → 自动修复
+/om:check --auto             # 全自动执行 (无确认)
 </examples>
 
 <notes>
-## 检测类别说明
-
-| 类别 | 说明 | 示例 |
-|------|------|------|
-| bug | 代码缺陷 | TODO, FIXME, 潜在bug |
-| quality | 代码质量 | 过长函数, 复杂度, 重复代码 |
-| capability | 缺失能力 | 缺少测试, 文档, 类型定义 |
-| ux | 用户体验 | 错误提示, 帮助信息 |
-| style | 代码风格 | 命名, 格式, 一致性 |
-| security | 安全问题 | 硬编码密钥, SQL注入 |
-| common | 常见问题 | 魔法数字, 硬编码路径 |
-| prompt | Prompt 问题 | 注入风险, 缺少格式说明 |
-| skill | Skill 问题 | 缺少 frontmatter, objective |
-| agent | Agent 配置 | CLAUDE.md 缺少构建命令 |
-
-## 优先级说明
-
-| 优先级 | 说明 | 处理建议 |
-|--------|------|----------|
-| critical | 严重问题 | 立即处理 |
-| high | 重要问题 | 优先处理 |
-| medium | 一般问题 | 计划处理 |
-| low | 轻微问题 | 有空再处理 |
-
-## 项目类型识别
-
-系统自动识别以下项目类型:
-- **openmatrix**: OpenMatrix 项目自身
-- **ai-project**: AI 项目 (包含 prompts/skills/agents)
-- **nodejs**: Node.js 项目
-- **typescript**: TypeScript 项目
-- **python**: Python 项目
-- **go**: Go 项目
-- **rust**: Rust 项目
-- **java**: Java 项目
-- **csharp**: C# 项目
-- **cpp**: C/C++ 项目
-- **php**: PHP 项目
-- **dart**: Dart 项目
-
-根据项目类型，检测器会调整检测策略和建议。
-
-## 与 /om:start 的关系
-
-`/om:check` 检测完成后，可以选择将改进项传递给 `/om:start` 执行:
+## 执行流程图
 
 ```
 /om:check
     │
-    ├── 检测项目 ──→ 生成建议列表
+    ├── 1. 检测项目 ──→ 生成建议列表
+    │
+    ├── 2. 展示结果 ──→ 用户选择执行方式
     │
-    ├── 用户选择 ──→ 筛选建议
+    ├── 3. 用户确认 ──→ 选择"全部执行"
     │
-    └── 执行改进 ──→ 调用 /om:start
-                        │
-                        └── 正常的任务执行流程
+    └── 4. 自动执行 ──→ 调用 /om:start
+                            │
+                            ├── 任务规划
+                            ├── 代码修改
+                            ├── 质量验证
+                            └── 完成 ✅
 ```
 
-## 使用场景
+## 检测类别说明
 
-### 场景 1: 日常维护
-```
-用户: /om:check
-系统: 扫描项目...
-      发现 15 个改进建议
-      用户选择: 仅关键+高优先级
-系统: 开始执行 5 个改进...
-```
+| 类别 | 说明 | 示例 |
+|------|------|------|
+| 🐛 bug | 代码缺陷 | TODO, FIXME, 潜在bug |
+| 🔧 quality | 代码质量 | 过长函数, 复杂度 |
+| 📦 capability | 缺失能力 | 缺少测试, 文档 |
+| 🔒 security | 安全问题 | 硬编码密钥, SQL注入 |
+| 🤖 prompt | Prompt 问题 | 注入风险, 缺少格式 |
+| ⚡ skill | Skill 问题 | 缺少 frontmatter |
+| 🧠 agent | Agent 配置 | CLAUDE.md 缺少构建命令 |
 
-### 场景 2: 安全审计
-```
-用户: /om:check 安全
-系统: 扫描安全问题...
-      发现 3 个安全隐患
-      用户选择: 全部执行
-系统: 自动修复安全问题...
-```
+## 与 /om:start 的关系
+
+`/om:check` 检测完成后，**自动**将改进项传递给 `/om:start` 执行:
 
-### 场景 3: AI 项目检查
 ```
 用户: /om:check
-系统: 检测到 AI 项目
-      扫描 prompts/skills/agent 配置...
-      发现 5 个 AI 相关建议
-      用户选择: 全部执行
-系统: 优化 AI 配置...
+系统: 检测到 5 个问题...
+      [展示问题列表]
+      请选择执行方式: [全部执行]
+系统: 正在调用 /om:start 执行改进...
+      → 任务规划中...
+      → 执行改进...
+      → 完成!
 ```
+
+**用户只需确认一次，后续全自动执行。**
 </notes>

package/skills/start.md

@@ -19,6 +19,7 @@ description: 启动新的任务执行周期
      openmatrix start --init-only
      ```
    - 这会创建 `.openmatrix/`、`.openmatrix/tasks/`、`.openmatrix/approvals/` 目录
+   - 同时自动将 `.openmatrix/` 添加到 `.gitignore`
 
 2. **检查当前状态**
    - 读取 `.openmatrix/state.json`
@@ -40,7 +41,7 @@ description: 启动新的任务执行周期
 
 5. **⚠️ 交互式问答 (必须执行)**
 
-   **重要**: 除非用户明确指定 `--skip-questions`，否则必须执行交互式问答。
+   **重要**: 除非用户明确指定 `--skip-questions` 或提供了 `--quality` 等选项，否则必须执行交互式问答。
 
    使用 `AskUserQuestion` 工具，逐个提出以下问题：