一、【交互模式】 (Interaction Modes) :

什么是Vibe模式 和 Spec模式 ？

Kiro 提供两种截然不同的交互模式，分别对应“快”与“慢”两种思考逻辑。

1.1 Vibe Mode (即时模式)

“像聊天一样直接执行”
【行为】
----------非阻塞式对话。你只需告诉 AI 想做什么，它会立即分析代码库并生成变更。
【适用场景】
----------修复 Bug
----------快速重构
----------添加简单功能
----------代码解释与咨询
【核心体验】
----------流畅、低延迟、所见即所得。

1.2 Spec Mode (规划模式)

“先规划，后执行”
【行为】
----------结构化生成。AI 会生成 需求文档、设计文档 和 任务清单。每一步都需你确认后才会继续。
【适用场景】
----------开发完整的用户功能
----------跨模块的大型重构
----------新项目初始化
----------高可靠性要求的任务
【核心体验】
----------严谨、可追溯、文档驱动。

1.3 模式选择映射表

你的需求	选择模式	对应逻辑	核心体验
“修个 bug”	Vibe⚡	直接执行	即时、同步
“做个功能”	Spec ✅️	需求→设计→任务	严谨、异步
“改下变量名”	Vibe ⚡	直接执行	快速反馈
“重构支付模块”	Spec ✅️	需求→设计→任务	防止回滚

1.4 如何切换模式

二、【上下文管理】 (Steering)

如果说模式决定了 AI 怎么动，Steering 就决定了 AI 知道什么。它是 Kiro 的核心上下文管理机制。

2.1 Steering 的作用

Steering = 项目说明书。它让 AI “记住”项目的背景信息，而不需要你每次对话都重复粘贴。

2.2 核心文件结构

所有 Steering 文件存放在 .kiro/steering/ 目录下：

.kiro/steering/
├── product.md # 产品背景 (做什么)
├── tech.md # 技术栈 (怎么做)
├── rules.md # 编码规范 (怎么写)
└── structure.md # 架构说明 (在哪写)

2.3 编写示例

rules.md (编码规范):

# 前端编码规范

1. **组合式 API**：必须使用 Vue 3 `<script setup>` 语法。
2. **类型安全**：严禁使用 `any`，接口定义在 `types/` 目录。
3. **样式方案**：使用 TailwindCSS，不写手写 CSS。

2.4 上下文引用机制

Kiro 会智能读取 Steering 文件：
自动加载：默认情况下，Kiro 会读取所有 Steering 文件作为基础上下文。
手动引用：使用 # 号可显式引用特定文件，如 #File .kiro/steering/rules.md。

三、【工作流】 (The Spec Workflow)

Spec Mode 是 Kiro 最强大的能力，它通过三个阶段确保复杂任务的成功率。

3.1 三阶段工作流

┌─────────────────────────────────────────────────────┐
│                    Spec 工作流                        │
├─────────────────────────────────────────────────────┤
│  阶段一：需求    阶段二：设计     阶段三：任务        │
│  (Requirements)    (Design)         (Tasks)         │
│       │              │               │              │
│       ▼              ▼               ▼              │
│  requirements.md   design.md       tasks.md         │
│       │              │               │              │
│   用户确认 ✓      用户确认 ✓       自动执行         │
└─────────────────────────────────────────────────────┘

3.2 阶段详解

Phase 1: 需求 (Requirements)

产物：requirements.md
内容：用户故事 (User Stories)、验收标准 (Acceptance Criteria)。
作用：明确“我们要解决什么问题”。

Phase 2: 设计 (Design)

产物：design.md
内容：API 接口定义、数据模型变更、伪代码。
作用：明确“我们如何从技术上解决”。

Phase 3: 任务 (Tasks)

产物：tasks.md
内容：详细的原子任务列表 (Checklist)。
作用：AI 将按此列表逐条执行代码编写。

3.3 文档复用

生成的 Spec 文档保存在.kiro/specs/[功能名]/ 下。这不仅是 AI 的中间产物，更是永久的项目文档，方便团队成员查阅。
总结

掌握了这三个维度，你就掌握了 Kiro 的核心：

Vibe 处理日常琐事。
Spec 攻克复杂碉堡。
Steering 确保方向正确。

接下来，我们将探索 Kiro 的高级能力体系，如何通过自动化和扩展能力进一步提升效率。