Kiro CLI 可以通过 /agent create 或 kiro-cli agent create 创建 custom agent。你可以选择 workspace 或 global 作用域，使用 AI 辅助生成配置，也可以用 --manual 手动编辑 JSON，之后通过 /agent swap 或 kiro-cli --agent 启动。

Kiro CLI 创建 Custom Agent：用 /agent create 定制专用工作流

Custom agents 让你为特定任务定制 Kiro CLI 行为，例如 backend 开发、code review、AWS 管理或文档写作。它们可以定义 tools、权限、resources、MCP servers 和 prompt。

快速创建

在 Kiro CLI chat 中运行：

/agent create

默认会进入 AI-assisted mode，根据你的描述生成完整 agent 配置。流程中会让你输入 agent 名称、描述、作用域，并选择 MCP servers。

示例：

> /agent create

✔ Enter agent name:  · backend-specialist
✔ Enter agent description:  · You are a specialist in backend coding practices
✔ Agent scope · Local (current workspace)
Select MCP servers (use Space to toggle, Enter to confirm): markdown-downloader (node), code-analysis (uv)

✓ Agent 'backend-specialist' has been created and saved successfully!

也可以 inline 提供名称和选项：

/agent create backend-specialist -D "Backend coding specialist" -m code-analysis

或者直接在终端中运行 CLI 命令：

kiro-cli agent create backend-specialist

常用选项

/agent create slash command 和 kiro-cli agent create CLI command 共享部分 flags：

Flag	说明	可用范围
--directory	agent 保存位置	两者都支持
--from	基于模板 agent 创建，隐含 --manual	两者都支持
--description	agent 描述	slash command
--mcp-server	添加 MCP server，可重复	slash command
--manual	使用编辑器手动创建，不用 AI 生成	slash command

保存目录

--directory 支持几个特殊值：

Value	说明
workspace	保存到当前项目 .kiro/agents/
global	保存到 ~/.kiro/agents/，默认值
./path 或 /path	保存到指定路径

团队共享的 agent 建议放 workspace；个人偏好 agent 建议放 global。

手动创建模式

如果你想自己编辑配置，而不是让 AI 生成，可以使用：

/agent create my-agent --manual

Kiro 会打开默认编辑器，并填入基础 agent 配置。

也可以基于已有 agent 创建：

/agent create my-agent --from backend-specialist

这个方式适合复制一个成熟配置后稍作调整，例如把 backend agent 改成 reviewer agent。

Agent 配置示例

Custom agents 使用 JSON 配置文件：

{
  "name": "my-agent",
  "description": "A custom agent for my workflow",
  "tools": ["read", "write"],
  "allowedTools": ["read"],
  "resources": [
    "file://README.md",
    "file://.kiro/steering/**/*.md",
    "skill://.kiro/skills/**/SKILL.md"
  ],
  "prompt": "You are a helpful coding assistant",
  "model": "claude-sonnet-4"
}

这里 tools 表示 agent 可用工具，allowedTools 表示无需确认即可使用的工具。上面配置允许 agent 看见 read/write，但只有 read 免确认。

使用 custom agent

在当前 chat 中切换 agent：

/agent swap

Kiro 会显示可选 agents：

Choose one of the following agents
❯ rust-developer-agent
  kiro_default
  backend-specialist

选择后，prompt 会变成：

[backend-specialist] >

也可以启动 CLI 时直接指定：

kiro-cli --agent my-agent

创建前的判断

创建 custom agent 前，先问自己：

• 这个任务是否会重复出现？
• 它需要哪些最小 tools？
• 哪些 tools 可以免确认，哪些必须保留审批？
• 哪些 resources 是每次都需要的？
• 是否需要 MCP servers？

如果只是一次性任务，直接 chat 或 prompt 更轻；如果是团队工作流，custom agent 更值得。

常见问题

Q: Kiro CLI 怎么创建 custom agent？

A: 在 chat 中用 /agent create，或在终端里运行 kiro-cli agent create <name>。

Q: Local agent 和 global agent 怎么选？

A: 项目或团队专用放 workspace，也就是 .kiro/agents/；个人跨项目使用放 global，也就是 ~/.kiro/agents/。

Q: 可以不让 AI 生成配置，自己写吗？

A: 可以。使用 /agent create my-agent --manual，会打开编辑器让你手动编辑 JSON。