openmatrix 0.2.17 → 0.2.18

package/package.json

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

package/skills/deploy.md

@@ -13,7 +13,32 @@ description: "智能部署助手：分析项目+系统环境 → 推荐最可行
 
 <process>
 
-## Step 1: 分析项目文件
+## Step 1: 读取历史部署配置
+
+```bash
+cat .openmatrix/deploy-config.json 2>/dev/null || echo "NO_HISTORY"
+```
+
+**如果有历史配置：**
+- 对比上次记录的关键文件和当前实际文件
+- 判断是否有变更
+
+```bash
+# 对比关键文件是否存在变化
+ls -la Dockerfile docker-compose.yml Makefile Taskfile.yml 2>/dev/null
+cat package.json 2>/dev/null | grep -E '"(deploy|start|build)"'
+```
+
+**变更检测结果：**
+| 状态 | 处理 |
+|------|------|
+| 无历史配置 | 正常流程（分析+询问） |
+| 无变更 | 直接使用上次配置，仅确认一次 |
+| 有变更 | 重新分析并询问 |
+
+---
+
+## Step 2: 分析项目文件
 
 直接读取项目文件，不调用 CLI：
 
@@ -34,7 +59,7 @@ cat requirements.txt pyproject.toml 2>/dev/null
 
 ---
 
-## Step 2: 检测系统环境
+## Step 3: 检测系统环境
 
 ```bash
 # 检测已安装的工具
@@ -52,7 +77,7 @@ uname -s 2>/dev/null || echo "Windows"
 
 ---
 
-## Step 3: AI 分析并展示环境报告
+## Step 4: AI 分析并展示环境报告
 
 基于收集到的信息，直接输出分析报告（不用 AskUserQuestion）：
 
@@ -76,7 +101,7 @@ uname -s 2>/dev/null || echo "Windows"
 
 ---
 
-## Step 4: 推荐部署方案（带理由）
+## Step 5: 推荐部署方案（带理由）
 
 AI 根据"项目配置 × 已安装工具"交叉分析，用 AskUserQuestion 展示推荐方案：
 
@@ -106,7 +131,7 @@ AskUserQuestion:
 
 ---
 
-## Step 5: 确认部署环境
+## Step 6: 确认部署环境
 
 ```
 AskUserQuestion:
@@ -124,7 +149,7 @@ AskUserQuestion:
 
 ---
 
-## Step 6: 执行部署
+## Step 7: 执行部署
 
 根据用户选择，AI 执行对应命令：
 
@@ -163,7 +188,7 @@ curl -s http://localhost:<port>/health 2>/dev/null || echo "服务已启动"
 
 ---
 
-## Step 7: 询问是否生成一键脚本
+## Step 8: 询问是否生成一键脚本
 
 ```
 AskUserQuestion:
@@ -183,7 +208,7 @@ AskUserQuestion:
 
 ---
 
-## Step 8: 生成一键脚本
+## Step 9: 生成一键脚本
 
 根据用户选择和项目实际情况，用 Write 工具生成脚本。
 
@@ -277,7 +302,35 @@ stop:
 
 ---
 
-## Step 9: 输出总结
+## Step 10: 保存部署配置
+
+将用户选择的部署方式保存到 `.openmatrix/deploy-config.json`：
+
+```json
+{
+  "deployMethod": "docker",
+  "envType": "local",
+  "scriptTool": "taskfile",
+  "lastDetectedFiles": {
+    "Dockerfile": true,
+    "docker-compose.yml": false,
+    "Makefile": false,
+    "package.json": true
+  },
+  "lastDetectedTools": {
+    "docker": "24.0.5",
+    "make": "4.3",
+    "task": null
+  },
+  "timestamp": "2026-04-22T15:00:00Z"
+}
+```
+
+下次运行时，对比 `lastDetectedFiles` 和当前实际文件状态，判断是否需要重新询问。
+
+---
+
+## Step 11: 输出总结
 
 ```markdown
 ## ✅ 部署完成
@@ -313,6 +366,19 @@ $ARGUMENTS
 2. **AI 是执行者**：用户确认后直接运行命令，不只是给建议
 3. **推荐最可行的**：基于"当前系统已有什么工具"，不是"理论上最好的"
 4. **产出可复用脚本**：最终生成 Taskfile/Makefile，方便后续开发调试
+5. **记录上次选择**：保存部署配置，下次未变化时直接复用，减少重复询问
+
+## 历史配置复用
+
+`.openmatrix/deploy-config.json` 存储上次部署选择：
+- 对比 `lastDetectedFiles` 和当前文件状态
+- 状态一致 → 直接使用上次配置，仅确认一次
+- 状态变化 → 重新分析并询问
+
+变更检测：
+- Dockerfile/docker-compose.yml/Makefile 新增或删除
+- package.json scripts 变化
+- 系统工具安装状态变化
 
 ## 推荐决策依据（AI 自行判断）
 

