@liangjie559567/ultrapower 5.2.2 → 5.2.4

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "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.2.1",
+  "version": "5.2.4",
   "author": {
     "name": "Jesse Vincent & oh-my-claudecode contributors"
   },

package/README.md

@@ -1,6 +1,6 @@
 # ultrapower
 
-ultrapower 是 Claude Code 的智能多 Agent 编排层（OMC），在 superpowers 工作流基础上深度融合了 Axiom 框架，提供 **48 个专业 agents**、**71 个 skills** 和完整的 TypeScript hooks 系统。
+ultrapower 是 Claude Code 的智能多 Agent 编排层（OMC），在 superpowers 工作流基础上深度融合了 Axiom 框架，提供 **49 个专业 agents**、**71 个 skills** 和完整的 TypeScript hooks 系统。
 
 ## 核心能力
 
@@ -45,7 +45,7 @@ ultrapower 是 Claude Code 的智能多 Agent 编排层（OMC），在 superpowe
 
 ---
 
-## Agents（48 个）
+## Agents（49 个）
 
 ### 构建/分析通道
 
@@ -256,6 +256,51 @@ team-plan → team-prd → team-exec → team-verify → team-fix（循环）
 
 ---
 
+## Axiom 自我进化系统
+
+ultrapower 内置 Axiom 自我进化引擎，让 AI 工作流随使用不断优化。
+
+### 核心机制
+
+| 机制 | 说明 |
+|------|------|
+| 知识收割 | 每次任务完成后自动提取经验教训，存入知识库 |
+| 模式检测 | 识别重复代码模式，达到阈值（出现 ≥3 次）后提升为最佳实践 |
+| 工作流优化 | 分析执行指标，发现瓶颈并生成优化建议 |
+| 跨会话记忆 | 知识库和模式库跨会话持久化，越用越聪明 |
+
+### 快速开始
+
+```bash
+# 1. 安装插件
+/plugin marketplace add https://github.com/liangjie559567/ultrapower
+/plugin install ultrapower
+
+# 2. 初始化 Axiom 系统
+/ultrapower:ax-context init
+
+# 3. 查看系统状态
+/ax-status
+```
+
+### 进化工作流
+
+```
+需求 → /ax-draft → /ax-review → /ax-decompose → /ax-implement
+                                                      ↓
+                                                 任务完成
+                                                      ↓
+                                             /ax-reflect（反思）
+                                                      ↓
+                                             /ax-evolve（进化）
+                                                      ↓
+                                        知识库更新 + 模式库更新
+```
+
+详细文档请参阅 [docs/EVOLUTION.md](docs/EVOLUTION.md)。
+
+---
+
 ## 哲学
 
 - **测试驱动开发** — 始终先写测试
@@ -294,5 +339,8 @@ MIT License — 详见 LICENSE 文件
 
 - **Issues**: https://github.com/liangjie559567/ultrapower/issues
 - **Marketplace**: https://github.com/liangjie559567/ultrapower
+- **安装部署教程**: [docs/INSTALL.md](docs/INSTALL.md)
 - **完整参考文档**: [docs/REFERENCE.md](docs/REFERENCE.md)
+- **进化系统文档**: [docs/EVOLUTION.md](docs/EVOLUTION.md)
+- **主动进化系统**: [docs/NEXUS.md](docs/NEXUS.md)
 - **迁移指南**: [docs/MIGRATION.md](docs/MIGRATION.md)

package/agents/AGENTS.md

