@liangjie559567/ultrapower 5.6.8 → 5.6.10

package/.claude-plugin/marketplace.json

@@ -8,11 +8,11 @@
     {
       "name": "ultrapower",
       "description": "Disciplined multi-agent orchestration: workflow enforcement + parallel execution",
-      "version": "5.6.8",
+      "version": "5.6.10",
       "source": {
         "source": "npm",
         "package": "@liangjie559567/ultrapower",
-        "version": "5.6.8"
+        "version": "5.6.10"
       },
       "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.6.8",
+  "version": "5.6.10",
   "author": {
     "name": "liangjie559567"
   },

package/.mcp.json

@@ -12,7 +12,8 @@
       "args": ["${CLAUDE_PLUGIN_ROOT}/bridge/codex-server.cjs"],
       "env": {
         "CLAUDE_PLUGIN_ROOT": "C:\\Users\\ljyih\\Desktop\\ultrapower",
-        "PATH": "C:\\Users\\ljyih\\AppData\\Roaming\\npm;${PATH}"
+        "PATH": "C:\\Users\\ljyih\\AppData\\Roaming\\npm;${PATH}",
+        "OMC_CODEX_TIMEOUT": "25000"
       }
     },
     "g": {
@@ -20,7 +21,8 @@
       "args": ["${CLAUDE_PLUGIN_ROOT}/bridge/gemini-server.cjs"],
       "env": {
         "CLAUDE_PLUGIN_ROOT": "C:\\Users\\ljyih\\Desktop\\ultrapower",
-        "PATH": "C:\\Users\\ljyih\\AppData\\Roaming\\npm;${PATH}"
+        "PATH": "C:\\Users\\ljyih\\AppData\\Roaming\\npm;${PATH}",
+        "OMC_GEMINI_TIMEOUT": "25000"
       }
     }
   }

package/README.md

@@ -12,9 +12,25 @@ ultrapower 是 Claude Code 的智能多 Agent 编排层（OMC），在 superpowe
 
 * **自动触发**：Skills 根据上下文自动激活，无需手动调用
 
-## 快速开始（10 分钟上手）
+## 架构概览
+
+```mermaid
+graph TB
+    A[Claude Code CLI] --> B[ultrapower OMC]
+    B --> C[Skills Layer<br/>71 个工作流自动化]
+    B --> D[Agents Layer<br/>49 个专业 AI agents]
+    B --> E[Tools Layer<br/>LSP/AST/Python REPL]
+    B --> F[Hooks Layer<br/>43 个事件驱动钩子]
+    C --> G[执行模式<br/>autopilot/team/ralph/ultrawork]
+    D --> H[模型路由<br/>Haiku/Sonnet/Opus]
+    E --> I[代码智能<br/>类型检查/重构/分析]
+```
+
+**核心理念**：Superpowers 的严格工作流纪律 + OMC 的并行执行能力
+
+## 快速开始（3 分钟上手）
 
-**新用户？** 查看 [📖 5 分钟快速入门指南](docs/QUICKSTART.md)
+**新用户？** 查看 [📖 3 分钟快速入门指南](docs/getting-started/QUICKSTART.md)
 
 ### 前置条件
 
@@ -26,28 +42,17 @@ ultrapower 是 Claude Code 的智能多 Agent 编排层（OMC），在 superpowe
 
 ### 安装步骤
 
-**方式 1：通过 Claude Code 插件（推荐）**
-
 在 Claude Code 会话中运行：
 
 ```bash
-
 # 1. 添加 marketplace 并安装
-
-/plugin marketplace add <<https://github.com/liangjie559567/ultrapower>>
+/plugin marketplace add https://github.com/liangjie559567/ultrapower
 /plugin install omc@ultrapower
 
 # 2. 运行安装向导
-
 /ultrapower:omc-setup
 ```
 
