@liangjie559567/ultrapower 6.0.0 → 7.0.2

package/docs/concepts/skills.md

@@ -0,0 +1,68 @@
+# Skills 参考
+
+## 工作流 Skills
+
+### autopilot
+**用途**: 从想法到可运行代码的全自主执行
+
+**触发词**: "autopilot", "build me", "I want a"
+
+**示例**:
+```bash
+/ultrapower:autopilot "Build a REST API for todo management"
+```
+
+### ralph
+**用途**: 带验证的自引用循环，持久执行直到完成
+
+**触发词**: "ralph", "don't stop", "must complete"
+
+**示例**:
+```bash
+/ultrapower:ralph "Fix all TypeScript errors in the project"
+```
+
+### team
+**用途**: 多 agent 协调，分阶段流水线
+
+**阶段**: plan → prd → exec → verify → fix
+
+**示例**:
+```bash
+/ultrapower:team "Implement user authentication system"
+```
+
+### ultrawork
+**用途**: 最大并行度的 agent 编排
+
+**触发词**: "ulw", "ultrawork"
+
+**示例**:
+```bash
+/ultrapower:ultrawork "Refactor all API endpoints"
+```
+
+## Agent 快捷 Skills
+
+| Skill | 映射 Agent | 用途 |
+|-------|-----------|------|
+| `analyze` | debugger | 调试分析 |
+| `deepsearch` | explore | 代码库搜索 |
+| `tdd` | test-engineer | 测试驱动开发 |
+| `build-fix` | build-fixer | 修复构建错误 |
+| `code-review` | code-reviewer | 代码审查 |
+
+## 规划 Skills
+
+### plan
+**用途**: 战略规划
+
+**模式**:
+- `--consensus`: 与多个 agents 迭代直至共识
+- `--review`: 批判性审查
+
+**示例**:
+```bash
+/ultrapower:plan "Design microservices architecture"
+/ultrapower:plan --consensus "Refactor authentication layer"
+```

package/docs/getting-started/concepts.md

@@ -1,116 +1,180 @@
-# 核心概念
+# 核心概念图解
 
-理解 ultrapower 的四大核心组件。
+理解 ultrapower 的四大核心组件及其交互方式。
 
 ---
 
-## Agents（智能体）
+## 1️⃣ Agents（智能体）
 
-**定义**: 专业的 AI 助手，每个 agent 专注于特定领域。
+**定义**：专业的 AI 助手，每个 agent 专注于特定领域。
 
-**示例**:
+### 三层 Agent 体系
 
-* `executor` - 代码实现
-
-* `debugger` - 问题诊断
-
-* `architect` - 系统设计
-
-**使用方式**:
 ```
-使用 executor agent 实现登录功能
+┌─────────────────────────────────────────────────┐
+│           49 个专业 Agents                      │
+├─────────────────────────────────────────────────┤
+│ 构建通道          │ 审查通道        │ 领域专家  │
+├──────────────────┼─────────────────┼──────────┤
+│ • explore        │ • code-reviewer │ • designer
+│ • planner        │ • security-rev  │ • debugger
+│ • executor       │ • quality-rev   │ • test-eng
+│ • architect      │ • perf-rev      │ • build-fix
+└──────────────────┴─────────────────┴──────────┘
 ```
 
-[查看完整 Agents 列表 →](../features/agents.md)
+**常用 Agents**：
+- `executor` (sonnet) - 代码实现
+- `debugger` (sonnet) - 问题诊断
+- `architect` (opus) - 系统设计
+- `verifier` (sonnet) - 完成验证
 
 ---
 
-## Skills（技能）
-
-**定义**: 预定义的工作流，自动化复杂任务。
+## 2️⃣ Skills（技能）
 
-**示例**:
+**定义**：预定义的工作流，自动化复杂任务。
 
-* `/ultrapower:autopilot` - 全自主执行
+### 五大 Skill 类别
 
-* `/ultrapower:team` - 多 agent 协作
-
-* `/ultrapower:ralph` - 持续执行
-
-**使用方式**:
 ```
-/ultrapower:autopilot "创建 REST API"
+工作流 Skills          开发 Skills         Axiom Skills
+├─ autopilot          ├─ brainstorming    ├─ ax-draft
+├─ team               ├─ writing-plans    ├─ ax-review
+├─ ralph              ├─ tdd              ├─ ax-decompose
+├─ ultrawork          └─ code-review      ├─ ax-implement
+└─ plan                                   └─ ax-reflect
 ```
 
-[查看完整 Skills 列表 →](../features/skills.md)
+**快速示例**：
+```bash
+# 全自主执行
+/ultrapower:autopilot "创建 REST API"
 
----
+# 多 agent 协作
+/ultrapower:team "重构认证模块"
 
-## Hooks（钩子）
+# 持续执行（带验证循环）
+/ultrapower:ralph "完成整个功能"
+```
 
