From ad8d3bb15598ed2cdc983a88c9874212f319f865 Mon Sep 17 00:00:00 2001
From: JOJO <1498581755@qq.com>
Date: Wed, 8 Apr 2026 13:01:12 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=94=B6=E7=B4=A7=E5=AD=90=E6=99=BA?=
 =?UTF-8?q?=E8=83=BD=E4=BD=93skill=E4=B8=BA=E7=A6=81=E6=AD=A2=E4=BB=A3?=
 =?UTF-8?q?=E7=A0=81=E7=BC=96=E5=86=99=E5=B9=B6=E5=BC=BA=E5=8C=96=E6=8E=A8?=
 =?UTF-8?q?=E8=8D=90=E5=9C=BA=E6=99=AF?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 agentskills/sub-agent-guide/SKILL.md | 41 +++++++++++++++-------------
 1 file changed, 22 insertions(+), 19 deletions(-)

diff --git a/agentskills/sub-agent-guide/SKILL.md b/agentskills/sub-agent-guide/SKILL.md
index d43fa71..026c6d7 100644
--- a/agentskills/sub-agent-guide/SKILL.md
+++ b/agentskills/sub-agent-guide/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: sub-agent-guide
-description: 子智能体使用指南。创建子智能体之前必须阅读此技能。子智能体用于并行处理多个完全独立的任务，如：并行生成多个模块的文档、同时进行多个网络调研、大范围信息搜集（分析项目认证实现、收集系统信息）。关键限制：子智能体之间无法通信，看不到主对话历史，只能通过文件共享信息。不适合需要协作或精细控制的任务（如代码重构）。
+description: 子智能体使用指南。创建子智能体之前必须阅读此技能。子智能体仅用于并行处理独立的“非代码编写”任务（如项目初步探索、网络搜索与信息收集、程序测试执行）。关键限制：子智能体之间无法通信，看不到主对话历史。严格禁止将子智能体用于项目代码编写、代码修改、重构或实现功能。
 ---
 
 # 子智能体使用指南
@@ -11,19 +11,22 @@ description: 子智能体使用指南。创建子智能体之前必须阅读此
 
 子智能体拥有完整工具能力，但与主智能体和其他子智能体完全隔离。它们看不到你的对话历史，无法互相通信，只能通过文件系统共享信息。
 
+**硬性限制：子智能体严格禁止用于项目代码编写/修改。**
+
 ## 何时使用
 
-**适合：**
-- **并行独立任务**：同时生成3个不同模块的文档、并行测试多个功能
-- **大范围信息搜集**：分析项目的前后端认证实现、收集系统硬件信息（CPU/GPU/内存）
-- **网络调研**：搜索并整理英伟达2025财报、对比 Claude 和 ChatGPT 最新模型
-- **耗时分析任务**：大规模日志分析、代码库依赖关系梳理
+**适合（推荐）：**
+- **项目初期探索**：快速梳理目录结构、模块职责、运行方式，形成初步认知
+- **占用大量上下文的网络搜索和信息收集**：竞品调研、资料汇总、文档整理、新闻/资料比对
+- **程序测试与验证**：执行测试命令、收集日志、汇总失败用例与错误模式
+- **并行独立的文档/分析任务**：生成说明文档、运行报告、排查清单
 
 **不适合：**
 - 任务之间需要频繁协调（子智能体无法互相通信）
 - 简单快速的任务（创建子智能体有开销）
 - 需要你参与决策的任务（子智能体是自主运行的）
-- 代码重构等需要精细控制的任务（建议自己完成）
+- 任何项目代码编写、代码修改、代码重构、功能实现任务（必须由主智能体处理）
+- 任何会直接改动项目源码的开发工作
 
 ## 任务描述的艺术
 
@@ -73,7 +76,7 @@ description: 子智能体使用指南。创建子智能体之前必须阅读此
 ```
 sub_agent_results/task_description/  # 清晰描述任务
 sub_agent_results/module_a_docs/     # 按模块组织
-sub_agent_results/refactor_auth/     # 按功能组织
+sub_agent_results/test_auth_report/  # 按测试/报告组织
 ```
 
 **避免：**
@@ -194,8 +197,8 @@ create_sub_agent(agent_id=2, task="分析后端鉴权实现", deliverables_dir="
 
 ```python
 # ❌ 不好的并行：需要协作
-create_sub_agent(agent_id=1, task="收集数据", ...)
-create_sub_agent(agent_id=2, task="分析数据", ...)  # 依赖子智能体1的结果
+create_sub_agent(agent_id=1, task="收集日志", ...)
+create_sub_agent(agent_id=2, task="基于子智能体1的日志结论生成报告", ...)  # 依赖子智能体1的结果
 # 子智能体2不知道子智能体1什么时候完成，无法协调
 ```
 
@@ -205,8 +208,8 @@ create_sub_agent(agent_id=2, task="分析数据", ...)  # 依赖子智能体1的
 
 ❌ **错误：**
 ```python
-create_sub_agent(agent_id=1, task="实现功能 A，完成后通知子智能体2")
-create_sub_agent(agent_id=2, task="等待子智能体1完成，然后实现功能 B")
+create_sub_agent(agent_id=1, task="收集 A 类日志并通知子智能体2")
+create_sub_agent(agent_id=2, task="等待子智能体1完成，然后汇总 B 类报告")
 ```
 
 子智能体之间无法通信。如果任务有依赖，应该：
@@ -217,18 +220,18 @@ create_sub_agent(agent_id=2, task="等待子智能体1完成，然后实现功
 
 ❌ **错误：**
 ```python
-# 你在对话中说："我们要重构认证模块，使用 JWT 替代 Session"
-create_sub_agent(task="按照我们讨论的方案重构认证模块")
+# 你在对话中说："我们要排查认证流程问题"
+create_sub_agent(task="按照我们讨论的方案排查认证流程")
 ```
 
 ✅ **正确：**
 ```python
 create_sub_agent(task="""
-重构 src/auth/ 目录的认证模块：
-- 移除基于 Session 的认证
-- 实现基于 JWT 的认证
-- 保持 API 接口不变
-- 更新相关测试
+排查 src/auth/ 目录认证流程：
+- 梳理认证相关入口、调用链和关键配置
+- 运行现有测试并记录失败项
+- 生成诊断报告（auth_diagnosis.md）
+- 不允许修改任何项目源码
 """)
 ```