<!-- title: AWS把Kiro藏太深：这八招你没用过 -->
<!-- domain: tips-tricks -->

# AWS把Kiro藏太深：这八招你没用过

Cursor 和 Claude Code 的教程中文圈已经卷成红海，但 AWS 2025 年 7 月推出的 agentic IDE **Kiro**，很多人还停留在「注册了、打开过、和 Cursor 撞脸」的印象里。这篇文章带你进入信息差的深水区：Kiro 真正的主菜不是补全代码，而是它从电信行业偷师来的**规格驱动开发（Spec-Driven Development）**——把「一句话需求」变成「三份工程图纸」再让 AI 照图施工，外加一套用大白话就能造的自动化流水线。八个机关拆开讲，每一个都有具体入口和操作步骤，大部分在中文教程里见不到。

## 先把底子交代清楚

Kiro（kiro.dev）是 AWS 出品的桌面 IDE，基于 Code OSS（也就是 VS Code 的开源底座）构建，所以你的快捷键肌肉记忆、扩展习惯基本可以无缝迁移，登录后还能导入已有的 VS Code 配置。它预览期注册一度排起长队，2025 年 8 月正式转正（GA）。

商业模式是订阅积分制：有免费档可以尝鲜，Pro 档约 19 美元/月起并附带每月积分包，往上还有更高档位。**积分会随 Agent 交互消耗，档位和价格请以 kiro.dev/pricing 实时显示为准**。我只提醒一句：在积分制下，「怎么用」比「用多少」更决定你的账单——这正是下面八个机关存在的意义。

## 八个深水机关

### 机关一：/spec，一句话需求进，三份工程图纸出

Kiro 的 Agent 面板有两种模式：**Vibe**（随聊随改）和 **Spec**（规格模式）。切到 Spec，输入一句模糊需求，比如「给站内加一个积分兑换商城」，Kiro 会在 `.kiro/specs/` 目录下生成三份文档：

1. **requirements.md** — 需求清单，用一种叫 **EARS** 的格式书写；
2. **design.md** — 技术方案：架构、组件、数据流、接口设计；
3. **tasks.md** — 拆好编号、可以逐个勾选的任务清单。

重点说说 EARS（Easy Approach to Requirements Syntax），这是航空和汽车电子行业用了十几年的需求句式，套路是「触发条件 + 系统必须做什么」：

- `WHEN 用户余额不足 THE SYSTEM SHALL 阻止下单并提示差额`
- `IF 库存为零 THE SYSTEM SHALL 隐藏兑换按钮`

它一共六种句式：Ubiquitous（无条件执行）、WHEN（事件触发）、IF（条件分支）、WHERE（状态限定）、WHILE（持续状态）、Optional（可选行为）。

**预期效果**：AI 从「猜你想要什么」变成「照图纸施工」，大需求的返工率肉眼可见地下降。
**适用场景**：工作量超过一天的功能、要跟同事分工的模块、需要给领导或客户过目的方案。

### 机关二：别点 Execute all，任务要逐个喂

Spec 生成 tasks.md 后，每个任务都可以单独点「Execute task」，也能一键「全部执行」。新手常犯的错是上来就全跑——积分一次性烧光，方向错了还没法救。

正确姿势：**先手动执行前一到两个任务**，看看 Kiro 对架构的理解对不对路，确认后再放行后续。任务清单自带勾选状态，做到哪一目了然，中断了下次继续，上下文也不会丢。

### 机关三：Steering 三份章程，一次立规矩永久生效

用 Cursor 的都知道那个痛点：每次开新会话，都要重新交代一遍「我们用 pnpm 不用 npm」「组件必须函数式」。Kiro 把这件事做成了基础设施——**Steering（掌舵）文件**，放在 `.kiro/steering/` 目录：

- **product.md**：产品是什么、给谁用、解决什么问题；
- **tech.md**：技术栈、框架版本、代码约定；
- **structure.md**：目录组织规范、新文件该放哪。

