@liangjie559567/ultrapower 5.6.6 → 5.6.8

package/docs/dev-standards/sufficiency-checklist.md

@@ -3,38 +3,59 @@
 ## 编码前必须全部回答"是"
 
 ### 1. 相似实现
+
 **问题**：我能说出至少3个相似实现的文件路径吗？
-- ✅ 是：[file1:line, file2:line, file3:line]
-- ❌ 否 → 返回步骤1重新搜索
+
+* ✅ 是：[file1:line, file2:line, file3:line]
+
+* ❌ 否 → 返回步骤1重新搜索
 
 ### 2. 实现模式
+
 **问题**：我理解项目中这类功能的实现模式吗？
-- ✅ 是：模式是 [具体描述]，因为 [理由]
-- ❌ 不确定 → 返回步骤3深度阅读
+
+* ✅ 是：模式是 [具体描述]，因为 [理由]
+
+* ❌ 不确定 → 返回步骤3深度阅读
 
 ### 3. 可复用组件
+
 **问题**：我知道项目中有哪些可复用的工具函数/类吗？
-- ✅ 是：[列出具体函数/类名和路径]
-- ❌ 不知道 → 强制搜索 utils/helpers/core 模块
+
+* ✅ 是：[列出具体函数/类名和路径]
+
+* ❌ 不知道 → 强制搜索 utils/helpers/core 模块
 
 ### 4. 命名和风格
+
 **问题**：我理解项目的命名约定和代码风格吗？
-- ✅ 是：命名约定是 [具体说明]，代码风格是 [具体说明]
-- ❌ 不清楚 → 阅读更多代码或项目规范文档
+
+* ✅ 是：命名约定是 [具体说明]，代码风格是 [具体说明]
+
+* ❌ 不清楚 → 阅读更多代码或项目规范文档
 
 ### 5. 测试策略
+
 **问题**：我知道如何测试这个功能吗？
-- ✅ 是：参考 [测试文件] 的模式，我会 [具体测试策略]
-- ❌ 不知道 → 搜索并阅读相关测试代码
+
+* ✅ 是：参考 [测试文件] 的模式，我会 [具体测试策略]
+
+* ❌ 不知道 → 搜索并阅读相关测试代码
 
 ### 6. 避免重复
+
 **问题**：我确认没有重复造轮子吗？
-- ✅ 是：检查了 [具体模块/文件]，确认不存在相同功能
-- ❌ 不确定 → 扩大搜索范围
+
+* ✅ 是：检查了 [具体模块/文件]，确认不存在相同功能
+
+* ❌ 不确定 → 扩大搜索范围
 
 ### 7. 依赖和集成
+
 **问题**：我理解这个功能的依赖和集成点吗？
-- ✅ 是：依赖 [具体依赖]，集成点是 [具体位置]
-- ❌ 不清楚 → 分析 import 语句和调用链
+
+* ✅ 是：依赖 [具体依赖]，集成点是 [具体位置]
+
+* ❌ 不清楚 → 分析 import 语句和调用链
 
 ## 无法全部回答"是" → 禁止编码

package/docs/dev-standards/tools-integration.md

@@ -3,23 +3,33 @@
 ## 本地文件操作（最高优先级）
 
 ### desktop-commander
+
 **核心能力**：
-- 文件操作：read_file、write_file、edit_block
-- 目录管理：list_directory、create_directory
-- 搜索：start_search（流式返回）
-- 进程管理：start_process、interact_with_process
-- 数据分析：Python/Node.js REPL
+
+* 文件操作：read_file、write_file、edit_block
+
+* 目录管理：list_directory、create_directory
+
+* 搜索：start_search（流式返回）
+
+* 进程管理：start_process、interact_with_process
+
+* 数据分析：Python/Node.js REPL
 
 **使用场景**：
-- 所有本地文件操作
-- CSV/JSON/数据分析
-- 交互式 REPL 工作流
+
+* 所有本地文件操作
+
+* CSV/JSON/数据分析
+
+* 交互式 REPL 工作流
 
 **绝对优先于 bash 命令**
 
 ## 编程文档检索
 
 ### context7（最高优先级）
+
 **用途**：编程库/SDK/API 文档
 **调用方式**：
 1. resolve-library-id 获取库 ID
@@ -28,20 +38,29 @@
 **优势**：官方文档、token 高效、最新版本
 
 ### firecrawl（通用后备）