-**定义**: 事件驱动的自动化触发器。
+---
 
-**示例**:
+## 3️⃣ Hooks（钩子）
 
-* `UserPromptSubmit` - 用户输入时触发
+**定义**：事件驱动的自动化触发器，根据上下文自动激活 Skills。
 
-* `ToolUse` - 工具调用时触发
+### Hook 触发流程
 
-**工作原理**:
 ```
-用户输入 → Hook 检测关键词 → 自动调用 Skill
+用户输入
+    ↓
+Hook 检测关键词
+    ↓
+匹配 Skill 触发规则
+    ↓
+自动调用对应 Skill
+    ↓
+Agent 执行任务
 ```
 
-[查看完整 Hooks 列表 →](../features/hooks.md)
+**常见 Hook 类型**：
+- `UserPromptSubmit` - 用户输入时检测
+- `ToolUse` - 工具调用时检测
+- `ExecutionComplete` - 任务完成时触发
 
----
+**示例**：输入 "autopilot" 关键词 → 自动激活 autopilot skill
 
-## Tools（工具）
+---
 
-**定义**: 35 个自定义工具，扩展 Claude 能力。
+## 4️⃣ Tools（工具）
 
-**分类**:
+**定义**：35 个扩展工具，赋予 Claude 代码智能和状态管理能力。
 
-* **LSP 工具** (12个): 代码智能分析
+### 工具分类
 
-* **AST 工具** (2个): 结构化代码搜索
+```
+LSP 工具 (12)          AST 工具 (2)         State 工具 (5)
+├─ hover              ├─ search            ├─ read
+├─ goto-def           └─ replace           ├─ write
+├─ find-refs                               ├─ clear
+├─ diagnostics                             ├─ list
+└─ rename                                  └─ status
+
+Notepad (6)           Project Memory (4)   Trace (2)
+├─ read               ├─ read              ├─ timeline
+├─ write              ├─ write             └─ summary
+├─ priority           ├─ add-note
+├─ working            └─ add-directive
+├─ manual
+└─ prune
+```
 
-* **State 工具** (5个): 状态管理
+---
 
-* **Notepad 工具** (6个): 会话记忆
+## 🔄 完整工作流程
 
-[查看完整 Tools 列表 →](../features/tools.md)
+```mermaid
+graph TB
+    A["👤 用户需求<br/>创建登录功能"] --> B["🎣 Hook 检测<br/>识别 autopilot 关键词"]
+    B --> C["⚙️ 调用 Skill<br/>启动 autopilot"]
+    C --> D["👥 分配 Agents<br/>explore + planner + executor"]
+    D --> E["🛠️ 使用 Tools<br/>LSP 代码智能 + AST 搜索"]
+    E --> F["✅ 完成任务<br/>代码实现 + 测试 + 验证"]
+    F --> G["📚 Axiom 学习<br/>知识收割 + 模式检测"]
+```
 
 ---
 
-## Axiom 进化系统
+## 🎯 执行模式对比
 
-**定义**: 自我改进的智能体系统。
+| 模式 | 用途 | 特点 |
+|------|------|------|
+| **autopilot** | 简单功能 | 全自主，无需干预 |
+| **team** | 复杂任务 | 多 agent 协作，分阶段 |
+| **ralph** | 长期任务 | 持续执行，自动修复 |
+| **ultrawork** | 并行工作 | 最大并行度 |
+| **plan** | 规划阶段 | 战略规划，生成任务 |
 
-**核心功能**:
-1. **知识收割** - 从执行中学习
-2. **模式检测** - 识别重复模式
-3. **工作流优化** - 自动改进流程
+---
 
-[了解 Axiom →](../features/axiom.md)
+## 📊 Axiom 进化系统
 
----
+**定义**：自我改进的智能体系统，让 ultrapower 越用越聪明。
 
-## 工作流程图
+### 进化循环
 
