Skip to content

Latest commit

 

History

History
233 lines (167 loc) · 5.16 KB

subagents.md

File metadata and controls

233 lines (167 loc) · 5.16 KB

🤖 Subagents 系统

Subagent 是可定制的子代理，用于执行特定类型的任务。Task 工具会根据配置选择合适的子代理执行子任务。

内置 Subagents

Blade 内置 4 个核心子代理：

名称 用途 可用工具
general-purpose 通用任务代理，用于复杂问题研究和多步骤任务 所有工具
Explore 代码探索专家，快速搜索和分析代码库 Glob, Grep, Read, WebFetch, WebSearch
Plan 软件架构师，设计实现计划和架构方案 所有工具
statusline-setup 状态栏配置专家 Read, Edit

general-purpose

通用任务代理，用于复杂问题研究、代码搜索和多步骤任务：

当你搜索关键字或文件时，如果不确定能否在前几次尝试中找到正确匹配，
可以使用此代理来执行搜索。

Explore

代码探索专家，快速搜索和分析代码库：

快速查找文件模式（如 "src/components/**/*.tsx"）
搜索代码关键字（如 "API endpoints"）
回答关于代码库的问题（如 "API 端点是如何工作的？"）

支持三种详细程度：
- quick: 基础搜索
- medium: 中等探索
- very thorough: 全面分析

Plan

软件架构师，设计实现计划：

分析需求
探索代码库理解现有模式
设计分步实现计划
识别关键文件和依赖
考虑架构权衡

自定义 Subagents

配置位置

~/.blade/agents/*.md        # 用户级（全局）
<project>/.blade/agents/*.md  # 项目级（优先级更高）

配置格式

创建 .md 文件，使用 YAML frontmatter 定义元数据：

---
name: code-reviewer
description: Review code for bugs and risks. Use this when you need critical feedback.
tools:
  - Read
  - Grep
  - Glob
color: blue
---

# Code Reviewer

你是一名代码审查专家，专注于发现代码中的问题和风险。

## 审查重点

1. **代码质量** - 可读性、可维护性、命名规范
2. **潜在 Bug** - 边界条件、空值处理、类型安全
3. **安全风险** - 注入攻击、敏感信息泄露
4. **性能问题** - 算法复杂度、内存泄漏

## 输出格式

请按以下格式输出审查结果：

### 问题列表

| 严重程度 | 位置 | 问题描述 | 建议 |
|----------|------|----------|------|
| 高/中/低 | 文件:行号 | 问题描述 | 修复建议 |

### 总结

简要总结代码质量和主要改进建议。

元数据字段

字段 类型 说明
name string 唯一标识（kebab-case）
description string 简要用途，建议包含 "Use this when …"
tools string[] 允许的工具列表，留空则不限制
color string UI 标记颜色（可选）

可用颜色

red, blue, green, yellow, purple, orange, pink, cyan

使用方式

在对话中使用

直接在对话中提出需求，AI 会自动选择合适的子代理：

请帮我审查 src/agent/Agent.ts 的代码

或明确指定子代理：

使用 code-reviewer 代理审查这段代码

通过 Task 工具

AI 会通过 Task 工具调用子代理：

{
  "name": "Task",
  "arguments": {
    "subagent_type": "code-reviewer",
    "query": "审查 src/agent/Agent.ts 的错误处理逻辑"
  }
}

管理命令

/agents         # 打开代理管理器
/agents list    # 列出所有代理
/agents create  # 创建新代理（向导）
/agents help    # 显示帮助

示例配置

测试专家

---
name: test-expert
description: Write and improve tests. Use this when you need to add or fix tests.
tools:
  - Read
  - Grep
  - Glob
  - Write
  - Edit
  - Bash
color: green
---

# Test Expert

你是一名测试专家，专注于编写高质量的测试代码。

## 职责

1. 分析现有代码，识别需要测试的场景
2. 编写单元测试、集成测试
3. 确保测试覆盖边界条件
4. 遵循项目的测试规范和框架

## 测试原则

- 每个测试只测试一个功能点
- 测试名称要清晰描述测试内容
- 使用 AAA 模式（Arrange-Act-Assert）
- 避免测试实现细节

文档专家

---
name: doc-writer
description: Write and improve documentation. Use this when you need to document code or features.
tools:
  - Read
  - Grep
  - Glob
  - Write
color: purple
---

# Documentation Expert

你是一名技术文档专家，专注于编写清晰、准确的文档。

## 文档类型

1. **API 文档** - 函数签名、参数说明、返回值
2. **使用指南** - 快速开始、常见用法
3. **架构文档** - 系统设计、模块关系
4. **注释** - 代码内注释、JSDoc

## 写作原则

- 简洁明了，避免冗余
- 提供实际可用的示例
- 保持与代码同步更新

注意事项

  1. 无状态 - 每次调用使用新的上下文
  2. 权限继承 - 工具权限受主会话权限模式约束
  3. 重新加载 - 修改配置后需重启 Blade 或重新进入 UI

相关资源