+
 **用途**：最新博客/文章/教程
 **调用方式**：
-- firecrawl_search：搜索并抓取
-- firecrawl_scrape：单页抓取
-- firecrawl_map：网站结构发现
+
+* firecrawl_search：搜索并抓取
+
+* firecrawl_scrape：单页抓取
+
+* firecrawl_map：网站结构发现
 
 ## GitHub 集成
 
 ### github
+
 **核心能力**：
-- 代码搜索：search_code、search_repositories
-- PR 管理：create_pull_request、merge_pull_request
-- Issue 管理：create_issue、update_issue
-- 代码审查：create_and_submit_pull_request_review
+
+* 代码搜索：search_code、search_repositories
+
+* PR 管理：create_pull_request、merge_pull_request
+
+* Issue 管理：create_issue、update_issue
+
+* 代码审查：create_and_submit_pull_request_review
 
 ## 工具选择决策树
 

package/docs/dev-standards/workflow.md

@@ -1,16 +1,21 @@
 # 工作流程规范
 
 ## 总原则
-- **强制深度思考**：使用 sequential-thinking 梳理问题
-- 问题驱动优先于流程驱动
-- 动态调整而非僵化执行
+
+* **强制深度思考**：使用 sequential-thinking 梳理问题
+
+* 问题驱动优先于流程驱动
+
+* 动态调整而非僵化执行
 
 ## 工具链顺序
+
 1. sequential-thinking（分析问题）
 2. shrimp-task-manager（任务规划）
 3. 直接执行（编码实现）
 
 ## 标准 6 步骤
+
 1. 分析需求
 2. 获取上下文
 3. 选择工具
@@ -19,6 +24,7 @@
 6. 存储知识
 
 ## 研究-计划-实施 5 阶段
+
 1. **研究**：阅读材料、厘清约束，禁止编码
 2. **计划**：制定详细计划与成功标准
 3. **实施**：根据计划执行并保持小步提交

package/docs/getting-started/concepts.md

@@ -9,9 +9,12 @@
 **定义**: 专业的 AI 助手，每个 agent 专注于特定领域。
 
 **示例**:
-- `executor` - 代码实现
-- `debugger` - 问题诊断
-- `architect` - 系统设计
+
+* `executor` - 代码实现
+
+* `debugger` - 问题诊断
+
+* `architect` - 系统设计
 
 **使用方式**:
 ```
@@ -27,9 +30,12 @@
 **定义**: 预定义的工作流，自动化复杂任务。
 
 **示例**:
-- `/ultrapower:autopilot` - 全自主执行
-- `/ultrapower:team` - 多 agent 协作
-- `/ultrapower:ralph` - 持续执行
+
+* `/ultrapower:autopilot` - 全自主执行
+
+* `/ultrapower:team` - 多 agent 协作
+
+* `/ultrapower:ralph` - 持续执行
 
 **使用方式**:
 ```
@@ -45,8 +51,10 @@
 **定义**: 事件驱动的自动化触发器。
 
 **示例**:
-- `UserPromptSubmit` - 用户输入时触发
-- `ToolUse` - 工具调用时触发
+
+* `UserPromptSubmit` - 用户输入时触发
+
+* `ToolUse` - 工具调用时触发
 
 **工作原理**:
 ```
@@ -62,10 +70,14 @@
 **定义**: 35 个自定义工具，扩展 Claude 能力。
 
 **分类**:
-- **LSP 工具** (12个): 代码智能分析
-- **AST 工具** (2个): 结构化代码搜索
-- **State 工具** (5个): 状态管理
-- **Notepad 工具** (6个): 会话记忆
+
+* **LSP 工具** (12个): 代码智能分析
+
+* **AST 工具** (2个): 结构化代码搜索
+
+* **State 工具** (5个): 状态管理
+
+* **Notepad 工具** (6个): 会话记忆
 
 [查看完整 Tools 列表 →](../features/tools.md)
 
@@ -99,5 +111,6 @@ graph LR
 
 ## 下一步
 
-- [查看实际使用场景](../guides/scenario-feature-dev.md)
-- [探索高级功能](../architecture/state-machine.md)
+* [查看实际使用场景](../guides/scenario-feature-dev.md)
+
+* [探索高级功能](../architecture/state-machine.md)

package/docs/getting-started/installation.md

@@ -7,9 +7,11 @@
 
 ## 前置要求
 
-- Node.js >= 18
-- npm >= 9
-- Claude Code CLI
+* Node.js >= 18
+
+* npm >= 9
+
+* Claude Code CLI
 
 ---
 
@@ -34,9 +36,12 @@ omc install
 ```
 
 这将：
