@liangjie559567/ultrapower 5.6.6 → 5.6.8

package/docs/reviews/ultrapower-standards/summary.md

@@ -10,7 +10,7 @@
 ## 1. 关键决策
 
 | 冲突 | 仲裁角色 | 决策结果 |
-|------|---------|---------|
+| ------ | --------- | --------- |
 | PRD 只定义规范名称，无实质内容 | Critic（安全/质量，最高优先级） | Rough PRD 必须为每个 P0 规范条目提供至少 3 条可执行规则草稿，不得仅列文件名 |
 | 状态文件路径遍历风险未处理 | Critic（安全边界不可协商） | 新增"安全边界"章节，要求 mode 参数白名单校验，禁止路径拼接 |
 | Agent 状态机存在死状态（ERROR 无强制退出） | Critic + Tech（技术可行性） | 状态机增加 ERROR 超时强制转换（30s）、WAITING 超时（5min）、ZOMBIE 清理状态 |
@@ -30,42 +30,62 @@
 
 ### 移除
 
-- 原 P0/P1/P2 同时作为 MVP 的三层结构（范围过大）
-- 原 AC-01"并发场景有明确处理指引"（存在性检查，替换为可量化版本）
-- 原 AC-04"三类 BUG 来源均有对应规范"（与 AC-01 重叠，替换为质量指标）
-- 原状态机图（存在死状态，已重新设计）
-- 原 Hook 三分类（PreToolUse/PostToolUse/Stop）（与代码不符，已替换）
+* 原 P0/P1/P2 同时作为 MVP 的三层结构（范围过大）
+
+* 原 AC-01"并发场景有明确处理指引"（存在性检查，替换为可量化版本）
+
+* 原 AC-04"三类 BUG 来源均有对应规范"（与 AC-01 重叠，替换为质量指标）
+
+* 原状态机图（存在死状态，已重新设计）
+
+* 原 Hook 三分类（PreToolUse/PostToolUse/Stop）（与代码不符，已替换）
 
 ### 新增
 
-- P0 前置任务：现有实现审计（35 个 hook + 49 个 agent）
-- 安全边界章节：路径遍历防护、hook 输入消毒、状态文件权限
-- 完整 Agent 状态机：含 ZOMBIE 状态、ERROR 超时、WAITING 超时、成本超限、死锁检测
-- 15 类 HookType 完整分类（来自 bridge.ts）
-- Stop 阶段优先级链规则
-- SDK 平台限制说明（success 字段已废弃）
-- Agent 边界情况矩阵（超时/孤儿/成本超限/死锁）
-- Windows 平台差异说明（rename 语义、文件锁）
-- 规范执行机制（CI 门禁策略）
-- 规范版本化策略（与 npm 版本号绑定）
-- 用户旅程地图（三类用户：新用户/日常用户/贡献者）
-- 系统反馈标准（进度/成功/错误提示格式）
-- Skill 决策树原型（3 层结构，第一层基于用户意图）
-- Impact Scope 补充 5 个遗漏文件
-- 新增 AC-05（系统反馈标准化）、AC-06（规范执行机制）
+* P0 前置任务：现有实现审计（35 个 hook + 49 个 agent）
+
+* 安全边界章节：路径遍历防护、hook 输入消毒、状态文件权限
+
+* 完整 Agent 状态机：含 ZOMBIE 状态、ERROR 超时、WAITING 超时、成本超限、死锁检测
+
+* 15 类 HookType 完整分类（来自 bridge.ts）
+
+* Stop 阶段优先级链规则
+
+* SDK 平台限制说明（success 字段已废弃）
+
+* Agent 边界情况矩阵（超时/孤儿/成本超限/死锁）
+
+* Windows 平台差异说明（rename 语义、文件锁）
+
+* 规范执行机制（CI 门禁策略）
+
+* 规范版本化策略（与 npm 版本号绑定）
+
+* 用户旅程地图（三类用户：新用户/日常用户/贡献者）
+
+* 系统反馈标准（进度/成功/错误提示格式）
+
+* Skill 决策树原型（3 层结构，第一层基于用户意图）
+
+* Impact Scope 补充 5 个遗漏文件
+
+* 新增 AC-05（系统反馈标准化）、AC-06（规范执行机制）
 
 ### 优先级调整
 
