Kiro Subagents 可以把上下文收集、票据分析、代码审查等任务拆给多个子代理并行处理。每个 subagent 有独立上下文窗口，结果会返回主 agent；steering 和 MCP 可用，但 specs 和 hooks 不会在 subagents 中触发。

Kiro Subagents：并行收集上下文和拆分任务

Subagents 让 Kiro 可以并行执行多个任务，或把某些工作委派给更专门的子代理。Kiro 会在合适时自动启动 subagents，你也可以在 prompt 中明确要求：

Run subagents to analyze these tickets in parallel

这类能力适合减少主对话上下文污染。比如同时分析多个 issue、收集不同模块信息、让一个子代理做代码审查，主 agent 只接收汇总结果。

Kiro 内置 subagents

Kiro 有两个内置 subagents：

• context gathering subagent：用于探索项目并收集相关上下文。
• general purpose subagent：用于并行处理其他通用任务。

Subagents 会并行运行，但主 Kiro agent 会等待所有 subagents 完成后再继续。每个 subagent 都有自己的 context window，执行过程中的工具调用和中间细节不会直接污染主 agent 上下文。

Subagents 有哪些限制

官方文档说明：

• Steering files 在 subagents 中可用。
• MCP servers 在 subagents 中可用。
• Subagents 不能访问 Specs。
• Hooks 不会在 subagents 中触发。

这意味着，如果任务强依赖某个 spec 的 requirements、design、tasks，不适合完全交给 subagent。你可以让主 agent 先整理 spec 关键信息，再把独立分析任务拆出去。

什么时候适合用 subagents

适合场景：

• 并行分析多个 tickets。
• 让不同子代理分别看前端、后端、测试。
• 大型项目中先收集多个模块上下文。
• 代码审查、性能检查、安全检查等角色分工。
• 避免把大量搜索结果塞进主上下文。

不适合场景：

• 需要你连续审批每一步的敏感修改。
• 强依赖 hooks 自动触发的流程。
• 强依赖 specs 内部状态的任务。
• 很小的单文件问题，启动 subagent 反而增加开销。

自定义 subagents

你可以创建 markdown 文件定义 custom agent：

• 全局范围：~/.kiro/agents
• 工作区范围：<workspace>/.kiro/agents

文件主体写 agent prompt，frontmatter 写属性。例如创建一个 code reviewer：

---
name: code-reviewer
description: Expert code review assistant.
tools: ["read", "@context7"]
model: claude-sonnet-4
---

You are a senior code reviewer.

## Your Responsibilities
- Review code for correctness, performance, and security

Kiro 会根据 description 自动选择合适的 custom agent。你也可以显式要求：

Use the code-reviewer subagent to find performance issues in my code

Subagents 也会作为 slash commands 出现，因此也可以这样调用：

/code-reviewer find performance issues in my code

frontmatter 属性

常见属性包括：

Attribute	说明	示例
name	agent 名称，必填	code-reviewer
description	用于自动选择 agent 的描述	Expert code review assistant
tools	agent 可访问的工具列表	["@builtin", "@context7"]
model	使用的模型	claude-sonnet-4
includeMcpJson	是否包含所有 MCP tools	true
includePowers	是否包含 Powers 中的 MCP tools	true

tools 可以写 read、write、shell、web、spec、@builtin、@<mcp_server>，也支持通配符，例如 * 或 @figma/*。

常见问题

Q: Kiro subagents 会并行运行吗？

A: 会。Subagents 并行执行，但主 agent 会等它们全部完成后再继续。

Q: Subagents 能访问 Kiro specs 吗？

A: 不能。官方文档说明 subagents 不访问 specs，hooks 也不会在 subagents 中触发。

Q: 什么时候不该用 subagents？

A: 很小的单点问题、需要连续人工审批的敏感修改、强依赖 spec 状态的任务，都不适合过度拆给 subagents。