Kiro AI 编程助手使用指南

Kiro AI 编程助手使用指南一、Kiro 是什么Kiro 是一个 AI 驱动的开发环境它能直接编写代码、运行命令、搜索文件、管理项目结构让开发者专注于系统设计、方案探索和决策制定。Kiro 不只是一个聊天机器人它是一个能实际操作你代码库的编程伙伴。官网地址https://kiro.dev/费用价格用量查询见右下角二、核心工作模式2.1 Autopilot 模式自动驾驶Kiro 可以自主修改工作区内的文件无需逐步确认适合信任度高、任务明确的场景子代理Sub-Agent功能仅在此模式下可用2.2 Supervised 模式监督模式每次修改后用户有机会回退变更适合需要逐步审查的场景三、聊天交互技巧3.1 引用文件和文件夹在聊天输入框中使用#前缀可以快速引用上下文语法说明#File引用指定文件将其内容加入上下文#Folder引用整个文件夹结构#Problems引用当前文件的编译/lint 错误#Terminal引用终端输出内容#Git Diff引用当前 Git 变更差异示例请帮我修复 #src/main/java/com/example/Service.java 中的空指针问题3.2 附件支持图片拖拽图片文件到聊天框或点击附件图标上传文档支持 PDF、DOCX 等格式同样拖拽或点击上传Kiro 会自动识别并分析附件内容3.3 高效提问技巧场景推荐写法说明修复 bug“修复 #File 中第 45 行的 NPE”精确定位问题重构代码“将这个方法拆分为两个独立方法”明确意图生成代码“按照项目现有风格新增一个 Service”让 Kiro 匹配现有规范理解代码“解释这个类的职责和调用链”获取分析而非修改注博客https://blog.csdn.net/badao_liumang_qizhi四、Spec规格说明功能Spec 是 Kiro 中结构化构建和文档化功能的方式适合复杂特性的增量开发。4.1 Spec 的工作流程需求阶段— 与 Kiro 迭代讨论需求设计阶段— 确定技术方案和架构任务拆分— 将实现拆分为可执行的小任务逐步实现— Kiro 按任务逐个完成实现4.2 Spec 中引用外部文件在 Spec 文件中可以通过特殊语法引用其他文件参考 API 定义#[[file:openapi.yaml]] 参考数据模型#[[file:src/main/resources/schema.sql]]这样 OpenAPI 规范、GraphQL Schema 等文档可以直接影响实现。4.3 使用场景新功能开发多文件、多层级复杂重构需要分步骤执行需要留下设计文档的场景五、Steering引导规则Steering 文件为 Kiro 提供额外的上下文和指令确保生成的代码符合团队规范。5.1 文件位置.kiro/steering/*.md5.2 三种引入方式方式配置说明始终引入默认行为每次对话都会加载条件引入inclusion: fileMatchfileMatchPattern当匹配文件被读取时加载手动引入inclusion: manual用户通过#手动引用时加载5.3 示例条件引入--- inclusion: fileMatch fileMatchPattern: **/*Mapper.java --- # MyBatis Mapper 编写规范 - 所有 Mapper 接口必须添加 Mapper 注解 - 方法命名遵循 selectXxx / insertXxx / updateXxx / deleteXxx - 复杂查询使用 XML 映射文件5.4 常见用途编码规范和团队约定项目架构说明构建/测试/部署命令说明技术栈和依赖版本约束六、Hooks钩子自动化Hooks 让 Kiro 在特定 IDE 事件发生时自动执行操作。6.1 支持的事件类型事件触发时机fileEdited用户保存文件时fileCreated新建文件时fileDeleted删除文件时promptSubmit发送消息给 Agent 时agentStopAgent 执行完成时preToolUse工具执行前postToolUse工具执行后preTaskExecutionSpec 任务开始前postTaskExecutionSpec 任务完成后userTriggered用户手动触发6.2 支持的动作askAgent— 向 Agent 发送提示词如代码审查提醒runCommand— 执行 Shell 命令如自动 lint、自动测试6.3 示例保存时自动 Lint{name:Lint on Save,version:1.0.0,when:{type:fileEdited,patterns:[*.java]},then:{type:runCommand,command:mvn checkstyle:check}}6.4 示例任务完成后自动测试{name:Run Tests After Task,version:1.0.0,when:{type:postTaskExecution},then:{type:runCommand,command:mvn test}}6.5 管理方式通过资源管理器中的 “Agent Hooks” 面板查看和管理或使用命令面板搜索 “Open Kiro Hook UI”七、MCPModel Context ProtocolMCP 允许 Kiro 连接外部工具服务器扩展其能力。7.1 配置文件位置级别路径用户级全局~/.kiro/settings/mcp.json工作区级.kiro/settings/mcp.json优先级用户配置 工作区配置7.2 配置示例{mcpServers:{aws-docs:{command:uvx,args:[awslabs.aws-documentation-mcp-serverlatest],env:{FASTMCP_LOG_LEVEL:ERROR},disabled:false,autoApprove:[]}}}7.3 安装 uvxMCP 服务器通常通过uvx运行Python 的uv包管理器的一部分# 使用 pip 安装pipinstalluv# 或使用 Homebrewbrewinstalluv安装后uvx会自动下载并运行 MCP 服务器无需额外安装。八、Powers能力扩展Powers 是打包好的文档、工作流引导和可选 MCP 服务器的集合。8.1 操作方式list— 查看已安装的 Powersactivate— 激活 Power获取文档和工具列表use— 调用 Power 中的工具readSteering— 读取 Power 的工作流引导configure— 打开 Powers 管理面板8.2 使用流程先activate获取 Power 的完整信息查看toolsByServer了解可用工具通过use调用具体工具九、省 Token 技巧9.1 精确引用# 好的做法 — 精确指定文件 修复 #src/main/java/.../StockService.java 第 120 行的问题 # 不好的做法 — 模糊描述 帮我看看项目里有没有 bug9.2 分步骤提问复杂任务拆分为多个小请求避免一次性加载过多上下文“先帮我分析 StockService 的结构”“在 allocateStock 方法中添加库存不足的校验”“为新增的校验逻辑编写单元测试”9.3 善用 Steering 文件将重复性的规范说明放入.kiro/steering/中避免每次对话都重复描述编码规范 →coding-standards.md项目结构 →structure.md技术栈 →tech.md9.4 使用条件引入对于只在特定场景需要的规则使用fileMatch条件引入避免始终占用上下文--- inclusion: fileMatch fileMatchPattern: **/*Controller.java --- # Controller 编写规范 ...9.5 利用 #Problems 和 #Git Diff直接引用 IDE 已有的诊断信息而不是让 Kiro 重新分析整个文件请修复 #Problems 中报告的所有类型错误十、常用操作示例10.1 生成文档为 StockService 类生成 JavaDoc 文档注释 根据 #src/main/java/.../api/StockApi.java 生成 API 接口文档10.2 代码生成参照 DeliveryService 的模式新建一个 TransferService 包含 api 接口、controller、service、dao 全套代码10.3 Bug 修复#Terminal 中显示 NullPointerException 堆栈指向 StockServiceImpl 第 234 行请修复10.4 重构将 StockServiceImpl 中超过 200 行的 processOrder 方法 拆分为多个职责单一的私有方法10.5 代码审查审查 #Git Diff 中的变更检查是否有潜在问题10.6 数据库相关根据以下表结构生成对应的 Entity、Mapper 接口和 XML 表名stock_transfer 字段id, from_warehouse_id, to_warehouse_id, sku_code, quantity, status, created_at十一、最佳实践总结原则说明明确意图告诉 Kiro 你要做什么而不是怎么做提供上下文用#引用相关文件减少 Kiro 猜测分步执行复杂任务拆分为小步骤逐步推进利用 Steering团队规范写入 steering 文件一劳永逸善用 Spec大功能用 Spec 管理保持设计和实现的一致性设置 Hooks重复性检查lint、test交给自动化信任但验证Autopilot 模式高效但关键变更建议审查匹配项目风格Kiro 会自动读取现有代码匹配风格但明确指出更好十二、快速上手清单✅ 了解两种工作模式Autopilot / Supervised✅ 学会用#引用文件、文件夹、Problems、Terminal、Git Diff✅ 在.kiro/steering/中添加项目规范文件✅ 尝试创建一个简单的 Hook如保存时 lint✅ 对复杂功能使用 Spec 进行结构化开发✅ 探索 Powers 面板安装有用的扩展能力✅ 根据需要配置 MCP 服务器连接外部工具