Kiro 配置大全 iamaanahmad/everything-kiro

Everything Kiro

Kiro IDE 配置合集——智能体、钩子、引导文件、Powers 和技能，始终与 Kiro 当前实际的 schema 保持同步。

内容一览

everything-kiro/
├── .kiro/ # 把整个文件夹放进工作区，就能一次用上全部内容 │ ├── settings/ │ │ └── mcp.json # MCP 服务商配置（工作区级） │ ├── steering/ # 常驻 + 条件触发 + 手动加载的上下文 │ │ ├── coding-standards.md # inclusion: always │ │ ├── security-rules.md # inclusion: always │ │ ├── project-patterns.md # inclusion: always │ │ ├── api-conventions.md # inclusion: fileMatch（只对 routes/controllers/api 文件加载） │ │ └── release-checklist.md # inclusion: manual（通过 /release-checklist 加载） │ └── hooks/ # v1 JSON 钩子，PascalCase 触发器 │ └── .json # 12 个钩子——清单见 hooks/README.md │ ├── agents/ # 8 个专用智能体（IDE 1.0 Markdown 格式） │ ├── architect.md # tools: read, web │ ├── code-reviewer.md # tools: read, web │ ├── debug-detective.md # tools: read, shell, web │ ├── devops-specialist.md # tools: read, write, shell, web │ ├── documentation-writer.md # tools: read, write, web │ ├── performance-optimizer.md # tools: read, shell, web │ ├── security-auditor.md # tools: read, web (shell: ask) │ └── test-engineer.md # tools: read, write, shell │ ├── powers/ # Kiro Powers（POWER.md + 可选 mcp.json + 可选 steering/） │ ├── README.md # 真实的 Powers schema 参考 │ ├── development-power/ # 知识库 Power：代码评审、TDD、调试、QA │ ├── devops-power/ # 知识库 Power：部署清单、Docker、CI/CD │ └── database-power/ # 引导式 MCP Power：通过 MCP 检查 Postgres │ ├── skills/ # 工作流文档，由智能体调用或直接阅读 │ ├── development-workflows/ │ │ ├── spec-driven-development.md # 真实的 .kiro/specs/ 格式，EARS 验收标准 │ │ └── tdd-cycle.md │ ├── language-patterns/ │ │ ├── typescript-best-practices.md │ │ ├── python-conventions.md │ │ └── react-patterns.md │ └── infrastructure/ │ ├── docker-workflows.md │ ├── ci-cd-patterns.md │ └── monitoring-setup.md │ ├── hooks/ │ └── README.md # 钩子 schema 参考——可运行的钩子放在 .kiro/hooks/ │ ├── examples/ │ ├── example-spec/ # 一份真实完整的 .kiro/specs/password-reset/ 示例 │ ├── fullstack-webapp/ # 项目级 Kiro 配置示例（MCP、钩子、引导文件） │ ├── AGENTS.md # AGENTS.md 模式：根目录、子目录和基础设施示例 │ └── permissions.yaml # permissions.yaml 参考——复制到 .kiro/settings/ 或 ~/.kiro/settings/ ├── INSTALL.md ├── CONTRIBUTING.md ├── CHANGELOG.md └── STATUS.md

核心概念（按当前实际行为说明）

Steering 文件

Markdown 文件放在 .kiro/steering/（工作区）或 ~/.kiro/steering/（用户），根据 frontmatter 加载： markdown

inclusion: always # default — every conversation

inclusion: fileMatch

fileMatchPattern: "/.api.ts"

inclusion: manual # loaded via slash command or #reference, not automatically

manual 类型的 steering 文件会以斜杠命令的形式出现（/filename）。这一机制完全取代了旧的「手动钩子触发」概念。

AGENTS.md

把 AGENTS.md 文件放在工作区任意位置，就能给 Kiro 提供目录级指令——约定、限制、技术栈细节。根目录的 AGENTS.md 作用于整个工作区；嵌套的则把范围收窄到所在子树。指令从父级向子级合并；冲突时更具体的文件优先。IDE 1.0.309 加入。

my-project/
├── AGENTS.md ← whole project
├── src/
│ └── AGENTS.md ← src/ and below
└── infra/
└── AGENTS.md ← infra only

根目录、API 层、infra 的示例见 examples/AGENTS.md。

钩子

钩子是带版本号的 JSON 文件，放在 .kiro/hooks/.json（工作区）或 ~/.kiro/hooks/.json（用户）： json { "version": "v1",
"hooks": [{
"name": "lint-on-save",
"trigger": "PostFileSave",
"matcher": "\\.ts$",
"action": { "type": "command", "command": "npm run lint" },
"timeout": 30
}]
}

触发器：SessionStart、Stop、UserPromptSubmit、PreToolUse、PostToolUse、PreTaskExec、PostTaskExec、PostFileCreate、PostFileSave、PostFileDelete。PreToolUse、UserPromptSubmit、PreTaskExec 可以阻断——命令动作以退出码 2 结束就会中止操作。完整参考见 hooks/README.md。

全局（用户级）钩子作用于每个工作区。IDE 1.0.182 加入。

钩子也会在智能体驱动的文件变更时触发（不只是用户保存）。IDE 1.0.116 加入。

