第 2 卷

使用专门的子代理

假设您想使用专门的 AI 子代理来更有效地处理特定任务。

步骤：

1.查看可用的子代理

> /agents

这会显示所有可用的子代理并让您创建新的。

2.自动使用子代理 CodeBuddy Code会自动将适当的任务委派给专门的子代理：

> 审查我最近的代码更改是否存在安全问题

> 运行所有测试并修复任何失败

3.明确请求特定子代理

> 使用代码审查子代理检查认证模块

> 让调试器子代理调查用户为什么无法登录

4.为您的工作流创建自定义子代理

> /agents

然后选择"创建新子代理"并按照提示定义：

子代理类型（如 api-designer、 performance-optimizer )

何时使用它

它可以访问哪些工具

它的专门系统提示词

最佳实践：

在 .codebuddy/agents/ 中创建项目特定的子代理以便团队共享

使用描述性的 description 字段以启用自动委派

将工具访问限制为每个子代理实际需要的内容

查看子代理文档了解详细示例

使用计划模式进行安全的代码分析

计划模式指示 CodeBuddy 通过只读操作分析代码库来创建计划，非常适合探索代码库、规划复杂更改或安全地审查代码。

何时使用计划模式

多步骤实现：当您的功能需要编辑许多文件时

代码探索：当您想在更改任何内容之前彻底研究代码库时

交互式开发：当您想与 CodeBuddy 就方向进行迭代时

如何使用计划模式

在会话期间开启计划模式

您可以在会话期间使用快捷键切换权限模式来切换到计划模式：

macOS/Linux：按 Shift+Tab

Windows：按 Alt+M

如果您处于普通模式，按快捷键将首先切换到自动接受模式，终端底部会显示 ⏵⏵ accept

edits on。再次按快捷键将切换到计划模式,显示 ⏸ plan mode on。

以计划模式启动新会话

要以计划模式启动新会话，使用 --permission-mode plan 参数：

bash

codebuddy --permission-mode plan

在计划模式下运行"无头"查询

您也可以使用 -p 直接在计划模式下运行查询（即在"无头模式"中）:

bash

codebuddy --permission-mode plan -p "分析身份验证系统并建议改进"

示例：规划复杂重构

codebuddy --permission-mode plan

> 我需要重构我们的身份验证系统以使用 OAuth2。创建详细的迁移计划。

CodeBuddy 将分析当前实现并创建全面的计划。使用后续问题进行完善：

> 向后兼容性怎么办？

> 我们应该如何处理数据库迁移？

将计划模式配置为默认

json

// .codebuddy/settings.json { "permissions": { "defaultMode": "plan"

} }

查看设置文档了解更多配置选项。

处理测试

假设您需要为未覆盖的代码添加测试。

步骤：

1.识别未测试的代码

> 查找 NotificationsService.swift 中未被测试覆盖的函数

2.生成测试脚手架

> 为通知服务添加测试

3.添加有意义的测试用例

> 为通知服务添加边缘条件的测试用例

4.运行并验证测试