@liangjie559567/ultrapower 5.5.2 → 5.5.3

package/.claude-plugin/marketplace.json

@@ -8,11 +8,11 @@
     {
       "name": "ultrapower",
       "description": "Disciplined multi-agent orchestration: workflow enforcement + parallel execution",
-      "version": "5.5.1",
+      "version": "5.5.20",
       "source": {
         "source": "npm",
         "package": "@liangjie559567/ultrapower",
-        "version": "5.5.1"
+        "version": "5.5.20"
       },
       "author": {
         "name": "liangjie559567"

package/.claude-plugin/plugin.json

@@ -1,20 +1,24 @@
 {
   "name": "ultrapower",
-  "description": "Disciplined multi-agent orchestration: workflow enforcement + parallel execution. Combines superpowers' TDD/debugging discipline with OMC's multi-agent execution capabilities.",
-  "version": "5.5.0",
+  "description": "Disciplined multi-agent orchestration: workflow enforcement + parallel execution",
+  "version": "5.5.3",
   "author": {
     "name": "liangjie559567"
   },
-  "homepage": "https://github.com/liangjie559567/ultrapower",
-  "repository": "https://github.com/liangjie559567/ultrapower",
+  "homepage": "https://github.com/liangjie559567/ultrapower#readme",
+  "repository": "git+https://github.com/liangjie559567/ultrapower.git",
   "license": "MIT",
   "keywords": [
-    "skills",
-    "tdd",
-    "debugging",
+    "claude",
+    "claude-code",
+    "ai",
+    "agent",
     "multi-agent",
     "orchestration",
-    "workflows",
-    "ultrapower"
-  ]
-}
+    "omc",
+    "claudecode",
+    "anthropic",
+    "llm"
+  ],
+  "skills": "skills"
+}

package/README.md

@@ -1,6 +1,6 @@
 # ultrapower
 
-ultrapower 是 Claude Code 的智能多 Agent 编排层（OMC），在 superpowers 工作流基础上深度融合了 Axiom 框架，提供 **49 个专业 agents**、**71 个 skills** 和完整的 TypeScript hooks 系统。
+ultrapower 是 Claude Code 的智能多 Agent 编排层（OMC），在 superpowers 工作流基础上深度融合了 Axiom 框架，提供 **50 个专业 agents**、**70 个 skills** 和完整的 TypeScript hooks 系统。
 
 ## 核心能力
 
@@ -9,21 +9,52 @@ ultrapower 是 Claude Code 的智能多 Agent 编排层（OMC），在 superpowe
 - **完整工作流**：从头脑风暴到代码审查的端到端开发流程
 - **自动触发**：Skills 根据上下文自动激活，无需手动调用
 
-## 安装
+## 快速开始（10 分钟上手）
 
-### Claude Code（插件市场）
+### 前置条件
+
+- Node.js >= 18
+- Claude Code >= v1.0.0
+- Git（用于插件安装）
+
+### 安装步骤
+
+**方式 1：通过 Claude Code 插件（推荐）**
+
+在 Claude Code 会话中运行：
 
 ```bash
-# 第一步：添加插件市场
+# 1. 添加 marketplace 并安装
 /plugin marketplace add https://github.com/liangjie559567/ultrapower
-
-# 第二步：安装插件
 /plugin install omc@ultrapower
+
+# 2. 运行安装向导
+/ultrapower:omc-setup
+```
+
+**方式 2：通过 npm 全局安装**
+
+```bash
+npm install -g @liangjie559567/ultrapower
 ```
 
 ### 验证安装
 
-启动新会话，说 "help me plan this feature"，agent 应自动调用相关 skill。
+```bash
+# 验证安装
+/ultrapower:omc-doctor
+```
+
+### 第一个示例
+
+```bash
+# 使用 autopilot 模式构建一个简单功能
+autopilot "创建一个 hello world 函数"
+```
+
+### 故障排查
+
+遇到问题？查看 [故障排查指南](docs/TROUBLESHOOTING.md)
 
 ---
 
