本文是"边玩边学"系列的第二篇，介绍 Kiro 的两个核心概念：steering 文件和 vibe coding。首先通过命令面板让 Kiro 自动生成 product.md、tech.md、structure.md 三个 steering 文件，让 AI 在后续所有交互中都能理解项目背景；然后用自然语言提示词改进游戏主页（添加图片、营销文案等），Vite 热更新让修改实时可见。核心收获：动手前先给 AI 建立上下文，让 AI 快速探索创意原型。

本模块假设你已按照环境搭建说明在本地启动了游戏。

理解问题

在浏览器中打开 localhost:5173，看看游戏主页。你会发现这个主页非常简陋：没有图片，没有对游戏的说明，也没有任何营销文案。这是一个典型的"vibe coding"任务。

设置 Kiro Steering 文件

但在"vibe"之前，我们必须先做准备工作。由于这个游戏相当复杂，提前让 Kiro 了解项目是什么、用了哪些技术、代码如何组织，会极大地提升后续交互的质量。

按 Control/Command + Shift + P 打开命令面板，搜索 "Steering"，选择 "Kiro: Generate project steering documents"。

Kiro agent 会开始探索仓库中的关键文件，然后生成描述项目的 steering 文件。这些文件会在未来所有 agent 交互中持续生效，让响应更快、更准确。

生成完成后，查看 .kiro 目录，你应该看到以下文件：

• product.md — 描述项目是什么，帮助 Kiro 理解整体目标
• tech.md — 描述项目使用的所有技术，避免 Kiro 推荐与你已有技术栈冲突的方案
• structure.md — 描述关键目录和代码区域，帮助 Kiro 更快找到正确位置

开始改进主页

steering 文件设置好后，尝试一个基础的 vibe coding 提示词：

I want you to make my homepage better.

游戏客户端由 Vite 提供服务，Kiro 的每次修改都会实时反映在页面上。

发挥创意

让 AI 帮你想方向：

Give me 20 potential themes for a game landing page.

从 Kiro 给出的主题中选一个，然后要求它重新设计主页：

Redesign the homepage with the [主题名] theme.

快速尝试几个不同方向，保留你喜欢的，舍弃不满意的。

---

本模块的核心收获：

1. steering 文件是首要准备工作。在开始任何复杂任务之前，先给 AI 建立项目上下文，后续所有交互都会更准确。
2. AI 可以大幅降低实验成本。几秒钟生成一个新方向，快速筛选，不必为"想法不成熟"而顾虑。

进入下一个任务：

调查并修复物理引擎的 Bug

常见问题

Q：生成的 steering 文件内容不准确怎么办？

steering 文件是 Markdown 格式，可以手动编辑。Kiro 生成的内容是一个起点，你可以根据实际情况补充或修正。特别是 tech.md 中的技术栈描述，确保它和项目实际使用的版本一致。

Q：steering 文件需要提交到 git 吗？

建议提交。steering 文件代表团队对项目的共同理解，提交后所有成员使用 Kiro 时都能获得一致的上下文，避免因人而异的输出质量差异。

Q：vibe coding 是否适合生产环境的代码修改？

主页这类 UI 改进风险较低，适合 vibe coding。对于涉及业务逻辑、数据库操作或安全相关的代码，建议使用更精确的 prompt 并做严格的代码审查，不要完全依赖 vibe 模式。