-**方式 2：通过 npm 全局安装**
-
-```bash
-npm install -g @liangjie559567/ultrapower
-```
-
 ### 验证安装
 
 ```bash
@@ -90,112 +95,29 @@ autopilot "创建一个 hello world 函数"
 
 ---
 
-## Agents（50 个）
-
-### 构建/分析通道
-
-| Agent | 模型 | 用途 |
-| ------- | ------ | ------ |
-| `explore` | haiku | 代码库发现、符号/文件映射 |
-| `analyst` | opus | 需求澄清、验收标准 |
-| `planner` | opus | 任务排序、执行计划 |
-| `architect` | opus | 系统设计、接口、长期权衡 |
-| `debugger` | sonnet | 根因分析、回归隔离 |
-| `executor` | sonnet | 代码实现、重构、功能开发 |
-| `deep-executor` | opus | 复杂自主目标导向任务 |
-| `verifier` | sonnet | 完成证据、声明验证 |
-
-### 审查通道
-
-| Agent | 模型 | 用途 |
-| ------- | ------ | ------ |
-| `style-reviewer` | haiku | 格式、命名、惯用法 |
-| `quality-reviewer` | sonnet | 逻辑缺陷、可维护性 |
-| `api-reviewer` | sonnet | API 契约、版本控制 |
-| `security-reviewer` | sonnet | 漏洞、信任边界 |
-| `performance-reviewer` | sonnet | 热点、复杂度优化 |
-| `code-reviewer` | opus | 跨关注点综合审查 |
-
-### 领域专家
-
-| Agent | 模型 | 用途 |
-| ------- | ------ | ------ |
-| `dependency-expert` | sonnet | 外部 SDK/API/包评估 |
-| `test-engineer` | sonnet | 测试策略、覆盖率 |
-| `quality-strategist` | sonnet | 质量策略、发布就绪性 |
-| `build-fixer` | sonnet | 构建/工具链/类型失败 |
-| `designer` | sonnet | UX/UI 架构、交互设计 |
-| `writer` | haiku | 文档、迁移说明 |
-| `qa-tester` | sonnet | 交互式 CLI/服务验证 |
-| `scientist` | sonnet | 数据/统计分析 |
-| `document-specialist` | sonnet | 外部文档查找 |
-| `git-master` | sonnet | 提交策略、历史整洁 |
-| `database-expert` | sonnet | 数据库设计、查询优化和迁移 |
-| `devops-engineer` | sonnet | CI/CD、容器化、基础设施即代码 |
-| `i18n-specialist` | sonnet | 国际化、本地化和多语言支持 |
-| `accessibility-auditor` | sonnet | Web 无障碍审查和 WCAG 合规 |
-| `api-designer` | sonnet | REST/GraphQL API 设计和契约定义 |
-
-### 产品通道
-
-| Agent | 模型 | 用途 |
-| ------- | ------ | ------ |
-| `product-manager` | sonnet | 问题定义、PRD |
-| `ux-researcher` | sonnet | 启发式审计、可用性 |
-| `information-architect` | sonnet | 分类、导航 |
-| `product-analyst` | sonnet | 产品指标、漏斗分析 |
-
-### 协调
-
-| Agent | 模型 | 用途 |
-| ------- | ------ | ------ |
-| `critic` | opus | 计划/设计批判性挑战 |
-| `vision` | sonnet | 图片/截图/图表分析 |
-
-### Axiom Agents
-
-| Agent | 模型 | 用途 |
-| ------- | ------ | ------ |
-| `axiom-requirement-analyst` | sonnet | 需求分析三态门（PASS/CLARIFY/REJECT） |
-| `axiom-product-designer` | sonnet | Draft PRD 生成，含 Mermaid 流程图 |
-| `axiom-review-aggregator` | sonnet | 5 专家并行审查聚合与冲突仲裁 |
-| `axiom-prd-crafter` | sonnet | 工程级 PRD，含门控验证 |
-| `axiom-system-architect` | sonnet | 原子任务 DAG 与 Manifest 生成 |
-| `axiom-evolution-engine` | sonnet | 知识收割、模式检测、工作流优化 |
-| `axiom-context-manager` | sonnet | 7 操作记忆系统（读/写/状态/检查点） |
-| `axiom-worker` | sonnet | PM→Worker 协议，三态输出 |
-| `axiom-ux-director` | sonnet | UX/体验专家评审 |
-| `axiom-product-director` | sonnet | 产品战略专家评审 |
-| `axiom-domain-expert` | sonnet | 领域知识专家评审 |
-| `axiom-tech-lead` | sonnet | 技术可行性评审 |
-| `axiom-critic` | sonnet | 安全/质量/逻辑评审 |
-| `axiom-sub-prd-writer` | sonnet | 将 Manifest 任务拆解为可执行 Sub-PRD |
+## Agents（49 个）
+
+完整列表请查看 [Agent 参考手册](docs/reference/AGENTS.md)
+
+**核心 Agents**：
+
+* **构建通道**：`explore` (haiku)、`planner` (opus)、`executor` (sonnet)、`architect` (opus)
+* **审查通道**：`code-reviewer` (opus)、`security-reviewer` (sonnet)、`quality-reviewer` (sonnet)
+* **领域专家**：`designer` (sonnet)、`test-engineer` (sonnet)、`debugger` (sonnet)
 
 ---
 
-## Skills（70 个）
+## Skills（71 个）
 
-### 工作流 Skills
+完整列表请查看 [Skills 参考手册](docs/reference/SKILLS.md)
 
-| Skill | 触发词 | 用途 |
-| ------- | -------- | ------ |
-| `autopilot` | "autopilot", "build me" | 从想法到可运行代码的全自主执行 |
-| `ralph` | "ralph", "don't stop" | 带 verifier 验证的自引用循环 |
-| `ultrawork` | "ulw", "ultrawork" | 并行 agent 编排最大并行度 |
-| `team` | "team", "coordinated team" | N 个协调 agents，阶段感知路由 |
-| `ultrapilot` | "ultrapilot", "parallel build" | 带文件所有权分区的并行 autopilot |
-| `pipeline` | "pipeline", "chain agents" | 带数据传递的顺序 agent 链 |
-| `ultraqa` | 由 autopilot 激活 | QA 循环：测试、验证、修复、重复 |
-| `plan` | "plan this", "plan the" | 战略规划，支持 `--consensus`/`--review` |
-| `ralplan` | "ralplan", "consensus plan" | 与 Planner/Architect/Critic 迭代规划 |
-| `swarm` | "swarm" | Team 的兼容性外观 |
+**核心 Skills**：
 
-### 开发工作流 Skills
+* **工作流**：`autopilot`、`team`、`ralph`、`ultrawork`、`plan`
+* **开发**：`brainstorming`、`writing-plans`、`test-driven-development`
+* **Axiom**：`ax-draft`、`ax-review`、`ax-decompose`、`ax-implement`
 
-| Skill | 用途 |
-| ------- | ------ |
-| `brainstorming` | 设计对话，代码前必须先设计 |
-| `writing-plans` | 详细实现计划，原子任务 |
+---
 | `executing-plans` | 带检查点的批量执行 |
 | `subagent-driven-development` | 每任务独立 subagent + 两阶段审查 |
 | `test-driven-development` | RED-GREEN-REFACTOR 循环 |
@@ -276,18 +198,20 @@ autopilot "创建一个 hello world 函数"
 
 ### Team 流水线（默认多 Agent 编排器）
 
-```
-team-plan → team-prd → team-exec → team-verify → team-fix（循环）
+```mermaid
+graph LR
+    A[team-plan<br/>探索与规划] --> B[team-prd<br/>需求确认]
+    B --> C[team-exec<br/>代码实现]
+    C --> D[team-verify<br/>验证与测试]
+    D -->|发现缺陷| E[team-fix<br/>修复]
+    E --> C
+    D -->|通过| F((完成))
 ```
 
 * **team-plan**：`explore` + `planner`，可选 `analyst`/`architect`
