Slash 命令（斜杠命令）是 Kiro CLI 交互对话模式中的快捷操作集合，以 / 开头。本文完整列出所有可用命令，涵盖 /help（帮助 Agent）、/agent（切换/创建 Agent）、/chat（会话管理）、/context（上下文控制）、/model（模型切换）、/checkpoint（工作区快照）、/knowledge（知识库）、/tools（工具权限）、/compact（压缩上下文）、/code（代码智能）、/plan（规划 Agent）等，以及基于 .kiro/skills/ 的自定义技能命令和常用键盘快捷键。

基本用法

Slash 命令仅在交互对话模式中可用：

kiro chat
> /help

帮助与退出

/help

切换到帮助 Agent，回答关于 Kiro CLI 功能的问题，或显示传统帮助文本。

# 切换到帮助 Agent
> /help

# 直接提问
> /help How do I configure MCP servers?

# 显示传统帮助文本
> /help --legacy

# 查看特定命令的帮助
> /help --legacy /context

详见 帮助 Agent。

/quit

退出交互对话会话。

> /quit

别名：/exit、/q

/clear

清除当前对话显示内容。

> /clear

注意：仅清除界面显示，不影响已保存的会话内容。

会话管理

/chat

管理对话会话，包括保存、加载和切换。Kiro CLI 在每次对话轮次后自动保存会话。

# 开启新对话（不退出 CLI）
> /chat new

# 以初始提示开启新对话
> /chat new how do I set up a React project

# 打开交互式选择器恢复历史会话
> /chat resume

# 保存当前会话到文件
> /chat save /myproject/codereview.json

# 从文件加载会话
> /chat load /myproject/codereview.json

子命令：

• new — 开启新对话，可选附带初始提示；使用 /chat resume 可回到历史会话
• resume — 交互式选择要恢复的历史会话
• save — 保存当前会话到文件
• load — 从文件加载会话（.json 扩展名可省略）
• save-via-script — 通过自定义脚本保存（脚本从 stdin 接收 JSON）
• load-via-script — 通过自定义脚本加载（脚本将 JSON 输出到 stdout）

自定义会话存储示例（保存到 Git notes）：

#!/bin/bash
set -ex
COMMIT=$(git rev-parse HEAD)
TEMP=$(mktemp)
cat > "$TEMP"
git notes --ref=kiro/notes add -F "$TEMP" "$COMMIT" --force
rm "$TEMP"
echo "Saved to commit ${COMMIT:0:8}" >&2

从 Git notes 加载会话：

#!/bin/bash
set -ex
COMMIT=$(git rev-parse HEAD)
git notes --ref=kiro/notes show "$COMMIT"

/save

保存当前对话到文件（是 /chat save 的简写形式）。

/load

加载已保存的对话（是 /chat load 的简写形式）。

上下文与模型

/context

管理上下文文件，查看上下文窗口使用情况。上下文规则决定哪些文件被纳入当前 Kiro 会话。

# 显示上下文规则配置和匹配文件
> /context show

# 添加上下文规则（文件名或 glob 模式）
> /context add src/app.js
> /context add "*.py"
> /context add "src/**/*.js"

# 移除指定规则
> /context remove src/app.js

# 清除所有规则
> /context clear

注意：

• 上下文变更在对话会话结束后不会保留；如需永久生效，请编辑 Agent 配置文件
• 匹配的文件为 Kiro 提供关于项目或环境的额外信息

详见 上下文管理。

/model

为当前会话选择 AI 模型。

# 打开交互式模型选择器
> /model

# 直接指定模型名称
> /model claude-opus-4.6

# Tab 补全模型名称
> /model clau<Tab>

# 将当前模型设为所有会话的默认模型
> /model set-current-as-default

特性：

• Tab 补全实时从 API 获取可用模型列表
• 支持模糊匹配，在精确名称未找到时提示相似模型
• 大小写不敏感

set-current-as-default 会将当前模型写入 ~/.kiro/settings/cli.json，后续所有会话自动使用。

Agent 管理

/agent

管理 Agent 并在不同 Agent 配置之间切换。

# 列出所有可用 Agent
> /agent list

# 创建新 Agent（默认 AI 辅助生成）
> /agent create my-agent

# 创建时指定描述和 MCP 服务器
> /agent create my-agent -D "Code reviewer" -m code-analysis

# 用编辑器手动创建
> /agent create my-agent --manual

# 在指定目录创建
> /agent create my-agent --directory workspace

# 编辑当前 Agent
> /agent edit

# 编辑指定 Agent
> /agent edit my-agent

# 通过文件路径编辑
> /agent edit --path /absolute/path/to/my-agent.json

# 显示 Agent 配置 schema
> /agent schema

# 设置默认 Agent（无参数时弹出选择器）
> /agent set-default my-agent

