海外已经不跟AI聊天了，他们让AI先写“合同”——这就是今天要交出去的信息差。
亚马逊2025年7月上线了一个叫 Kiro（kiro.dev）的 AI 编程 IDE，上线时火到要排队领邀请码。国内很多人对它的印象还停留在“又一个 Cursor 平替”，这恰恰错过了它真正的杀器：Kiro 根本不是靠对话框取胜的，它是靠三个藏在 .kiro/ 目录下的文件夹，把 Agent 管得服服帖帖。Cursor、Windsurf 的教程国内已经烂大街，但“规格驱动开发（Spec-Driven Development）”这套玩法，中文圈真正讲透的不多。今天把 Kiro 最值钱的 7 个暗格一次拆完。
大多数人用 AI 写代码的姿势是：描述一句，看它生成一堆，不合意就回一句“不对，重来”，来回拉扯五轮，credits 烧完，代码还没跑通。
Kiro 的 Spec 模式把这个流程整个倒过来了。你描述完需求，它不是直接写码，而是先产出三份文档：
操作：对话框底部切到 Spec 模式 → 描述需求 → Kiro 会先追问几个澄清问题 → 逐份文档确认 → 按任务逐个执行。
适用场景：需求稍微复杂（超过“改个按钮颜色”的量级）就别裸聊了，走 Spec。它等于把“来回拉扯”的前置成本一次付清，后面每一步都有据可查。
这是我认为 Kiro 最被低估的功能。 .kiro/steering/ 目录下放三个 Markdown 文件：
| 文件 | 管什么 | 类比 |
|---|---|---|
| product.md | 产品是干嘛的、给谁用、核心功能 | 公司章程 |
| tech.md | 技术栈、框架、代码规范 | 施工规范 |
| structure.md | 目录结构、文件放哪 | 小区平面图 |
关键在于：这三个文件会自动注入每一次对话。你在 Cursor 里反复粘贴“我们用 pnpm 不用 npm”“组件统一放 src/components”的日子结束了——写一次，Agent 永远记得。
还有个更细的暗格：每个 steering 文件头部可以设定注入模式——always（每次都注入）、fileMatch（只在编辑特定文件时注入，比如只在碰 .tsx 时才注入前端规范）、manual（平时不注入，聊天时用 #文件名 手动拉进来）。项目一大、规范一多，这个分档注入能显著省 token。
新手捷径：老项目不用手写，让 Kiro 读现有仓库反向生成这三个文件，几分钟就把“项目宪法”立起来了。
Hooks（钩子）是另一个多数人没碰过的暗格。你可以在 Agent Hooks 面板里定义规则：“当某事件发生时，自动让 Agent 干某件活”。
| 触发器 | 钩子干的活 | 收益 |
|---|---|---|
保存 .py 文件 |
自动跑格式化并修掉风格问题 | 代码评审少挨骂 |
| 新建组件文件 | 自动补团队文件头和注释骨架 | 规范不再靠自觉 |
| 删除某个接口 | 自动检查全库引用并提示更新文档 | 告别“删了没人知道” |
| 保存测试文件 | 自动跑该测试并汇报结果 | 红灯绿灯当场见分晓 |
本质上，这是把“你盯着 Agent 干活”变成“制度替你盯着”。事件类型支持文件创建、保存、删除和手动触发，动作可以是让 Agent 执行一段提示词，也可以是直接跑一条 shell 命令。配置一次，整个团队受益——这才是“AI 提效”该有的样子：不靠人肉盯梢，靠机制兜底。
AI 写代码最容易翻车的地方是“它不知道你们用的框架版本”。老外玩家的土办法是把整页文档复制粘贴进上下文，又贵又容易超长。
Kiro 的做法：把 Markdown 格式的文档（框架手册、内部 API 说明、协议文档）放进 .kiro/docs/ 目录，Kiro 会建立索引。聊天时用 #docs 引用，Agent 按需取用，而不是每次全文塞进去。内部接口文档、自家协议规范这种“网上搜不到的东西”，用这招喂进去最干净。
Kiro 聊天框里的 # 是个被严重浪费的入口，它的引用体系比很多人想象的丰富：
#File、#Folder：精确指定文件/目录；#Codebase：让 Agent 全库检索理解；#Problems：把 IDE 当前报错面板直接递给它——调试神器；#Terminal：把终端输出喂进去，报错日志不用复制粘贴；#Git Diff：让它基于本次改动说话，code review 场景极好用。配合第二条的 manual 模式 steering 文件（#规范名 随取随用），你的上下文可以做到“要多少给多少”，这直接决定了回复质量和 credits 消耗。
Kiro 支持 MCP（Model Context Protocol），配置文件放在项目的 .kiro/settings/mcp.json（也有用户级全局配置）。接上社区 MCP Server 后，Agent 可以查 Postgres 数据库、读 GitHub PR、甚至操作浏览器做验证——它就从“写码的”升级成“能自己动手验证的”。
但放权要有刻度。Kiro 里有信任命令机制：默认每条命令都要你点确认，你可以把 npm test、pnpm lint 这类安全命令加入信任清单，Agent 执行时不再逐条请示。经验法则是：只读、幂等的命令放行，写入、删除类永远人工确认。
Kiro 按 credits 计费，注册用免费的 AWS Builder ID 即可，发布时免费档每月送 50 credits，Pro 档约 $19–20/月含 1000 credits（价格随时在变，以 kiro.dev/pricing 实时页面为准；模型档位也以官网为准）。
省钱的顺序其实是：规格先行（少返工就是省钱）→ steering 常驻（不用反复贴约定）→ hooks 接管脏活（格式化、跑测试不走对话轮次）→ # 引用精准投喂（别拿全文对话）。同样是 50 credits，会用的能出一个完整功能，不会用的三轮对话就烧完了。
flowchart TD
A["接一个新需求"] --> B["Spec 规格模式"]
B --> C["requirements<br/>EARS句式写验收"]
C --> D["design<br/>定技术方案"]
D --> E["tasks<br/>拆成可勾选任务"]
E --> F["逐任务执行"]
F --> G["steering 常驻<br/>注入项目规矩"]
F --> H["hooks 自动化<br/>存盘即干活"]
G --> I["上下文不跑偏"]
H --> I
I --> J["勾掉一项<br/>验收下一项"]
值得注意的是，"spec-driven"这条路线不是 Kiro 一家的赌注——GitHub 后来也开源了 Spec Kit（github.com/github/spec-kit），说明行业在集体从“嘴改代码”转向“文档先行”。Kiro 的价值是把它做成了开箱即用的 IDE，而不是一套要自己拼的脚手架。
| 你可能还在用的姿势 | 海外玩家的姿势 |
|---|---|
| 对话框里来回拉扯改代码 | Spec 三件套，先立字据再动工 |
| 每次手动粘贴项目规范 | steering 三件套常驻注入 |
| 盯着 AI 手动跑测试、改格式 | hooks 存盘触发，机制兜底 |
| 整页文档贴进上下文 | docs 索引 + # 精准引用 |
| 每条命令逐个点确认 | 信任清单按风险分级放权 |
| credits 三轮烧光 | 规格先行，把钱花在刀刃上 |
注：本文功能与价格信息整理自官方公开资料；AI 工具迭代极快，具体功能、模型与价格请以官网实时页面为准。
本文由「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 等场景全覆盖。