Kiro CLI 的 Experimental 功能适合提前试用新工作流的开发者。本文梳理 /experiment 的管理方式、实验特性场景、启用命令与排障思路，帮助你在不影响主项目的前提下评估 checkpointing、delegate、knowledge、tangent mode 等能力。

Kiro CLI Experimental 实验功能：提前体验高级工作流

Kiro CLI 的 Experimental 功能可以理解为“提前开放的高级能力”。它们已经能在真实开发中使用，但仍处于活跃迭代阶段，行为、配置项或交互方式后续都可能调整。因此，更适合在分支、测试项目或非关键目录里试用，而不是一上来就放进生产流程。

如果你在使用过程中遇到问题，可以通过 kiro issue 向 Kiro 团队反馈。

用 /experiment 管理实验功能

在 Kiro CLI 会话里输入：

/experiment

你会看到一个交互式菜单，可以完成三件事：

• 查看每个实验功能当前是 ON 还是 OFF。
• 选择某个功能并切换启用状态。
• 阅读该功能的简短说明，判断是否适合当前任务。

如果你更习惯命令式配置，也可以直接使用 kiro-cli settings 修改对应开关。Experimental 功能本质上会写入设置，因此启用状态会跨会话保留。

当前可用的实验功能

Knowledge management

命令：/knowledge

Knowledge management 用来把文件、目录或文本内容加入可检索的 knowledge base，让 Kiro 在后续会话中也能找回这些上下文。它适合长期维护的项目文档、配置说明、错误日志、调研资料等内容。

核心能力包括：

• 存储并检索文件、目录和文本内容。
• 使用 semantic search 提升上下文召回质量。
• knowledge base 可以跨聊天会话持久存在。
• 不同 agent 的 knowledge 相互隔离，避免上下文串台。

启用命令：

kiro-cli settings chat.enableKnowledge true

进一步阅读：Knowledge Management

Tangent mode

命令：/tangent 或 Ctrl+T

Tangent mode 适合在主线任务中临时问一个旁支问题。例如你正在让 Kiro 重构一个组件，突然想确认某个 React 概念，就可以进入 tangent mode 提问；退出后，主对话会回到进入前的 checkpoint，不会把旁支讨论塞进主上下文。

核心能力包括：

• 为当前对话创建 conversation checkpoint。
• 临时探索旁支问题或替代方案。
• 返回主线程继续工作。
• 在需要时用 /tangent tail 保留最后一组问答。

启用命令：

kiro-cli settings chat.enableTangentMode true

进一步阅读：Tangent Mode

TODO lists

工具：todo；命令：/todo

TODO lists 让 Kiro 在合适的时候自动创建和维护任务清单。它适合多步骤开发、重构、排障等任务，可以帮助你看到当前进行到哪一步、哪些事项还未完成。

核心能力包括：

• Kiro 可在合适场景自动创建 TODO。
• 支持查看、管理和删除 TODO。
• 可恢复已有 TODO 列表。
• TODO 可跨聊天会话保留。

启用命令：

kiro-cli settings chat.enableTodoList true

进一步阅读：TODO Lists

Thinking tool

Thinking tool 会展示 AI 处理复杂问题时的分步 reasoning 过程。它适合用来理解 Kiro 为什么得出某个结论，或者在调试、学习、方案评审时观察决策链路。

核心能力包括：

• 展示更透明的决策过程。
• 按步骤呈现推理路径。
• 便于调试和学习。
• 帮助你判断结论是否可靠。

启用命令：

kiro-cli settings chat.enableThinking true

进一步阅读：Thinking Tool

Checkpointing

命令：/checkpoint

Checkpointing 为文件改动创建会话级快照，交互方式接近 Git。它会用 shadow git repo 记录当前会话中的文件状态，让你可以查看 checkpoint、比较差异，或者回滚到某个状态。

核心能力包括：

• 把文件改动保存为 shadow git repo 中的快照。
• 支持 list、expand、diff、restore、clean 等操作。
• restore 时会同步回退对话历史，保持文件状态和上下文一致。
• 在 Git 仓库中会自动启用；非 Git 目录可手动初始化。

启用命令：

kiro-cli settings chat.enableCheckpoint true

常用命令：

