@liangjie559567/ultrapower 5.5.33 → 5.5.35

package/.claude-plugin/marketplace.json

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

package/README.md

@@ -1,6 +1,6 @@
 # ultrapower
 
-ultrapower 是 Claude Code 的智能多 Agent 编排层（OMC），在 superpowers 工作流基础上深度融合了 Axiom 框架，提供 **50 个专业 agents**、**70 个 skills** 和完整的 TypeScript hooks 系统。
+ultrapower 是 Claude Code 的智能多 Agent 编排层（OMC），在 superpowers 工作流基础上深度融合了 Axiom 框架，提供 **49 个专业 agents**、**71 个 skills** 和完整的 TypeScript hooks 系统。
 
 ## 核心能力
 
@@ -11,6 +11,8 @@ ultrapower 是 Claude Code 的智能多 Agent 编排层（OMC），在 superpowe
 
 ## 快速开始（10 分钟上手）
 
+**新用户？** 查看 [📖 5 分钟快速入门指南](docs/QUICKSTART.md)
+
 ### 前置条件
 
 - Node.js >= 18

package/docs/AXIOM.md

@@ -0,0 +1,316 @@
+# Axiom 系统指南
+
+## 什么是 Axiom？
+
+Axiom 是 ultrapower 的智能工作流引擎，将复杂的多 Agent 编排转化为简单的命令。它通过**持久记忆**、**自动路由**和**门禁规则**，确保每个工作流都高效、可追溯、符合规范。
+
+**核心价值**：从想法到交付的完整工作流自动化，无需手动协调 49 个 agents。
+
+---
+
+## 快速开始
+
+### 第一个工作流示例
+
+```bash
+# 1. 提出新需求（触发专家评审）
+/ax-draft "添加用户认证模块"
+
+# 2. 专家评审（架构师 + 产品经理）
+/ax-review
+
+# 3. 拆解为可执行任务
+/ax-decompose
+
+# 4. 开始开发（自动路由 executors）
+/ax-implement
+
+# 5. 遇到错误？自动诊断
+/ax-analyze-error
+
+# 6. 完成后反思和学习
+/ax-reflect
+```
+
+### 基本命令
+
+| 命令 | 用途 | 触发 Agent |
+|------|------|-----------|
+| `/ax-draft` | 新需求 → PRD | analyst + product-manager |
+| `/ax-review` | 专家评审 | architect + critic |
+| `/ax-decompose` | 拆解任务 | planner + analyst |
+| `/ax-implement` | 开始开发 | executor + task-specialists |
+| `/ax-analyze-error` | 修 Bug | debugger + executor |
+| `/ax-reflect` | 总结学习 | architect + scientist |
+| `/ax-status` | 查看状态 | - |
+| `/ax-suspend` | 保存退出 | - |
+
+---
+
+## 14 个 Axiom Agents
+
+| Agent | 模型 | 职责 |
+|-------|------|------|
+| `analyst` | opus | 需求澄清、验收标准、隐性约束 |
+| `architect` | opus | 系统设计、边界、接口、长期权衡 |
+| `planner` | opus | 任务排序、执行计划、风险标记 |
+| `executor` | sonnet | 代码实现、重构、功能开发 |
+| `debugger` | sonnet | 根因分析、回归隔离、故障诊断 |
+| `verifier` | sonnet | 完成证据、声明验证、测试充分性 |
+| `product-manager` | sonnet | 问题定义、用户画像、PRD |
+| `critic` | opus | 计划/设计批判性挑战 |
+| `security-reviewer` | sonnet | 漏洞、信任边界、认证/授权 |
+| `test-engineer` | sonnet | 测试策略、覆盖率、不稳定测试加固 |
+| `designer` | sonnet | UX/UI 架构、交互设计 |
+| `writer` | haiku | 文档、迁移说明、用户指南 |
+| `build-fixer` | sonnet | 构建/工具链/类型失败 |
+| `explore` | haiku | 代码库发现、符号/文件映射 |
+
+---
+
+## 14 个 Axiom Skills
+
+| Skill | 触发词 | 工作流 |
+|-------|--------|--------|
+| `ax-draft` | "draft", "新需求" | 需求 → PRD 生成 |
+| `ax-review` | "review", "评审" | 专家评审门禁 |
+| `ax-decompose` | "decompose", "拆解" | 任务分解 |
+| `ax-implement` | "implement", "开发" | 执行流水线 |
+| `ax-analyze-error` | "error", "bug" | 错误诊断 + 修复 |
+| `ax-reflect` | "reflect", "总结" | 学习 + 进化 |
+| `ax-status` | "status", "状态" | 查看当前状态 |
+| `ax-suspend` | "suspend", "保存" | 保存并退出 |
+| `ax-rollback` | "rollback", "回滚" | 回滚到上一步 |
+| `ax-knowledge` | "knowledge", "知识库" | 知识库管理 |
+| `ax-evolution` | "evolution", "进化" | 查询知识库/模式库 |
+| `ax-export` | "export", "导出" | 导出工作流 |
+| `ax-gate-expert` | (自动) | 专家评审门禁 |
+| `ax-gate-ci` | (自动) | CI 编译门禁 |
+
+---
+
+## 记忆系统
+
+Axiom 维护三层记忆，确保工作流连贯性：
+
+### 1. 活跃上下文（`.omc/axiom/active_context.md`）
+
+```markdown
+# 当前工作流状态
+
+状态: EXECUTING
+当前阶段: team-exec
+任务: 添加用户认证模块
+开始时间: 2026-03-08T03:46:35Z
+```
+
+### 2. 项目决策（`.omc/axiom/project_decisions.md`）
+
+```markdown
+# 架构约束
+
+- 认证: JWT + Redis session
+- 数据库: PostgreSQL
+- 框架: Express.js
+- 禁止: 直接 SQL 拼接
+```
+
+### 3. 用户偏好（`.omc/axiom/user_preferences.md`）
+
+```markdown
+# 工作流偏好
+
+- 默认模型: sonnet
+- 并行度: 4
+- 自动审查: 启用
+- 学习队列: 启用
+```
+
+---
+
+## 门禁规则
+
+### Expert Gate（专家评审）
+- **触发**：所有新功能需求
+- **流程**：`/ax-draft` → `/ax-review` → 确认
+- **通过条件**：架构师 + 产品经理同意
+
+### User Gate（PRD 确认）
+- **触发**：PRD 终稿生成
+- **动作**：显示 "PRD 已生成，是否确认执行？(Yes/No)"
+- **通过条件**：用户确认
+
+### CI Gate（编译提交）
+- **触发**：代码修改完成
+- **命令**：`tsc --noEmit && npm run build && npm test`
+- **通过条件**：无错误
+
+### Scope Gate（范围检查）
+- **触发**：修改文件时
+- **检查**：是否在 `manifest.md` 的 `Impact Scope` 内
+- **动作**：越界修改需用户确认
+
+---
+
+## 实际示例
+
+### 示例 1：完整功能开发流程
+
+```bash
+# 第 1 步：提出需求
+/ax-draft "实现 OAuth2 登录"
+
+# 输出：
+# ✓ PRD 已生成
+# ✓ 验收标准：
+#   - 支持 Google/GitHub 登录
+#   - 自动创建用户账户
+#   - 返回 JWT token
+
+# 第 2 步：专家评审
+/ax-review
+
+# 输出：
+# ✓ 架构师审查：设计合理，建议添加 rate limiting
+# ✓ 产品经理审查：符合需求
+# ✓ 安全审查：需要 CSRF 防护
+
+# 第 3 步：拆解任务
+/ax-decompose
+
+# 输出：
+# ✓ 任务 1: 配置 OAuth2 提供商 (30 min)
+# ✓ 任务 2: 实现登录端点 (45 min)
+# ✓ 任务 3: 添加单元测试 (30 min)
+# ✓ 任务 4: 集成测试 (20 min)
+
+# 第 4 步：开始开发
+/ax-implement
+
+# 输出：
+# ✓ 任务 1 完成 (executor)
+# ✓ 任务 2 完成 (executor)
+# ✓ 任务 3 完成 (test-engineer)
+# ✓ 任务 4 完成 (qa-tester)
+# ✓ 代码审查通过 (code-reviewer)
+# ✓ 安全审查通过 (security-reviewer)
+```
+
+### 示例 2：错误诊断和修复
+
+```bash
+# 构建失败
+npm run build
+# Error: Type 'User' is not assignable to type 'UserDTO'
+
+# 自动诊断
+/ax-analyze-error
+
+# 输出：
+# ✓ 根因：User model 缺少 email 字段
+# ✓ 影响范围：3 个文件
+# ✓ 修复方案：添加 email 字段到 User model
+# ✓ 修复中...
+# ✓ 修复完成，重新构建
+# ✓ 构建成功
+```
+
+### 示例 3：工作流反思
+
+```bash
+# 完成后反思
+/ax-reflect
+
+# 输出：
+# ✓ 工作流总结：
+#   - 总耗时：2.5 小时
+#   - 任务数：4
+#   - 成功率：100%
+#   - 平均任务时间：37.5 min
+#
+# ✓ 学习收获：
+#   - 模式：OAuth2 集成最佳实践
+#   - 反模式：避免在 middleware 中做 DB 查询
+#   - 性能优化：使用 Redis 缓存 token 验证
+#
+# ✓ 知识库已更新
+```
+
+---
+
+## 状态恢复
+
+Axiom 自动检测中断的工作流：
+
+```bash
+# 会话启动时自动检测
+# 如果存在 .omc/axiom/active_context.md
+
+状态: EXECUTING
+当前阶段: team-exec
+任务: 添加用户认证模块
+
+是否继续？(Yes/No)
+```
+
+**状态类型**：
+- `IDLE` - 系统就绪，等待指令
+- `EXECUTING` - 工作流进行中，可继续
+- `BLOCKED` - 遇到问题，需人工介入
+- `ARCHIVING` - 自动触发 `/ax-reflect`
+
+---
+
+## 进化引擎
+
+Axiom 自动学习和改进：
+
+| 触发事件 | 自动行为 |
+|---------|---------|
+| 任务完成 | 代码变更加入 `learning_queue.md` |
+| 错误修复成功 | 修复模式加入学习队列 (P1) |
+| 工作流完成 | 更新 `workflow_metrics.md` |
+| 状态 → ARCHIVING | 自动触发 `/ax-reflect` |
+| 状态 → IDLE | 处理学习队列 (P0/P1) |
+
+---
+
+## 常见场景
+
+### 场景 1：快速修复 Bug
+
+```bash
+/ax-analyze-error "TypeError: Cannot read property 'id' of undefined"
+```
+
+### 场景 2：重构现有模块
+
+```bash
+/ax-draft "重构认证模块，提高可维护性"
+/ax-decompose
+/ax-implement
+```
+
+### 场景 3：性能优化
+
+```bash
+/ax-draft "优化数据库查询性能"
+/ax-review  # 架构师评审方案
+/ax-implement
+```
+
+### 场景 4：查询知识库
+
+```bash
+/ax-evolution knowledge "JWT 最佳实践"
+/ax-evolution patterns "错误处理"
+```
+
+---
+
+## 下一步
+
+- 📖 [完整 API 文档](./REFERENCE.md)
+- 🏗️ [架构设计指南](./ARCHITECTURE.md)
+- 🔒 [安全规范](./standards/runtime-protection.md)
+- 🧪 [测试策略](./standards/testing-strategy.md)