package/skills/om.md

@@ -15,8 +15,6 @@ always_load: true
 - "实现X" / "implement X" / "build X" → Development task → This skill
 - "修复X" / "fix X" → Development task → This skill
 - "怎么实现?" / "how to?" → Question → NOT this skill (just answer)
-
-Complex tasks route to `/om:brainstorm`, simple tasks route to `/om:start`.
 </EXTREMELY-IMPORTANT>
 
 <NO-OTHER-SKILLS>
@@ -31,72 +29,111 @@ OpenMatrix 默认入口 — 用户无需记忆命令，直接描述任务即可
 </objective>
 
 <process>
-1. **Parse user input**
-
-   `$ARGUMENTS` can be:
-   - Task description: "实现用户登录功能"
-   - File path: "docs/task.md"
-   - Empty input
-
-2. **复杂度评估与路由**
-
-   **AI 评估任务复杂度（< 3 秒）：**
-
-   | 条件 | 路由 |
-   |-----|-----|
-   | 描述 ≤ 100 字 + 单一功能 + 无架构设计 + 小需求关键词 | → `/om:feature` |
-   | 多个独立子系统 + 需要架构设计 + 从零搭建/重构/迁移 | → `/om:brainstorm` |
-   | 中等复杂度 + 需要完整追踪 + 实现/修复关键词 | → `/om:start` |
-
-   **小需求关键词：**
-   小需求、小功能、小改动、minor、quick、快速、简单、添加按钮、加个字段、轻量
-
-   **复杂任务关键词：**
-   从零搭建、重构、迁移、架构、设计、多模块、系统
-
-   **标准任务关键词：**
-   实现、修复、添加功能、开发（非小改动）
-
-3. **Auto-route examples**
-
-   ```
-   "给列表页添加搜索按钮"  → /om:feature (小需求)
-   "实现用户登录功能"      → /om:start (标准)
-   "从零搭建后台系统"      → /om:brainstorm (复杂)
-   "修复登录页面的样式"    → /om:start (标准)
-   "小改动：调整按钮颜色"  → /om:feature (小需求关键词)
-   "docs/task.md"         → /om:start (从文件)
-   ```
-
-4. **Help**
-
-   If empty or `--help`:
-   ```
-   OpenMatrix - AI task orchestration
-
-   Usage:
-     /om <task>              Start task
-     /om:brainstorm <task>   Brainstorm first
-     /om:start <task>        Interactive start
-     /om:auto <task>         Full auto
-
-   Examples:
-     /om 实现用户登录功能
-     /om 修复登录页面的样式问题
-     /om 添加 API 接口
-
-   Quality:
-     strict   - TDD + 80% coverage
-     balanced - 60% coverage
-     fast     - No gates
-
-   Commands:
-     /om:brainstorm  - Brainstorm then execute
-     /om:status      - View status
-     /om:meeting     - Handle blockers
-     /om:report      - Generate report
-     /om:debug       - Systematic debugging (bug/error investigation)
-   ```
+
+## Step 1: 解析用户输入
+
+`$ARGUMENTS` 可以是:
+- 任务描述: "实现用户登录功能"
+- 文件路径: "docs/task.md"
+- 空输入 → 显示帮助
+
+**如果是文件路径，先读取文件内容作为任务描述。**
+
+## Step 2: AI 评估复杂度（自动路由）
+
+**Claude 根据以下条件自动判断路由目标：**
+
+### 2.1 小需求 → `/om:feature`
+
+**核心条件（语义判断）：**
+- 单一改动点（聚焦一个功能/组件/文件）
+- 无架构设计关键词（"架构"、"设计"、"从零"、"重构整个"）
+- 无多子系统描述
+- 或包含小需求关键词：小需求、小功能、小改动、minor、quick、快速、简单、添加按钮、加个字段、轻量
+
+**辅助参考（非硬性）：**
+- 描述较短（通常 ≤ 150 字）— 长描述也可能聚焦单一改动
+
+**示例：**
+- "给列表页添加搜索按钮" → /om:feature
+- "小改动：调整按钮颜色" → /om:feature
+- "加个字段存储用户头像" → /om:feature
+
+### 2.2 复杂任务 → `/om:brainstorm`
+
+**任一满足即路由：**
+- 包含复杂关键词：从零搭建、重构整个、迁移、架构设计、多模块、系统
+- 多个独立子系统（"和"、"同时"、"另外"连接多个大模块）
+- 需要技术选型决策
+- 涉及非代码产出（文档、设计规范、调研报告）
+
+**示例：**
+- "从零搭建后台管理系统" → /om:brainstorm
+- "重构整个认证模块，支持 OAuth 和 SAML" → /om:brainstorm
+- "设计微服务架构并实现核心模块" → /om:brainstorm
+
+### 2.3 标准任务 → `/om:start`
+
+**不符合小需求和复杂任务的，默认路由：**
+- 中等复杂度（单一功能但需要完整追踪）
+- 包含标准关键词：实现、修复、添加功能、开发（非小改动）
+- 需要质量门禁验证
+
+**示例：**
+- "实现用户登录功能" → /om:start
+- "修复登录页面的样式问题" → /om:start
+- "添加 API 接口返回用户列表" → /om:start
+
+## Step 3: 用户确认路由（带 AI 推荐）
+
+**AI 先判断推荐路由，再让用户确认：**
+
+AskUserQuestion: `header: "任务流程"`, `multiSelect: false`
+
+**question:** 选择执行流程（AI 推荐：${recommendedRoute}，原因：${recommendReason}）
+
+| label | description |
+|-------|-------------|
+| `小需求流程 (推荐)` | 2-5 个任务块，轻量追踪，适合单一改动点 |
+| `标准流程` | 完整追踪，质量门禁，适合中等复杂度 |
+| `复杂流程` | 先设计后执行，适合架构/重构/多模块 |
+
+**用户选择后，调用对应 Skill：**
+- 选择 "小需求流程" → Skill("om:feature", args=任务描述)
+- 选择 "标准流程" → Skill("om:start", args=任务描述)
+- 选择 "复杂流程" → Skill("om:brainstorm", args=任务描述)
+
+## Step 4: 空输入或 --help
+
+显示帮助信息：
+```
+OpenMatrix - AI task orchestration
+
+Usage:
+  /om <task>              AI 推荐路由，用户确认后执行
+  /om:feature <task>      小需求快速流程（跳过推荐）
+  /om:start <task>        标准任务流程（跳过推荐）
+  /om:brainstorm <task>   复杂任务先设计后执行（跳过推荐）
+  /om:auto <task>         全自动执行
+
+Examples:
+  /om 给列表页添加搜索按钮       → AI 推荐小需求流程
+  /om 实现用户登录功能           → AI 推荐标准流程
+  /om 从零搭建后台系统            → AI 推荐复杂流程
+
+Quality:
+  strict   - TDD + 80% coverage
+  balanced - 60% coverage
+  fast     - No gates
+
+Commands:
+  /om:status      - 查看执行状态
+  /om:meeting     - 处理阻塞任务
+  /om:report      - 生成执行报告
+  /om:debug       - 系统化调试
+  /om:resume      - 恢复中断任务
+```
+
 </process>
 
 <arguments>
