Kiro AI 开发助手能力全景指南一、概述Kiro 是一个 AI 驱动的开发环境除了基础的代码编写能力外还提供了多种可配置的扩展机制来增强开发体验。核心能力体系如下能力作用配置位置MCP Server连接外部工具和数据源.kiro/settings/mcp.jsonSteering设定 AI 行为规则和规范.kiro/steering/*.mdHooks事件驱动的自动化操作.kiro/hooks/*.kiro.hookSkills按需激活的专项能力.kiro/skills/*.mdSpecs结构化需求拆解和实现.kiro/specs/注博客https://blog.csdn.net/badao_liumang_qizhi二、MCP Server模型上下文协议2.1 什么是 MCPMCPModel Context Protocol是一种让 AI 代理与外部系统通信的标准协议。配置后 AI 可以直接操作数据库、缓存、版本控制等无需人工复制粘贴。2.2 配置文件位置作用域路径工作区级别.kiro/settings/mcp.json用户全局级别~/.kiro/settings/mcp.json多工作区时后面的 workspace 配置覆盖前面的。2.3 配置结构说明{mcpServers:{服务名称:{command:启动命令npx/uvx/可执行文件路径,args:[命令参数数组],env:{环境变量:值},disabled:false,autoApprove:[]}}}字段说明command启动命令npxNode.js、uvxPython、或本地可执行文件路径args命令参数数组env环境变量传递连接信息、镜像源等disabledtrue临时禁用false启用autoApprove自动批准的工具名列表空数组表示每次都需确认2.4 常用 MCP Server 一览2.4.1 MySQL{mysql:{command:uvx,args:[mcp-server-mysql],env:{MYSQL_HOST:数据库地址,MYSQL_PORT:3306,MYSQL_USER:用户名,MYSQL_PASSWORD:密码,MYSQL_DATABASE:数据库名,UV_INDEX_URL:https://mirrors.aliyun.com/pypi/simple/}}}提供的工具执行 SQL、创建表、插入数据、查询数据、列出表、查看表结构2.4.2 RedisNode.js 版推荐兼容 Redis 5.x{redis:{command:npx,args:[-y,modelcontextprotocol/server-redis,redis://:密码地址:端口/库编号],env:{},disabled:false,autoApprove:[]}}Python 版需要 Redis 6.0{redis:{command:uvx,args:[mcp-server-redis],env:{REDIS_HOST:127.0.0.1,REDIS_PORT:6379,REDIS_DB:0,REDIS_PASSWORD:密码,UV_INDEX_URL:https://mirrors.aliyun.com/pypi/simple/}}}提供的工具set写入、get读取、delete删除、list按模式列出 key常见问题问题原因解决PyPI 下载超时国内网络不通加UV_INDEX_URL镜像源403 Forbidden镜像源限流换阿里云/中科大镜像unknown command ‘HELLO’Redis 版本 6.0改用 Node.js 版Field requiredPython 版需要环境变量在 env 中配置四个必填项2.4.3 Git{git:{command:uvx,args:[mcp-server-git,--repository,项目路径],env:{UV_INDEX_URL:https://mirrors.aliyun.com/pypi/simple/}}}提供的工具status、diff、commit、log、branch、checkout、show 等2.4.4 Fetch网页抓取{fetch:{command:uvx,args:[mcp-server-fetch],env:{PYTHONIOENCODING:utf-8,UV_INDEX_URL:https://mirrors.aliyun.com/pypi/simple/}}}提供的工具fetchURL 抓取HTML 转 Markdown参数说明参数说明url目标 URL必填max_length最大返回字符数默认 5000start_index起始字符位置分页读取raw是否返回原始内容不转 Markdown自定义选项加在 args 中--proxy-urlhttp://127.0.0.1:7890— 代理访问--ignore-robots-txt— 忽略 robots.txt--user-agentYourAgent— 自定义 UA注意Windows 必须加PYTHONIOENCODING: utf-8否则可能超时。2.4.5 其他推荐 MCP Server工具包名用途MongoDBmcp-server-mongodbNoSQL 查询Elasticsearchmcp-server-elasticsearch日志搜索Dockermcp-server-docker容器管理Kubernetesmcp-server-kubernetes集群管理Kafkakafkajs/mcp-server-kafka消息队列调试Sequential Thinkinganthropic/mcp-server-sequential-thinking复杂问题分步推理2.5 国内镜像源汇总镜像URL阿里云 PyPIhttps://mirrors.aliyun.com/pypi/simple/清华 PyPIhttps://pypi.tuna.tsinghua.edu.cn/simple中科大 PyPIhttps://pypi.mirrors.ustc.edu.cn/simple/npm 镜像https://registry.npmmirror.comnpm 镜像配置方式在 env 中加npm_config_registry: https://registry.npmmirror.com三、Steering规则引导3.1 什么是 SteeringSteering 是给 AI 设定的行为准则文件相当于团队编码规范的 AI 版本。AI 在每次对话中会根据配置自动或按需加载这些规则。3.2 配置位置工作区级别.kiro/steering/*.md用户级别~/.kiro/steering/*.md3.3 三种加载模式模式Front-matter 配置触发条件始终加载无默认每次对话自动生效文件匹配inclusion: fileMatchfileMatchPattern操作匹配的文件时生效手动加载inclusion: manual聊天中用#引用时生效3.4 常用 Steering 示例编码规范始终加载—coding-standards.md# Java 编码规范 - 类名 PascalCase方法名 camelCase - 常量 UPPER_SNAKE_CASE - 数据库字段 snake_case - 代码注释使用中文 - 禁止拼音命名 - DTO/VO/Entity 后缀严格区分 - Service 接口XxxService实现类XxxServiceImpl - 方法前缀查询 get/find/query/list创建 create/add/save更新 update/modify删除 delete/remove项目架构说明始终加载—project-architecture.md# 项目架构 Spring Cloud 微服务某服务模块。 ## 分层 - controller → service → mapper → entity - dto: 传输对象 / vo: 视图对象 ## 技术栈 Spring Boot 2.x / MyBatis-Plus / Redis / MySQL / RocketMQGit 提交规范始终加载—git-conventions.md# Git Commit 规范 格式type(scope): subject type: feat / fix / refactor / docs / style / test / chore 示例feat(xx): 新增xx锁定接口Controller 规范文件匹配加载—controller-rules.md--- inclusion: fileMatch fileMatchPattern: **/controller/*.java --- # Controller 规范 - 统一返回 ResultT - GET 查询POST 创建PUT 更新DELETE 删除 - 路径 kebab-case/api/xxx-record - 必须加 ApiOperation 注解 - 参数校验使用 ValidMapper 规范文件匹配加载—mapper-rules.md--- inclusion: fileMatch fileMatchPattern: **/mapper/*.java --- # Mapper 规范 - 继承 BaseMapperT - 复杂 SQL 写 XML - 禁止在 Mapper 中写业务逻辑3.5 引用外部文件Steering 支持引用项目中的其他文件作为上下文# API 设计参考 请参考以下 OpenAPI 规范进行接口开发 #[[file:docs/api-spec.yaml]]四、Hooks自动化钩子4.1 什么是 HooksHooks 是事件驱动的自动化机制。当 IDE 中发生特定事件时自动触发 AI 操作或执行命令。4.2 配置位置.kiro/hooks/*.kiro.hookJSON 格式4.3 支持的事件类型事件触发时机fileEdited用户保存文件时fileCreated用户创建新文件时fileDeleted用户删除文件时userTriggered用户手动点击按钮触发promptSubmit发送消息给 AI 时agentStopAI 执行完成时preToolUse工具执行前postToolUse工具执行后preTaskExecutionSpec 任务开始前postTaskExecutionSpec 任务完成后4.4 支持的动作类型动作说明askAgent发消息给 AI需配置promptrunCommand执行 shell 命令需配置command4.5 常用 Hook 示例写入前代码审查{name:Pre-Write Code Review,version:1.0.0,when:{type:preToolUse,toolTypes:[write]},then:{type:askAgent,prompt:检查代码是否符合编码规范命名、注释、分层等}}保存后编译检查{name:Compile on Save,version:1.0.0,when:{type:fileEdited,patterns:[*.java]},then:{type:runCommand,command:mvn compile -pl . -q}}新文件自动加文件头{name:Auto File Header,version:1.0.0,when:{type:fileCreated,patterns:[*.java]},then:{type:askAgent,prompt:为新建的 Java 文件添加标准文件头注释作者、日期、描述}}SQL 安全审查{name:SQL Safety Review,version:1.0.0,when:{type:preToolUse,toolTypes:[.*sql.*,.*mysql.*]},then:{type:askAgent,prompt:检查 SQL 安全性禁止无 WHERE 的 UPDATE/DELETE禁止 DROP TABLE}}提交前敏感信息检查{name:Secret Check,version:1.0.0,when:{type:preToolUse,toolTypes:[.*git_commit.*]},then:{type:askAgent,prompt:检查暂存变更中是否包含密码、密钥、Token 等敏感信息}}任务完成后跑测试{name:Run Tests After Task,version:1.0.0,when:{type:postTaskExecution},then:{type:runCommand,command:mvn test -pl . -q}}五、Skills技能5.1 什么是 SkillsSkills 是可以在聊天中通过#手动激活的专项能力文档。适合不需要每次都加载、但偶尔需要的专业指导。5.2 配置位置工作区级别.kiro/skills/*.md用户级别~/.kiro/skills/*.md5.3 常用 Skills 示例代码审查技能 —code-review.md# Code Review 按以下维度检查 1. 功能正确性逻辑是否满足需求 2. 性能N1 查询、循环中重复调用 3. 安全SQL 注入、XSS、权限校验 4. 可读性命名、注释、方法长度 5. 异常处理边界情况是否覆盖 6. 并发安全共享资源同步 输出格式 - 严重问题必须修复 - 建议优化 - 优点数据库设计技能 —db-design.md# Database Design - 主键BIGINT 自增 - 必有字段id, create_time, update_time, create_by, update_by, is_deleted - 字段命名snake_case - 索引命名idx_表名_字段名 - 唯一索引uk_表名_字段名 - 金额DECIMAL(18,2) - 状态TINYINT 注释枚举值接口设计技能 —api-design.md# API Design - 响应结构{code: 200, message: success, data: {}} - 分页结构{list: [], total: 100, pageNum: 1, pageSize: 10} - 错误码5 位业务码模块前缀 序号 - Swagger 注解必须完整 - 参数校验Valid NotNull/NotBlank5.4 使用方式在聊天输入框中输入#从列表中选择要激活的 SkillAI 就会按照该 Skill 的指导来执行任务。六、Specs规格文档6.1 什么是 SpecsSpecs 是 Kiro 的结构化开发流程工具将复杂功能拆解为需求 → 设计 → 任务 → 实现的标准流程适合大功能开发。6.2 流程需求文档Requirements ↓ 设计文档Design ↓ 任务列表Tasks ↓ 逐步实现Implementation6.3 适用场景新增一个完整的业务模块如盘点功能涉及多个文件的大功能开发需要跟踪进度的复杂重构团队协作时的需求对齐6.4 特性支持通过#[[file:相对路径]]引用外部文档OpenAPI spec、数据库设计文档等任务可配合 Hooks 实现自动测试支持增量开发每一步都有反馈七、接口测试能力7.1 本地接口测试方式当你写完接口并在本地运行后AI 可以通过以下方式帮你测试方式适用场景需要额外配置终端 curl 命令简单请求快速验证否Python/Node 脚本复杂请求批量测试否mcp-server-fetchGET 请求为主是curl 示例最常用curl-XPOST http://localhost:8080/api/stock/query\-HContent-Type: application/json\-d{wareCode: WH001}7.2 内网文档访问方式适用场景推荐度拖文件进聊天临时查看一份文档⭐⭐⭐⭐⭐#File引用项目内的设计文档⭐⭐⭐⭐⭐.kiro/steering/长期规范、架构说明⭐⭐⭐⭐fetch 无认证 URL内网无登录页面⭐⭐⭐八、推荐项目配置结构针对 Java/Spring Cloud 项目的完整配置建议.kiro/ ├── settings/ │ └── mcp.json # MCP 工具配置 ├── steering/ │ ├── coding-standards.md # 编码规范始终加载 │ ├── project-architecture.md # 架构说明始终加载 │ ├── git-conventions.md # Git 规范始终加载 │ ├── controller-rules.md # Controller 规范文件匹配 │ └── mapper-rules.md # Mapper 规范文件匹配 ├── hooks/ │ ├── pre-write-code-review.kiro.hook # 写入前审查 │ ├── sql-safety-review.kiro.hook # SQL 安全审查 │ └── secret-check.kiro.hook # 提交前检查敏感信息 ├── skills/ │ ├── code-review.md # 代码审查技能 │ ├── db-design.md # 数据库设计技能 │ └── api-design.md # 接口设计技能 └── specs/ # 复杂功能的结构化开发九、快速上手检查清单配置 MCPMySQL、Redis、Git按需加 Fetch创建 Steering编码规范 项目架构说明设置 Hooks写入前审查 SQL 安全检查编写 Skills代码审查 数据库设计国内环境加镜像源PyPI阿里云、npmnpmmirror
