技巧2025年12月22日by admin👁️ 55
Kiro AI 编辑器完整使用指南
Kiro 是由 AWS 推出的一款 AI 驱动的集成开发环境（IDE），专为开发者设计，旨在通过智能辅助提升编码效率和开发体验。
目录
Kiro 简介
Kiro 是一款结合了传统 IDE 功能与 AI 智能辅助的现代化开发工具。它能够：
- 理解用户的系统上下文（操作系统、当前目录等）
- 推荐文件系统和代码编辑
- 建议 Shell 命令
- 提供软件开发相关的帮助和建议
- 协助基础设施代码和配置
- 分析和优化资源使用
- 排查问题和错误
- 编写和修改软件代码
- 测试和调试软件
安装与初始设置
下载安装
- 访问 Kiro 官方网站下载对应操作系统的安装包
- 运行安装程序，按照向导完成安装
- 首次启动时需要登录 AWS 账户或创建新账户
初始配置
首次启动 Kiro 后，建议进行以下配置：
1. 设置工作区目录
2. 配置主题和字体
3. 设置自主模式偏好
4. 配置 MCP 服务器（可选）
核心功能
智能代码补全
Kiro 提供基于 AI 的智能代码补全，能够：
- 根据上下文预测代码
- 提供多行代码建议
- 支持多种编程语言
代码诊断
使用内置诊断工具检查代码问题：
- 语法错误检测
- 类型检查
- Lint 规则验证
- 语义分析
文件操作
Kiro 可以直接操作文件系统：
- 创建、读取、修改、删除文件
- 搜索文件内容
- 批量文件操作
自主模式设置
Kiro 提供两种自主模式，控制 AI 如何与你的代码交互：
Autopilot 模式（自动驾驶）
特点：
- AI 可以自主修改工作区内的文件
- 无需逐一确认每个更改
- 适合信任 AI 建议的场景
- 提高开发效率
Supervised 模式（监督模式）
特点：
- 每次更改后用户有机会回滚
- 更高的控制权
- 适合关键代码或学习阶段
- 更安全的操作方式
切换模式
在 Kiro 设置中可以随时切换这两种模式，根据项目需求和个人偏好选择合适的模式。
聊天上下文功能
Kiro 的聊天功能支持丰富的上下文引用，让 AI 更好地理解你的需求：
文件和文件夹引用
#File - 引用特定文件
#Folder - 引用特定文件夹
图片支持
- 拖拽图片文件到聊天输入框
- 点击聊天输入框中的图片图标上传
其他上下文
#Problems - 引用当前文件的问题/错误
#Terminal - 引用终端输出
#Git Diff - 引用当前 Git 差异
#Codebase - 扫描整个代码库（需要索引完成）
使用示例
用户: 请帮我检查 #File src/app.js 中的错误
用户: 根据 #Problems 修复当前文件的问题
用户: 分析 #Codebase 找出所有未使用的导入
Spec 规格文档
Spec 是 Kiro 中用于结构化构建和记录功能的方式。
什么是 Spec
- 设计和实现过程的形式化文档
- 包含需求、设计和实现任务
- 支持增量开发复杂功能
- 提供控制和反馈机制
Spec 的优势
1. 结构化开发流程
2. 清晰的需求文档
3. 可追踪的实现进度
4. 与 AI 协作的标准化方式
引用外部文件
Spec 文件支持引用其他文件：
#[[file:api/openapi.yaml]]
#[[file:schema/graphql.schema]]
这允许你将 OpenAPI 规范、GraphQL Schema 等文档纳入实现参考。
Hooks 钩子功能
Hooks 允许在特定事件发生时自动触发 AI 执行。
触发事件类型
- 发送消息给 AI 时
- AI 执行完成时
- 创建新会话时（首次发送消息）
- 保存代码文件时
- 手动点击钩子按钮时
钩子动作类型
1. 发送新消息给 AI（提醒或指令）
2. 执行 Shell 命令
使用场景示例
场景 1: 自动测试
- 触发: 保存代码文件时
- 动作: 自动运行相关测试
场景 2: 翻译同步
- 触发: 更新翻译字符串时
- 动作: 同步更新其他语言文件
场景 3: 文档检查
- 触发: 手动点击钩子按钮
- 动作: 检查并修复 README 中的语法错误
管理 Hooks
方式 1: 使用资源管理器视图中的 "Agent Hooks" 部分
方式 2: 使用命令面板搜索 "Open Kiro Hook UI"
Steering 引导规则
Steering 允许在用户与 Kiro 交互时包含额外的上下文和指令。
存储位置
.kiro/steering/*.md
常见用途
- 团队的标准和规范
- 项目的有用信息
- 构建/测试等任务的额外说明
包含模式
1. 始终包含（默认）
<!-- .kiro/steering/coding-standards.md -->
# 编码标准
- 使用 TypeScript 严格模式
- 所有函数必须有 JSDoc 注释
- 变量命名使用 camelCase
2. 条件包含（文件匹配）
---
inclusion: fileMatch
fileMatchPattern: '**/*.test.ts'
---
# 测试规范
- 使用 Jest 框架
- 测试覆盖率需达到 80%
- 每个函数至少一个测试用例
3. 手动包含
---
inclusion: manual
---
# 部署指南
此文档仅在用户明确引用时包含。
引用外部文件
Steering 文件同样支持引用：
#[[file:docs/api-spec.yaml]]
MCP 模型上下文协议
MCP（Model Context Protocol）是 Kiro 扩展功能的重要机制。
配置文件位置
工作区级别: .kiro/settings/mcp.json
用户级别: ~/.kiro/settings/mcp.json
配置优先级
用户配置 < 工作区1 < 工作区2 < ...
（后面的工作区配置会覆盖前面的）
配置示例
{
"mcpServers": {
"aws-docs": {
"command": "uvx",
"args": ["awslabs.aws-documentation-mcp-server@latest"],
"env": {
"FASTMCP_LOG_LEVEL": "ERROR"
},
"disabled": false,
"autoApprove": []
}
}
}
配置字段说明
| 字段 | 说明 |
|---|---|
command |
运行 MCP 服务器的命令 |
args |
命令参数数组 |
env |
环境变量 |
disabled |
是否禁用该服务器 |
autoApprove |
自动批准的工具名称列表 |
安装 uvx
大多数 MCP 服务器使用 uvx 命令运行，需要先安装 uv：
# 使用 pip 安装
pip install uv
# 或使用 Homebrew (macOS)
brew install uv
# 安装指南
# https://docs.astral.sh/uv/getting-started/installation/
管理 MCP 服务器
- 配置更改后服务器会自动重连
- 可通过 Kiro 功能面板中的 MCP Server 视图手动重连
- 使用命令面板搜索 "MCP" 查找相关命令
常用快捷键
通用快捷键
| 快捷键 | 功能 |
|---|---|
Ctrl+Shift+P |
打开命令面板 |
Ctrl+P |
快速打开文件 |
Ctrl+, |
打开设置 |
Ctrl+ ` |
打开/关闭终端 |
AI 相关快捷键
| 快捷键 | 功能 |
|---|---|
Ctrl+L |
打开 AI 聊天面板 |
Ctrl+I |
内联 AI 建议 |
编辑快捷键
| 快捷键 | 功能 |
|---|---|
Ctrl+S |
保存文件 |
Ctrl+Z |
撤销 |
Ctrl+Shift+Z |
重做 |
Ctrl+F |
查找 |
Ctrl+H |
替换 |
最佳实践
1. 有效使用上下文
✓ 使用 #File 引用相关文件
✓ 使用 #Codebase 进行全局分析
✓ 提供清晰的问题描述
2. 合理配置 Steering
✓ 为团队创建统一的编码规范
✓ 使用条件包含减少不必要的上下文
✓ 定期更新和维护 Steering 文件
3. 善用 Spec 功能
✓ 复杂功能使用 Spec 进行规划
✓ 引用 API 文档和 Schema
✓ 分步骤实现，保持可控
4. 配置合适的自主模式
✓ 日常开发使用 Autopilot 提高效率
✓ 关键代码使用 Supervised 确保安全
✓ 根据项目阶段灵活切换
5. 利用 Hooks 自动化
✓ 设置保存时自动运行测试
✓ 配置代码格式化钩子
✓ 创建文档更新提醒
故障排除
MCP 服务器连接失败
# 检查 uvx 是否安装
uvx --version
# 检查配置文件语法
# 确保 JSON 格式正确
# 查看 MCP Server 视图中的错误信息
AI 响应缓慢
1. 检查网络连接
2. 减少上下文引用的文件数量
3. 使用更具体的问题描述
文件操作权限问题
1. 检查文件/文件夹权限
2. 确认工作区信任设置
3. 查看命令信任配置
总结
Kiro 是一款功能强大的 AI 辅助开发工具，通过合理配置和使用其各项功能，可以显著提升开发效率。关键是：
- 理解并善用上下文引用功能
- 根据需求配置合适的自主模式
- 利用 Steering 和 Hooks 实现自动化
- 通过 MCP 扩展更多能力
持续探索和实践，你会发现 Kiro 能够成为你开发过程中的得力助手。