iamaanahmad/everything-kiro

Everything Kiro 大全

一组 Kiro IDE 配置集合——包括 agents、hooks、steering 文件、powers 和 skills——与 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 hooks，PascalCase 触发器
│       └── .json                # 12 个 hooks——列表见 hooks/README.md
│
├── agents/                       # 8 个专用 agents（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/        # Knowledge Base Power：代码审查、TDD、调试、QA
│   ├── devops-power/             # Knowledge Base Power：部署清单、Docker、CI/CD
│   └── database-power/           # Guided MCP Power：通过 MCP 检查 Postgres
│
├── skills/                       # 工作流文档，由 agents 调用或直接阅读
│   ├── 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                 # Hook schema 参考——可运行的 hooks 位于 .kiro/hooks/
│
├── examples/
│   ├── example-spec/             # 一个真实、完整的 .kiro/specs/password-reset/ 示例
│   ├── fullstack-webapp/         # 示例项目级 Kiro 配置（MCP、hooks、steering）
│   ├── AGENTS.md                 # AGENTS.md 模式：根目录、子目录和基础设施示例
│   └── permissions.yaml          # permissions.yaml 参考——复制到 .kiro/settings/ 或 ~/.kiro/settings/
├── INSTALL.md
├── CONTRIBUTING.md
├── CHANGELOG.md
└── STATUS.md

关键概念（按当前实际工作方式）

Steering 文件

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

inclusion: always        # 默认 — 每次对话
inclusion: fileMatch
fileMatchPattern: "/.api.ts"
inclusion: manual      # 通过斜杠命令或 #reference 加载，不会自动加载

manual steering 文件会显示为斜杠命令（/filename）。这完全取代了旧的“手动 hook 触发”概念。

AGENTS.md

在工作区中的任意位置放置一个 AGENTS.md 文件，即可为 Kiro 提供目录范围的指令——约定、限制、技术栈细节。根级 AGENTS.md 适用于整个工作区；嵌套的则将其范围缩小到所在子树。指令从父级到子级合并；发生冲突时，更具体的文件优先。在 IDE 1.0.309 中添加。

my-project/
├── AGENTS.md          ← 整个项目
├── src/
│   └── AGENTS.md      ← src/ 及其下级
└── infra/
└── AGENTS.md      ← 仅 infra

根级、API 层和 infra 示例见 examples/AGENTS.md。

Hooks

Hooks 是位于 .kiro/hooks/.json（工作区）或 ~/.kiro/hooks/.json（用户）的带版本 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。

全局（用户级）hooks 适用于每个工作区。在 IDE 1.0.182 中添加。

Hooks 也会在代理驱动的文件更改时触发（不仅仅是用户保存）。在 IDE 1.0.116 中添加。

权限

一个基于能力的系统，控制代理可以读取、写入、执行和调用什么。取代了 0.x 中的旧 Trusted Commands / Command Denylist。规则位于 YAML 文件中：

- ~/.kiro/settings/permissions.yaml — 用户范围，所有项目
- ~/.kiro/workspace-roots//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 格式）
Agent 是位于 .kiro/agents/（工作区）或 ~/.kiro/agents/（用户）中的 Markdown 文件。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 工具， = 所有内置工具。可在会话中途切换 Agent，而不会丢失对话历史。本仓库中的 8 个 Agent 各自都有合适的工具范围。

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 注册表。

Agent Focus Mode

一种实验性的聊天优先布局，用于指导多个并行 Agent 会话。启动独立会话，以内联差异形式查看文件更改，并使用结构化工作流（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 文件、自定义 Agent、技能、Powers 和 hooks 可以同步到你的 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、hooks、skills 和自定义代理模式在安装后无需单独迁移即可沿用。

这仅是兼容性文档：Kiro 所做的一切并不附带 Crew 清单、计划、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，将占位符令牌替换为真实凭据——切勿提交真实密钥。

贡献

请参见 CONTRIBUTING.md。遵循真实 schema（如有疑问，请查看 kiro.dev/docs），保持 README/STATUS/CHANGELOG 中的声明与磁盘上的实际内容一致，并且在没有同时更新上方文件树的情况下，不要添加组件。

资源

- Kiro IDE
- Kiro 文档
- Kiro 更新日志 — 在假定某个 schema 是最新的之前，请先查看此处
- 官方 Powers 注册表
- 模型上下文协议
- 灵感来自 everything-claude-code

许可证

MIT — 可自由使用，按需修改，如有可能请回馈贡献。