-- 创建 `.omc/` 目录
-- 生成 `CLAUDE.md` 配置文件
-- 安装必要的 hooks
+
+* 创建 `.omc/` 目录
+
+* 生成 `CLAUDE.md` 配置文件
+
+* 安装必要的 hooks
 
 ✅ **检查点**: 项目根目录应包含 `CLAUDE.md` 文件
 
@@ -45,7 +50,9 @@ omc install
 ### 3. 验证安装
 
 ```bash
+
 # 检查 ultrapower 状态
+
 omc doctor
 ```
 
@@ -61,14 +68,19 @@ omc doctor
 
 **解决**:
 ```bash
+
 # 查看 npm 全局路径
+
 npm config get prefix
 
 # 添加到 PATH（macOS/Linux）
+
 export PATH="$PATH:$(npm config get prefix)/bin"
 
 # 添加到 PATH（Windows）
+
 # 将 %APPDATA%\npm 添加到系统环境变量
+
 ```
 
 ---
@@ -79,10 +91,13 @@ export PATH="$PATH:$(npm config get prefix)/bin"
 
 **解决**:
 ```bash
+
 # 使用 sudo（不推荐）
+
 sudo npm install -g @liangjie559567/ultrapower
 
 # 或配置 npm 使用用户目录（推荐）
+
 npm config set prefix ~/.npm-global
 export PATH=~/.npm-global/bin:$PATH
 ```
@@ -92,8 +107,10 @@ export PATH=~/.npm-global/bin:$PATH
 ## 下一步
 
 ✅ 安装完成！继续：
-- [快速开始](./quickstart.md) - 15 分钟跑通第一个示例
-- [核心概念](./concepts.md) - 理解 ultrapower 工作原理
+
+* [快速开始](./quickstart.md) - 15 分钟跑通第一个示例
+
+* [核心概念](./concepts.md) - 理解 ultrapower 工作原理
 
 ---
 

package/docs/getting-started/quickstart.md

@@ -38,9 +38,12 @@ claude chat
 ```
 
 **预期输出**:
-- Agent 自动分析需求
-- 生成代码文件
-- 运行测试验证
+
+* Agent 自动分析需求
+
+* 生成代码文件
+
+* 运行测试验证
 
 ✅ **检查点 3**: 生成了 `server.js` 或类似文件
 
@@ -50,7 +53,9 @@ claude chat
 
 ```bash
 node server.js
-# 访问 http://localhost:3000
+
+# 访问 <http://localhost:3000>
+
 ```
 
 ✅ **检查点 4**: 服务器正常运行
@@ -66,12 +71,16 @@ node server.js
 ## 下一步学习
 
 ### 理解核心概念
-- [什么是 Agents？](./concepts.md#agents)
-- [什么是 Skills？](./concepts.md#skills)
+
+* [什么是 Agents？](./concepts.md#agents)
+
+* [什么是 Skills？](./concepts.md#skills)
 
 ### 尝试更多功能
-- [Team 协作](../guides/workflow-team-pipeline.md) - 多 agent 并行工作
-- [Ralph 循环](../guides/workflow-ralph-loop.md) - 持续执行直到完成
+
+* [Team 协作](../guides/workflow-team-pipeline.md) - 多 agent 并行工作
+
+* [Ralph 循环](../guides/workflow-ralph-loop.md) - 持续执行直到完成
 
 ---
 

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

@@ -11,21 +11,31 @@ The MCP server is built into ultrapower. To use it, configure your editor to con
 ### Starting the Server
 
 ```bash
+
 # Start the MCP server on stdio
+
 node bridge/mcp-server.cjs
 
 # Or with npm
