@liangjie559567/ultrapower 5.5.18 → 5.5.20

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.20",
       "source": {
         "source": "npm",
         "package": "@liangjie559567/ultrapower",
-        "version": "5.5.17"
+        "version": "5.5.20"
       },
       "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.20",
   "author": {
     "name": "liangjie559567"
   },

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 Jesse Vincent
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 Jesse Vincent
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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 验证引用的组件或模式是否存在于代码库中。