Kiro CLI Plan Agent 是内置规划 agent，用于把模糊想法转成结构化实现计划。它会先澄清需求、研究代码和技术方案，再输出任务拆解，并在用户确认后切回执行模式，适合复杂功能和重构任务。

Kiro CLI Plan Agent：先澄清需求再进入执行

Kiro CLI 的 Plan agent 是一个专门负责规划的内置 agent。它不会一上来就改代码，而是先把想法变成需求、约束、任务拆解和可验证目标。

这很符合“古法编程”的思路：AI 可以执行，但架构决策和任务边界要先讲清楚。和 Kiro 的 spec-driven development 一样，Plan agent 适合在动手前建立共识。

如何进入 Plan agent

快捷键：

Shift + Tab

它可以在 plan mode 和 execution mode 之间切换。

也可以用 slash command：

/plan

带初始需求进入：

/plan Build a REST API for user authentication

进入后，prompt 中会出现 [plan] 标识，并显示欢迎信息。

Plan workflow

Plan agent 的典型流程分为四步。

1. 需求澄清

你给出初始想法后，Plan agent 会通过结构化问题缩小范围。

例如你说：

[plan] > I want to build a todo app

它可能会问：

• 目标平台是 Web、Mobile、Desktop 还是 CLI？
• 主要用途是个人任务、团队协作还是项目管理？
• 是否有特定技术栈或数据存储要求？

这些问题不是走形式。回答越具体，后续计划越不容易变成“泛泛实现”。

2. 研究和分析

Plan agent 会探索代码库并研究相关技术：

能力	说明
Code exploration	读取和搜索现有代码，理解项目结构
Technology research	查找相关框架、库和实现模式
Architecture analysis	分析当前架构和约定

这一步适合大型项目。它能避免 agent 直接写出和现有风格冲突的实现。

3. 生成实现计划

Plan agent 会输出结构化 implementation plan，通常包含：

• Problem statement。
• Requirements。
• Task breakdown。
• 每个任务的目标、实现方向和 demo 标准。

好的 plan 不只是“做 A、做 B、做 C”，还会说明每一步怎样证明完成。例如“CLI 能接受 todo 命令并显示 help”。

4. 审批和交接

Plan agent 在切换到执行前会寻求你的确认。你可以要求调整计划，或者确认进入 execution。

交接过程通常是：

1. 你批准 implementation plan。
2. Kiro 询问是否退出 [plan] agent。
3. 确认后切回之前的执行 agent。
4. 完整 plan 传给执行 agent。

只读设计

Plan agent 是 read-only 的，重点是规划而不是动手改文件。

操作	状态
读取文件	支持
Code intelligence	支持
grep / glob 搜索	支持
Web search	支持
写文件	不支持
执行命令	只支持有限只读命令
MCP tools	不支持

这个限制能避免“还没想清楚就改了代码”。

最佳实践

• 复杂功能、跨文件重构、架构调整时优先使用 Plan agent。
• 认真回答澄清问题，不要急着跳到实现。
• 允许它探索代码库，避免凭空设计。
• 审查计划中的任务边界和验证标准。
• 如果计划不够具体，先迭代计划，再进入 execution。

常见问题

Q: Kiro CLI Plan agent 适合所有任务吗？

A: 不适合。小修小补直接执行更快；复杂功能、重构、架构决策更适合先用 Plan agent。

Q: Plan agent 会修改文件吗？

A: 不会。它是 read-only 设计，用来研究和规划，确认后再交给执行 agent。

Q: 怎么退出 Plan agent？

A: 可以用 Shift + Tab 返回之前的 agent；规划完成后也会提示你确认切回执行模式。