@liangjie559567/ultrapower 7.5.2 → 7.7.0

package/docs/glossary.md

@@ -0,0 +1,174 @@
+# ultrapower 术语表
+
+> **版本**: v5.5.33 | **更新**: 2026-03-16
+
+核心术语分类参考。
+
+---
+
+## Agent（代理）
+
+**Agent** - 专业化的 AI 角色，处理特定类型的工作。ultrapower 包含 49 个 agent，分为 6 个通道。
+
+**Executor** - 代码实现 agent（Sonnet 模型）。处理多文件实现、重构、功能开发。
+
+**Verifier** - 验证 agent（Sonnet 模型）。收集完成证据（BUILD/TEST/LINT/TODO），验证声明。
+
+**Debugger** - 调试 agent（Sonnet 模型）。根因分析、回归隔离、故障诊断。
+
+**Architect** - 架构 agent（Opus 模型）。系统设计、边界定义、接口设计、长期权衡。
+
+**Planner** - 规划 agent（Opus 模型）。任务排序、执行计划、风险标记。
+
+**Explore** - 探索 agent（Haiku 模型）。代码库发现、符号/文件映射、快速扫描。
+
+**Deep-Executor** - 深度执行 agent（Opus 模型）。复杂自主目标导向任务，包含自我验证循环。
+
+---
+
+## Skill（技能）
+
+**Skill** - 行为注入器，修改编排器的运行方式。用户通过 `/ultrapower:<name>` 调用。
+
+**Autopilot** - 全自主执行模式。从想法到可运行代码，无需人工干预。触发词："autopilot"、"build me"。
+
+**Ralph** - 持久循环模式。带 verifier 验证的自引用循环，"不停止直到完成"。触发词："ralph"、"don't stop"。
+
+**Ultrawork** - 最大并行度编排。并行 agent 编排，多个 agent 同时工作。触发词："ulw"、"ultrawork"。
+
+**Team** - 多 agent 协调模式。使用 Claude Code 原生团队，分阶段流水线（plan→prd→exec→verify→fix）。
+
+**Pipeline** - 顺序链式执行。带数据传递的顺序 agent 链。
+
+**Ultrapilot** - Team 的兼容性外观。并行 autopilot，映射到 Team 分阶段运行时。
+
+**Swarm** - 分布式任务认领。N 个协调 agents，SQLite 任务队列，动态任务认领。
+
+---
+
+## Hook（钩子）
+
+**Hook** - 事件驱动的生命周期控制。Claude Code 触发 hook 事件，ultrapower 注册处理器。
+
+**Hook Event** - Claude Code 发出的事件类型。15 种类型：UserPromptSubmit、SubagentStart/Stop、SessionStart/End、PermissionRequest 等。
+
+**Hook Handler** - Hook 事件的处理函数。位于 `src/hooks/` 目录。
+
+**Keyword Detector** - 关键词检测 hook。识别魔法关键词（"autopilot"、"ralph"、"team"），激活对应 skill。
+
+**Bridge Normalize** - Hook 输入规范化。将 Claude Code 的 snake_case 输入转换为内部 camelCase，应用安全过滤。
+
+**SENSITIVE_HOOKS** - 敏感 hook 集合。permission-request、setup-init、setup-maintenance、session-end，严格白名单过滤。
+
+---
+
+## Mode（模式）
+
+**Mode** - 执行模式。8 个有效值：autopilot、ultrapilot、team、pipeline、ralph、ultrawork、ultraqa、swarm。
+
+**Valid Modes** - 白名单模式集合。`['autopilot', 'ultrapilot', 'team', 'pipeline', 'ralph', 'ultrawork', 'ultraqa', 'swarm']`。
+
+**Mode State** - 模式执行状态。存储于 `.omc/state/{mode}-state.json`，包含 active、current_phase、iteration 等字段。
+
+**Exclusive Modes** - 互斥模式。autopilot、ultrapilot、swarm、pipeline 互斥，同时只能激活一个。
+
+**Mode Stale** - 模式过期标记。1 小时未更新的模式状态标记为 stale（不同于 agent stale 的 5 分钟）。
+
+---
+
+## State（状态）
+
+**State File** - 模式状态持久化文件。JSON 格式，存储于 `.omc/state/{mode}-state.json`。
+
+**Session State** - 会话级状态。存储于 `.omc/state/sessions/{sessionId}/{mode}-state.json`，隔离并发会话。
+
+**Atomic Write** - 原子写入。通过临时文件 + rename 保证写入原子性，防止并发损坏。
+
+**State Manager** - 状态管理器。统一的读/写接口，强制路径安全校验（assertValidMode）。
+
+**Stale Threshold** - 过期阈值。Agent stale：5 分钟（警告日志）；Mode stale：1 小时（标记过期）。
+
+**Subagent Tracking** - Agent 生命周期追踪。`.omc/state/subagent-tracking.json`，记录活跃 agents、超时、孤儿检测。
+
+---
+
+## Tool（工具）
+
+**Tool** - 可调用的功能单元。35 个自定义工具：LSP x12、AST x2、REPL x1、Notepad x6、State x5、Memory x4、Trace x2、Skills x3。
+
+**LSP Tool** - 语言服务器协议工具。ultrapower:lsp_hover、ultrapower:lsp_goto_definition、ultrapower:lsp_find_references、ultrapower:lsp_diagnostics 等。
+
+**AST Tool** - 抽象语法树工具。ast_grep_search（结构化代码搜索）、ast_grep_replace（结构化转换）。
+
+**State Tool** - 状态管理工具。state_read、state_write、state_clear、state_list_active、state_get_status。
+
+**Notepad Tool** - 会话记忆工具。notepad_read、notepad_write_priority、notepad_write_working、notepad_write_manual。
+
+**MCP Tool** - 模型上下文协议工具。ask_codex（GPT-5.3）、ask_gemini（Gemini-3-pro）。
+
+---
+
+## 核心概念
+
+**Delegation** - 委派。将工作路由到专业 agent 而非直接处理。多文件实现、复杂重构、架构决策必须委派。
+
+**Model Routing** - 模型路由。任务复杂度 → 模型层级映射：Haiku（快速）→ Sonnet（标准）→ Opus（复杂）。
+
+**Verification** - 验证。完成前收集证据（BUILD/TEST/LINT/TODO/ERROR_FREE），verifier 确认。
+
+**Boulder State** - 岩石状态。Ralph/ultrawork 的持久化状态，"岩石永不停止"直到完成。
+
+**Magic Keyword** - 魔法关键词。用户输入中的触发词，激活对应 skill 或 mode。
+
+**Context Injection** - 上下文注入。在 hook 时注入 AGENTS.md、规则文件、Axiom 记忆。
+
+**Path Traversal Guard** - 路径遍历防护。assertValidMode() 校验 mode 参数，防止 `../../etc/passwd` 攻击。
+
+**Axiom System** - Axiom 系统。需求→PRD→实现→验证→知识演化的完整工作流引擎。
+
+---
+
+## 执行流程
+
+**Team Pipeline** - Team 分阶段流水线：team-plan → team-prd → team-exec → team-verify → team-fix（循环）。
+
+**Expert Gate** - 专家评审门禁。所有新功能需求必须通过 `/ax-draft` → `/ax-review` 流程。
+
+**User Gate** - 用户确认门禁。PRD 生成完成后，显示确认提示，用户确认才能进入开发。
+
+**CI Gate** - 编译提交门禁。代码修改完成后，必须执行 `tsc --noEmit && npm run build && npm test`，无错误才允许完成。
+
+**Scope Gate** - 范围门禁。修改文件时检查是否在 manifest 定义的 Impact Scope 内，越界修改需用户确认。
+
+---
+
+## 反模式
+
+**AP-S01** - 未校验 mode 参数直接拼接路径。路径遍历风险。正确做法：先调用 assertValidMode()。
+
+**AP-ST01** - 混淆两种 stale 阈值。Agent stale（5分钟）vs Mode stale（1小时）。
+
+**AP-ST02** - 跨会话误清理状态文件。必须检查 session_id 匹配后才能清理。
+
+**AP-ST03** - 在 `~/.claude/` 中存储 OMC 状态。应存储在 worktree 根目录 `.omc/state/`。
+
+**AP-AL02** - 混淆超时阈值。5 分钟（警告）vs 10 分钟（自动终止）。
+
+**AP-MR01** - 同时激活互斥模式。autopilot、ultrapilot、swarm、pipeline 互斥。
+
+**AP-MR02** - 使用不在白名单中的 mode。只能使用 VALID_MODES 中的 8 个值。
+
+---
+
+## 文件路径
+
+**Worktree Root** - Git worktree 根目录。所有 OMC 状态存储于此，不在 `~/.claude/`。
+
+**.omc/state/** - 模式状态目录。存储 `{mode}-state.json` 和 `sessions/{sessionId}/` 子目录。
+
+**.omc/axiom/** - Axiom 系统目录。active_context.md、project_decisions.md、evolution/ 等。
+
+**.omc/notepad.md** - 会话记忆文件。7 天自动清理的 working 部分 + 永久 manual 部分。
+
+**.omc/project-memory.json** - 项目记忆。持久化的项目知识、架构决策、用户偏好。
+

package/docs/guides/mcp-server-usage.md

@@ -70,8 +70,8 @@ Edit `~/.claude/claude_desktop_config.json`:
 After configuration, restart Claude Desktop. The MCP server tools should appear in the tool list:
 
 ```
-mcp__plugin_ultrapower_t__ultrapower:lsp_hover
-mcp__plugin_ultrapower_t__ultrapower:lsp_goto_definition
+mcp__plugin_ultrapower_t__lsp_hover
+mcp__plugin_ultrapower_t__lsp_goto_definition
 mcp__plugin_ultrapower_t__ultrapower:ast_grep_search
 ... (64 tools total - each tool has both new and legacy names)
 ```
@@ -121,12 +121,12 @@ Restart Cursor. Check the MCP panel to confirm the server is connected and all 3
 
 Get type information at cursor position:
 ```
-Use mcp__plugin_ultrapower_t__ultrapower:lsp_hover with file and position
+Use mcp__plugin_ultrapower_t__lsp_hover with file and position
 ```
 
 Find all references to a symbol:
 ```
-Use mcp__plugin_ultrapower_t__ultrapower:lsp_find_references to locate usage
+Use mcp__plugin_ultrapower_t__lsp_find_references to locate usage
 ```
 
 ### AST Tools

package/docs/guides/tool-name-migration.md

@@ -17,29 +17,29 @@ Starting from v5.6.0, all ultrapower tools use the `ultrapower:` prefix instead
 
 ### LSP Tools
 
-* `lsp_hover` → `ultrapower:lsp_hover`
+* `ultrapower:lsp_hover` → `ultrapower:lsp_hover`
 
-* `lsp_goto_definition` → `ultrapower:lsp_goto_definition`
+* `ultrapower:lsp_goto_definition` → `ultrapower:lsp_goto_definition`
 
-* `lsp_find_references` → `ultrapower:lsp_find_references`
+* `ultrapower:lsp_find_references` → `ultrapower:lsp_find_references`
 
-* `lsp_document_symbols` → `ultrapower:lsp_document_symbols`
+* `ultrapower:lsp_document_symbols` → `ultrapower:lsp_document_symbols`
 
-* `lsp_workspace_symbols` → `ultrapower:lsp_workspace_symbols`
+* `ultrapower:lsp_workspace_symbols` → `ultrapower:lsp_workspace_symbols`
 
-* `lsp_diagnostics` → `ultrapower:lsp_diagnostics`
+* `ultrapower:lsp_diagnostics` → `ultrapower:lsp_diagnostics`
 
-* `lsp_diagnostics_directory` → `ultrapower:lsp_diagnostics_directory`
+* `ultrapower:lsp_diagnostics_directory` → `ultrapower:lsp_diagnostics_directory`
 
-* `lsp_servers` → `ultrapower:lsp_servers`
+* `ultrapower:lsp_servers` → `ultrapower:lsp_servers`
 
-* `lsp_prepare_rename` → `ultrapower:lsp_prepare_rename`
+* `ultrapower:lsp_prepare_rename` → `ultrapower:lsp_prepare_rename`
 
-* `lsp_rename` → `ultrapower:lsp_rename`
+* `ultrapower:lsp_rename` → `ultrapower:lsp_rename`
 
-* `lsp_code_actions` → `ultrapower:lsp_code_actions`
+* `ultrapower:lsp_code_actions` → `ultrapower:lsp_code_actions`
 
-* `lsp_code_action_resolve` → `ultrapower:lsp_code_action_resolve`
+* `ultrapower:lsp_code_action_resolve` → `ultrapower:lsp_code_action_resolve`
 
 ### State Tools
 

package/docs/mcp/configuration.md

@@ -91,7 +91,7 @@ Location: `.claude/mcp.json` (workspace)
       "args": ["bridge/mcp-server.cjs"],
       "disabled": false,
       "autoApprove": [
-        "lsp_hover",
+        "ultrapower:lsp_hover",
         "state_read",
         "notepad_read"
       ]
@@ -137,8 +137,8 @@ Edit `src/mcp/timeout.ts`:
 
 ```typescript
 export const TOOL_TIMEOUTS: Record<string, number> = {
-  lsp_hover: 30000,
-  lsp_diagnostics: 60000,
+  ultrapower:lsp_hover: 30000,
+  ultrapower:lsp_diagnostics: 60000,
   ast_grep_search: 60000,
   ask_codex: 300000,
   ask_gemini: 300000
@@ -160,8 +160,8 @@ Skip permission prompts for trusted tools:
   "mcpServers": {
     "ultrapower": {
       "autoApprove": [
-        "lsp_hover",
-        "lsp_goto_definition",
+        "ultrapower:lsp_hover",
+        "ultrapower:lsp_goto_definition",
         "state_read",
         "notepad_read",
         "project_memory_read"

package/docs/mcp/performance.md

@@ -6,9 +6,9 @@
 
 | Tool | Cold Start | Warm | Notes |
 | ------ | ----------- | ------ | ------- |
-| `lsp_hover` | 150ms | 20ms | LSP server cached |
-| `lsp_diagnostics` | 300ms | 50ms | File-level |
-| `lsp_diagnostics_directory` | 2s | 500ms | Directory scan |
+| `ultrapower:lsp_hover` | 150ms | 20ms | LSP server cached |
+| `ultrapower:lsp_diagnostics` | 300ms | 50ms | File-level |
+| `ultrapower:lsp_diagnostics_directory` | 2s | 500ms | Directory scan |
 | `ast_grep_search` | 100ms | 30ms | Pattern complexity varies |
 | `state_read` | 10ms | 5ms | JSON parse |
 | `notepad_read` | 15ms | 8ms | Markdown parse |
@@ -137,8 +137,8 @@ await mcp__plugin_ultrapower_t__lsp_diagnostics_directory({
 
 Output includes timing:
 ```
-[debug] lsp_hover started
-[debug] lsp_hover completed in 23ms
+[debug] ultrapower:lsp_hover started
+[debug] ultrapower:lsp_hover completed in 23ms
 ```
 
 ### Measure Tool Calls

package/docs/mcp-compatibility-matrix.md

@@ -47,7 +47,7 @@ All community MCP server tools use the format: `mcp__servername__toolname`
 
 Internal OMC tools do not use namespace prefixes:
 
-* `lsp_*` - Language Server Protocol tools
+* `ultrapower:lsp_*` - Language Server Protocol tools
 
 * `ast_grep_*` - AST manipulation tools
 

package/docs/partials/agent-tiers.md

@@ -116,18 +116,18 @@ Task(subagent_type="ultrapower:explore",
 
 | 工具 | 类别 | 用途 | 是否分配给 Agent？ |
 | ------ | ---------- | --------- | --------------------- |
-| `lsp_hover` | LSP | 获取代码位置的类型信息和文档 | 否（orchestrator 直接使用） |
-| `lsp_goto_definition` | LSP | 跳转到符号定义处 | 否（orchestrator 直接使用） |
-| `lsp_find_references` | LSP | 查找符号在代码库中的所有用法 | 是（仅 `explore`） |
-| `lsp_document_symbols` | LSP | 获取文件中所有符号的概览 | 是 |
-| `lsp_workspace_symbols` | LSP | 按名称在工作区中搜索符号 | 是 |
-| `lsp_diagnostics` | LSP | 获取文件的错误、警告和提示 | 是 |
-| `lsp_diagnostics_directory` | LSP | 项目级类型检查（tsc --noEmit 或 LSP） | 是 |
-| `lsp_prepare_rename` | LSP | 检查符号是否可以重命名 | 否（orchestrator 直接使用） |
-| `lsp_rename` | LSP | 在整个项目中重命名符号 | 否（orchestrator 直接使用） |
-| `lsp_code_actions` | LSP | 获取可用的重构和快速修复 | 否（orchestrator 直接使用） |
-| `lsp_code_action_resolve` | LSP | 获取代码操作的完整编辑详情 | 否（orchestrator 直接使用） |
-| `lsp_servers` | LSP | 列出可用的语言服务器及安装状态 | 否（orchestrator 直接使用） |
+| `ultrapower:lsp_hover` | LSP | 获取代码位置的类型信息和文档 | 否（orchestrator 直接使用） |
+| `ultrapower:lsp_goto_definition` | LSP | 跳转到符号定义处 | 否（orchestrator 直接使用） |
+| `ultrapower:lsp_find_references` | LSP | 查找符号在代码库中的所有用法 | 是（仅 `explore`） |
+| `ultrapower:lsp_document_symbols` | LSP | 获取文件中所有符号的概览 | 是 |
+| `ultrapower:lsp_workspace_symbols` | LSP | 按名称在工作区中搜索符号 | 是 |
+| `ultrapower:lsp_diagnostics` | LSP | 获取文件的错误、警告和提示 | 是 |
+| `ultrapower:lsp_diagnostics_directory` | LSP | 项目级类型检查（tsc --noEmit 或 LSP） | 是 |
+| `ultrapower:lsp_prepare_rename` | LSP | 检查符号是否可以重命名 | 否（orchestrator 直接使用） |
+| `ultrapower:lsp_rename` | LSP | 在整个项目中重命名符号 | 否（orchestrator 直接使用） |
+| `ultrapower:lsp_code_actions` | LSP | 获取可用的重构和快速修复 | 否（orchestrator 直接使用） |
+| `ultrapower:lsp_code_action_resolve` | LSP | 获取代码操作的完整编辑详情 | 否（orchestrator 直接使用） |
+| `ultrapower:lsp_servers` | LSP | 列出可用的语言服务器及安装状态 | 否（orchestrator 直接使用） |
 | `ast_grep_search` | AST | 基于 AST 的模式化结构代码搜索 | 是 |
 | `ast_grep_replace` | AST | 基于模式的结构化代码转换 | 是 |
 | `python_repl` | Data | 用于数据分析和计算的持久化 Python REPL | 是 |
@@ -154,30 +154,30 @@ Task(subagent_type="ultrapower:explore",
 
 | 工具 | 直接使用时机 |
 | ------ | --------------------- |
-| `lsp_hover` | 对话中快速查询类型 |
-| `lsp_goto_definition` | 分析过程中导航到符号定义 |
-| `lsp_prepare_rename` | 在决定方案前检查重命名可行性 |
-| `lsp_rename` | 安全重命名操作（返回编辑预览，不自动应用） |
-| `lsp_code_actions` | 发现可用的重构操作 |
-| `lsp_code_action_resolve` | 获取特定代码操作的详情 |
-| `lsp_servers` | 检查语言服务器可用性 |
+| `ultrapower:lsp_hover` | 对话中快速查询类型 |
+| `ultrapower:lsp_goto_definition` | 分析过程中导航到符号定义 |
+| `ultrapower:lsp_prepare_rename` | 在决定方案前检查重命名可行性 |
+| `ultrapower:lsp_rename` | 安全重命名操作（返回编辑预览，不自动应用） |
+| `ultrapower:lsp_code_actions` | 发现可用的重构操作 |
+| `ultrapower:lsp_code_action_resolve` | 获取特定代码操作的详情 |
+| `ultrapower:lsp_servers` | 检查语言服务器可用性 |
 
 对于需要实现的复杂重命名或重构任务，委派给 `executor`（使用 `model="opus"`），它可以使用 `ast_grep_replace` 进行结构化转换。
 
 ### 工具选择指南
 
-* **需要文件符号概览或工作区搜索？** 通过 `explore` 使用 `lsp_document_symbols`/`lsp_workspace_symbols`
+* **需要文件符号概览或工作区搜索？** 通过 `explore` 使用 `ultrapower:lsp_document_symbols`/`ultrapower:lsp_workspace_symbols`
 
-* **需要查找符号的所有用法？** 通过 `explore` 使用 `lsp_find_references`
+* **需要查找符号的所有用法？** 通过 `explore` 使用 `ultrapower:lsp_find_references`
 
 * **需要结构化代码模式？**（如"查找所有匹配 X 形状的函数"）通过 `explore`、`architect` 或 `code-reviewer` 使用 `ast_grep_search`
 
 * **需要结构化代码转换？** 通过 `executor`（使用 `model="opus"`）使用 `ast_grep_replace`
 
-* **需要全项目类型检查？** 通过 `architect`、`executor` 或 `build-fixer` 使用 `lsp_diagnostics_directory`
+* **需要全项目类型检查？** 通过 `architect`、`executor` 或 `build-fixer` 使用 `ultrapower:lsp_diagnostics_directory`
 
-* **需要单文件错误检查？** 通过多个 agent 使用 `lsp_diagnostics`（参见矩阵）
+* **需要单文件错误检查？** 通过多个 agent 使用 `ultrapower:lsp_diagnostics`（参见矩阵）
 
 * **需要数据分析/计算？** 通过 `scientist` 使用 `python_repl`
 
-* **需要快速类型信息或定义查询？** 直接使用 `lsp_hover`/`lsp_goto_definition`（orchestrator 直接工具）
+* **需要快速类型信息或定义查询？** 直接使用 `ultrapower:lsp_hover`/`ultrapower:lsp_goto_definition`（orchestrator 直接工具）

package/docs/partials/features.md

@@ -59,7 +59,7 @@
 
 ## 目录诊断工具
 
-通过 `lsp_diagnostics_directory` 工具进行项目级类型检查。
+通过 `ultrapower:lsp_diagnostics_directory` 工具进行项目级类型检查。
 
 **策略：**
 

package/docs/partials/verification-tiers.md

@@ -6,7 +6,7 @@
 
 | 层级 | 标准 | Agent | 模型 | 所需证据 |
 | ------ | ---------- | ------- | ------- | ------------------- |
-| **LIGHT** | <5 个文件，<100 行，完整测试覆盖 | architect-low | haiku | lsp_diagnostics 无错误 |
+| **LIGHT** | <5 个文件，<100 行，完整测试覆盖 | architect-low | haiku | ultrapower:lsp_diagnostics 无错误 |
 | **STANDARD** | 默认（非 LIGHT 或 THOROUGH） | architect-medium | sonnet | diagnostics + 构建通过 |
 | **THOROUGH** | >20 个文件，或架构/安全变更 | architect | opus | 完整审查 + 所有测试 |
 
@@ -94,7 +94,7 @@ ELSE:
 | 声明 | 所需证据 |
 | ------- | ------------------- |
 | "已修复" | 显示现在通过的测试 |
-| "已实现" | lsp_diagnostics 无错误 + 构建通过 |
+| "已实现" | ultrapower:lsp_diagnostics 无错误 + 构建通过 |
 | "已重构" | 所有测试仍然通过 |
 | "已调试" | 定位到 file:line 的根本原因 |
 

package/docs/plans/2026-02-24-superpowers-ultrapower-integration-design.md

@@ -113,7 +113,7 @@ brainstorming 触发时的强制流程：
   verification-before-completion → [验证通过]
 
 阶段5b: 构建验证（新增）
-  build-fixer → lsp_diagnostics_directory → [零错误]
+  build-fixer → ultrapower:lsp_diagnostics_directory → [零错误]
 
 阶段6: 部署测试
   qa-tester → ultraqa循环 → [全部通过]
@@ -282,7 +282,7 @@ brainstorming 触发时的强制流程：
 
 | Agent | 关键节点 | 主推 | 备选 | 推荐理由 |
 | --- | --- | --- | --- | --- |
-| `build-fixer` agent | lsp_diagnostics 零错误后 | `qa-tester` agent | `requesting-code-review` | 构建通过进入部署测试 |
+| `build-fixer` agent | ultrapower:lsp_diagnostics 零错误后 | `qa-tester` agent | `requesting-code-review` | 构建通过进入部署测试 |
 
 ### 阶段6：部署测试
 

package/docs/plans/2026-03-02-docs-comprehensive-update.md

@@ -311,18 +311,18 @@ Total: **35 tools** exposed via `mcp__plugin_ultrapower_t__` prefix.
 ### LSP Tools (12)
 
 ```
-lsp_hover                  — Type info and docs at position
-lsp_goto_definition        — Jump to definition
-lsp_find_references        — Find all usages
-lsp_document_symbols       — File outline
-lsp_workspace_symbols      — Cross-workspace symbol search
-lsp_diagnostics            — Per-file errors/warnings
-lsp_diagnostics_directory  — Project-level type check
-lsp_servers                — List available language servers
-lsp_prepare_rename         — Check if rename is valid
-lsp_rename                 — Preview multi-file rename
-lsp_code_actions           — Available refactors/fixes
-lsp_code_action_resolve    — Get action details
+ultrapower:lsp_hover                  — Type info and docs at position
+ultrapower:lsp_goto_definition        — Jump to definition
+ultrapower:lsp_find_references        — Find all usages
+ultrapower:lsp_document_symbols       — File outline
+ultrapower:lsp_workspace_symbols      — Cross-workspace symbol search
+ultrapower:lsp_diagnostics            — Per-file errors/warnings
+ultrapower:lsp_diagnostics_directory  — Project-level type check
+ultrapower:lsp_servers                — List available language servers
+ultrapower:lsp_prepare_rename         — Check if rename is valid
+ultrapower:lsp_rename                 — Preview multi-file rename
+ultrapower:lsp_code_actions           — Available refactors/fixes
+ultrapower:lsp_code_action_resolve    — Get action details
 ```
 
 Supported languages: TypeScript, Python, Rust, Go, C/C++, Java, JSON, HTML, CSS, YAML
@@ -860,17 +860,17 @@ Directives are the highest-priority memory: they survive context compression and
 
 ### LSP Tools (12)
 
-Require a running language server. Use `lsp_servers()` to check availability.
+Require a running language server. Use `ultrapower:lsp_servers()` to check availability.
 
 ```typescript
 // Type info at cursor position
-lsp_hover({ file: "src/hooks/bridge.ts", line: 42, character: 15 })
+ultrapower:lsp_hover({ file: "src/hooks/bridge.ts", line: 42, character: 15 })
 
 // Find all usages
-lsp_find_references({ file: "src/lib/validateMode.ts", symbol: "assertValidMode" })
+ultrapower:lsp_find_references({ file: "src/lib/validateMode.ts", symbol: "assertValidMode" })
 
 // Project-wide diagnostics
-lsp_diagnostics_directory({ directory: "src/", includeWarnings: false })
+ultrapower:lsp_diagnostics_directory({ directory: "src/", includeWarnings: false })
 ```
 
 ### AST Tools (2)

package/docs/plans/2026-03-05-mcp-adoption-atomic-tasks.md

@@ -162,11 +162,11 @@ npm install --save-dev @types/node
 
 **步骤：**
 1. 创建 `src/mcp/adapters/lsp-adapter.ts`
-2. 转换 lsp_hover, lsp_goto_definition, lsp_find_references
-3. 转换 lsp_document_symbols, lsp_workspace_symbols
-4. 转换 lsp_diagnostics, lsp_diagnostics_directory
-5. 转换 lsp_servers, lsp_prepare_rename, lsp_rename
-6. 转换 lsp_code_actions, lsp_code_action_resolve
+2. 转换 ultrapower:lsp_hover, ultrapower:lsp_goto_definition, ultrapower:lsp_find_references
+3. 转换 ultrapower:lsp_document_symbols, ultrapower:lsp_workspace_symbols
+4. 转换 ultrapower:lsp_diagnostics, ultrapower:lsp_diagnostics_directory
+5. 转换 ultrapower:lsp_servers, ultrapower:lsp_prepare_rename, ultrapower:lsp_rename
+6. 转换 ultrapower:lsp_code_actions, ultrapower:lsp_code_action_resolve
 
 **验收：**
 
@@ -380,7 +380,7 @@ npm install --save-dev @types/node
 1. 创建 `src/mcp/tool-resolver.ts`
 2. 实现 `resolveTool(name: string)` 函数
 3. 支持带前缀：`mcp__plugin_ultrapower_t__lsp_hover`
-4. 支持不带前缀：`lsp_hover`
+4. 支持不带前缀：`ultrapower:lsp_hover`
 5. 支持命名空间：`ultrapower:lsp_hover`
 
 **验收：**
@@ -530,8 +530,8 @@ npm install --save-dev @types/node
 **依赖：** 1.4.1
 
 **步骤：**
-1. 测试 `lsp_hover` 调用
-2. 测试 `lsp_diagnostics` 调用
+1. 测试 `ultrapower:lsp_hover` 调用
+2. 测试 `ultrapower:lsp_diagnostics` 调用
 3. 验证参数传递正确
 4. 验证返回结果格式
 
@@ -581,7 +581,7 @@ npm install --save-dev @types/node
 **步骤：**
 1. 使用旧前缀调用工具：`mcp__plugin_ultrapower_t__lsp_hover`
 2. 使用新前缀调用工具：`ultrapower:lsp_hover`
-3. 使用无前缀调用工具：`lsp_hover`
+3. 使用无前缀调用工具：`ultrapower:lsp_hover`
 4. 验证三种方式都能成功
 
 **验收：**