+
 npm run mcp:start
 ```
 
 The server listens on stdio and exposes 32 custom tools:
-- 12 LSP tools (code navigation, diagnostics)
-- 2 AST tools (pattern matching)
-- 1 Python REPL tool
-- 6 Notepad tools (session memory)
-- 5 State tools (mode state management)
-- 4 Project Memory tools (persistent memory)
-- 2 Trace tools (agent flow analysis)
+
+* 12 LSP tools (code navigation, diagnostics)
+
+* 2 AST tools (pattern matching)
+
+* 1 Python REPL tool
+
+* 6 Notepad tools (session memory)
+
+* 5 State tools (mode state management)
+
+* 4 Project Memory tools (persistent memory)
+
+* 2 Trace tools (agent flow analysis)
 
 ---
 
@@ -182,7 +192,7 @@ node --version
 Set these to customize behavior:
 
 | Variable | Values | Default |
-|----------|--------|---------|
+| ---------- | -------- | --------- |
 | `OMC_LOG_LEVEL` | `debug`, `info`, `warn`, `error` | `info` |
 | `OMC_MCP_OUTPUT_PATH_POLICY` | `strict`, `redirect_output` | `strict` |
 | `OMC_MCP_OUTPUT_REDIRECT_DIR` | path | `.omc/outputs` |
@@ -235,6 +245,9 @@ Redirect MCP tool outputs to a specific directory:
 ## Support
 
 For issues or questions:
-- Check [REFERENCE.md](../REFERENCE.md) for complete tool documentation
-- Review [Troubleshooting Guide](./troubleshooting-guide.md)
-- Check server logs with `OMC_LOG_LEVEL=debug`
+
+* Check [REFERENCE.md](../REFERENCE.md) for complete tool documentation
+
+* Review [Troubleshooting Guide](./troubleshooting-guide.md)
+
+* Check server logs with `OMC_LOG_LEVEL=debug`

package/docs/guides/task-templates-guide.md

@@ -13,11 +13,16 @@
 ```
 
 包含：
-- 需求分析
-- 设计审查
-- 实现
-- 测试
-- 文档更新
+
+* 需求分析
+
+* 设计审查
+
+* 实现
+
+* 测试
+
+* 文档更新
 
 ### Bug 修复模板
 
@@ -26,11 +31,16 @@
 ```
 
 包含：
-- 问题复现
-- 根因分析
-- 修复实现
-- 回归测试
-- 验证通过
+
+* 问题复现
+
+* 根因分析
+
+* 修复实现
+
+* 回归测试
+
+* 验证通过
 
 ### 代码重构模板
 
@@ -39,11 +49,16 @@
 ```
 
 包含：
-- 现状分析
-- 重构设计
-- 实现变更
-- 测试验证
-- 性能对比
+
+* 现状分析
+
+* 重构设计
+
+* 实现变更
+
+* 测试验证
+
+* 性能对比
 
 ### 性能优化模板
 
@@ -52,11 +67,16 @@
 ```
 
 包含：
-- 性能基线测试
-- 瓶颈识别
-- 优化实现
-- 性能验证
-- 文档更新
+
+* 性能基线测试
+
+* 瓶颈识别
+
+* 优化实现
+
+* 性能验证
+
+* 文档更新
 
 ### 文档编写模板
 
@@ -65,11 +85,16 @@
 ```
 
 包含：
-- 内容大纲
-- 示例代码
-- 最佳实践
-- 常见问题
-- 审查发布
+
+* 内容大纲
+
+* 示例代码
+
+* 最佳实践
+
+* 常见问题
+
+* 审查发布
 
 ## 使用模板
 

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

@@ -9,54 +9,87 @@ Starting from v5.6.0, all ultrapower tools use the `ultrapower:` prefix instead
 
 ## Migration Timeline
 
-- **v5.6.0**: New prefix introduced, legacy names deprecated
-- **v6.0.0**: Legacy names will be removed
+* **v5.6.0**: New prefix introduced, legacy names deprecated
+
+* **v6.0.0**: Legacy names will be removed
 
 ## Affected Tools
 
 ### LSP Tools
