- name
- kiro
- description
- Kiro agentic IDE 开发工作流指南。使用 spec 驱动开发、hooks 自动化、steering 规则、MCP 集成和 powers 扩展。当用户需要：(1) 用 Kiro 创建/管理 specs，(2) 配置 hooks 自动化工作流，(3) 设置 steering 规则，(4) 连接 MCP 服务器，(5) 使用 powers 扩展 agent 能力，(6) 从原型到生产的完整开发流程。
Kiro 开发工作流
概述
Kiro 是 Amazon 开发的 agentic IDE 和 CLI 工具，支持规格驱动开发（Spec-Driven Development）。本技能指导你使用 Kiro 的核心功能从原型快速迭代到生产。
核心能力：
- Specs - 结构化规格文档，将需求拆解为详细实现计划
- Hooks - 基于文件变化和开发事件的自动化触发器
- Steering - 通过 markdown 文件定义自定义规则和项目上下文
- MCP Servers - 通过 Model Context Protocol 连接外部工具和数据源
- Powers - 按需扩展 agent 能力的领域特定知识和集成
快速开始
1. 安装 Kiro
IDE（桌面应用）：
- 访问 kiro.dev 下载
- 支持 macOS、Windows、Linux
CLI（命令行）：
# 安装 CLI（参考官方文档）
npm install -g @kiro/cli2. 创建第一个 Spec
Spec 是 Kiro 的核心，用于结构化规划功能开发：
# 在项目根目录创建 spec
kiro spec create "用户认证系统"Spec 标准结构（位于 .kiro/specs/）：
requirements.md- 需求定义和用户故事design.md- 技术设计和架构tasks.md- 实现任务清单
3. 配置 Steering
在项目根目录创建 .kiro/steering/ 目录，添加规则文件：
# .kiro/steering/project-rules.md
## 代码风格
- 使用 TypeScript 严格模式
- 函数不超过 50 行
- 所有公共 API 必须有 JSDoc
## 项目上下文
- 技术栈：Next.js 15 + TypeScript + Tailwind
- 部署目标：Vercel
- 数据库：Supabase4. 设置 Hooks
Hooks 自动化重复任务，配置文件变化触发：
# .kiro/hooks.yaml
hooks:
- name: auto-format
trigger: file.save
pattern: "*.ts"
action: run "prettier --write {{file}}"
- name: run-tests
trigger: file.save
pattern: "src/**/*.test.ts"
action: run "npm test"核心工作流
Spec 驱动开发流程
- 创建 Spec → 定义需求和验收标准
- Review Spec → 与 Kiro agent 讨论完善
- 生成 Tasks → 自动拆解为实现任务
- 执行 Tasks → Agent 按任务逐步实现
- 验证验收 → 对照验收标准测试
使用 Agentic Chat
Kiro 的聊天功能理解整个项目上下文：
用户：帮我实现用户登录功能
Kiro：我看到你在 .kiro/specs/auth/requirements.md 中定义了登录需求。
我将按照 spec 中的验收标准逐步实现：
1. 创建登录表单组件
2. 实现 Supabase 认证
3. 添加错误处理
4. 编写单元测试
开始吗？连接 MCP 服务器
MCP 允许 Kiro 访问外部工具和数据：
// .kiro/mcp.json
{
"servers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_TOKEN": "${GITHUB_TOKEN}"
}
},
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem"],
"options": {
"allowedPaths": ["/Users/mac/.openclaw/workspace"]
}
}
}
}最佳实践
Spec 编写规范
好的 Spec 特征：
- ✅ 清晰的用户故事和验收标准
- ✅ 可测试的需求描述
- ✅ 技术实现细节分离到 design.md
- ✅ 任务拆解到可独立完成的粒度
避免：
- ❌ 模糊的需求描述（"提升性能"）
- ❌ 混合需求和实现细节
- ❌ 缺少验收标准
Steering 规则设计
有效规则：
## 错误处理
- 所有 async 函数必须用 try-catch 包裹
- API 错误必须返回标准格式：{ error: { code, message } }
- 禁止吞掉错误而不记录日志无效规则：
## 代码质量
- 写好代码（过于模糊）
- 保持简洁（没有可操作标准）Hooks 自动化策略
推荐 Hooks：
- 保存时自动格式化
- 提交前运行 lint
- 测试文件保存时运行测试
- Spec 更新时同步任务状态
避免：
- 耗时操作（>5 秒）阻塞保存
- 依赖外部网络服务的同步操作
常见问题
Q: Spec 应该多详细？
A: 足够让另一个开发者理解需求并实现，但不包含具体代码实现。通常 2-5 页 markdown。
Q: 如何迁移现有 VS Code 项目？
A: Kiro 支持一键导入 VS Code 设置和扩展。首次启动时会提示迁移。
Q: MCP 服务器安全吗？
A: MCP 服务器在沙箱中运行，通过明确配置的允许路径访问资源。建议最小权限原则。
资源导航
官方文档
社区
参考文件：
references/spec-template.md- Spec 模板和示例references/hooks-reference.md- Hooks 配置完整参考references/mcp-servers.md- 可用 MCP 服务器列表
脚本工具：
scripts/create-spec.py- 快速创建标准结构 Specscripts/validate-hooks.py- 验证 hooks 配置语法
资产模板：
assets/steering-templates/- 常用 steering 规则模板