package/docs/CLAUDE.md

@@ -1,5 +1,5 @@
 <!-- OMC:START -->
-<!-- OMC:VERSION:5.5.32 -->
+<!-- OMC:VERSION:5.5.33 -->
 # ultrapower - Multi-Agent Orchestration 智能多 Agent 编排
 
 你正在使用 ultrapower（OMC），这是 Claude Code 的多 agent 编排层。

package/docs/INSTALL.md

@@ -1,15 +1,24 @@
 # ultrapower 安装部署详细教程
 
-ultrapower v5.2.2 完整安装指南，覆盖从零开始到完全配置的所有步骤。
+ultrapower v5.5.33 完整安装指南，覆盖从零开始到完全配置的所有步骤。
+
+---
+
+> **⚠️ 重要提示：仅支持 Claude Code 插件安装方式**
+>
+> 从 v5.5.x 开始，ultrapower 仅支持通过 Claude Code 插件系统安装（方式一）。
+> 方式二（本地开发）和方式三（npm 全局安装）已不再官方支持，仅供开发者参考。
+>
+> 推荐所有用户使用**方式一：插件市场安装**。
 
 ---
 
 ## 目录
 
 - [前提条件](#前提条件)
-- [方式一：插件市场安装（推荐）](#方式一插件市场安装推荐)
-- [方式二：本地开发安装](#方式二本地开发安装)
-- [方式三：npm 全局安装](#方式三npm-全局安装)
+- [方式一：插件市场安装（推荐，唯一官方支持）](#方式一插件市场安装推荐)
+- [方式二：本地开发安装（不支持）](#方式二本地开发安装)
+- [方式三：npm 全局安装（不支持）](#方式三npm-全局安装)
 - [安装后配置](#安装后配置)
 - [Axiom 系统初始化](#axiom-系统初始化)
 - [MCP 服务器配置](#mcp-服务器配置)
@@ -53,9 +62,9 @@ git --version
 
 ---
 
-## 方式一：插件市场安装（推荐）
+## 方式一：插件市场安装（推荐，唯一官方支持）
 
-这是最简单的安装方式，适合大多数用户。
+这是唯一官方支持的安装方式，适合所有用户。
 
 ### 步骤 1：添加插件市场
 
@@ -79,7 +88,7 @@ git --version
 
 **预期输出：**
 ```
-✓ Installing ultrapower v5.2.2...
+✓ Installing ultrapower v5.5.33...
 ✓ Hooks registered: 39
 ✓ Agents loaded: 49
 ✓ Skills available: 71
@@ -105,7 +114,12 @@ Plugin installed successfully.
 
 ---
 
-## 方式二：本地开发安装
+## 方式二：本地开发安装（不支持）
+
+> **⚠️ 警告：此方式不再官方支持**
+>
+> 本地开发安装仅供 ultrapower 核心开发者使用。普通用户请使用方式一。
+> 使用此方式可能遇到兼容性问题，不提供技术支持。
 
 适合开发者或需要自定义修改的用户。
 
@@ -130,7 +144,7 @@ npm run build
 
 **预期输出：**
 ```
-> ultrapower@5.2.2 build
+> ultrapower@5.5.33 build
 > tsc && node scripts/build-skill-bridge.mjs
 ✓ TypeScript compiled
 ✓ Skill bridge built
@@ -175,7 +189,12 @@ claude plugin update omc@ultrapower
 
 ---
 
-## 方式三：npm 全局安装
+## 方式三：npm 全局安装（不支持）
+
+> **⚠️ 警告：此方式不再官方支持**
+>
+> npm 全局安装已废弃，不保证与最新版本兼容。
+> 强烈建议使用方式一（插件市场安装）。
 
 适合需要在多个项目间共享的场景。
 
@@ -430,7 +449,7 @@ ultrapower 支持多种 AI 工具，安装后自动生成适配器文件：
 
 ```bash
 # 在 Claude Code 中
-/plugin install omc@ultrapower@5.2.2
+/plugin install omc@ultrapower@5.5.33
 ```
 
 ### 检查当前版本
@@ -487,7 +506,7 @@ rmdir C:\empty_temp
 Remove-Item -Recurse -Force "C:\Users\<name>\.claude\plugins\marketplaces\omc"
 ```
 
-删除后重新安装插件，v5.2.2 已修复此问题，不会再次出现。
+删除后重新安装插件，v5.5.33 已修复此问题，不会再次出现。
 
 ### 问题：hooks 未触发
 
@@ -506,7 +525,7 @@ cat ~/.claude/settings.json | grep hooks
 
 **症状**：`lsp_hover`、`lsp_goto_definition` 等工具报错
 
-**解决**：确保 Node.js 在 PATH 中，LSP 服务器需要 `.cmd` 扩展名支持（v5.2.2 已修复）。
+**解决**：确保 Node.js 在 PATH 中，LSP 服务器需要 `.cmd` 扩展名支持（v5.5.33 已修复）。
 
 ```bash
 # 验证 Node.js 可访问

package/docs/QUICKSTART.md

@@ -0,0 +1,113 @@
+# 快速入门指南
+
+## 5 分钟快速上手
+
+### 安装
+
+在 Claude Code 中运行：
+
+```bash
+/plugin marketplace add https://github.com/liangjie559567/ultrapower
+/plugin install omc@ultrapower
+/ultrapower:omc-setup
+```
+
+### 第一个命令
+
+```bash
+autopilot "创建一个 hello world 函数"
+```
+
+### 验证安装
+
+```bash
+/ultrapower:omc-doctor
+```
+
+---
+
+## 最常用的 5 个 Skills
+
+| Skill | 用途 | 示例 |
+|-------|------|------|
+| **autopilot** | 全自动从想法到代码 | `autopilot "添加用户认证"` |
+| **ultrawork** | 并行执行多个任务 | `ultrawork "任务1" "任务2"` |
+| **team** | 多 agent 协作编排 | `team "设计并实现登录流程"` |
+| **deepinit** | 代码库深度初始化 | `deepinit` |
+| **analyze** | 调试和根因分析 | `analyze "为什么测试失败"` |
+
+---
+
+## 最常用的 3 个执行模式
+
+### 1. autopilot - 从想法到代码
+
+自动完成整个开发流程：需求 → 设计 → 实现 → 测试 → 验证
+
+```bash
+autopilot "实现用户登录功能"
+```
+
+**何时使用**：明确的单一需求，希望快速交付
+
+### 2. ralph - 持续执行直到完成
+
+带验证循环的自引用执行，失败自动修复
+
+```bash
+ralph "构建完整的支付系统"
+```
+
+**何时使用**：复杂任务，需要多轮迭代和自动修复
+
+### 3. team - 分阶段多 agent 协作
+
+规划 → PRD → 执行 → 验证 → 修复（循环）
+
+```bash
+team "重构认证模块"
+```
+
+**何时使用**：大型功能，需要专业 agents 分工协作
+
+---
+
+## 常见问题 Top 3
+
+### Q1: 如何选择执行模式？
+
+| 场景 | 推荐模式 |
+|------|---------|
+| 简单功能，快速交付 | `autopilot` |
+| 复杂任务，需要自动修复 | `ralph` |
+| 大型功能，需要多 agent 协作 | `team` |
+| 多个独立任务并行 | `ultrawork` |
+
+### Q2: 如何查看可用的 agents？
+
+```bash
+/ultrapower:omc-help
+```
+
+查看完整列表：[docs/REFERENCE.md](./REFERENCE.md)
+
+### Q3: 如何停止运行中的任务？
+
+```bash
+/ultrapower:cancel
+```
+
+使用 `--force` 清除所有状态：
+
+```bash
+/ultrapower:cancel --force
+```
+
+---
+
+## 下一步
+
+- 详细文档：[docs/REFERENCE.md](./REFERENCE.md)
+- 架构设计：[docs/ARCHITECTURE.md](./ARCHITECTURE.md)
+- 故障排查：[docs/guides/troubleshooting-guide.md](./guides/troubleshooting-guide.md)
+- 工作流指南：[docs/guides/workflow-recommendation-guide.md](./guides/workflow-recommendation-guide.md)

package/docs/REFERENCE.md

@@ -1,6 +1,6 @@
-<!-- ultrapower v5.5.5 | updated: 2026-03-02 -->
+<!-- ultrapower v5.5.33 | updated: 2026-03-02 -->
 
-# ultrapower Reference — v5.5.5
+# ultrapower Reference — v5.5.33
 
 Complete reference manual for ultrapower. For quick start see [README.md](../README.md).