@liangjie559567/ultrapower 5.5.18 → 5.5.19

package/.claude-plugin/marketplace.json

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

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "ultrapower",
   "description": "Disciplined multi-agent orchestration: workflow enforcement + parallel execution",
-  "version": "5.5.15",
+  "version": "5.5.18",
   "author": {
     "name": "liangjie559567"
   },

package/README.md

@@ -1,6 +1,6 @@
 # ultrapower
 
-ultrapower 是 Claude Code 的智能多 Agent 编排层（OMC），在 superpowers 工作流基础上深度融合了 Axiom 框架，提供 **50 个专业 agents**、**71 个 skills** 和完整的 TypeScript hooks 系统。
+ultrapower 是 Claude Code 的智能多 Agent 编排层（OMC），在 superpowers 工作流基础上深度融合了 Axiom 框架，提供 **50 个专业 agents**、**70 个 skills** 和完整的 TypeScript hooks 系统。
 
 ## 核心能力
 
@@ -9,24 +9,30 @@ 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
 ```
 
-### 方式二：npm 全局安装
+**方式 2：通过 npm 全局安装**
 
 ```bash
 npm install -g @liangjie559567/ultrapower
@@ -34,7 +40,21 @@ npm install -g @liangjie559567/ultrapower
 
 ### 验证安装
 
-启动新会话，说 "help me plan this feature"，agent 应自动调用相关 skill。
+```bash
+# 验证安装
+/ultrapower:omc-doctor
+```
+
+### 第一个示例
+
+```bash
+# 使用 autopilot 模式构建一个简单功能
+autopilot "创建一个 hello world 函数"
+```
+
+### 故障排查
+
+遇到问题？查看 [故障排查指南](docs/TROUBLESHOOTING.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 验证引用的组件或模式是否存在于代码库中。