docs(agentskills): 更新子智能体使用指南

- 强调阻塞/后台模式的唯一判断标准是运行期间有没有别的事情要做
- 强调大范围搜索/调查前必须先自己进行浅层搜索
- 重写示例：国产开源智能体调研、程序 bug 定位
- 拆分后台模式场景：单个子智能体用阻塞，多个子智能体用后台并等待通知

agentskills/sub-agent-guide/SKILL.md

@@ -18,6 +18,7 @@ description: 子智能体使用指南。创建子智能体之前必须阅读此
 **适合（推荐）：**
 - **项目初期探索**：快速梳理目录结构、模块职责、运行方式，形成初步认知
 - **占用大量上下文的网络搜索和信息收集**：竞品调研、资料汇总、文档整理、新闻/资料比对
+  - **重要**：进行大范围搜索或调查前，必须先自己进行一次浅层搜索/调查，摸清关键词、主要来源和任务边界，再创建子智能体并给出精确指导。
 - **程序测试与验证**：执行测试命令、收集日志、汇总失败用例与错误模式
 - **并行独立的文档/分析任务**：生成说明文档、运行报告、排查清单
 
@@ -41,19 +42,19 @@ description: 子智能体使用指南。创建子智能体之前必须阅读此
 **好的示例：**
 
 ```
-# 信息搜集任务
-分析项目的前后端认证与鉴权实现：
-1. 查找所有与认证相关的代码文件（login, auth, jwt, session 等关键词）
-2. 分析前端如何存储和传递认证信息
-3. 分析后端如何验证和管理用户权限
-4. 整理成一份技术文档（auth_analysis.md），包含流程图和代码位置
+# 代码定位任务
+用户反馈了一个程序 bug：登录时偶尔报 500 错误。
+1. 先自己阅读项目结构，确认技术栈和登录相关模块位置
+2. 复现或定位错误触发条件，理解问题表现
+3. 创建子智能体：在 src/auth/、src/middleware/、src/api/login/ 等目录中查找可能导致 500 的代码路径
+4. 子智能体交付可疑文件列表和代码位置，生成 bug_location.md
 
 # 网络调研任务
-搜索并整理英伟达2025年的财报信息：
-1. 搜索英伟达2025年Q1-Q4财报
-2. 提取关键财务数据（营收、利润、增长率）
-3. 分析主要业务板块表现
-4. 生成结构化报告（nvidia_2025_report.md）
+用户要求调查国产开源智能体功能：
+1. 先自己进行一次浅层搜索，列出当前主要的国产开源智能体（如 AgentScope、DB-GPT、ModelScope-Agent 等）
+2. 根据初步结果，为每个候选智能体创建独立的子智能体，分别调研其功能特性、架构设计、适用场景
+3. 每个子智能体生成独立报告
+4. 最后由你整合对比，生成 overall_comparison.md
 
 # 系统信息收集
 收集当前计算机的硬件和系统信息：
@@ -126,9 +127,8 @@ create_sub_agent(
 - 你只需在收到通知后直接查看交付目录即可，系统会把所有必需信息一并带上。
 
 **何时使用：**
-- ✅ 耗时任务（预计 > 1 分钟）
-- ✅ 多个并行任务
-- ✅ 你有其他工作可以先做（回答用户问题、处理其他任务）
+- ✅ 需要同时创建多个子智能体
+- ✅ 创建后你有其他工作可以先做（回答用户问题、处理其他任务）
 
 **后台模式下你应该做什么：**
 
@@ -149,15 +149,25 @@ create_sub_agent(agent_id=2, task="...", run_in_background=true, ...)
 # 子智能体完成时会自动插入一条 system 消息通知你
 ```
 