-
 * **team-prd**：`analyst`，可选 `product-manager`/`critic`
-
 * **team-exec**：`executor` + 任务适配专家
-
 * **team-verify**：`verifier` + 按需审查 agents
-
 * **team-fix**：根据缺陷类型路由到 `executor`/`build-fixer`/`debugger`
 
 ### MCP 路由
@@ -321,36 +245,18 @@ ultrapower 内置 Axiom 自我进化引擎，让 AI 工作流随使用不断优
 | 工作流优化 | 分析执行指标，发现瓶颈并生成优化建议 |
 | 跨会话记忆 | 知识库和模式库跨会话持久化，越用越聪明 |
 
-### 快速开始
-
-```bash
-
-# 1. 安装插件
-
-/plugin marketplace add <<https://github.com/liangjie559567/ultrapower>>
-/plugin install omc@ultrapower
-
-# 2. 初始化 Axiom 系统
-
-/ultrapower:ax-context init
-
-# 3. 查看系统状态
-
-/ax-status
-```
-
-### 进化工作流
-
-```
-需求 → /ax-draft → /ax-review → /ax-decompose → /ax-implement
-                                                      ↓
-                                                 任务完成
-                                                      ↓
-                                             /ax-reflect（反思）
-                                                      ↓
-                                             /ax-evolve（进化）
-                                                      ↓
-                                        知识库更新 + 模式库更新
+### Axiom 进化工作流
+
+```mermaid
+graph TB
+    A[需求] --> B[/ax-draft<br/>需求起草/]
+    B --> C[/ax-review<br/>专家评审/]
+    C --> D[/ax-decompose<br/>任务拆解/]
+    D --> E[/ax-implement<br/>实施交付/]
+    E --> F[任务完成]
+    F --> G[/ax-reflect<br/>反思/]
+    G --> H[/ax-evolve<br/>进化/]
+    H --> I[知识库更新<br/>模式库更新]
 ```
 
 详细文档请参阅 [docs/EVOLUTION.md](docs/EVOLUTION.md)。

package/bridge/codex-server.cjs

@@ -13723,6 +13723,147 @@ var ExperimentalServerTasks = class {
   requestStream(request, resultSchema, options) {
     return this._server.requestStream(request, resultSchema, options);
   }
+  /**
+   * Sends a sampling request and returns an AsyncGenerator that yields response messages.
+   * The generator is guaranteed to end with either a 'result' or 'error' message.
+   *
+   * For task-augmented requests, yields 'taskCreated' and 'taskStatus' messages
+   * before the final result.
+   *
+   * @example
+   * ```typescript
+   * const stream = server.experimental.tasks.createMessageStream({
+   *     messages: [{ role: 'user', content: { type: 'text', text: 'Hello' } }],
+   *     maxTokens: 100
+   * }, {
+   *     onprogress: (progress) => {
+   *         // Handle streaming tokens via progress notifications
+   *         console.log('Progress:', progress.message);
+   *     }
+   * });
+   *
+   * for await (const message of stream) {
+   *     switch (message.type) {
+   *         case 'taskCreated':
+   *             console.log('Task created:', message.task.taskId);
+   *             break;
+   *         case 'taskStatus':
+   *             console.log('Task status:', message.task.status);
+   *             break;
+   *         case 'result':
+   *             console.log('Final result:', message.result);
+   *             break;
+   *         case 'error':
+   *             console.error('Error:', message.error);
+   *             break;
+   *     }
+   * }
+   * ```
+   *
+   * @param params - The sampling request parameters
+   * @param options - Optional request options (timeout, signal, task creation params, onprogress, etc.)
+   * @returns AsyncGenerator that yields ResponseMessage objects
+   *
+   * @experimental
+   */
+  createMessageStream(params, options) {
+    const clientCapabilities = this._server.getClientCapabilities();
+    if ((params.tools || params.toolChoice) && !clientCapabilities?.sampling?.tools) {
+      throw new Error("Client does not support sampling tools capability.");
+    }
+    if (params.messages.length > 0) {
+      const lastMessage = params.messages[params.messages.length - 1];
+      const lastContent = Array.isArray(lastMessage.content) ? lastMessage.content : [lastMessage.content];
+      const hasToolResults = lastContent.some((c) => c.type === "tool_result");
+      const previousMessage = params.messages.length > 1 ? params.messages[params.messages.length - 2] : void 0;
+      const previousContent = previousMessage ? Array.isArray(previousMessage.content) ? previousMessage.content : [previousMessage.content] : [];
+      const hasPreviousToolUse = previousContent.some((c) => c.type === "tool_use");
+      if (hasToolResults) {
+        if (lastContent.some((c) => c.type !== "tool_result")) {
+          throw new Error("The last message must contain only tool_result content if any is present");
+        }
+        if (!hasPreviousToolUse) {
+          throw new Error("tool_result blocks are not matching any tool_use from the previous message");
+        }
+      }
+      if (hasPreviousToolUse) {
+        const toolUseIds = new Set(previousContent.filter((c) => c.type === "tool_use").map((c) => c.id));
+        const toolResultIds = new Set(lastContent.filter((c) => c.type === "tool_result").map((c) => c.toolUseId));
+        if (toolUseIds.size !== toolResultIds.size || ![...toolUseIds].every((id) => toolResultIds.has(id))) {
+          throw new Error("ids of tool_result blocks and tool_use blocks from previous message do not match");
+        }
+      }
+    }
+    return this.requestStream({
+      method: "sampling/createMessage",
+      params
+    }, CreateMessageResultSchema, options);
+  }
+  /**
+   * Sends an elicitation request and returns an AsyncGenerator that yields response messages.
+   * The generator is guaranteed to end with either a 'result' or 'error' message.
+   *
+   * For task-augmented requests (especially URL-based elicitation), yields 'taskCreated'
+   * and 'taskStatus' messages before the final result.
+   *
+   * @example
+   * ```typescript
+   * const stream = server.experimental.tasks.elicitInputStream({
+   *     mode: 'url',
+   *     message: 'Please authenticate',
+   *     elicitationId: 'auth-123',
+   *     url: 'https://example.com/auth'
+   * }, {
+   *     task: { ttl: 300000 } // Task-augmented for long-running auth flow
+   * });
+   *
+   * for await (const message of stream) {
+   *     switch (message.type) {
+   *         case 'taskCreated':
+   *             console.log('Task created:', message.task.taskId);
+   *             break;
+   *         case 'taskStatus':
+   *             console.log('Task status:', message.task.status);
+   *             break;
+   *         case 'result':
+   *             console.log('User action:', message.result.action);
+   *             break;
+   *         case 'error':
+   *             console.error('Error:', message.error);
+   *             break;
+   *     }
+   * }
+   * ```
+   *
+   * @param params - The elicitation request parameters
+   * @param options - Optional request options (timeout, signal, task creation params, etc.)
+   * @returns AsyncGenerator that yields ResponseMessage objects
+   *
+   * @experimental
+   */
+  elicitInputStream(params, options) {
+    const clientCapabilities = this._server.getClientCapabilities();
+    const mode = params.mode ?? "form";
+    switch (mode) {
+      case "url": {
+        if (!clientCapabilities?.elicitation?.url) {
+          throw new Error("Client does not support url elicitation.");
+        }
+        break;
+      }
+      case "form": {
+        if (!clientCapabilities?.elicitation?.form) {
+          throw new Error("Client does not support form elicitation.");
+        }
+        break;
+      }
+    }
+    const normalizedParams = mode === "form" && params.mode === void 0 ? { ...params, mode: "form" } : params;
+    return this.requestStream({
+      method: "elicitation/create",
+      params: normalizedParams
+    }, ElicitResultSchema, options);
+  }
   /**
    * Gets the current status of a task.
    *
@@ -14707,6 +14848,41 @@ Prompt unavailable.`;
   }
 }
 
