Kiro CLI Prompts 提供可复用 prompt 管理能力，支持项目本地 prompts、用户全局 prompts 和 MCP prompts。你可以用 /prompts 创建、编辑、查看详情，再用 @prompt-name 在 chat 中调用，适合沉淀团队工作流。

Kiro CLI Prompts：管理本地、全局和 MCP Prompt

Kiro CLI 的 prompt system 用来管理可复用提示词。它适合把常见工作流固化下来，例如 code review、测试生成、迁移检查、发布前核对等。

和一次性 prompt 不同，prompts 可以跨会话复用；和 agent 不同，prompt 更轻，只封装一段任务说明或模板。

Prompt 类型

Kiro CLI 支持三类 prompts：

类型	说明
Local prompts	当前项目专用，保存在 workspace 中
Global prompts	用户全局可用，跨项目复用
MCP prompts	由 MCP servers 提供，可能带额外能力和参数

如果是团队项目规则，优先用 local prompts；如果是个人常用写作或审查模板，可以放 global prompts。

列出 prompts

/prompts list

它会显示所有可用 prompts，包括名称、描述和来源，并区分 local、global、MCP。

创建 prompt

/prompts create --name name [--content content]

参数说明：

• name：必填，最多 50 个字符。
• --content：可选，直接指定 prompt 内容。

如果提供 --content，Kiro 会直接创建 prompt；如果不提供，则打开默认编辑器编写内容。

Local prompt 会保存到当前 workspace：

.kiro/prompts/

编辑 prompt

/prompts edit name

支持编辑：

• 当前项目 local prompts。
• 用户 global prompts。
• MCP prompts，前提是对应 server 支持编辑。

查看 prompt 详情

/prompts details name

它会展示：

• prompt metadata。
• 参数详情。
• AI 处理前的完整 prompt 内容。
• 参数要求和示例。
• 来源信息：local、global 或 MCP server。

这一步很重要，因为它能让你确认“真正发给模型的内容是什么”。

在 chat 中使用 prompt

创建后，用 @ 前缀调用：

@prompt-name

示例：

@code-review

File references 也使用 @ 语法。如果 @name 同时匹配 prompt 和文件，Kiro 会优先按 prompt 解析。想强制引用文件时，用显式路径，例如：

@./code-review

文件和目录引用

从 v1.26.0 开始，@ 语法也可以引用文件和目录：

> Review @src/auth.rs for security issues
> What's the structure of @crates/agent/?
> Check @"my file.txt" for errors
> Compare @./v1/api.rs with @./v2/api.rs

限制：

• 文件最大 250KB，超出会截断。
• 目录最多 3 层，每层最多 10 项。
• 不支持二进制文件。
• 不支持 glob，例如 @*.rs。
• 不支持行号范围，例如 @file.rs:10-20。
• 不支持 @~ home 展开。

更多见 Kiro CLI File References。

MCP prompt 参数

MCP prompts 可以带参数，本地和全局文件型 prompts 不支持参数。

语法：

@server-name/prompt-name <required-arg> [optional-arg]

先用下面命令查看参数要求：

/prompts details prompt-name

示例：

@dev-tools/analyze "performance issue" "detailed"
@security-tools/scan "web-app" "high-severity"

存储位置和优先级

类型	存储位置	作用域	优先级
Local prompts	project/.kiro/prompts/	当前项目	最高
Global prompts	~/.kiro/prompts/	所有项目	中等
MCP prompts	MCP server 提供	取决于 server	最低

同名 prompt 的优先级：

1. Local prompts。
2. Global prompts。
3. MCP prompts。

这意味着你可以在项目里覆盖全局或 MCP 提供的同名 prompt。

常见问题

Q: Kiro CLI prompt 和 agent 有什么区别？

A: prompt 更轻，主要复用一段任务说明；agent 可以封装更完整的角色、resources、MCP 和工作流。

Q: @name 是 prompt 还是文件？

A: Kiro 优先匹配已知 prompt，其次才是文件和目录。要强制文件路径，用 @./file。

Q: MCP prompts 能传参数吗？

A: 可以。用 @server-name/prompt-name <arg>，参数要求可通过 /prompts details 查看。