Appearance
Kiro CLI Custom Agents 允许你为不同任务定义专用 agent 配置，包括可用 tools、权限、上下文资源和 MCP servers。它适合代码审查、调试、AWS 管理、文档写作等固定工作流，也能降低权限提示和安全风险。
Kiro CLI Custom Agents：为不同任务定制工具、权限和上下文
Kiro CLI custom agents 让你为不同场景定制 agent 行为。每个 custom agent 都由配置文件定义，说明它能访问哪些 tools、拥有哪些权限、启动时包含哪些上下文。
默认 Kiro CLI 可以访问所有可用 tools，但大多数操作需要用户确认。这更安全，但在高频工作流中可能打断思路。Custom agents 的价值，就是把“哪些工具可信、哪些上下文必要、哪些权限应该限制”提前写清楚。
Custom agents 能解决什么问题
通过 custom agents，你可以：
- 预先批准特定 tools，减少重复确认。
- 限制 tool access，降低复杂度和风险。
- 自动包含相关 context，例如项目文档、配置文件、规范。
- 配置工具行为，例如限定命令、路径或 MCP server。
- 把团队工作流固化成可共享配置。
例如，你可以准备一个 reviewer agent，只能读文件和使用 code intelligence；再准备一个 debugger agent，允许运行测试命令但不允许写生产配置。
使用 custom agents 的收益
- Workflow optimization：为 AWS 管理、code review、debugging 等任务准备专用 agent。
- Reduced interruptions：预先批准低风险工具，减少权限弹窗。
- Enhanced context：自动加载项目文档、配置和系统信息。
- Team collaboration：团队共享 agent 配置，统一开发环境。
- Security control：只开放任务需要的 tools，降低误操作风险。
对中文团队来说，custom agents 可以扮演“团队规范入口”：新人启动指定 agent，就能获得相同上下文和权限边界。
和 MCP、内置 tools 的关系
Custom agents 可以同时使用 Kiro built-in tools 和 MCP tools。
内置 tools 包括：
- 文件操作。
- 命令执行。
- AWS CLI 集成。
- Code Intelligence 等核心能力。
MCP servers 则可以接入外部系统和自定义服务。
Custom agent 可以控制：
- 使用哪些 built-in tools。
- 接入哪些 MCP servers。
- 每个工具是否需要确认。
- 工具命名冲突时如何用 aliases 管理。
这比把所有 MCP 都暴露给默认 agent 更安全，也更容易维护。
什么时候该创建 custom agent
适合创建 custom agent 的场景：
- 某类任务反复出现，例如 code review、测试生成、文档同步。
- 每次都要加载相同项目规则或文档。
- 希望限制 agent 权限，例如只读审查 agent。
- 团队需要共享统一 AI 工作流。
- MCP 工具很多，需要按任务筛选暴露范围。
不适合的场景：
- 一次性小任务。
- 只是临时问一个问题。
- 需求还没稳定，频繁改 agent 配置反而增加成本。
Custom agent 和 prompt 的区别
| 项 | Custom Agent | Prompt |
|---|---|---|
| 作用 | 定义角色、工具、权限和上下文 | 复用一段任务说明 |
| 持久性 | 持久配置 | 持久文本模板 |
| 适合 | 固定工作流和团队协作 | 高频提示词和轻量模板 |
| 权限控制 | 支持 | 不负责权限 |
如果只是复用一段“请审查这段代码”的提示，用 prompt；如果要限制 tools、加载 resources、接入 MCP，就用 custom agent。
与 subagents 配合
Custom agents 也可以作为 subagents 使用。例如主 agent 可以把安全审查交给 security-reviewer，把测试修复交给 tester。
这种组合适合复杂任务：主 agent 负责编排，custom agents 各自按权限和上下文执行专门工作。
下一步
创建 custom agent 前，建议先明确三件事：
- 这个 agent 解决哪类重复任务？
- 它最小需要哪些 tools？
- 哪些 context 应该常驻，哪些应该按需添加？
后续可以继续阅读 Kiro CLI 的 custom agents 创建和配置参考页面。
常见问题
Q: Kiro CLI custom agent 和默认 agent 有什么区别？
A: 默认 agent 更通用；custom agent 可以为特定任务定义 tools、权限、resources 和 MCP 配置。
Q: Custom agents 能提升安全吗？
A: 可以。你可以只开放任务所需工具，并限制高风险操作，减少误用 shell、write 或 AWS 的可能。
Q: 什么时候不需要 custom agent？
A: 一次性小任务或临时问答不需要。只有当某类工作流反复出现、需要固定权限和上下文时才值得创建。