openmatrix 0.2.31 → 0.2.33

package/skills/deploy.md

@@ -1,658 +1,658 @@
----
-name: om:deploy
-description: "Triggers on DEPLOYMENT intent: user wants to deploy, publish, set up environments, or create deployment scripts. DO NOT trigger on: development tasks, status checks, or debugging."
----
-
-<INTENT-JUDGMENT>
-## 意图判断指南
-
-**AI 应根据用户语义判断意图：**
-
-### 触发信号（部署意图）
-
-- 用户想部署/发布项目
-- 需要配置 Docker/Kubernetes
-- 环境搭建需求
-- 生成部署脚本
-- 发布到生产环境
-
-### 不触发信号
-
-| 用户意图 | 应调用 |
-|---------|--------|
-| 实现功能 | /om:start |
-| 修复 bug | /om:debug 或 /om:start |
-| 查看状态 | /om:status |
-
-### 示例判断
-
-| 用户消息 | 判断 | 结果 |
-|---------|------|------|
-| "部署到服务器" | 部署意图 | 触发 ✓ |
-| "用 Docker 运行" | 环境配置意图 | 触发 ✓ |
-| "发布 npm 包" | 发布意图 | 触发 ✓ |
-| "实现 API 接口" | 开发意图 | /om:start |
-| "为什么部署失败" | 调查意图 | /om:debug |
-</INTENT-JUDGMENT>
-
-<NO-OTHER-SKILLS>
-本 skill 与其他任务编排技能功能重叠，请勿同时使用。
-</NO-OTHER-SKILLS>
-
-<objective>
-智能部署助手：自动分析项目文件和系统环境 → 推荐当前环境下最可行的部署方案 → 用户确认后执行 → 生成可复用的一键脚本。
-</objective>
-
-<process>
-
-## 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：
-
-```bash
-# 项目配置文件
-ls -la Dockerfile docker-compose.yml docker-compose.yaml Makefile Taskfile.yml Taskfile.yaml 2>/dev/null
-ls -la k8s/ helm/ .github/workflows/ 2>/dev/null
-cat package.json 2>/dev/null
-cat go.mod 2>/dev/null
-cat Cargo.toml 2>/dev/null
-cat requirements.txt pyproject.toml 2>/dev/null
-```
-
-提取关键信息：
-- 项目类型（Node.js/Go/Python/Rust/Java 等）
-- 已有部署配置（Dockerfile、docker-compose、Makefile、k8s 等）
-- package.json 中的 scripts（build/start/deploy 等）
-
----
-
-## Step 2.1: 检测并优化依赖源
-
-检测项目使用的包管理器和镜像源，如果是国外慢源则建议替换为国内镜像：
-
-```bash
-# npm/yarn/pnpm 源
-npm config get registry 2>/dev/null
-cat .npmrc 2>/dev/null
-cat .yarnrc 2>/dev/null
-cat .yarnrc.yml 2>/dev/null
-
-# pip 源
-cat pip.conf 2>/dev/null
-pip config get global.index-url 2>/dev/null
-
-# Docker 镜像源
-cat /etc/docker/daemon.json 2>/dev/null
-cat ~/.docker/daemon.json 2>/dev/null
-
-# Go 代理
-go env GOPROXY 2>/dev/null
-
-# Rust 源
-cat ~/.cargo/config.toml 2>/dev/null
-
-# Gradle/Maven 源
-cat build.gradle 2>/dev/null | grep -i "repositories" -A 5
-cat pom.xml 2>/dev/null | grep -i "mirror" -A 5
-```
-
-**AI 分析源速度，如果检测到国外源，建议替换：**
-
-| 包管理器 | 国外源 | 国内镜像 |
-|---------|--------|---------|
-| npm/yarn/pnpm | registry.npmjs.org | https://registry.npmmirror.com |
-| pip | pypi.org | https://pypi.tuna.tsinghua.edu.cn/simple |
-| Docker | docker.io | mirror.ccs.tencentyun.com |
-| Go | proxy.golang.org | https://goproxy.cn,direct |
-| Rust/Cargo | crates.io | https://rsproxy.cn/crates.io-index |
-| Gradle/Maven | repo.maven.apache.org | https://maven.aliyun.com/repository/public |
-
-**如果检测到慢源，输出建议并询问：**
-
-```
-AskUserQuestion:
-  header: "镜像源"
-  question: "检测到 npm 使用官方源（registry.npmjs.org），国内访问较慢。是否切换到国内镜像？"
-
-  options:
-  - label: "切换到淘宝镜像 (推荐)"
-    description: "npmmirror.com，国内速度快，同步延迟 < 10 分钟"
-  - label: "保持不变"
-    description: "当前源可用，不需要切换"
-  - label: "使用其他镜像"
-    description: "指定自定义镜像地址"
-```
-
-**用户确认后执行切换：**
-```bash
-# npm
-npm config set registry https://registry.npmmirror.com
-
-# pip
-pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
-
-# Go
-go env -w GOPROXY=https://goproxy.cn,direct
-
-# Dockerfile 中的 apt 源（如果有）
-# AI 读取 Dockerfile，将 archive.ubuntu.com 替换为 mirrors.aliyun.com
-```
-
----
-
-## Step 3: 检测系统环境
-
-```bash
-# 检测已安装的工具
-docker --version 2>/dev/null && echo "docker:ok" || echo "docker:missing"
-docker-compose --version 2>/dev/null && echo "docker-compose:ok" || echo "docker-compose:missing"
-kubectl version --client 2>/dev/null && echo "kubectl:ok" || echo "kubectl:missing"
-make --version 2>/dev/null && echo "make:ok" || echo "make:missing"
-task --version 2>/dev/null && echo "task:ok" || echo "task:missing"
-pm2 --version 2>/dev/null && echo "pm2:ok" || echo "pm2:missing"
-node --version 2>/dev/null && echo "node:ok" || echo "node:missing"
-
-# 操作系统
-uname -s 2>/dev/null || echo "Windows"
-```
-
----
-
-## Step 4: AI 分析并展示环境报告
-
-基于收集到的信息，直接输出分析报告（不用 AskUserQuestion）：
-
-```markdown
-## 🔍 环境分析报告
-
-**项目**: [名称] ([类型])
-**操作系统**: [Linux/macOS/Windows]
-
-### 已检测到的部署配置
-- ✅ Dockerfile
-- ✅ docker-compose.yml
-- ❌ Makefile（未找到）
-
-### 已安装的工具
-- ✅ Docker 24.0.5
-- ✅ make 4.3
-- ❌ task（未安装）
-- ❌ pm2（未安装）
-```
-
----
-
-## Step 5: 推荐部署方案（带理由）
-
-AI 根据"项目配置 × 已安装工具"交叉分析，用 AskUserQuestion 展示推荐方案：
-
-**推荐逻辑（AI 自行判断，不是硬编码）：**
-- 有 Dockerfile + docker 已安装 → Docker 是最直接的选择
-- 有 docker-compose + 多服务 → Docker Compose 更合适
-- 有 k8s 配置 + kubectl 已安装 → Kubernetes
-- 有 Makefile + make 已安装 → 直接用 make
-- Node.js + pm2 已安装 → PM2 轻量方案
-- 什么都没有 → AI 根据项目类型推荐创建配置
-
-```
-AskUserQuestion:
-  header: "部署方案"
-  question: "基于你的环境分析，推荐以下方案（已标注推荐原因）："
-
-  options:
-  - label: "Docker (推荐)"
-    description: "已有 Dockerfile + Docker 已安装，直接可用，环境隔离好"
-  - label: "Docker Compose"
-    description: "检测到 docker-compose.yml，适合多服务编排"
-  - label: "Make"
-    description: "已有 Makefile + make 已安装，运行 make deploy"
-  - label: "npm scripts"
-    description: "无需额外工具，直接用 package.json 中的 scripts"
-```
-
----
-
-## Step 6: 确认部署环境
-
-```
-AskUserQuestion:
-  header: "目标环境"
-  question: "部署到哪个环境？"
-
-  options:
-  - label: "本地开发 (推荐)"
-    description: "快速启动，用于开发调试"
-  - label: "测试环境"
-    description: "模拟生产配置，用于验证"
-  - label: "生产环境"
-    description: "需要完整配置和安全检查"
-```
-
----
-
-## Step 6.1: 生成部署任务清单
-
-根据前面的分析和用户选择，将所有部署步骤写入 TodoWrite，逐条执行：
-
-**示例（Docker 本地部署 + 源优化 + 脚本生成）：**
-
-```typescript
-TodoWrite({
-  todos: [
-    { content: "切换 npm 源到淘宝镜像", activeForm: "正在切换 npm 镜像源", status: "pending" },
-    { content: "构建 Docker 镜像", activeForm: "正在构建 Docker 镜像", status: "pending" },
-    { content: "启动容器", activeForm: "正在启动容器", status: "pending" },
-    { content: "验证部署：容器状态", activeForm: "正在检查容器状态", status: "pending" },
-    { content: "验证部署：端口监听", activeForm: "正在检查端口", status: "pending" },
-    { content: "验证部署：HTTP 连通", activeForm: "正在验证 HTTP 连通性", status: "pending" },
-    { content: "生成 Taskfile.yml 一键脚本", activeForm: "正在生成一键脚本", status: "pending" },
-    { content: "保存部署配置", activeForm: "正在保存部署配置", status: "pending" }
-  ]
-})
-```
-
-**任务清单根据实际情况动态生成：**
-- 需要切换源 → 加入源切换任务
-- 需要生成 Dockerfile → 加入生成任务
-- 多服务 → 每个服务一条任务
-- 选择生成脚本 → 加入脚本生成任务
-
-**执行规则：**
-- 每次只执行一条，完成后立即标记 completed
-- 失败时停止，输出错误信息
-- 用户可以看到整体进度
-
----
-
-## Step 7: 执行部署
-
-根据用户选择，AI 执行对应命令：
-
-**Docker 本地：**
-```bash
-docker build -t <project-name> .
-docker run -d -p <port>:<port> --name <project-name> <project-name>
-```
-
-**Docker Compose：**
-```bash
-docker-compose up -d --build
-```
-
-**Make：**
-```bash
-make deploy
-```
-
-**npm scripts：**
-```bash
-npm run build
-npm run start &
-```
-
----
-
-## Step 7.1: 自动验证部署结果
-
-执行部署后，AI 自动执行以下验证（按顺序，全部通过才算成功）：
-
-**1. 检查容器/进程状态：**
-```bash
-# Docker
-docker ps --format "{{.Names}}\t{{.Status}}" | grep <project-name>
-
-# Docker Compose
-docker-compose ps
-
-# PM2
-pm2 list
-
-# 进程检查
-ps aux | grep <project-name>
-```
-
-**2. 检查端口是否在监听：**
-```bash
-# Linux/Mac
-lsof -i :<port> 2>/dev/null || netstat -tlnp 2>/dev/null | grep <port>
-
-# Windows
-netstat -ano | findstr :<port>
-```
-
-**3. HTTP 连通性验证（核心验证）：**
-```bash
-# 等待服务启动（最多重试 5 次，每次间隔 2 秒）
-for i in 1 2 3 4 5; do
-  STATUS=$(curl -s -o /dev/null -w "%{http_code}" http://localhost:<port>/ 2>/dev/null)
-  if [ "$STATUS" -ge 200 ] && [ "$STATUS" -lt 400 ]; then
-    echo "HTTP $STATUS OK"
-    break
-  fi
-  sleep 2
-done
-
-# 获取响应内容摘要
-curl -s http://localhost:<port>/ 2>/dev/null | head -20
-```
-
-**4. 健康检查端点（如果存在）：**
-```bash
-curl -s http://localhost:<port>/health 2>/dev/null
-curl -s http://localhost:<port>/api/health 2>/dev/null
-curl -s http://localhost:<port>/healthz 2>/dev/null
-```
-
-**5. 浏览器可访问性验证（Web 项目）：**
-
-如果是 Web 项目，使用 Playwright 工具打开浏览器验证页面是否正常加载：
-```
-browser_navigate: http://localhost:<port>/
-browser_snapshot: 检查页面是否正常渲染
-browser_take_screenshot: 截图保存验证结果
-browser_close
-```
-
-如果无法使用浏览器工具，输出可访问的 URL 供用户手动验证：
-```
-🌐 请在浏览器中访问: http://localhost:<port>/
-```
-
-**6. 日志检查（任何验证失败时）：**
-```bash
-# Docker 日志
-docker logs <project-name> --tail 50
-
-# PM2 日志
-pm2 logs <project-name> --lines 50
-```
-
----
-
-## Step 7.2: 输出验证报告
-
-AI 根据验证结果输出状态报告：
-
-**验证成功：**
-```markdown
-## ✅ 部署验证报告
-
-**服务状态**: 运行中 (Up 2 minutes)
-**端口**: 3000 已监听
-**HTTP 连通**: http://localhost:3000/ → 200 OK
-**健康检查**: /health → 200 OK
-
-### 验证清单
-- ✅ 容器/进程正常运行
-- ✅ 端口 3000 已监听
-- ✅ HTTP 请求返回 200
-- ✅ 页面可正常访问
-
-### 访问地址
-🌐 http://localhost:3000/
-
-### 快捷命令
-- 查看日志: docker logs -f <project-name>
-- 停止服务: docker stop <project-name>
-- 重启服务: docker restart <project-name>
-```
-
-**验证失败：**
-```markdown
-## ❌ 部署验证失败
-
-**问题**: 容器启动后立即退出
-**状态**: Exited (1)
-
-### 错误日志（最近 20 行）
-<显示 docker logs 输出>
-
-### 建议修复
-1. 检查 Dockerfile 配置
-2. 检查启动命令是否正确
-3. 查看完整日志: docker logs <project-name>
-```
-
-验证失败时，询问用户是否要查看完整日志或尝试修复。
-
----
-
-## Step 8: 询问是否生成一键脚本
-
-```
-AskUserQuestion:
-  header: "一键脚本"
-  question: "部署完成！是否生成一键脚本方便后续开发调试？"
-
-  options:
-  - label: "生成 Taskfile.yml (推荐)"
-    description: "task 已安装 / 现代化工具，YAML 格式简洁，跨平台"
-  - label: "生成 Makefile"
-    description: "make 已安装 / 经典工具，已有 Makefile 时保持一致"
-  - label: "添加到 npm scripts"
-    description: "Node.js 项目，无需额外工具"
-  - label: "不需要"
-    description: "已有足够配置"
-```
-
----
-
-## Step 9: 生成一键脚本
-
-根据用户选择和项目实际情况，用 Write 工具生成脚本。
-
-**Taskfile.yml 示例（根据实际项目定制）：**
-```yaml
-version: '3'
-
-vars:
-  APP: '{{.APP | default "app"}}'
-  PORT: '{{.PORT | default "3000"}}'
-
-tasks:
-  setup:
-    desc: 安装依赖
-    cmds:
-      - npm install
-
-  build:
-    desc: 构建项目
-    cmds:
-      - npm run build
-
-  test:
-    desc: 运行测试
-    cmds:
-      - npm test
-
-  dev:
-    desc: 本地开发（热重载）
-    cmds:
-      - npm run dev
-
-  deploy:local:
-    desc: 本地 Docker 部署
-    cmds:
-      - docker build -t {{.APP}} .
-      - docker run -d -p {{.PORT}}:{{.PORT}} --name {{.APP}} {{.APP}}
-      - echo "✅ 服务已启动 http://localhost:{{.PORT}}"
-
-  deploy:prod:
-    desc: 生产部署
-    cmds:
-      - docker build -t {{.APP}}:{{.VERSION}} .
-      - docker push {{.REGISTRY}}/{{.APP}}:{{.VERSION}}
-
-  logs:
-    desc: 查看日志
-    cmds:
-      - docker logs -f {{.APP}}
-
-  stop:
-    desc: 停止服务
-    cmds:
-      - docker stop {{.APP}} && docker rm {{.APP}}
-```
-
-**Makefile 示例（根据实际项目定制）：**
-```makefile
-APP ?= app
-PORT ?= 3000
-
-.PHONY: setup build test dev deploy-local deploy-prod logs stop
-
-setup:
-	npm install
-
-build:
-	npm run build
-
-test:
-	npm test
-
-dev:
-	npm run dev
-
-deploy-local:
-	docker build -t $(APP) .
-	docker run -d -p $(PORT):$(PORT) --name $(APP) $(APP)
-	@echo "✅ 服务已启动 http://localhost:$(PORT)"
-
-deploy-prod:
-	docker build -t $(APP):$(VERSION) .
-	docker push $(REGISTRY)/$(APP):$(VERSION)
-
-logs:
-	docker logs -f $(APP)
-
-stop:
-	docker stop $(APP) && docker rm $(APP)
-```
-
----
-
-## 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
-## ✅ 部署完成
-
-**方案**: Docker 本地部署
-**环境**: 本地开发
-**脚本**: 已生成 Taskfile.yml
-
-### 常用命令
-- `task dev` — 本地开发
-- `task deploy:local` — Docker 本地部署
-- `task deploy:prod` — 生产部署
-- `task logs` — 查看日志
-- `task stop` — 停止服务
-```
-
-</process>
-
-<arguments>
-$ARGUMENTS
-</arguments>
-
-<examples>
-/om:deploy              # 自动分析 → 推荐方案 → 执行 → 生成脚本
-/om:deploy local        # 直接指定本地环境
-/om:deploy prod         # 直接指定生产环境
-</examples>
-
-<notes>
-## 核心原则
-
-1. **AI 是分析者**：读取真实文件和系统状态，不靠硬编码规则推断
-2. **AI 是执行者**：用户确认后直接运行命令，不只是给建议
-3. **推荐最可行的**：基于"当前系统已有什么工具"，不是"理论上最好的"
-4. **产出可复用脚本**：最终生成 Taskfile/Makefile，方便后续开发调试
-5. **记录上次选择**：保存部署配置，下次未变化时直接复用，减少重复询问
-
-## 历史配置复用
-
-`.openmatrix/deploy-config.json` 存储上次部署选择：
-- 对比 `lastDetectedFiles` 和当前文件状态
-- 状态一致 → 直接使用上次配置，仅确认一次
-- 状态变化 → 重新分析并询问
-
-变更检测：
-- Dockerfile/docker-compose.yml/Makefile 新增或删除
-- package.json scripts 变化
-- 系统工具安装状态变化
-
-## 推荐决策依据（AI 自行判断）
-
-| 项目配置 | 系统工具 | 推荐方案 |
-|---------|---------|---------|
-| 有 Dockerfile | docker 已安装 | Docker |
-| 有 docker-compose | docker-compose 已安装 | Docker Compose |
-| 有 k8s/ | kubectl 已安装 | Kubernetes |
-| 有 Makefile | make 已安装 | Make |
-| Node.js | pm2 已安装 | PM2 |
-| Node.js | 无特殊工具 | npm scripts |
-| 无任何配置 | docker 已安装 | 生成 Dockerfile |
-| 无任何配置 | 无工具 | npm scripts / shell 脚本 |
-
-## 脚本工具选择依据
-
-| 条件 | 推荐 |
-|------|------|
-| task 已安装 | Taskfile.yml |
-| make 已安装 / 已有 Makefile | Makefile |
-| Node.js 项目 / 无工具 | npm scripts |
-| Windows + 无工具 | package.json scripts |
-</notes>
+---
+name: om:deploy
+description: "Triggers on DEPLOYMENT intent: user wants to deploy, publish, set up environments, or create deployment scripts. DO NOT trigger on: development tasks, status checks, or debugging."
+---
+
+<INTENT-JUDGMENT>
+## 意图判断指南
+
+**AI 应根据用户语义判断意图：**
+
+### 触发信号（部署意图）
+
+- 用户想部署/发布项目
+- 需要配置 Docker/Kubernetes
+- 环境搭建需求
+- 生成部署脚本
+- 发布到生产环境
+
+### 不触发信号
+
+| 用户意图 | 应调用 |
+|---------|--------|
+| 实现功能 | /om:start |
+| 修复 bug | /om:debug 或 /om:start |
+| 查看状态 | /om:status |
+
+### 示例判断
+
+| 用户消息 | 判断 | 结果 |
+|---------|------|------|
+| "部署到服务器" | 部署意图 | 触发 ✓ |
+| "用 Docker 运行" | 环境配置意图 | 触发 ✓ |
+| "发布 npm 包" | 发布意图 | 触发 ✓ |
+| "实现 API 接口" | 开发意图 | /om:start |
+| "为什么部署失败" | 调查意图 | /om:debug |
+</INTENT-JUDGMENT>
+
+<NO-OTHER-SKILLS>
+本 skill 与其他任务编排技能功能重叠，请勿同时使用。
+</NO-OTHER-SKILLS>
+
+<objective>
+智能部署助手：自动分析项目文件和系统环境 → 推荐当前环境下最可行的部署方案 → 用户确认后执行 → 生成可复用的一键脚本。
+</objective>
+
+<process>
+
+## 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：
+
+```bash
+# 项目配置文件
+ls -la Dockerfile docker-compose.yml docker-compose.yaml Makefile Taskfile.yml Taskfile.yaml 2>/dev/null
+ls -la k8s/ helm/ .github/workflows/ 2>/dev/null
+cat package.json 2>/dev/null
+cat go.mod 2>/dev/null
+cat Cargo.toml 2>/dev/null
+cat requirements.txt pyproject.toml 2>/dev/null
+```
+
+提取关键信息：
+- 项目类型（Node.js/Go/Python/Rust/Java 等）
+- 已有部署配置（Dockerfile、docker-compose、Makefile、k8s 等）
+- package.json 中的 scripts（build/start/deploy 等）
+
+---
+
+## Step 2.1: 检测并优化依赖源
+
+检测项目使用的包管理器和镜像源，如果是国外慢源则建议替换为国内镜像：
+
+```bash
+# npm/yarn/pnpm 源
+npm config get registry 2>/dev/null
+cat .npmrc 2>/dev/null
+cat .yarnrc 2>/dev/null
+cat .yarnrc.yml 2>/dev/null
+
+# pip 源
+cat pip.conf 2>/dev/null
+pip config get global.index-url 2>/dev/null
+
+# Docker 镜像源
+cat /etc/docker/daemon.json 2>/dev/null
+cat ~/.docker/daemon.json 2>/dev/null
+
+# Go 代理
+go env GOPROXY 2>/dev/null
+
+# Rust 源
+cat ~/.cargo/config.toml 2>/dev/null
+
+# Gradle/Maven 源
+cat build.gradle 2>/dev/null | grep -i "repositories" -A 5
+cat pom.xml 2>/dev/null | grep -i "mirror" -A 5
+```
+
+**AI 分析源速度，如果检测到国外源，建议替换：**
+
+| 包管理器 | 国外源 | 国内镜像 |
+|---------|--------|---------|
+| npm/yarn/pnpm | registry.npmjs.org | https://registry.npmmirror.com |
+| pip | pypi.org | https://pypi.tuna.tsinghua.edu.cn/simple |
+| Docker | docker.io | mirror.ccs.tencentyun.com |
+| Go | proxy.golang.org | https://goproxy.cn,direct |
+| Rust/Cargo | crates.io | https://rsproxy.cn/crates.io-index |
+| Gradle/Maven | repo.maven.apache.org | https://maven.aliyun.com/repository/public |
+
+**如果检测到慢源，输出建议并询问：**
+
+```
+AskUserQuestion:
+  header: "镜像源"
+  question: "检测到 npm 使用官方源（registry.npmjs.org），国内访问较慢。是否切换到国内镜像？"
+
+  options:
+  - label: "切换到淘宝镜像 (推荐)"
+    description: "npmmirror.com，国内速度快，同步延迟 < 10 分钟"
+  - label: "保持不变"
+    description: "当前源可用，不需要切换"
+  - label: "使用其他镜像"
+    description: "指定自定义镜像地址"
+```
+
+**用户确认后执行切换：**
+```bash
+# npm
+npm config set registry https://registry.npmmirror.com
+
+# pip
+pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
+
+# Go
+go env -w GOPROXY=https://goproxy.cn,direct
+
+# Dockerfile 中的 apt 源（如果有）
+# AI 读取 Dockerfile，将 archive.ubuntu.com 替换为 mirrors.aliyun.com
+```
+
+---
+
+## Step 3: 检测系统环境
+
+```bash
+# 检测已安装的工具
+docker --version 2>/dev/null && echo "docker:ok" || echo "docker:missing"
+docker-compose --version 2>/dev/null && echo "docker-compose:ok" || echo "docker-compose:missing"
+kubectl version --client 2>/dev/null && echo "kubectl:ok" || echo "kubectl:missing"
+make --version 2>/dev/null && echo "make:ok" || echo "make:missing"
+task --version 2>/dev/null && echo "task:ok" || echo "task:missing"
+pm2 --version 2>/dev/null && echo "pm2:ok" || echo "pm2:missing"
+node --version 2>/dev/null && echo "node:ok" || echo "node:missing"
+
+# 操作系统
+uname -s 2>/dev/null || echo "Windows"
+```
+
+---
+
+## Step 4: AI 分析并展示环境报告
+
+基于收集到的信息，直接输出分析报告（不用 AskUserQuestion）：
+
+```markdown
+## 🔍 环境分析报告
+
+**项目**: [名称] ([类型])
+**操作系统**: [Linux/macOS/Windows]
+
+### 已检测到的部署配置
+- ✅ Dockerfile
+- ✅ docker-compose.yml
+- ❌ Makefile（未找到）
+
+### 已安装的工具
+- ✅ Docker 24.0.5
+- ✅ make 4.3
+- ❌ task（未安装）
+- ❌ pm2（未安装）
+```
+
+---
+
+## Step 5: 推荐部署方案（带理由）
+
+AI 根据"项目配置 × 已安装工具"交叉分析，用 AskUserQuestion 展示推荐方案：
+
+**推荐逻辑（AI 自行判断，不是硬编码）：**
+- 有 Dockerfile + docker 已安装 → Docker 是最直接的选择
+- 有 docker-compose + 多服务 → Docker Compose 更合适
+- 有 k8s 配置 + kubectl 已安装 → Kubernetes
+- 有 Makefile + make 已安装 → 直接用 make
+- Node.js + pm2 已安装 → PM2 轻量方案
+- 什么都没有 → AI 根据项目类型推荐创建配置
+
+```
+AskUserQuestion:
+  header: "部署方案"
+  question: "基于你的环境分析，推荐以下方案（已标注推荐原因）："
+
+  options:
+  - label: "Docker (推荐)"
+    description: "已有 Dockerfile + Docker 已安装，直接可用，环境隔离好"
+  - label: "Docker Compose"
+    description: "检测到 docker-compose.yml，适合多服务编排"
+  - label: "Make"
+    description: "已有 Makefile + make 已安装，运行 make deploy"
+  - label: "npm scripts"
+    description: "无需额外工具，直接用 package.json 中的 scripts"
+```
+
+---
+
+## Step 6: 确认部署环境
+
+```
+AskUserQuestion:
+  header: "目标环境"
+  question: "部署到哪个环境？"
+
+  options:
+  - label: "本地开发 (推荐)"
+    description: "快速启动，用于开发调试"
+  - label: "测试环境"
+    description: "模拟生产配置，用于验证"
+  - label: "生产环境"
+    description: "需要完整配置和安全检查"
+```
+
+---
+
+## Step 6.1: 生成部署任务清单
+
+根据前面的分析和用户选择，将所有部署步骤写入 TodoWrite，逐条执行：
+
+**示例（Docker 本地部署 + 源优化 + 脚本生成）：**
+
+```typescript
+TodoWrite({
+  todos: [
+    { content: "切换 npm 源到淘宝镜像", activeForm: "正在切换 npm 镜像源", status: "pending" },
+    { content: "构建 Docker 镜像", activeForm: "正在构建 Docker 镜像", status: "pending" },
+    { content: "启动容器", activeForm: "正在启动容器", status: "pending" },
+    { content: "验证部署：容器状态", activeForm: "正在检查容器状态", status: "pending" },
+    { content: "验证部署：端口监听", activeForm: "正在检查端口", status: "pending" },
+    { content: "验证部署：HTTP 连通", activeForm: "正在验证 HTTP 连通性", status: "pending" },
+    { content: "生成 Taskfile.yml 一键脚本", activeForm: "正在生成一键脚本", status: "pending" },
+    { content: "保存部署配置", activeForm: "正在保存部署配置", status: "pending" }
+  ]
+})
+```
+
+**任务清单根据实际情况动态生成：**
+- 需要切换源 → 加入源切换任务
+- 需要生成 Dockerfile → 加入生成任务
+- 多服务 → 每个服务一条任务
+- 选择生成脚本 → 加入脚本生成任务
+
+**执行规则：**
+- 每次只执行一条，完成后立即标记 completed
+- 失败时停止，输出错误信息
+- 用户可以看到整体进度
+
+---
+
+## Step 7: 执行部署
+
+根据用户选择，AI 执行对应命令：
+
+**Docker 本地：**
+```bash
+docker build -t <project-name> .
+docker run -d -p <port>:<port> --name <project-name> <project-name>
+```
+
+**Docker Compose：**
+```bash
+docker-compose up -d --build
+```
+
+**Make：**
+```bash
+make deploy
+```
+
+**npm scripts：**
+```bash
+npm run build
+npm run start &
+```
+
+---
+
+## Step 7.1: 自动验证部署结果
+
+执行部署后，AI 自动执行以下验证（按顺序，全部通过才算成功）：
+
+**1. 检查容器/进程状态：**
+```bash
+# Docker
+docker ps --format "{{.Names}}\t{{.Status}}" | grep <project-name>
+
+# Docker Compose
+docker-compose ps
+
+# PM2
+pm2 list
+
+# 进程检查
+ps aux | grep <project-name>
+```
+
+**2. 检查端口是否在监听：**
+```bash
+# Linux/Mac
+lsof -i :<port> 2>/dev/null || netstat -tlnp 2>/dev/null | grep <port>
+
+# Windows
+netstat -ano | findstr :<port>
+```
+
+**3. HTTP 连通性验证（核心验证）：**
+```bash
+# 等待服务启动（最多重试 5 次，每次间隔 2 秒）
+for i in 1 2 3 4 5; do
+  STATUS=$(curl -s -o /dev/null -w "%{http_code}" http://localhost:<port>/ 2>/dev/null)
+  if [ "$STATUS" -ge 200 ] && [ "$STATUS" -lt 400 ]; then
+    echo "HTTP $STATUS OK"
+    break
+  fi
+  sleep 2
+done
+
+# 获取响应内容摘要
+curl -s http://localhost:<port>/ 2>/dev/null | head -20
+```
+
+**4. 健康检查端点（如果存在）：**
+```bash
+curl -s http://localhost:<port>/health 2>/dev/null
+curl -s http://localhost:<port>/api/health 2>/dev/null
+curl -s http://localhost:<port>/healthz 2>/dev/null
+```
+
+**5. 浏览器可访问性验证（Web 项目）：**
+
+如果是 Web 项目，使用 Playwright 工具打开浏览器验证页面是否正常加载：
+```
+browser_navigate: http://localhost:<port>/
+browser_snapshot: 检查页面是否正常渲染
+browser_take_screenshot: 截图保存验证结果
+browser_close
+```
+
+如果无法使用浏览器工具，输出可访问的 URL 供用户手动验证：
+```
+🌐 请在浏览器中访问: http://localhost:<port>/
+```
+
+**6. 日志检查（任何验证失败时）：**
+```bash
+# Docker 日志
+docker logs <project-name> --tail 50
+
+# PM2 日志
+pm2 logs <project-name> --lines 50
+```
+
+---
+
+## Step 7.2: 输出验证报告
+
+AI 根据验证结果输出状态报告：
+
+**验证成功：**
+```markdown
+## ✅ 部署验证报告
+
+**服务状态**: 运行中 (Up 2 minutes)
+**端口**: 3000 已监听
+**HTTP 连通**: http://localhost:3000/ → 200 OK
+**健康检查**: /health → 200 OK
+
+### 验证清单
+- ✅ 容器/进程正常运行
+- ✅ 端口 3000 已监听
+- ✅ HTTP 请求返回 200
+- ✅ 页面可正常访问
+
+### 访问地址
+🌐 http://localhost:3000/
+
+### 快捷命令
+- 查看日志: docker logs -f <project-name>
+- 停止服务: docker stop <project-name>
+- 重启服务: docker restart <project-name>
+```
+
+**验证失败：**
+```markdown
+## ❌ 部署验证失败
+
+**问题**: 容器启动后立即退出
+**状态**: Exited (1)
+
+### 错误日志（最近 20 行）
+<显示 docker logs 输出>
+
+### 建议修复
+1. 检查 Dockerfile 配置
+2. 检查启动命令是否正确
+3. 查看完整日志: docker logs <project-name>
+```
+
+验证失败时，询问用户是否要查看完整日志或尝试修复。
+
+---
+
+## Step 8: 询问是否生成一键脚本
+
+```
+AskUserQuestion:
+  header: "一键脚本"
+  question: "部署完成！是否生成一键脚本方便后续开发调试？"
+
+  options:
+  - label: "生成 Taskfile.yml (推荐)"
+    description: "task 已安装 / 现代化工具，YAML 格式简洁，跨平台"
+  - label: "生成 Makefile"
+    description: "make 已安装 / 经典工具，已有 Makefile 时保持一致"
+  - label: "添加到 npm scripts"
+    description: "Node.js 项目，无需额外工具"
+  - label: "不需要"
+    description: "已有足够配置"
+```
+
+---
+
+## Step 9: 生成一键脚本
+
+根据用户选择和项目实际情况，用 Write 工具生成脚本。
+
+**Taskfile.yml 示例（根据实际项目定制）：**
+```yaml
+version: '3'
+
+vars:
+  APP: '{{.APP | default "app"}}'
+  PORT: '{{.PORT | default "3000"}}'
+
+tasks:
+  setup:
+    desc: 安装依赖
+    cmds:
+      - npm install
+
+  build:
+    desc: 构建项目
+    cmds:
+      - npm run build
+
+  test:
+    desc: 运行测试
+    cmds:
+      - npm test
+
+  dev:
+    desc: 本地开发（热重载）
+    cmds:
+      - npm run dev
+
+  deploy:local:
+    desc: 本地 Docker 部署
+    cmds:
+      - docker build -t {{.APP}} .
+      - docker run -d -p {{.PORT}}:{{.PORT}} --name {{.APP}} {{.APP}}
+      - echo "✅ 服务已启动 http://localhost:{{.PORT}}"
+
+  deploy:prod:
+    desc: 生产部署
+    cmds:
+      - docker build -t {{.APP}}:{{.VERSION}} .
+      - docker push {{.REGISTRY}}/{{.APP}}:{{.VERSION}}
+
+  logs:
+    desc: 查看日志
+    cmds:
+      - docker logs -f {{.APP}}
+
+  stop:
+    desc: 停止服务
+    cmds:
+      - docker stop {{.APP}} && docker rm {{.APP}}
+```
+
+**Makefile 示例（根据实际项目定制）：**
+```makefile
+APP ?= app
+PORT ?= 3000
+
+.PHONY: setup build test dev deploy-local deploy-prod logs stop
+
+setup:
+	npm install
+
+build:
+	npm run build
+
+test:
+	npm test
+
+dev:
+	npm run dev
+
+deploy-local:
+	docker build -t $(APP) .
+	docker run -d -p $(PORT):$(PORT) --name $(APP) $(APP)
+	@echo "✅ 服务已启动 http://localhost:$(PORT)"
+
+deploy-prod:
+	docker build -t $(APP):$(VERSION) .
+	docker push $(REGISTRY)/$(APP):$(VERSION)
+
+logs:
+	docker logs -f $(APP)
+
+stop:
+	docker stop $(APP) && docker rm $(APP)
+```
+
+---
+
+## 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
+## ✅ 部署完成
+
+**方案**: Docker 本地部署
+**环境**: 本地开发
+**脚本**: 已生成 Taskfile.yml
+
+### 常用命令
+- `task dev` — 本地开发
+- `task deploy:local` — Docker 本地部署
+- `task deploy:prod` — 生产部署
+- `task logs` — 查看日志
+- `task stop` — 停止服务
+```
+
+</process>
+
+<arguments>
+$ARGUMENTS
+</arguments>
+
+<examples>
+/om:deploy              # 自动分析 → 推荐方案 → 执行 → 生成脚本
+/om:deploy local        # 直接指定本地环境
+/om:deploy prod         # 直接指定生产环境
+</examples>
+
+<notes>
+## 核心原则
+
+1. **AI 是分析者**：读取真实文件和系统状态，不靠硬编码规则推断
+2. **AI 是执行者**：用户确认后直接运行命令，不只是给建议
+3. **推荐最可行的**：基于"当前系统已有什么工具"，不是"理论上最好的"
+4. **产出可复用脚本**：最终生成 Taskfile/Makefile，方便后续开发调试
+5. **记录上次选择**：保存部署配置，下次未变化时直接复用，减少重复询问
+
+## 历史配置复用
+
+`.openmatrix/deploy-config.json` 存储上次部署选择：
+- 对比 `lastDetectedFiles` 和当前文件状态
+- 状态一致 → 直接使用上次配置，仅确认一次
+- 状态变化 → 重新分析并询问
+
+变更检测：
+- Dockerfile/docker-compose.yml/Makefile 新增或删除
+- package.json scripts 变化
+- 系统工具安装状态变化
+
+## 推荐决策依据（AI 自行判断）
+
+| 项目配置 | 系统工具 | 推荐方案 |
+|---------|---------|---------|
+| 有 Dockerfile | docker 已安装 | Docker |
+| 有 docker-compose | docker-compose 已安装 | Docker Compose |
+| 有 k8s/ | kubectl 已安装 | Kubernetes |
+| 有 Makefile | make 已安装 | Make |
+| Node.js | pm2 已安装 | PM2 |
+| Node.js | 无特殊工具 | npm scripts |
+| 无任何配置 | docker 已安装 | 生成 Dockerfile |
+| 无任何配置 | 无工具 | npm scripts / shell 脚本 |
+
+## 脚本工具选择依据
+
+| 条件 | 推荐 |
+|------|------|
+| task 已安装 | Taskfile.yml |
+| make 已安装 / 已有 Makefile | Makefile |
+| Node.js 项目 / 无工具 | npm scripts |
+| Windows + 无工具 | package.json scripts |
+</notes>