-- Skill 调用决策树：从 P1 提升，与 P0 并行交付
-- 贡献检查清单：从 P2 提升为 P1 子集（CI 可验证，形成闭环）
-- 自动化规范检查工具：从"v2 延期"调整为"v1 CI 门禁"（无执行机制的规范无价值）
+* Skill 调用决策树：从 P1 提升，与 P0 并行交付
+
+* 贡献检查清单：从 P2 提升为 P1 子集（CI 可验证，形成闭环）
+
+* 自动化规范检查工具：从"v2 延期"调整为"v1 CI 门禁"（无执行机制的规范无价值）
 
 ---
 
 ## 3. 放弃项（经仲裁明确不纳入）
 
 | 放弃项 | 放弃理由 |
-|--------|---------|
+| -------- | --------- |
 | 英文版规范文档 | 当前用户群以中文为主，v2 延期 |
 | 视频教程/交互式引导 | 超出文档范围，v2 延期 |
 | 规范覆盖率度量仪表盘 | 超出 v1 范围 |
@@ -78,8 +98,12 @@
 
 本次仲裁共触发 12 个冲突点，按优先级层级处理如下：
 
-- 安全（Critic）覆盖其他所有意见：路径遍历、hook 注入、状态文件权限 — 3 项
-- 技术可行性（Tech）作为硬性约束：Impact Scope 补充、Windows 兼容性、原子写入工具函数 — 3 项
-- 战略对齐（Product）调整优先级：Skill 决策树并行、CI 门禁列为 v1、MVP 范围收窄 — 3 项
-- 逻辑正确性（Domain）修正技术描述：15 类 HookType、Stop 优先级链、SDK 限制 — 3 项
-- 用户体验（UX）补充设计细节：决策树原型、用户旅程、系统反馈标准 — 纳入但不覆盖上层决策
+* 安全（Critic）覆盖其他所有意见：路径遍历、hook 注入、状态文件权限 — 3 项
+
+* 技术可行性（Tech）作为硬性约束：Impact Scope 补充、Windows 兼容性、原子写入工具函数 — 3 项
+
+* 战略对齐（Product）调整优先级：Skill 决策树并行、CI 门禁列为 v1、MVP 范围收窄 — 3 项
+
+* 逻辑正确性（Domain）修正技术描述：15 类 HookType、Stop 优先级链、SDK 限制 — 3 项
+
+* 用户体验（UX）补充设计细节：决策树原型、用户旅程、系统反馈标准 — 纳入但不覆盖上层决策

package/docs/reviews/ultrapower-tech-review/review_tech.md

@@ -1,19 +1,28 @@
 ### ⚠️ 架构风险
 
 **循环依赖问题**
-- 多个模块间存在循环引用
-- 影响：构建顺序敏感，可能导致运行时错误
-- 建议：引入依赖注入容器或事件总线解耦
+
+* 多个模块间存在循环引用
+
+* 影响：构建顺序敏感，可能导致运行时错误
+
+* 建议：引入依赖注入容器或事件总线解耦
 
 **状态管理复杂度**
-- 多种状态文件：`.omc/state/{mode}-state.json`
-- 会话级状态：`.omc/state/sessions/{sessionId}/`
-- 状态同步机制需要严格测试
+
+* 多种状态文件：`.omc/state/{mode}-state.json`
+
+* 会话级状态：`.omc/state/sessions/{sessionId}/`
+
+* 状态同步机制需要严格测试
 
 **并发控制**
-- Team 模式支持多 Agent 并行
-- 需要关注：资源竞争、死锁、超时处理
-- 当前有 `agent-lifecycle.md` 规范，但实现复杂度高
+
+* Team 模式支持多 Agent 并行
+
+* 需要关注：资源竞争、死锁、超时处理
+
+* 当前有 `agent-lifecycle.md` 规范，但实现复杂度高
 
 **风险等级**: 🟡 中等（需持续监控）
 
@@ -24,7 +33,7 @@
 ### 📊 债务指标
 
 | 指标 | 当前值 | 目标值 | 状态 |
-|------|--------|--------|------|
+| ------ | -------- | -------- | ------ |
 | `any` 类型使用 | 603 次 | <200 | 🔴 高 |
 | 源码文件数 | 661 个 | - | ✅ |
 | 测试文件数 | 231 个 | - | ✅ |
@@ -34,15 +43,19 @@
 ### 🔴 P0 技术债务
 
 **1. any 类型泛滥 (603 处)**