权限

一套基于能力的系统，控制智能体能读、写、执行、调用什么。取代了 0.x 的旧 Trusted Commands / Command Denylist。规则放在 YAML 文件里：

- ~/.kiro/settings/permissions.yaml — 用户范围，所有项目
- ~/.kiro/workspace-roots/<hash>/permissions.yaml — 工作区范围，单个项目

工作区权限存放在仓库之外（按用户），这样克隆下来的仓库无法注入规则。
yaml
rules:
- capability: shell
match: ["git ", "npm "]
effect: allow
- capability: fs_write
match: ["/.env", "/.key"]
effect: deny

能力：fs_read、fs_write、shell、web_fetch、web_search、mcp、subagent、skill、power。优先级：deny > ask > allow。完整的带注释参考见 examples/permissions.yaml。

自定义智能体（IDE 1.0 格式）智能体就是 Markdown 文件，放在 .kiro/agents/（工作区）或 ~/.kiro/agents/（用户）下。IDE 1.0 格式在 frontmatter 里新增了 tools 标签、内联 permissions、welcomeMessage 等： markdown

name: my-agent
description: What this agent does
tools: [read, write, shell, web]
welcomeMessage: "Ready. What are we working on?"
permissions:
rules:
- capability: shell
match: ["npm ", "git "]
effect: allow

Your system prompt here...

tools 标签的简写形式：read = fs_read，write = fs_write，shell，web = web 工具， = 所有内置工具。会话中途切换智能体，不会丢失对话历史。本仓库的 8 个智能体各自有合适的工具范围。

Specs

Kiro 的结构化功能工作流：.kiro/specs/{feature_name}/ 下有三个带门禁的文件。

1. requirements.md — EARS 格式的验收标准（WHEN [event] THEN [system] SHALL [response]）
2. design.md — 架构、接口、数据模型
3. tasks.md — 只含编码任务的复选框列表

每个阶段都要用户明确批准，才能进入下一阶段。Quick Spec 模式为较小的功能一次性生成全部三个文件。参见 skills/development-workflows/spec-driven-development.md 和 examples/example-spec/。

Powers

Powers 把文档（以及可选的 MCP 服务器）打包成 Kiro 按需激活的东西：

- Knowledge Base Power — 只有 POWER.md（development-power、devops-power）
- Guided MCP Power — POWER.md + mcp.json（database-power）

Powers 也能打包成开放的 Agent Plugin format（捆绑技能 + MCP），可从本地文件夹或 GitHub URL 安装。IDE 1.0.288 新增。

没有 power.json —— 所有元数据都在 POWER.md frontmatter 里。参见 powers/README.md 和 官方 Powers registry。

Agent Focus Mode

一种实验性的聊天优先布局，用来指挥多个并行智能体会话。启动独立会话，以内联 diff 查看文件变更，使用结构化工作流（Spec、Plan、Bug Fix、Quick Spec）或自由聊天。从右上角切换。IDE 1.0 新增；Agent Focus 里的 Cloud Sessions 在 IDE 1.0.293 新增。

Cloud Sessions

在云端运行会话，与本地会话并行。从 Agent Focus Mode 启动，选择它要操作的仓库，合上笔记本后还能继续干活。IDE 1.0.293 新增。

Cloud Configuration Sync

Steering 文件、自定义智能体、技能、powers 和钩子都能同步到你的 Kiro 账号，在 IDE 和 Agent Focus 之间访问。云端管理的项目会显示云图标，以只读方式打开，并带一个「Edit in web」操作。IDE 1.0.437 新增。

MCP
外部工具服务器在 .kiro/settings/mcp.json（工作区）或 ~/.kiro/settings/mcp.json（用户）中配置。支持最新的 MCP 协议修订版，包括为需要登录的服务器提供 OAuth。启用的服务器只保留项目真正需要的那些——每个启用的 MCP 服务器，其工具都会占用上下文预算。

Kiro Crew

Kiro Crew 运行在 Kiro CLI 上，读取现有的 .kiro 配置。本仓库的 steering、钩子、技能和自定义智能体模式在安装后即可沿用，无需单独迁移。

本文档仅说明兼容性：Kiro 未提供的一切，Crew 都不提供 manifest、调度、Apps、集成或自主编排工作流。

安装

完整步骤见 INSTALL.md。简版： bash
git clone https://github.com/iamaanahmad/everything-kiro.git
cp -r everything-kiro/.kiro your-project/.kiro
cp -r everything-kiro/agents your-project/.kiro/agents

然后编辑 .kiro/settings/mcp.json，把占位 token 换成真实凭据——切勿提交真实密钥。

贡献

见 CONTRIBUTING.md。遵循真实 schema（不确定就查 kiro.dev/docs），保持 README/STATUS/CHANGELOG 中的说法与磁盘上的实际内容一致，新增组件时别忘了同步更新上面的文件树。

资源

- Kiro IDE
- Kiro Docs
- Kiro Changelog — 在假定某个 schema 是最新之前，先来这里查一下
- Official Powers registry
- Model Context Protocol
- 灵感来自 everything-claude-code

许可证

MIT — 自由使用，按需修改，有余力就回馈社区。