不用手写。左侧打开 Kiro Steering 面板，点 **Generate Steering Docs**，Agent 会扫描你的代码库自动起草三份文档，你只需要审校修订。之后每次对话，这些章程默认自动注入——相当于给 Agent 发了一本永久员工手册。

### 机关四：inclusion 三种注入模式，规矩不是越多越好

章程全量注入也有代价：吃上下文窗口。Steering 文件的 front-matter 里有个 `inclusion` 字段，三种玩法：

- **always**：每次对话必带（默认）；
- **fileMatch**：配置 `fileMatchPattern`，只在碰到匹配文件时注入——比如测试规范只对 `*.test.ts` 生效，API 约定只对 routes 目录生效；
- **manual**：平时不占上下文，聊天时用 `#` 手动拉取。

这一招的精髓是**让规范在正确的时刻出现，而不是时刻都在**。上下文省着用，Prompt 更聚焦，答案质量反而更高。

### 机关五：Agent Hooks，用大白话造一个巡逻兵

这是 Kiro 最被低估的功能。命令面板输入 `/hooks` 或打开侧栏 Agent Hooks 面板，点 Create，然后用**自然语言**描述你要的自动化，比如：

> 「当我保存一个 .ts 文件时，检查里面有没有 console.log，有就移除并告诉我改了哪些。」

Agent 会自动把这句话变成一份 hook 配置。触发器有四种：User Initiated（手动）、File Create（新建）、File Save（保存）、File Delete（删除），执行体就是一段喂给 Agent 的提示词。

几个可以直接抄的玩法：

- **保存组件时**自动同步更新 Storybook 文档；
- **新建 API 路由时**自动补齐错误处理骨架；
- **删除文件时**自动清理相关引用和文档；
- 保存代码时自动跑一遍安全检查。

### 机关六：Hook 文件进 git，团队规范变成可执行资产

Hook 的定义不是黑盒，它落在 `.kiro/hooks/` 目录下的 `.kiro.hook` 文件里（JSON 格式）。把它 commit 进仓库，队友 `git pull` 之后打开 Kiro 就自动生效——团队的代码规范从「wiki 里一篇没人看的文章」升级成「代码库里自动运转的机器」。新人入职第一天，规范就在替你盯梢。Steering 文件同理，`.kiro/` 整个目录都应该进版本库。

### 机关七：# 引用，上下文投喂要精准打击

聊天框里输入 `#` 会弹出上下文引用菜单：`#File` 精确到文件、`#Folder` 指定目录、`#Codebase` 全库语义检索、`#Docs` 引用文档，Steering 文件也能引用。

反直觉的要点：**别一上来就 `#Codebase`**。大仓库全库检索又贵又容易把 Agent 带偏，正确顺序是先用 `#File` 精准定位，确实需要全局视角时才放大到 `#Codebase`。

### 机关八：MCP 配置，从 Claude Desktop 直接搬

Kiro 支持 MCP（Model Context Protocol），配置文件在 `.kiro/settings/mcp.json`（工作区级）或用户级目录。最省事的入口：它提供**从 Claude Desktop 配置一键导入**的能力——你家里那套 MCP server 不用重新手写。

每个 server 可以按工作区单独开关，还能设置 auto-approve 自动放行只读工具，减少确认弹窗。实战玩法：接 Playwright MCP 让 Agent 写完页面自己开浏览器验收；接数据库 MCP 先查真实 schema 再写迁移代码。

## 整条流水线长这样

```mermaid
flowchart TD
    A["一个模糊想法"] --> B["切到 Spec 模式"]
    B --> C["requirements.md<br/>EARS 格式需求"]
    C --> D["design.md<br/>技术方案"]
    D --> E["tasks.md<br/>可勾选任务清单"]
    E --> F["先执行前两个任务<br/>试探方向"]
    F --> G["方向对<br/>放行后续任务"]
    F --> H["方向错<br/>回炉改图纸"]
    G --> I["代码落地"]
    S1[".kiro/steering 三份章程<br/>产品/技术/结构"] -->|约束每一步| C
    S1 -->|约束每一步| F
    I --> J["Hooks 自动巡检<br/>保存即查即改"]
```