-- 影响：类型安全丧失，运行时错误风险高
-- 建议：
+
+* 影响：类型安全丧失，运行时错误风险高
+
+* 建议：
   - 优先修复核心模块（agents/、team/、hooks/）
   - 使用 `unknown` 替代 `any`，强制类型收窄
   - 引入 `zod` schema 验证外部输入
 
 **2. 测试覆盖率不足 (40-60%)**
-- 影响：重构风险高，回归测试不充分
-- 建议：
+
+* 影响：重构风险高，回归测试不充分
+
+* 建议：
   - 核心路径（Agent 路由、状态机转换）达到 90%+
   - Hook 系统需要集成测试
   - 添加 E2E 测试覆盖关键工作流
@@ -50,12 +63,16 @@
 ### 🟡 P1 技术债务
 
 **3. 循环依赖**
-- 影响：模块耦合度高，难以独立测试
-- 建议：使用 `madge` 工具检测并逐步解耦
+
+* 影响：模块耦合度高，难以独立测试
+
+* 建议：使用 `madge` 工具检测并逐步解耦
 
 **4. 错误处理不统一**
-- 影响：调试困难，用户体验差
-- 建议：引入统一的错误类型体系和错误边界
+
+* 影响：调试困难，用户体验差
+
+* 建议：引入统一的错误类型体系和错误边界
 
 ---
 
@@ -68,12 +85,12 @@
    - 安全规范：路径遍历防护、输入消毒
    - 状态机规范：清晰的转换矩阵
 
-2. **安全设计**
+1. **安全设计**
    - `assertValidMode()` 路径校验
    - Hook 输入白名单过滤
    - 状态文件权限控制
 
-3. **可观测性**
+1. **可观测性**
    - Analytics 引擎：使用指标追踪
    - Trace 系统：Hook/Agent/Tool 调用链
    - 审计日志：`.omc/logs/`
@@ -85,11 +102,11 @@
    - Agent 并行度可配置性不足
    - 建议：引入 LRU 缓存、连接池
 
-2. **可测试性**
+1. **可测试性**
    - 部分模块依赖文件系统，Mock 困难
    - 建议：抽象文件系统接口
 
-3. **文档同步**
+1. **文档同步**
    - 代码与文档可能不同步
    - 建议：CI 中添加文档验证步骤
 
@@ -99,24 +116,28 @@
 
 ### 🟢 低风险项
 
-- ✅ 技术栈成熟稳定
-- ✅ 模块化设计清晰
-- ✅ 有完整的规范文档
+* ✅ 技术栈成熟稳定
+
+* ✅ 模块化设计清晰
+
+* ✅ 有完整的规范文档
 
 ### 🟡 中风险项
 
-- ⚠️ **any 类型债务**: 需要 2-3 个 sprint 逐步清理
-- ⚠️ **测试覆盖率**: 需要持续投入，优先核心路径
-- ⚠️ **循环依赖**: 需要架构重构，影响范围大
+* ⚠️ **any 类型债务**: 需要 2-3 个 sprint 逐步清理
+
+* ⚠️ **测试覆盖率**: 需要持续投入，优先核心路径
+
+* ⚠️ **循环依赖**: 需要架构重构，影响范围大
 
 ### 🔴 高风险项
 
-- 🔴 **并发控制复杂度**:
+* 🔴 **并发控制复杂度**:
   - Team 模式下多 Agent 协调
   - 状态同步、死锁检测、超时处理
   - 建议：先做 POC 验证关键场景
 
-- 🔴 **MCP 协议依赖**:
+* 🔴 **MCP 协议依赖**:
   - 外部协议变更风险
   - 建议：抽象 MCP 适配层，降低耦合
 
@@ -125,16 +146,19 @@
 ## 6. 实施计划建议
 
 ### Phase 1: 债务清理 (2-3 周)
+
 1. 修复核心模块 any 类型（agents/、team/、hooks/）
 2. 补充核心路径单元测试（目标 80%+）
 3. 使用 `madge` 检测并修复循环依赖
 
 ### Phase 2: 架构加固 (2-3 周)
+
 1. 引入统一错误处理体系
 2. 添加性能监控和缓存层
 3. 完善 E2E 测试套件
 
 ### Phase 3: 持续优化 (长期)
