本指南通过一个真实项目带你走完 Kiro 四大核心功能的完整使用流程。Steering 文件为 Kiro 提供项目背景和技术约定；Specs（规范）将需求分解为用户故事、技术设计和可执行任务三个阶段；Hooks 通过文件事件或手动触发自动执行预定义操作；MCP 服务器扩展 Kiro 的工具能力，连接外部 API、知识库和数据库。四者结合可显著提升开发效率和 AI 辅助质量。

本指南通过实际项目演示 Kiro 的核心功能，你将学会如何使用 Steering 文件、Specs 规范、Hooks 自动化和 MCP 服务器来增强开发工作流。

前提条件

开始前，请确认：

• 已安装 Kiro。
• 有一个可以操作的项目（现有项目或新建项目均可）。
• 对项目的目录结构和技术栈有基本了解。

打开项目

1. 启动 Kiro 并打开项目，有以下三种方式：
   • 使用 File > Open Folder 选择项目目录
   • 将项目文件夹拖放到 Kiro 窗口中
   • 在命令行中进入项目目录后运行 kiro .
2. 点击左侧活动栏中的 Kiro Ghost 图标打开 Kiro 面板，所有 AI 功能均通过此面板访问。
3. 聊天窗格默认已打开，这是与 AI 交互的对话界面。

配置 Steering 文件

Steering 文件为 Kiro 提供关于项目的上下文，帮助它理解代码库的结构、约定和要求。

在 Kiro 面板中选择 Generate Steering Docs，Kiro 会自动为你生成项目 Steering 文档，存储在 .kiro/steering/ 目录下，内容包括：

• 产品定位和目标
• 技术栈和使用的框架
• 项目结构和编码约定

你也可以点击 Steering 区域的 + 按钮创建自定义 Steering 文件，加入编码规范、工作流程、团队最佳实践等内容。详情参见 Steering 文档。

用 Specs 构建功能

Specs（规范）将高层功能描述转化为详细的实现计划，分三个阶段推进：

1. 需求（Requirements） — 以 EARS 范式编写的用户故事和验收标准
2. 设计（Design） — 技术架构和实现方案
3. 任务（Tasks） — 可追踪的离散实现步骤

创建你的第一个 Spec

1. 新建 Spec：在聊天会话中点击 Spec 按钮，或在 Kiro 面板的 Specs 区域点击 + 按钮。
2. 输入功能描述：用自然语言描述要实现的功能，例如："添加一个包含登录、登出和密码重置的用户认证系统"。
3. 跟随引导流程：
   • 需求阶段：Kiro 帮助你以 EARS 范式整理需求
   • 设计阶段：生成技术架构和组件设计文档
   • 实现阶段：生成离散的实现任务

执行 Spec 任务

Spec 生成完成后：

1. 查看 tasks.md 中生成的任务列表。
2. 点击单个任务条目开始执行。
3. 任务状态会自动更新为"In Progress"和"Done"，方便追踪进度。

用 Hooks 自动化工作流

Agent Hooks（钩子）通过自动执行预定义操作消除重复手动工作，支持以下触发场景：

• 文件被创建、保存或删除
• 手动触发
• 特定文件模式被修改

创建 Hook 的步骤：

1. 进入 Kiro 面板的 Agent Hooks 区域，点击 + 创建新 Hook。
2. 用自然语言描述要自动化的行为，例如："每次保存 React 组件文件时，自动创建或更新对应的测试文件"。
3. 配置 Hook 参数：
   • Event Type（事件类型）：选择触发时机——文件事件（创建、保存、删除）、Prompt 和 Agent 生命周期事件（Prompt 提交、Agent 停止、工具调用前后）、Spec 任务事件（任务执行前后）或手动触发
   • File Pattern（文件模式）：指定哪些文件触发该 Hook，例如 src/**/*.tsx
   • Instructions（指令）：定义触发后具体执行的操作

用 MCP 扩展 Kiro 能力

Model Context Protocol（MCP）让 Kiro 能够：

• 访问专业知识库和文档
• 与外部 API 和服务集成
• 使用领域专属工具和实用程序
• 连接数据库和云服务

配置 MCP

1. 点击活动栏中的 Kiro Ghost 图标打开 Kiro 面板，先启用 MCP，然后点击面板中 MCP 旁的编辑按钮（铅笔图标）。
2. Kiro 默认附带 fetch MCP server。将其 JSON 配置中的 disabled 改为 false 即可连接。
3. 你也可以让 Kiro 帮你添加新 MCP 服务器，或直接编辑 JSON 配置文件，例如：

{
  "mcpServers": {
    "web-search": {
      "command": "uvx",
      "args": ["mcp-server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "autoApprove": ["search"]
    }
  }
}

使用 MCP 工具

配置完成后，可以通过以下方式使用 MCP 工具：

• 直接提问：直接提出需要 MCP 服务器处理的问题，例如：Search for the latest React 18 best practices
• 显式调用：使用 #MCP 上下文提供器指定工具，例如：`#[fetch] fetch` Use the web search to find examples of TypeScript generic constraints
• 与其他功能组合：将 MCP 与 Hooks 和 Specs 结合使用，例如："创建一个 Hook，当我新建组件文件时用 web search MCP 自动查找相关文档"

下一步

• 尝试互动教程：通过游戏开发教程动手学习
• 深入了解 Specs：查阅 Specs 文档，了解详细概念和工作原理
• 加入社区：在 Discord 服务器 上与其他 Kiro 用户交流经验

常见问题

Q：Steering 文件和普通 README 有什么区别？

README 是给人类开发者看的项目说明，而 Steering 文件是专门为 Kiro AI 设计的上下文文档，内容更侧重于约定、规范和决策背景，帮助 AI 在生成代码时自动遵循项目规则，减少需要手动纠正的情况。

Q：Specs 生成的任务可以手动编辑吗？

可以。tasks.md 是普通 Markdown 文件，可以直接编辑增删任务内容。Kiro 在执行时会读取文件中的实际内容，修改后立即生效。

Q：MCP 服务器需要在每个项目中单独配置吗？

MCP 配置支持全局（用户级）和项目级两个层级。全局配置对所有项目生效；项目级配置存放在项目的 .kiro/ 目录下，只对当前项目生效。推荐通用工具（如 web search）放全局，项目专属工具（如连接特定数据库的 MCP）放项目级配置。