/checkpoint list                    # 查看 checkpoints
/checkpoint expand <tag>            # 查看某个 checkpoint 的详细信息
/checkpoint diff <tag1> [tag2]      # 比较两个 checkpoint
/checkpoint restore [<tag>]         # 恢复到某个 checkpoint
/checkpoint clean                   # 删除当前会话的 shadow repo

进一步阅读：Checkpointing

Context usage percentage

Context usage percentage 会在聊天提示符里显示上下文窗口使用比例，例如 [rust-agent] 6% >。颜色也会随使用量变化，帮助你判断是否接近上下文上限。

核心能力包括：

• 在 prompt 中显示百分比。
• 低于 50% 显示绿色，50% 到 89% 显示黄色，90% 到 100% 显示红色。
• 方便长会话中监控 context 消耗。

启用命令：

kiro-cli settings chat.enableContextUsageIndicator true

Delegate

Delegate 用来启动和管理异步后台任务，让 Kiro 在主对话之外并行运行特定 agent 或聊天会话。它适合测试、构建、代码分析、文档生成等耗时但相对独立的任务。

核心能力包括：

• 用自然语言创建后台任务。
• 让特定 agent 在并行会话中执行任务。
• 独立查看任务进度和结果。
• 对 agent 执行加入审批流程，降低误授权风险。

启用命令：

kiro-cli settings chat.enableDelegate true

使用示例：

Can you create a background task to analyze the performance of our API endpoints?

稍后查看结果：

Check the status of my API analysis task
Show me the results from the background analysis

进一步阅读：Delegate

通过 settings 管理开关

你可以列出所有实验相关配置：

kiro-cli settings list | grep -i enable

也可以单独启用或关闭某项能力：

kiro-cli settings chat.enableKnowledge true
kiro-cli settings chat.enableTangentMode true
kiro-cli settings chat.enableTodoList true
kiro-cli settings chat.enableThinking true
kiro-cli settings chat.enableCheckpoint true
kiro-cli settings chat.enableContextUsageIndicator true
kiro-cli settings chat.enableDelegate true

如果要关闭某项功能，把最后的 true 改成 false 即可。

在 fuzzy search 中调用实验命令

启用后，实验命令也可以通过 fuzzy search（Ctrl+S）找到：

• /experiment：管理 Experimental 功能。
• /knowledge：knowledge base 相关命令。
• /todo：TODO list 相关命令。
• /tangent：进入或退出 tangent mode。
• /checkpoint：checkpointing 相关命令。

使用建议

1. 先在安全环境中试用：Experimental 功能可能会修改文件或影响会话上下文，建议先在测试目录中验证。
2. 明确每项功能解决的问题：例如 checkpointing 解决回滚，delegate 解决并行任务，不要为了新鲜感全部打开。
3. 保留项目备份：尤其是涉及文件恢复、TODO 自动写入或后台任务执行时。
4. 遇到异常及时反馈：使用 kiro issue 提交问题和建议。
5. 关注发布说明：Experimental 功能的命令、参数和默认行为可能随版本变化。

常见排障

功能已经启用，但命令不可用怎么办？

先确认对应设置是否生效：

kiro-cli settings list | grep -i enable

如果仍不可用，可以尝试关闭后重新启用，再重启 Kiro CLI。

/knowledge、/tangent 这类命令为什么找不到？

这些命令只有在对应实验功能启用后才会出现。比如 /knowledge 依赖 chat.enableKnowledge，/tangent 依赖 chat.enableTangentMode。

是否建议一次性启用所有 Experimental 功能？

不建议。更稳妥的做法是按任务启用：需要长期上下文时开 knowledge，需要安全试错时开 checkpointing，需要并行任务时开 delegate。这样更容易定位问题，也能减少不必要的上下文和权限复杂度。

常见问题

Experimental 功能可以用于正式项目吗？

可以试用，但建议先在分支或非关键目录验证。它们仍处于实验阶段，最好不要把关键交付完全依赖在尚未稳定的行为上。

启用设置会不会只对当前会话有效？

不会。Experimental 功能的开关通过 settings 保存，通常会跨会话保留，直到你手动关闭。

我应该先学哪几个功能？

建议从 checkpointing、tangent mode 和 knowledge 开始。前者保护文件改动，中间者保护主对话上下文，后者增强长期项目记忆，都是日常开发中比较容易感知价值的能力。