+
 1. 监控 MCP 协议变更，及时适配
 2. 定期 Review 技术债务指标
 3. 优化并发控制和资源管理
@@ -146,9 +170,12 @@
 ### ✅ Pass（有条件通过）
 
 **通过理由**:
-- 技术选型合理，架构设计清晰
-- 有完善的规范文档和安全设计
-- 核心功能可实现，风险可控
+
+* 技术选型合理，架构设计清晰
+
+* 有完善的规范文档和安全设计
+
+* 核心功能可实现，风险可控
 
 **前置条件**:
 1. **必须**: 完成 Phase 1 债务清理（P0 优先级）
@@ -158,7 +185,7 @@
 ### 📊 工作量估算
 
 | 阶段 | 工作量 | 优先级 |
-|------|--------|--------|
+| ------ | -------- | -------- |
 | Phase 1: 债务清理 | 2-3 周 | P0 |
 | Phase 2: 架构加固 | 2-3 周 | P1 |
 | Phase 3: 持续优化 | 长期 | P2 |

package/docs/reviews/user_guide/summary.md

@@ -10,8 +10,10 @@
 ### 冲突仲裁：REVISE vs APPROVE
 
 **冲突**:
-- Tech Lead: APPROVE WITH MINOR REVISIONS
-- Product Director, UX Director, Domain Expert, Critic: REVISE
+
+* Tech Lead: APPROVE WITH MINOR REVISIONS
+
+* Product Director, UX Director, Domain Expert, Critic: REVISE
 
 **仲裁决定**: **REVISE**
 
@@ -24,41 +26,58 @@
    - 安装步骤错误（命令不正确）
    - 遗漏关键功能（MCP、Axiom 进化系统、Team 流水线）
 
-2. **Product Director (战略对齐)**: 目标用户定位过窄，成功指标缺乏量化基线
-3. **UX Director (用户体验)**: 5 分钟目标不现实，缺少前置条件检查
-4. **Critic (风险缓解)**: 文档维护机制缺失，示例验证策略不足
+1. **Product Director (战略对齐)**: 目标用户定位过窄，成功指标缺乏量化基线
+2. **UX Director (用户体验)**: 5 分钟目标不现实，缺少前置条件检查
+3. **Critic (风险缓解)**: 文档维护机制缺失，示例验证策略不足
 
 ---
 
 ## 2. 范围变更
 
 ### 移除
-- ❌ 交互式教程（Phase 3）改为静态教程（Tech Lead 建议，降低实现复杂度）
-- ❌ 5 分钟上手目标 → 调整为 10 分钟（UX Director 建议）
+
+* ❌ 交互式教程（Phase 3）改为静态教程（Tech Lead 建议，降低实现复杂度）
+
+* ❌ 5 分钟上手目标 → 调整为 10 分钟（UX Director 建议）
 
 ### 修正
-- ✅ Skills 数量：71 → 70
-- ✅ Agents 分类：领域专家 16 → 15，新增协调 2 个
-- ✅ 安装步骤：分离两种安装方式，修正插件命令
-- ✅ 示例命令：使用自然语言触发方式
+
+* ✅ Skills 数量：71 → 70
+
+* ✅ Agents 分类：领域专家 16 → 15，新增协调 2 个
+
+* ✅ 安装步骤：分离两种安装方式，修正插件命令
+
+* ✅ 示例命令：使用自然语言触发方式
 
 ### 新增
-- ✅ 前置条件检查（Claude Code >= v1.0.0, Node.js >= 18.0.0）
-- ✅ 安装验证步骤（/ultrapower:omc-doctor）
-- ✅ MCP 服务器功能说明
-- ✅ Axiom 自我进化系统说明
-- ✅ Team 流水线说明
-- ✅ 文档同步机制（CI 验证 + 文档生成脚本）
-- ✅ 版本兼容性策略
-- ✅ 故障排查指南
-- ✅ 商业目标章节
-- ✅ 用户分层（初学者/进阶/专家）
+
+* ✅ 前置条件检查（Claude Code >= v1.0.0, Node.js >= 18.0.0）
+
+* ✅ 安装验证步骤（/ultrapower:omc-doctor）
+
+* ✅ MCP 服务器功能说明
+
+* ✅ Axiom 自我进化系统说明
+
+* ✅ Team 流水线说明
+
+* ✅ 文档同步机制（CI 验证 + 文档生成脚本）
+
+* ✅ 版本兼容性策略
+
+* ✅ 故障排查指南
+
+* ✅ 商业目标章节
+
+* ✅ 用户分层（初学者/进阶/专家）
 
 ---
 
 ## 3. 优先级调整
 
 ### 原计划