-```mermaid
-graph LR
-    A[用户需求] --> B[Hook 检测]
-    B --> C[调用 Skill]
-    C --> D[分配 Agents]
-    D --> E[使用 Tools]
-    E --> F[完成任务]
+```
+任务执行
+    ↓
+知识收割 (自动提取经验)
+    ↓
+模式检测 (识别重复模式)
+    ↓
+工作流优化 (生成改进建议)
+    ↓
+知识库更新 (跨会话持久化)
+    ↓
+下次执行更聪明 ✨
 ```
 
 ---
 
-## 下一步
+## 💡 核心设计原则
+
+| 原则 | 说明 |
+|------|------|
+| **自动化** | Hooks 自动检测，Skills 自动激活 |
+| **专业化** | 每个 Agent 专注一个领域 |
+| **可验证** | 所有输出都经过验证 |
+| **可追踪** | 完整的执行历史和日志 |
+| **自进化** | 系统从使用中不断学习 |
+
+---
 
-* [查看实际使用场景](../guides/scenario-feature-dev.md)
+## 🚀 下一步
 
-* [探索高级功能](../architecture/state-machine.md)
+- [15 分钟快速上手](./quickstart.md)
+- [49 个 Agents 完整列表](../reference/AGENTS.md)
+- [71 个 Skills 完整列表](../reference/SKILLS.md)
+- [Axiom 进化系统详解](../AXIOM.md)

package/docs/getting-started/quick-reference.md

@@ -0,0 +1,135 @@
+# 快速参考卡片
+
+常用命令速查表。
+
+---
+
+## 🎯 执行模式
+
+```bash
+# 全自主执行（简单功能）
+/ultrapower:autopilot "创建登录组件"
+
+# 多 agent 协作（复杂任务）
+/ultrapower:team "重构 API 层"
+
+# 持续执行（长期任务）
+/ultrapower:ralph "完成整个功能"
+
+# 并行工作（最大并行度）
+/ultrapower:ultrawork "并行处理多个模块"
+
+# 战略规划
+/ultrapower:plan "规划项目架构"
+```
+
+---
+
+## 🔧 诊断与管理
+
+```bash
+# 诊断安装问题
+/ultrapower:omc-doctor
+
+# 查看执行历史
+/ultrapower:trace
+
+# 取消正在执行的任务
+/ultrapower:cancel
+
+# 查看系统状态
+/ultrapower:ax-status
+```
+
+---
+
+## 📚 Axiom 工作流
+
+```bash
+# 需求澄清
+/ultrapower:ax-draft "创建用户认证系统"
+
+# 专家评审
+/ultrapower:ax-review
+
+# 任务拆解
+/ultrapower:ax-decompose
+
+# 开始实施
+/ultrapower:ax-implement
+
+# 反思总结
+/ultrapower:ax-reflect
+```
+
+---
+
+## 🛠️ 开发工作流
+
+```bash
+# 代码审查
+/ultrapower:code-review
+
+# 安全审查
+/ultrapower:security-review
+
+# 测试驱动开发
+/ultrapower:tdd "编写登录测试"
+
+# 修复构建错误
+/ultrapower:build-fix
+```
+
+---
+
+## 📝 常用快捷键
+
+| 命令 | 用途 |
+|------|------|
+| `/ultrapower:omc-help` | 显示帮助 |
+| `/ultrapower:omc-setup` | 初始化配置 |
+| `/ultrapower:mcp-setup` | 配置 MCP 服务器 |
+| `/ultrapower:skill` | 管理 skills |
+| `/ultrapower:note` | 保存笔记 |
+
+---
+
+## 🎓 学习资源
+
+| 资源 | 链接 |
+|------|------|
+| 15 分钟快速上手 | [quickstart.md](./quickstart.md) |
+| 核心概念图解 | [concepts.md](./concepts.md) |
+| 49 个 Agents | [AGENTS.md](../reference/AGENTS.md) |
+| 71 个 Skills | [SKILLS.md](../reference/SKILLS.md) |
+| Axiom 进化系统 | [AXIOM.md](../AXIOM.md) |
+| 故障排查 | [TROUBLESHOOTING.md](./TROUBLESHOOTING.md) |
+
+---
+
+## ⚡ 常见场景
+
+### 场景 1：快速创建功能
+```bash
+/ultrapower:autopilot "创建用户注册页面"
+```
+
+### 场景 2：重构大模块
+```bash
+/ultrapower:team "重构认证系统"
+```
+
+### 场景 3：修复 Bug
+```bash
+/ultrapower:analyze "登录页面崩溃"
+```
+
+### 场景 4：代码审查
+```bash
+/ultrapower:code-review
+```
+
+### 场景 5：性能优化
+```bash
+/ultrapower:team "优化数据库查询"
+```

package/docs/getting-started/quickstart.md

@@ -1,45 +1,129 @@
-# 🚀 3 分钟快速开始
+# 🚀 15 分钟快速上手指南
 
-## 第一步：安装与初始化
+完整的 ultrapower 入门教程，从安装到第一个自主执行任务。
+
+---
+
+## ⏱️ 第 1-2 分钟：安装与初始化
 
 在 Claude Code 会话中执行：
 
 ```bash
-# 1. 挂载应用市场并安装
+# 1. 添加应用市场
 /plugin marketplace add https://github.com/liangjie559567/ultrapower
+
+# 2. 安装 ultrapower
 /plugin install omc@ultrapower
 