-**情况 B：运行子智能体期间不需要做别的事情**
+**情况 B：运行子智能体期间不需要做别的事情，且只需要一个子智能体**
 ```python
-create_sub_agent(agent_id=1, task="大规模日志分析", run_in_background=true, timeout_seconds=1800)
+# 只有单个子智能体，且期间没有其他工作，直接使用阻塞模式
+create_sub_agent(agent_id=1, task="大规模日志分析", run_in_background=false, timeout_seconds=1800)
+
+# 等待工具返回后，直接读取交付目录处理结果
+```
+
+**情况 C：运行子智能体期间不需要做别的事情，但需要同时创建多个子智能体**
+```python
+# 多个子智能体同时运行，即使自己暂时没事做，也全部使用后台模式
+create_sub_agent(agent_id=1, task="分析前端认证实现", deliverables_dir="analysis/frontend_auth", run_in_background=true, ...)
+create_sub_agent(agent_id=2, task="分析后端鉴权实现", deliverables_dir="analysis/backend_auth", run_in_background=true, ...)
 
 # 告诉用户预计时间
-"我已启动子智能体进行日志分析，这个任务比较耗时，预计需要20-30分钟。系统会在完成后自动通知我，届时我会立即处理结果并回复你。"
+"我已启动2个子智能体并行分析认证与鉴权实现，预计需要10-15分钟。系统会在完成后自动通知我，届时我会立即整合结果并回复你。"
 
 # 然后停止工作和输出，等待系统通知
-# 子智能体运行完成后，系统会自动发送一条 user 消息通知你
+# 每个子智能体完成后，系统都会自动发送一条 user 消息通知你
 ```
 
 **重要提示：**
@@ -171,13 +181,15 @@ create_sub_agent(agent_id=1, task="大规模日志分析", run_in_background=tru
 ```
 任务预计耗时 < 1 分钟？
 ├─ 是 → 使用阻塞模式（run_in_background=false）
-└─ 否 → 有多个并行任务？
-    ├─ 是 → 使用后台模式（run_in_background=true）
-    └─ 否 → 有其他工作可以先做？
-        ├─ 是 → 使用后台模式
-        └─ 否 → 使用阻塞模式
+└─ 否 → 需要同时创建多个子智能体？
+    ├─ 是 → 使用后台模式（run_in_background=true），然后停止输出等待系统通知
+    └─ 否 → 创建后你有没有其他工作可以先做？
+        ├─ 是 → 使用后台模式（run_in_background=true），继续处理其他工作
+        └─ 否 → 使用阻塞模式（run_in_background=false）
 ```
 
+> **核心判断标准**：选择阻塞模式还是后台模式，**唯一标准是创建子智能体后你自己还有没有别的事情要做**，和子智能体本身被用来做什么任务无关。不要因为任务是“搜索”就一定用后台，也不要因为任务是“分析”就一定用阻塞。
+
 ## 并行执行模式
 
 创建多个子智能体时，确保它们的任务**完全独立**：
@@ -190,9 +202,12 @@ create_sub_agent(agent_id=2, task="生成模块 B 的文档", deliverables_dir="
 # 然后你可以继续做其他事情，或者停止输出等待通知
 
 # ✅ 好的并行：信息搜集
-create_sub_agent(agent_id=1, task="搜索并整理 Claude 最新模型信息", deliverables_dir="research/claude", run_in_background=true, ...)
-create_sub_agent(agent_id=2, task="搜索并整理 ChatGPT 最新模型信息", deliverables_dir="research/chatgpt", run_in_background=true, ...)
-# 等系统自动通知两个都完成后，你再对比整合
+# 先自己浅层搜索，列出 3-5 个国产开源智能体
+# 然后为每个智能体创建独立的子智能体并行调研
+create_sub_agent(agent_id=1, task="调研 AgentScope 的功能特性、架构和适用场景", deliverables_dir="research/agentscope", run_in_background=true, ...)
+create_sub_agent(agent_id=2, task="调研 DB-GPT 的功能特性、架构和适用场景", deliverables_dir="research/dbgpt", run_in_background=true, ...)
+create_sub_agent(agent_id=3, task="调研 ModelScope-Agent 的功能特性、架构和适用场景", deliverables_dir="research/modelscope_agent", run_in_background=true, ...)
+# 等系统自动通知全部完成后，你再整合生成对比报告
 
 # ✅ 好的并行：系统调研
 create_sub_agent(agent_id=1, task="分析前端认证实现", deliverables_dir="analysis/frontend_auth", run_in_background=true, ...)
@@ -331,7 +346,7 @@ else:
 子智能体的本质是**并行执行完全独立的任务**。
 
 **关键要点：**
-1. **执行模式选择**：快速任务用阻塞模式，耗时任务或并行任务用后台模式
+1. **执行模式选择**：运行子智能体期间没有别的事情要做且只创建一个子智能体 → 阻塞模式；需要同时创建多个子智能体，或期间有其他工作可以先做 → 后台模式
 2. **后台模式下**：创建后继续工作或停止输出，系统会自动通知完成
 3. **任务独立性**：子智能体之间无法通信，确保任务完全独立
 4. **任务描述**：子智能体看不到对话历史，task 参数必须包含所有信息

static/src/components/chat/MinimalBlocks.vue

@@ -216,7 +216,9 @@ const emit = defineEmits<{
 const expandedGroups = ref(new Set<string>());
 const thinkingRefs = new Map<string, HTMLElement>();
 const stepsWrapperRefs = new Map<string, HTMLElement>();
+const stepsWrapperScrollLocks = new Map<string, boolean>();
 const summaryLoaders = new Map<string, Component>();
+const STEPS_WRAPPER_BOTTOM_THRESHOLD = 20;
 const TOOL_REEL_ITEM_HEIGHT = 26;
 const TOOL_REEL_INTERVAL_MS = 1450;
 const TOOL_REEL_ROLL_MS = 520;
@@ -811,17 +813,35 @@ const getSummarySteps = (actions: Action[]) => {
   }));
 };
 
