docs: 收紧子智能体skill为禁止代码编写并强化推荐场景
This commit is contained in:
parent
c4e4e0f576
commit
ad8d3bb155
@ -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)
|
||||
- 不允许修改任何项目源码
|
||||
""")
|
||||
```
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user