# 运行时切换到另一个 Agent
> /agent swap code-reviewer

要点：

• Agent 可以存放在全局 ~/.kiro/agents/ 或工作区的 .kiro/agents/
• 内置 Agent（kiro_default、kiro_help、kiro_planner）不可编辑
• 编辑时使用临时文件；验证失败不会覆盖原配置文件

详见 自定义 Agent。

代码智能

/code

管理代码智能配置，初始化 LSP 服务器，获取工作区概览。

# 在当前目录初始化 LSP 代码智能
> /code init

# 强制重新初始化（重启 LSP 服务器）
> /code init -f

# 获取工作区完整概览
> /code overview

# 精简输出
> /code overview --silent

# 查看工作区状态及 LSP 服务器状态
> /code status

# 查看 LSP 日志（默认最近 20 条 ERROR）
> /code logs

# 指定日志级别和数量
> /code logs -l INFO -n 50

# 导出日志到文件
> /code logs -p ./lsp-logs.json

工具与权限

/tools

查看工具列表和权限状态，控制哪些工具可以无需确认直接使用。

# 查看所有工具、token 估算和权限状态
> /tools

# 显示所有工具的输入 schema
> /tools schema

# 信任某个工具（本次会话有效）
> /tools trust write

# 撤销某个工具的信任
> /tools untrust write

# 信任所有工具
> /tools trust-all

# 重置所有工具的权限到默认状态
> /tools reset

输出列说明：

• ~Tokens — 工具 schema 的估算 token 数（1000 以上显示为 k）
• Permission — 当前权限状态：Trusted（已信任）、Ask（每次询问）、Allowed（已放行）
• Total — 每个来源（原生工具、各 MCP 服务器）的合计 token 数

如需永久配置工具权限，参见 Agent 配置参考。

规划与任务

/plan

切换到 Plan Agent，将复杂想法拆解为可执行的实施方案。

# 切换到 Plan Agent
> /plan

# 切换时附带初始提示
> /plan Build a REST API for user management

Plan Agent 专注于将复杂想法拆解为可操作的实施计划。使用 Shift+Tab 返回上一个 Agent。

/todos

查看、管理和恢复 ToDo 列表。

> /todo
> /todo add "Fix authentication bug"
> /todo complete 1

知识库

/knowledge

管理语义搜索知识库，用于跨文件和目录的内容检索。

# 查看所有知识库条目
> /knowledge show

# 添加文件或目录
> /knowledge add --name my-docs --path ./docs

# 添加时指定包含/排除模式
> /knowledge add --name src --path ./src --include "*.ts" --exclude "*.test.ts"

# 搜索知识库
> /knowledge search "authentication flow"

# 移除某个条目
> /knowledge remove ./docs

# 重新索引某个条目
> /knowledge update ./docs

# 清空整个知识库（需确认）
> /knowledge clear

# 取消后台索引操作
> /knowledge cancel

注意：这是实验性功能，需先开启：kiro-cli settings chat.enableKnowledge true

详见 知识库管理。

工作区 Checkpoint

/checkpoint

管理工作区快照，用于追踪和恢复文件变更。

# 初始化 checkpoint
> /checkpoint init

# 列出所有 checkpoint
> /checkpoint list

# 恢复到某个 checkpoint（交互式选择）
> /checkpoint restore

# 恢复到指定 checkpoint
> /checkpoint restore 2

# 精确恢复（删除 checkpoint 之后创建的文件）
> /checkpoint restore 2 --hard

# 查看 checkpoint 详情
> /checkpoint expand 1

# 查看两个 checkpoint 之间的差异
> /checkpoint diff 1 2

# 清理 checkpoint 数据
> /checkpoint clean

工作机制：

• 通过 shadow bare git 仓库追踪文件变更
• 每轮对话以及每次工具调用都会创建子快照
• 恢复到 checkpoint 时，对话历史同步回退
• 在 git 仓库中自动启用（临时模式）；非 git 目录可手动初始化

恢复模式：

• 默认：回滚已追踪的修改和删除，保留快照后新建的文件
• Hard 模式（--hard）：精确匹配快照状态，删除快照后新建的文件

注意：这是实验性功能，需先开启：kiro-cli settings chat.enableCheckpoint true

会话与上下文工具

/compact

压缩对话历史，释放上下文窗口空间。

> /compact

AI 会生成当前对话的摘要并替换消息历史，在接近上下文限制时非常有用。

/editor

打开默认编辑器编写较长的提示语。

> /editor

打开 $EDITOR（未设置时默认 vi），保存退出后发送消息。适合编写多行指令或粘贴大段代码。

/reply

在编辑器中打开 AI 上一条消息，方便引用回复。

> /reply

打开 $EDITOR 并预填最近一条 AI 响应，便于对特定部分提出问题或反馈。

/paste

将剪贴板中的图片粘贴到对话中。