-# 2. 运行配置向导（初始化基础权限与设置）
+# 3. 运行配置向导
 /ultrapower:omc-setup
 ```
 
-## 第二步：体验自主执行（Autopilot）
+**预期输出**：配置向导会引导你设置基础权限和偏好设置。
+
+---
 
-无需手动选择模型或 Agent，直接输入想法，引擎会自动进行需求分析、拆解任务并执行：
+## ⏱️ 第 3-5 分钟：理解核心概念
+
+ultrapower 由四个核心层组成：
+
+| 层级 | 说明 | 示例 |
+|------|------|------|
+| **Agents** | 专业 AI 助手 | `executor`（代码实现）、`debugger`（问题诊断） |
+| **Skills** | 预定义工作流 | `autopilot`（全自主）、`team`（多 agent 协作） |
+| **Hooks** | 事件驱动触发 | 用户输入时自动激活相关 skill |
+| **Tools** | 35 个扩展工具 | LSP（代码智能）、AST（结构搜索）、State（状态管理） |
+
+**工作流程**：
+```
+用户需求 → Hook 检测 → 调用 Skill → 分配 Agents → 使用 Tools → 完成任务
+```
+
+---
+
+## ⏱️ 第 6-10 分钟：体验自主执行（Autopilot）
+
+无需手动选择模型或 Agent，直接输入想法：
 
 ```bash
 /ultrapower:autopilot "创建一个带密码强度验证的登录组件，要求响应式设计"
 ```
 
-## 第三步：体验并行多 Agent（Team 模式）
+**autopilot 会自动**：
+1. 分析你的需求
+2. 拆解为原子任务
+3. 分配最合适的 agents
+4. 并行执行任务
+5. 验证完成质量
+
+---
+
+## ⏱️ 第 11-13 分钟：体验多 Agent 协作（Team 模式）
 
-对于复杂重构，启动团队协同模式，多线程同时修改：
+对于复杂任务，启动团队协同模式：
 
 ```bash
 /ultrapower:team "重构所有的 API 请求，替换为统一的 Axios 实例，并添加错误重试拦截器"
 ```
 
+**Team 模式流水线**：
+```
+规划 → 需求确认 → 代码实现 → 验证测试 → 修复（如需）
+```
+
+每个阶段使用专业 agents：
+- **规划**：`explore` + `planner`
+- **实现**：`executor` + 领域专家
+- **验证**：`verifier` + 审查 agents
+
+---
+
+## ⏱️ 第 14-15 分钟：验证安装
+
+运行诊断工具确保一切正常：
+
+```bash
+/ultrapower:omc-doctor
+```
+
+**检查项**：
+- ✅ 依赖安装
+- ✅ 权限配置
+- ✅ 工具可用性
+- ✅ 状态文件
+
+---
+
+## 📚 接下来学什么？
+
+| 目标 | 资源 |
+|------|------|
+| 了解所有 49 个 Agents | [Agent 参考手册](../reference/AGENTS.md) |
+| 掌握 71 个 Skills | [Skills 清单](../reference/SKILLS.md) |
+| 学习端到端工作流 | [Workflows 深度指南](../guides/workflows.md) |
+| 配置 MCP 服务器 | [MCP 使用指南](../guides/mcp-server-usage.md) |
+| 了解 Axiom 进化系统 | [Axiom 文档](../AXIOM.md) |
+
 ---
 
-## 💡 接下来？
+## 🔧 常见问题
+
+**Q: 如何查看 Agent 执行进度？**
+```bash
+/ultrapower:omc-doctor
+```
 
-* **查看实时大盘和 Agent 消耗**：输入 `omc stats`
-* **了解端到端的纪律开发流程**：[阅读 Workflows 深度指南](../core-concepts/WORKFLOWS.md)
-* **探索 49 个专业 Agents**：[查看 Agent 参考手册](../reference/AGENTS.md)
-* **掌握 71 个 Skills**：[浏览 Skills 清单](../reference/SKILLS.md)
+**Q: 如何取消正在执行的任务？**
+```bash
+/ultrapower:cancel
+```
 
-## 🔧 遇到问题？
+**Q: 如何查看执行历史？**
+```bash
+/ultrapower:trace
+```
 
-* **诊断工具**：运行 `/ultrapower:omc-doctor` 自动检测并修复常见问题
-* **故障排查**：查看 [TROUBLESHOOTING.md](./TROUBLESHOOTING.md)
-* **提交 Issue**：https://github.com/liangjie559567/ultrapower/issues
+**Q: 遇到错误怎么办？**
+1. 运行 `/ultrapower:omc-doctor` 诊断
+2. 查看 [故障排查指南](./TROUBLESHOOTING.md)
+3. 提交 Issue：https://github.com/liangjie559567/ultrapower/issues