+const isStepsWrapperNearBottom = (wrapper: HTMLElement) => {
+  const distance = wrapper.scrollHeight - wrapper.scrollTop - wrapper.clientHeight;
+  return distance <= STEPS_WRAPPER_BOTTOM_THRESHOLD;
+};
+
+const handleStepsWrapperScroll = (groupId: string, event: Event) => {
+  const wrapper = event.target as HTMLElement;
+  if (!wrapper) return;
+  const escaped = !isStepsWrapperNearBottom(wrapper);
+  stepsWrapperScrollLocks.set(groupId, escaped);
+};
+
 const registerStepsWrapper = (groupId: string, el: Element | null) => {
+  const prev = stepsWrapperRefs.get(groupId);
+  if (prev) {
+    prev.removeEventListener('scroll', handleStepsWrapperScroll as EventListener);
+  }
   if (el instanceof HTMLElement) {
     stepsWrapperRefs.set(groupId, el);
+    el.addEventListener('scroll', (event) => handleStepsWrapperScroll(groupId, event));
   } else {
     stepsWrapperRefs.delete(groupId);
+    stepsWrapperScrollLocks.delete(groupId);
   }
 };
 
 const scrollStepsWrapperToBottom = (groupId: string) => {
   const wrapper = stepsWrapperRefs.get(groupId);
-  if (wrapper) {
+  if (wrapper && !stepsWrapperScrollLocks.get(groupId)) {
     wrapper.scrollTop = wrapper.scrollHeight;
   }
 };
@@ -853,6 +873,8 @@ const toggleExpand = (groupId: string) => {
     nextTick(() => {
       const group = blockGroups.value.find((g) => g.id === groupId);
       if (group && group.actions) {
+        // 展开时重置锁定：用户新展开的内容默认跟随到底部
+        stepsWrapperScrollLocks.set(groupId, false);
         // 运行中展开时，将展开区滚动到底部
         if (isSummaryRunning(group.actions, groupId)) {
           scrollStepsWrapperToBottom(groupId);
@@ -980,7 +1002,7 @@ watch(
   () => props.actions,
   () => {
     syncToolReels();
-    // 对展开的 running 摘要组，自动将展开区滚动到底部
+    // 对展开的 running 摘要组，若用户未主动向上滚动，自动将展开区滚动到底部
     nextTick(() => {
       blockGroups.value.forEach((group) => {
         if (
@@ -1006,7 +1028,11 @@ watch(
 
 onBeforeUnmount(() => {
   Object.keys(toolReelStates).forEach(clearToolReelTimers);
+  stepsWrapperRefs.forEach((el) => {
+    el.removeEventListener('scroll', handleStepsWrapperScroll as EventListener);
+  });
   stepsWrapperRefs.clear();
+  stepsWrapperScrollLocks.clear();
 });
 </script>