@@ -45,7 +76,7 @@ ultrapower 是 Claude Code 的智能多 Agent 编排层（OMC），在 superpowe
 
 ---
 
-## Agents（49 个）
+## Agents（50 个）
 
 ### 构建/分析通道
 
@@ -301,6 +332,71 @@ ultrapower 内置 Axiom 自我进化引擎，让 AI 工作流随使用不断优
 
 ---
 
+## MCP 服务器
+
+ultrapower 提供完整的 MCP（Model Context Protocol）服务器，暴露 35 个自定义工具供 Claude Desktop 和 Cursor 使用。
+
+### 快速开始
+
+```bash
+# 启动 MCP 服务器
+node bridge/mcp-server.cjs
+
+# 或使用 npm
+npm run mcp:start
+```
+
+### 配置 Claude Desktop
+
+编辑 `~/.claude/claude_desktop_config.json`：
+
+```json
+{
+  "mcpServers": {
+    "ultrapower": {
+      "command": "node",
+      "args": ["/path/to/ultrapower/bridge/mcp-server.cjs"],
+      "env": {
+        "OMC_LOG_LEVEL": "info"
+      }
+    }
+  }
+}
+```
+
+### 配置 Cursor
+
+在项目根目录创建 `.cursor/mcp.json`：
+
+```json
+{
+  "mcpServers": {
+    "ultrapower": {
+      "command": "node",
+      "args": ["/path/to/ultrapower/bridge/mcp-server.cjs"],
+      "env": {
+        "OMC_LOG_LEVEL": "info"
+      }
+    }
+  }
+}
+```
+
+### 可用工具（35 个）
+
+- **LSP 工具（12 个）**：代码导航、诊断、重构
+- **AST 工具（2 个）**：结构化模式匹配和替换
+- **Python REPL（1 个）**：持久数据分析环境
+- **Notepad 工具（6 个）**：会话记忆管理
+- **State 工具（5 个）**：模式状态管理
+- **Project Memory 工具（4 个）**：项目级持久记忆
+- **Trace 工具（2 个）**：Agent 流程追踪分析
+- **Skills 工具（3 个）**：Skill 加载和管理
+
+详见 [docs/guides/mcp-server-usage.md](docs/guides/mcp-server-usage.md)。
+
+---
+
 ## 哲学
 
 - **测试驱动开发** — 始终先写测试

package/agents/analyst.md

@@ -39,8 +39,32 @@ disallowedTools: Write, Edit
     5) 检查依赖关系：工作开始前必须存在什么？
     6) 列举边缘情况：异常输入、状态、时序条件。
     7) 优先排序发现：关键缺口优先，次要问题最后。
+    8) **预分配专业 Agent**：基于需求特征推荐后续 agent（见下方 Agent_Routing 章节）。
   </Investigation_Protocol>
 
+  <Agent_Routing>
+    分析完成后，根据需求特征推荐专业 agent：
+
+    **信号检测规则**：
+    - 含 "security"/"auth"/"permission" → 推荐 `security-reviewer`
+    - 含 "API"/"endpoint"/"contract" → 推荐 `api-reviewer`
+    - 含 "performance"/"optimize"/"slow" → 推荐 `performance-reviewer`
+    - 含 "UI"/"component"/"frontend" → 推荐 `designer`
+    - 含 "database"/"schema"/"migration" → 推荐 `database-expert`
+    - 含 "test"/"coverage"/"TDD" → 推荐 `test-engineer`
+    - 文件数 > 10 或跨模块 → 推荐 `architect`
+    - 文件数 1-3 → 推荐 `executor`
+    - 外部依赖/SDK → 推荐 `dependency-expert`
+
+    **输出格式**（在分析末尾添加）：
+    ```
+    ### 推荐 Agent 路由
+    基于需求特征，建议后续使用：
+    1. [agent-name] (model) - [理由]
+    2. [agent-name] (model) - [理由]
+    ```
+  </Agent_Routing>
+
   <Tool_Usage>
     - 使用 Read 检查任何引用的文档或规范。
     - 使用 Grep/Glob 验证引用的组件或模式是否存在于代码库中。