@@ -0,0 +1,60 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# agents/
+
+## Purpose
+包含 49 个专业 AI agent 的 Markdown 提示模板。每个文件定义一个 agent 的角色、能力边界和行为规范，供 `src/agents/` 中的 TypeScript 实现加载。
+
+## Key Files
+
+| 文件 | 描述 |
+|------|------|
+| `executor.md` | 代码实现、重构、功能开发（Sonnet） |
+| `architect.md` | 系统设计、边界、接口、长期权衡（Opus） |
+| `planner.md` | 任务排序、执行计划、风险标记（Opus） |
+| `analyst.md` | 需求澄清、验收标准、隐性约束（Opus） |
+| `explore.md` | 代码库发现、符号/文件映射（Haiku） |
+| `debugger.md` | 根因分析、回归隔离、故障诊断（Sonnet） |
+| `deep-executor.md` | 复杂自主目标导向任务（Opus） |
+| `verifier.md` | 完成证据、声明验证、测试充分性（Sonnet） |
+| `code-reviewer.md` | 跨关注点综合审查（Opus） |
+| `security-reviewer.md` | 漏洞、信任边界、认证/授权（Sonnet） |
+| `axiom-worker.md` | PM→Worker 协议，三态输出（Sonnet） |
+| `axiom-system-architect.md` | 原子任务 DAG 与 Manifest 生成（Sonnet） |
+
+## Agent 分类
+
+| 类别 | Agent 数量 | 代表 Agent |
+|------|-----------|-----------|
+| Build/Analysis Lane | 8 | explore, analyst, planner, architect, debugger, executor, deep-executor, verifier |
+| Review Lane | 6 | style-reviewer, quality-reviewer, api-reviewer, security-reviewer, performance-reviewer, code-reviewer |
+| Domain Specialists | 16 | dependency-expert, test-engineer, designer, writer, qa-tester, scientist 等 |
+| Product Lane | 4 | product-manager, ux-researcher, information-architect, product-analyst |
+| Axiom Lane | 14 | axiom-requirement-analyst, axiom-prd-crafter, axiom-worker 等 |
+| Coordination | 1 | critic |
+
+## For AI Agents
+
+### 修改此目录时
+- 修改 agent 提示后，必须同步更新 `src/agents/definitions.ts` 和 `src/agents/index.ts`
+- 分层 agent（`-low`、`-medium`、`-high` 变体）需同步更新所有变体
+- 更新 `docs/REFERENCE.md` 中的 agent 列表
+- 更新根目录 `AGENTS.md` 中的 agent 概览表
+
+### 命名规范
+- 文件名使用 kebab-case：`my-agent.md`
+- Axiom 系列以 `axiom-` 前缀命名
+- 审查类以 `-reviewer` 后缀命名
+
+### 模板结构
+每个 agent 文件应包含：角色定义、能力边界、输出格式、禁止行为
+
+## Dependencies
+
+### Internal
+- `src/agents/definitions.ts` — agent 注册表，引用此目录的文件名
+- `src/agents/prompt-generator.ts` — 加载并渲染 agent 提示模板
+- `docs/REFERENCE.md` — 面向用户的 agent 文档
+
+<!-- MANUAL: -->

package/bridge/AGENTS.md

@@ -0,0 +1,51 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# bridge/
+
+## Purpose
+包含预打包的 MCP（Model Context Protocol）服务器，用于插件分发。这些 `.cjs` 文件是构建产物，由 `scripts/build-*.mjs` 脚本生成，供 Claude Code 插件系统加载。
+
+## Key Files
+
+| 文件 | 描述 |
+|------|------|
+| `mcp-server.cjs` | 主 MCP 工具服务器（LSP、AST、Python REPL、状态工具等） |
+| `codex-server.cjs` | Codex（OpenAI）MCP 代理服务器 |
+| `gemini-server.cjs` | Gemini（Google）MCP 代理服务器 |
+| `team-bridge.cjs` | Team 协调 MCP 桥接服务器 |
+| `gyoshu_bridge.py` | Python 桥接脚本（辅助工具） |
+| `run-mcp-server.sh` | MCP 服务器启动脚本 |
+
+## For AI Agents
+
+### 重要：这是构建产物目录
+- **不要直接编辑** `.cjs` 文件，它们由构建脚本生成
+- 修改 MCP 服务器逻辑应在 `src/mcp/` 中进行
+- 运行 `npm run build` 重新生成这些文件
+
+### 构建来源映射
+| 产物文件 | 源文件 |
+|---------|--------|
+| `mcp-server.cjs` | `src/mcp/omc-tools-server.ts` + `scripts/build-mcp-server.mjs` |
+| `codex-server.cjs` | `src/mcp/codex-server.ts` + `scripts/build-codex-server.mjs` |
+| `gemini-server.cjs` | `src/mcp/gemini-server.ts` + `scripts/build-gemini-server.mjs` |
+| `team-bridge.cjs` | `src/team/` + `scripts/build-bridge-entry.mjs` |
+
+### 修改此目录时
+- 修改 `src/mcp/` 后运行 `npm run build` 重新生成
+- 提交时包含更新后的 `.cjs` 文件（它们是发布产物）
+- 更新 `docs/REFERENCE.md` 中的 MCP 工具部分
+
+## Dependencies
+
+### Internal
+- `src/mcp/` — MCP 服务器源代码
+- `src/team/` — Team 桥接源代码
+- `scripts/build-*.mjs` — 构建脚本
+
+### External
+- `@modelcontextprotocol/sdk` — MCP 协议实现
+- `esbuild` — 打包工具
+
+<!-- MANUAL: -->