+// src/features/prompt-optimizer/index.ts
+init_define_AGENT_PROMPTS_CODEX();
+init_define_AGENT_PROMPTS();
+init_define_AGENT_ROLES();
+var REDUNDANT_PHRASES = [
+  /could you please /gi,
+  /I would like you to /gi,
+  /can you help me /gi,
+  / and help me understand it$/gi,
+  /help me /gi
+];
+var INSTRUCTION_SIMPLIFIERS = [
+  { pattern: /Please summarize the following/gi, replacement: "Summarize" },
+  { pattern: /Could you analyze/gi, replacement: "Analyze" },
+  { pattern: /^please /gi, replacement: "" }
+];
+function optimizePromptText(prompt) {
+  const changes = [];
+  let optimized = prompt;
+  REDUNDANT_PHRASES.forEach((pattern) => {
+    if (pattern.test(optimized)) {
+      optimized = optimized.replace(pattern, "");
+      changes.push("\u79FB\u9664\u5197\u4F59\u77ED\u8BED");
+    }
+  });
+  const originalOptimized = optimized;
+  INSTRUCTION_SIMPLIFIERS.forEach(({ pattern, replacement }) => {
+    optimized = optimized.replace(pattern, replacement);
+  });
+  if (optimized !== originalOptimized) {
+    changes.push("\u7B80\u5316\u6307\u4EE4\u52A8\u8BCD");
+  }
+  return { text: optimized.trim(), changes };
+}
+
 // src/mcp/prompt-injection.ts
 var import_meta2 = {};
 function getPackageDir2() {
@@ -14801,7 +14977,8 @@ ${systemPrompt}
 
 ${fileContext}`);
   }
-  parts.push(userPrompt);
+  const { text: optimizedPrompt } = optimizePromptText(userPrompt);
+  parts.push(optimizedPrompt);
   return parts.join("\n\n");
 }
 
@@ -16691,7 +16868,7 @@ function parseEnvInt(envVal, fallback) {
   return isNaN(n) ? fallback : n;
 }
 var CODEX_DEFAULT_MODEL = process.env.OMC_CODEX_DEFAULT_MODEL || "gpt-5.3-codex";
-var CODEX_TIMEOUT = Math.min(Math.max(5e3, parseEnvInt(process.env.OMC_CODEX_TIMEOUT, 36e5)), 36e5);
+var CODEX_TIMEOUT = Math.min(Math.max(5e3, parseEnvInt(process.env.OMC_CODEX_TIMEOUT, 3e5)), 36e5);
 var RATE_LIMIT_RETRY_COUNT = Math.min(10, Math.max(1, parseEnvInt(process.env.OMC_CODEX_RATE_LIMIT_RETRY_COUNT, 3)));
 var RATE_LIMIT_INITIAL_DELAY = Math.max(1e3, parseEnvInt(process.env.OMC_CODEX_RATE_LIMIT_INITIAL_DELAY, 5e3));
 var RATE_LIMIT_MAX_DELAY = Math.max(5e3, parseEnvInt(process.env.OMC_CODEX_RATE_LIMIT_MAX_DELAY, 6e4));
@@ -17477,7 +17654,7 @@ function parseEnvInt2(envVal, fallback) {
   return isNaN(n) ? fallback : n;
 }
 var GEMINI_DEFAULT_MODEL = process.env.OMC_GEMINI_DEFAULT_MODEL || "gemini-3-pro-preview";
-var GEMINI_TIMEOUT = Math.min(Math.max(5e3, parseEnvInt2(process.env.OMC_GEMINI_TIMEOUT, 36e5)), 36e5);
+var GEMINI_TIMEOUT = Math.min(Math.max(5e3, parseEnvInt2(process.env.OMC_GEMINI_TIMEOUT, 3e5)), 36e5);
 var _yoloEnv = process.env.OMC_GEMINI_YOLO;
 var MAX_FILE_SIZE2 = 5 * 1024 * 1024;
 var MAX_STDOUT_BYTES2 = 10 * 1024 * 1024;