> /paste

支持 PNG、JPEG 等常见图片格式，可用于分析截图、图表、错误信息等视觉内容。

/transcript

在分页器中打开完整对话记录。

> /transcript

在 $PAGER（默认 less，Windows 下为 notepad）中查看完整对话历史。按 q 退出并返回对话。也可通过 Ctrl+T 触发。

实用工具

/prompts

查看和管理提示模板。提示模板由已安装的 MCP 服务器提供。

# 列出所有可用提示
> /prompts list

# 查看某个提示的详情
> /prompts details code-review

# 获取并使用某个提示
> /prompts get code-review [arg]

# 快捷方式（不加 /prompts get 前缀）
> @code-review [arg]

# 创建本地提示
> /prompts create my-prompt

# 编辑本地提示
> /prompts edit my-prompt

# 删除本地提示
> /prompts remove my-prompt

/copy

复制最近一条 AI 响应到剪贴板。

> /copy

包含工具调用过程中的所有片段。通过 OSC 52 转义序列支持 SSH 和终端复用器（tmux、Zellij）。超过 100KB 的内容不会复制，以避免终端截断。

/mcp

查看当前活跃的 MCP 服务器、可用工具及注册表状态。

> /mcp

/hooks

显示当前会话中活跃的上下文 Hook。

> /hooks

/usage

查看账单和配额使用情况。

> /usage

/theme

覆盖提示文本和响应文本的颜色主题。

> /theme

/tangent

创建对话 checkpoint，用于探索侧边话题而不干扰主对话。

> /tangent

进入或退出 tangent 模式。也可通过 Ctrl+T 触发（需先启用 tangent 模式）。

/experiment

切换实验性功能的开关状态。

> /experiment

/issue

创建新的 GitHub Issue 或功能请求。

> /issue

/logdump

生成包含日志的 zip 文件，用于问题排查和提交支持工单。

# 打包对话日志
> /logdump

# 同时包含 MCP 服务器日志
> /logdump --mcp

输出文件格式：q-logs-YYYY-MM-DDTHH-MM-SSZ.zip（在当前目录生成）

包含内容：

• logs/kiro-chat.log — 主对话日志（始终包含）
• logs/mcp.log — MCP 服务器日志（仅 --mcp 标志时包含）

注意：分享日志前请先检查内容，日志可能包含文件路径和对话历史。

/changelog

查看 Kiro CLI 的更新日志。

> /changelog

技能 Slash 命令

.kiro/skills/ 和 ~/.kiro/skills/ 目录中定义的技能会自动注册为 Slash 命令：

# 调用名为 "pr-review" 的技能
> /pr-review

# 调用名为 "cdk-deploy" 的技能
> /cdk-deploy

详见 Agent 技能。

键盘快捷键

在交互模式中可使用以下快捷键：

快捷键	功能
Ctrl+C	取消当前输入 / 退出会话
Ctrl+D	退出会话
Ctrl+D/U	在子 Agent 监控面板之间导航
Ctrl+G	打开子 Agent 执行监控
Ctrl+J	插入换行（所有终端含 tmux）
Ctrl+O	展开折叠的 Shell 输出
Ctrl+R	反向增量历史搜索
Ctrl+S	模糊搜索命令和上下文文件，Tab 多选
Ctrl+T	切换 tangent 模式（需先启用）
Alt+Enter	插入换行（Terminal.app、Ghostty）
Alt+Backspace	删除上一个单词
Shift+Enter	插入换行（iTerm2、Ghostty、Kitty、Warp、Zed）
Shift+Tab	进入 Plan 模式
↑/↓	浏览命令历史
Tab	进入权限确认详情 / 自动补全文件引用
Esc	关闭面板、取消 Agent 执行、清空提示队列

常见问题

Q：/chat new 和 /clear 有什么区别？

A：/clear 只清除界面显示，已保存的会话内容不受影响，重启或恢复后历史仍在。/chat new 则真正开启一次全新的对话，当前会话会自动保存，新对话从空白状态开始，两者完全独立。

Q：/context 添加的文件规则如何才能在下次启动时生效？

A：/context add 添加的规则仅对当前会话有效，会话结束后自动清除。要永久生效，需要直接编辑 Agent 配置文件（~/.kiro/agents/ 或 .kiro/agents/ 中对应的 .json 文件），在 contextFiles 字段中添加对应的文件或 glob 规则。

Q：/agent swap 和重新启动时指定 --agent 有什么区别？

A：/agent swap 在当前会话中实时切换 Agent，上下文和对话历史会继续保留（但新 Agent 的工具配置和权限立即生效）。--agent 是在启动时指定初始 Agent，从全新会话开始。如果你只是想临时换个 Agent 测试某个功能，用 /agent swap 更方便；如果需要完整隔离的新会话，用 kiro-cli chat --agent 启动。