+
 ```
 Phase 1 (P0): 快速开始
 Phase 2 (P1): 完整手册
@@ -67,6 +86,7 @@ Phase 4 (P2): 补充文档
 ```
 
 ### 修订后
+
 ```
 Phase 0 (P0 - 前置条件): 质量基线（4-6 周）
 ├─ 安全加固
@@ -86,7 +106,7 @@ Phase 4 (P2): 静态教程（1 周）
 ## 4. 工作量估算
 
 | Phase | 原估算 | 修订后 | 变化 |
-|-------|--------|--------|------|
+| ------- | -------- | -------- | ------ |
 | Phase 1 | 2-3h | 3-4h | +33% (新增前置条件) |
 | Phase 2 | 6-8h | 8-10h | +25% (新增 MCP/Axiom/Team) |
 | Phase 3 | 8-12h | 4-6h | -50% (改为静态教程) |
@@ -106,11 +126,11 @@ Phase 4 (P2): 静态教程（1 周）
    - 需要文档生成脚本
    - 需要版本同步机制
 
-2. **示例代码验证不足** (4/5)
+1. **示例代码验证不足** (4/5)
    - 需要 E2E 测试覆盖
    - 需要多环境测试
 
-3. **安装步骤不清晰** (4/5)
+1. **安装步骤不清晰** (4/5)
    - 需要前置条件说明
    - 需要验证步骤
    - 需要故障排查指南

package/docs/shared/AGENTS.md

@@ -4,12 +4,13 @@
 # docs/partials/
 
 ## Purpose
+
 文档片段目录。存放可复用的文档组件，包括 agent 层级说明、功能特性描述、模式层级和选择指南等，供主文档引用。
 
 ## Key Files
 
 | File | Description |
-|------|-------------|
+| ------ | ------------- |
 | `agent-tiers.md` | Agent 层级（haiku/sonnet/opus）说明 |
 | `features.md` | 功能特性描述片段 |
 | `mode-hierarchy.md` | 执行模式层级关系说明 |
@@ -19,6 +20,7 @@
 ## For AI Agents
 
 ### 修改此目录时
-- 片段变更需检查所有引用该片段的主文档
+
+* 片段变更需检查所有引用该片段的主文档
 
 <!-- MANUAL: -->

package/docs/shared/agent-tiers.md

@@ -9,7 +9,7 @@ ultrapower 使用 `model` 参数动态控制 agent 层级，而非使用后缀
 ## Agent 默认模型配置
 
 | Agent | 默认模型 | 可用层级 | 用途 |
-|-------|---------|---------|------|
+| ------- | --------- | --------- | ------ |
 | architect | opus | haiku/sonnet/opus | 系统设计、架构决策、深度分析 |
 | executor | sonnet | haiku/sonnet/opus | 代码实现、重构、功能开发 |
 | deep-executor | opus | haiku/sonnet/opus | 复杂自主目标导向任务 |
@@ -38,7 +38,7 @@ ultrapower 使用 `model` 参数动态控制 agent 层级，而非使用后缀
 ## 模型路由指南
 
 | 任务复杂度 | 推荐模型 | 使用时机 |
-|-----------------|------|-------------|
+| ----------------- | ------ | ------------- |
 | 简单 | haiku | 快速查询、简单修复、"X 返回什么？" |
 | 标准 | sonnet | 功能实现、标准调试、"添加验证" |
 | 复杂 | opus | 架构决策、复杂调试、"重构系统" |
@@ -46,7 +46,7 @@ ultrapower 使用 `model` 参数动态控制 agent 层级，而非使用后缀
 ## 按任务类型选择 Agent
 
 | 任务类型 | 最佳 Agent | 推荐模型 |
-|-----------|------------|------|
+| ----------- | ------------ | ------ |
 | 快速代码查询 | explore | haiku |
 | 查找文件/模式 | explore | haiku |
 | 复杂架构搜索 | explore | opus |
@@ -103,16 +103,19 @@ Task(subagent_type="ultrapower:explore",
 ```
 
 为节省 token，在任务允许时优先使用较低层级：
