Kiro 使用 AGENTS.md 定义编码规范（steering 标准）

说明

Kiro 从 v0.5（2025-10-31）起支持 AGENTS.md 标准，可以通过 AGENTS.md 文件定义项目规范、编码风格和架构约束，与 Cursor、Claude Code、OpenAI Codex 等工具保持一致的配置方式。

配置位置

位置	作用范围
~/.kiro/steering/AGENTS.md	全局（所有项目）
<workspace>/AGENTS.md	工作区根目录（该项目）
<workspace>/.kiro/steering/AGENTS.md	工作区 steering 目录

示例

# 项目规范

## 编码风格

- 使用 TypeScript，严格模式
- 函数式编程优先，避免 class（除非框架要求）
- 错误处理：使用 Result 类型而非 throw/catch

## 技术栈

- 前端：React 18 + Vite
- 状态管理：Zustand
- 样式：Tailwind CSS

## 禁止事项

- 不在 production 代码中使用 console.log
- 不使用 any 类型
- 不直接修改 props

嵌套 AGENTS.md（注意）

截至目前，Kiro CLI 对嵌套 AGENTS.md 的支持不完整。在 monorepo 中，根目录 AGENTS.md 有效，但子包目录下的 AGENTS.md 可能不会被自动读取（与 Claude Code 等工具有差异）。如果需要子包独立规范，可以使用 Kiro 的 steering 文件（.kiro/steering/*.md），它支持按文件配置 inclusion: always/auto/never。

与 Kiro Steering 的关系

AGENTS.md 是通用跨工具标准，Kiro 原生的 steering 文件（.kiro/steering/）功能更强：

• 支持 inclusion: always（每次都加载）
• 支持 inclusion: auto（AI 判断何时加载）
• 支持文件触发条件

官方文档：kiro.dev/docs/steering/#agentsmd

来源：GitHub Issue #4772