docs: 收紧子智能体skill为禁止代码编写并强化推荐场景

This commit is contained in:
JOJO 2026-04-08 13:01:12 +08:00
parent c4e4e0f576
commit ad8d3bb155

View File

@ -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
- 不允许修改任何项目源码
""")
```