-- `lsp_hover` → `ultrapower:lsp_hover`
-- `lsp_goto_definition` → `ultrapower:lsp_goto_definition`
-- `lsp_find_references` → `ultrapower:lsp_find_references`
-- `lsp_document_symbols` → `ultrapower:lsp_document_symbols`
-- `lsp_workspace_symbols` → `ultrapower:lsp_workspace_symbols`
-- `lsp_diagnostics` → `ultrapower:lsp_diagnostics`
-- `lsp_diagnostics_directory` → `ultrapower:lsp_diagnostics_directory`
-- `lsp_servers` → `ultrapower:lsp_servers`
-- `lsp_prepare_rename` → `ultrapower:lsp_prepare_rename`
-- `lsp_rename` → `ultrapower:lsp_rename`
-- `lsp_code_actions` → `ultrapower:lsp_code_actions`
-- `lsp_code_action_resolve` → `ultrapower:lsp_code_action_resolve`
+
+* `lsp_hover` → `ultrapower:lsp_hover`
+
+* `lsp_goto_definition` → `ultrapower:lsp_goto_definition`
+
+* `lsp_find_references` → `ultrapower:lsp_find_references`
+
+* `lsp_document_symbols` → `ultrapower:lsp_document_symbols`
+
+* `lsp_workspace_symbols` → `ultrapower:lsp_workspace_symbols`
+
+* `lsp_diagnostics` → `ultrapower:lsp_diagnostics`
+
+* `lsp_diagnostics_directory` → `ultrapower:lsp_diagnostics_directory`
+
+* `lsp_servers` → `ultrapower:lsp_servers`
+
+* `lsp_prepare_rename` → `ultrapower:lsp_prepare_rename`
+
+* `lsp_rename` → `ultrapower:lsp_rename`
+
+* `lsp_code_actions` → `ultrapower:lsp_code_actions`
+
+* `lsp_code_action_resolve` → `ultrapower:lsp_code_action_resolve`
 
 ### State Tools
-- `state_read` → `ultrapower:state_read`
-- `state_write` → `ultrapower:state_write`
-- `state_clear` → `ultrapower:state_clear`
-- `state_list_active` → `ultrapower:state_list_active`
-- `state_get_status` → `ultrapower:state_get_status`
+
+* `state_read` → `ultrapower:state_read`
+
+* `state_write` → `ultrapower:state_write`
+
+* `state_clear` → `ultrapower:state_clear`
+
+* `state_list_active` → `ultrapower:state_list_active`
+
+* `state_get_status` → `ultrapower:state_get_status`
 
 ### Notepad Tools
-- `notepad_read` → `ultrapower:notepad_read`
-- `notepad_write_priority` → `ultrapower:notepad_write_priority`
-- `notepad_write_working` → `ultrapower:notepad_write_working`
-- `notepad_write_manual` → `ultrapower:notepad_write_manual`
-- `notepad_prune` → `ultrapower:notepad_prune`
-- `notepad_stats` → `ultrapower:notepad_stats`
+
+* `notepad_read` → `ultrapower:notepad_read`
+
+* `notepad_write_priority` → `ultrapower:notepad_write_priority`
+
+* `notepad_write_working` → `ultrapower:notepad_write_working`
+
+* `notepad_write_manual` → `ultrapower:notepad_write_manual`
+
+* `notepad_prune` → `ultrapower:notepad_prune`
+
+* `notepad_stats` → `ultrapower:notepad_stats`
 
 ### Memory Tools
-- `project_memory_read` → `ultrapower:project_memory_read`
-- `project_memory_write` → `ultrapower:project_memory_write`
-- `project_memory_add_note` → `ultrapower:project_memory_add_note`
-- `project_memory_add_directive` → `ultrapower:project_memory_add_directive`
+
+* `project_memory_read` → `ultrapower:project_memory_read`
+
+* `project_memory_write` → `ultrapower:project_memory_write`
+
+* `project_memory_add_note` → `ultrapower:project_memory_add_note`
+
+* `project_memory_add_directive` → `ultrapower:project_memory_add_directive`
 
 ### AST Tools
-- `ast_grep_search` → `ultrapower:ast_grep_search`
-- `ast_grep_replace` → `ultrapower:ast_grep_replace`
+
+* `ast_grep_search` → `ultrapower:ast_grep_search`
+
+* `ast_grep_replace` → `ultrapower:ast_grep_replace`
 
 ### Other Tools
-- `python_repl` → `ultrapower:python_repl`
-- `trace_timeline` → `ultrapower:trace_timeline`
-- `trace_summary` → `ultrapower:trace_summary`
+
+* `python_repl` → `ultrapower:python_repl`
+
+* `trace_timeline` → `ultrapower:trace_timeline`
+
+* `trace_summary` → `ultrapower:trace_summary`
 
 ## Automated Migration