Hooks 这条自动化支线单独看：

```mermaid
flowchart TD
    A["四种触发器"] --> B["保存文件"]
    A --> C["新建文件"]
    A --> D["删除文件"]
    A --> E["手动触发"]
    B --> F["喂给 Agent<br/>一段大白话指令"]
    C --> F
    D --> F
    E --> F
    F --> G["自动改文档<br/>补骨架或跑检查"]
    G --> H[".kiro.hook 进 git<br/>全队自动生效"]
```

## 信息差总结

| 你以为的 Kiro | 实际上的 Kiro |
|---|---|
| 一个 Cursor 平替 | 规格驱动开发工具，Spec 三件套才是主菜 |
| 立规矩要在 prompt 里反复说 | Steering 章程一键生成、默认永久注入 |
| 自动化得自己写脚本 | Agent Hooks 大白话就能造，还随 git 全队共享 |
| 上下文给得越多越好 | fileMatch 按需注入，#File 精准投喂更省 |
| MCP 配置要手写 JSON | 可从 Claude Desktop 一键导入 |
| AI IDE 越自主越好 | 先 Supervised 试方向，再放心放权 |

## 行动指南：周末两小时上手路线

1. **安装登录**（10 分钟）：kiro.dev 下载（Win/macOS/Linux 都有），免费档注册，导入你的 VS Code 配置；
2. **找真项目练手**：选一个三文件以上的真实小项目，第一件事点 **Generate Steering Docs**，审校三份章程；
3. **跑通一条 Spec**：把 backlog 里拖了一周的需求喂给 Spec 模式，拿到三份图纸；
4. **克制地执行**：手动跑前两个任务，验证方向再放行剩下的；
5. **造第一个 Hook**：就从「保存时检查 console.log」开始，十行大白话的事；
6. **提交 `.kiro/` 目录**：让 Steering、Specs、Hooks 成为团队的共享资产。

做完这六步，你对 Kiro 的理解就已经超过 90% 只把它当「又一个 AI 编辑器」的人——**工具的红利，从来都藏在第二层功能里**。

## 参考来源

- Kiro 官方文档 Specs：https://kiro.dev/docs/specs/
- Steering 章程：https://kiro.dev/docs/steering/
- Agent Hooks：https://kiro.dev/docs/hooks/
- MCP 配置：https://kiro.dev/docs/mcp/
- 定价页（以实时显示为准）：https://kiro.dev/pricing
- 发布公告：https://kiro.dev/blog/introducing-kiro

> 注：积分消耗速率、免费额度与档位价格可能随版本调整，动手前请以官网实时页面为准。

---
> 本文由「51学通信」技术团队出品。51学通信由通信行业18年老兵**爱卫生**（微信ID: gprshome201101）维护。
> 聚焦5G/6G核心网、3GPP标准、AI工具实战。知识星球「51学通信」提供深度技术答疑和行业洞察。

> [!tip] 51学通信知识星球
> **星主：爱卫生**（微信：gprshome201101）——公众号「51学通信」创办者，19 年通信行业运维与讲师经验，著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书（各大电商平台有售）。
> **星球定位**：深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域，主打运维岗位与信令分析。
> **当前规模**：5200 篇主题 / 990 个回答，198 元/年。
> **加入福利**：加入星球后请加爱卫生微信，拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题，另有群内分享。
> **AI 加持**：51学通信知识星球已作为 skill 接入 WorkBuddy，使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例，做总结、找文档和 PPT 等场景全覆盖。

![51学通信知识星球海报-扫码加入](https://wiki.500nian.com/images/zhixingqiu_qrcode.png)