@@ -104,16 +141,20 @@ $ARGUMENTS
 </arguments>
 
 <examples>
-/om 给用户列表页添加搜索功能              → /om:feature (小需求)
-/om 小改动：调整按钮颜色                  → /om:feature (小需求关键词)
-/om 实现用户登录功能                      → /om:start (标准)
-/om 从零搭建后台系统                       → /om:brainstorm (复杂)
-/om 修复登录页面的样式问题                → /om:start (标准)
-/om docs/task.md                         → /om:start (从文件)
-/om                                      → Show help
+/om 给用户列表页添加搜索功能              → AI 推荐小需求流程，用户确认
+/om 小改动：调整按钮颜色                  → AI 推荐小需求流程，用户确认
+/om 实现用户登录功能                      → AI 推荐标准流程，用户确认
+/om 从零搭建后台系统                       → AI 推荐复杂流程，用户确认
+/om 修复登录页面的样式问题                → AI 推荐标准流程，用户确认
+/om docs/task.md                         → 读取文件后 AI 推荐，用户确认
+/om                                      → 显示帮助
 </examples>
 
 <notes>
-`/om` is shorthand for the OpenMatrix workflow. Same skill set as `openmatrix`, shorter invocation.
-Available commands: `/om:brainstorm`, `/om:start`, `/om:feature`, `/om:auto`, `/om:status`, `/om:meeting`, `/om:report`, `/om:resume`, `/om:retry`, `/om:research`, `/om:approve`, `/om:check`, `/om:debug`
+`/om` 是 OpenMatrix 工作的简写。路由流程：
+1. AI 评估任务复杂度，给出推荐路由和原因
+2. AskUserQuestion 让用户确认（标注推荐选项）
+3. 用户选择后调用对应 skill
+
+可用命令: `/om:brainstorm`, `/om:start`, `/om:feature`, `/om:auto`, `/om:status`, `/om:meeting`, `/om:report`, `/om:resume`, `/om:retry`, `/om:research`, `/om:approve`, `/om:check`, `/om:debug`
 </notes>