-- 简单查询和快速修复使用 `haiku`
-- 标准实现工作使用 `sonnet`
-- 复杂推理任务保留 `opus`
+
+* 简单查询和快速修复使用 `haiku`
+
+* 标准实现工作使用 `sonnet`
+
+* 复杂推理任务保留 `opus`
 
 ## MCP 工具与 Agent 能力
 
 ### 工具清单
 
 | 工具 | 类别 | 用途 | 是否分配给 Agent？ |
-|------|----------|---------|---------------------|
+| ------ | ---------- | --------- | --------------------- |
 | `lsp_hover` | LSP | 获取代码位置的类型信息和文档 | 否（orchestrator 直接使用） |
 | `lsp_goto_definition` | LSP | 跳转到符号定义处 | 否（orchestrator 直接使用） |
 | `lsp_find_references` | LSP | 查找符号在代码库中的所有用法 | 是（仅 `explore`） |
@@ -132,7 +135,7 @@ Task(subagent_type="ultrapower:explore",
 ### Agent 工具矩阵（仅 MCP 工具）
 
 | Agent | LSP Diagnostics | LSP Dir Diagnostics | LSP Symbols | LSP References | AST Search | AST Replace | Python REPL |
-|-------|:-:|:-:|:-:|:-:|:-:|:-:|:-:|
+| ------- | :-: | :-: | :-: | :-: | :-: | :-: | :-: |
 | `explore` | - | - | doc + workspace | yes | yes | - | - |
 | `architect` | yes | yes | - | - | yes | - | - |
 | `executor` | yes | yes | - | - | - | - | - |
@@ -150,7 +153,7 @@ Task(subagent_type="ultrapower:explore",
 以下 7 个 MCP 工具未分配给任何 agent，需要时直接使用：
 
 | 工具 | 直接使用时机 |
-|------|---------------------|
+| ------ | --------------------- |
 | `lsp_hover` | 对话中快速查询类型 |
 | `lsp_goto_definition` | 分析过程中导航到符号定义 |
 | `lsp_prepare_rename` | 在决定方案前检查重命名可行性 |
@@ -163,11 +166,18 @@ Task(subagent_type="ultrapower:explore",
 
 ### 工具选择指南
 
-- **需要文件符号概览或工作区搜索？** 通过 `explore` 使用 `lsp_document_symbols`/`lsp_workspace_symbols`
-- **需要查找符号的所有用法？** 通过 `explore` 使用 `lsp_find_references`
-- **需要结构化代码模式？**（如"查找所有匹配 X 形状的函数"）通过 `explore`、`architect` 或 `code-reviewer` 使用 `ast_grep_search`
-- **需要结构化代码转换？** 通过 `executor`（使用 `model="opus"`）使用 `ast_grep_replace`
-- **需要全项目类型检查？** 通过 `architect`、`executor` 或 `build-fixer` 使用 `lsp_diagnostics_directory`
-- **需要单文件错误检查？** 通过多个 agent 使用 `lsp_diagnostics`（参见矩阵）
-- **需要数据分析/计算？** 通过 `scientist` 使用 `python_repl`
-- **需要快速类型信息或定义查询？** 直接使用 `lsp_hover`/`lsp_goto_definition`（orchestrator 直接工具）
+* **需要文件符号概览或工作区搜索？** 通过 `explore` 使用 `lsp_document_symbols`/`lsp_workspace_symbols`
+
+* **需要查找符号的所有用法？** 通过 `explore` 使用 `lsp_find_references`
+
+* **需要结构化代码模式？**（如"查找所有匹配 X 形状的函数"）通过 `explore`、`architect` 或 `code-reviewer` 使用 `ast_grep_search`
+
+* **需要结构化代码转换？** 通过 `executor`（使用 `model="opus"`）使用 `ast_grep_replace`
+
+* **需要全项目类型检查？** 通过 `architect`、`executor` 或 `build-fixer` 使用 `lsp_diagnostics_directory`
+
+* **需要单文件错误检查？** 通过多个 agent 使用 `lsp_diagnostics`（参见矩阵）
+
+* **需要数据分析/计算？** 通过 `scientist` 使用 `python_repl`
+
+* **需要快速类型信息或定义查询？** 直接使用 `lsp_hover`/`lsp_goto_definition`（orchestrator 直接工具）