古法编程

Kiro Skills：可复用的 AI 指令包

Kiro Skills 是遵循开放 Agent Skills 标准的可移植指令包，将使用说明、脚本与模板打包成可复用单元。Kiro 启动时只加载每个 skill 的名称与描述，仅在请求匹配时才加载完整指令，实现按需激活。Skills 分为工作区级别（.kiro/skills/）和全局级别（~/.kiro/skills/），支持从 GitHub 或本地目录导入，也可通过 / 斜杠命令手动触发，适合团队共享标准化工作流。

什么是 Skills？

Skills 是遵循开放 Agent Skills 标准的可移植指令包。它们将使用说明、脚本和模板打包成可复用单元，Kiro 在合适的时机自动激活。

由于 Skills 遵循开放标准，你可以从社区导入 Skills，也可以将自己的 Skills 分享给其他兼容 AI 工具。

Skills 的工作原理

AI 智能体能力越来越强，但往往缺乏完成真实工作所需的具体上下文。如果把所有背景信息一次性加载，会导致上下文过大，响应变慢、质量下降。

Skills 通过渐进式加载解决这个问题：

  1. 发现：Kiro 启动时只加载每个 skill 的名称和描述
  2. 激活：当请求与某个 skill 的描述匹配时，Kiro 加载完整指令
  3. 执行：Kiro 按指令执行，仅在需要时加载脚本或参考文件

这样既保持上下文精简，又能在需要时按需获取专项知识。

使用 Skills

Kiro 会在请求匹配时自动激活 Skills。你也可以在聊天输入框中输入 / 查看可用 Skills 列表，直接选择斜杠命令来显式激活。

在 Kiro 面板的 Agent Steering & Skills 部分可以查看和管理 Skills。

Skill 的作用范围

Skills 分为工作区范围和全局范围。

工作区 Skills

存放在项目的 .kiro/skills/ 目录下，仅对当前工作区生效。适合存放特定项目的工作流，如部署流程或团队规范。

全局 Skills

存放在用户主目录的 ~/.kiro/skills/ 下，对所有工作区可用。适合存放个人通用工作流，如代码审查流程或文档规范。

当全局 Skills 与工作区 Skills 名称冲突时，Kiro 优先使用工作区 Skills，从而允许在特定项目中覆盖全局设置。

导入 Skills

  1. 打开 Kiro 面板中的 Agent Steering & Skills 部分
  2. 点击 +，选择 Import a skill
  3. 选择来源：
    • GitHub：粘贴指向 skill 文件夹或 SKILL.md 文件的公开仓库 URL（必须指向子目录，不能是仓库根目录）
    • 本地文件夹：从本地文件系统导入

导入的 Skills 会被复制到 Skills 目录并立即生效。

创建 Skill

一个 Skill 就是一个包含 SKILL.md 文件的文件夹：

my-skill/
├── SKILL.md           # 必须
├── scripts/           # 可选：可执行脚本
├── references/        # 可选：参考文档
└── assets/            # 可选：模板文件

SKILL.md 格式 

---
name: pr-review
description: Review pull requests for code quality, security issues, and test coverage. Use when reviewing PRs or preparing code for review.
---

## Review process

1. Check for security vulnerabilities
2. Verify error handling
3. Confirm test coverage
4. Review naming and structure

Frontmatter 字段说明

字段 是否必填 说明
name 是 必须与文件夹名称一致，只允许小写字母、数字和连字符（最多 64 个字符）
description 是 描述该 Skill 的使用场景，Kiro 依此匹配请求（最多 1024 个字符）
license 否 许可证名称或对内置许可证文件的引用
compatibility 否 环境要求（如所需工具、网络访问）
metadata 否 附加键值数据，如作者或版本号

详细字段约束请参阅 完整规范。

Skills 与 steering、Powers 的区别

Skills 是遵循开放标准的可移植包，按需加载，可包含脚本，适合可共享或可导入的可复用工作流。

Steering 是 Kiro 专属的上下文，用于塑造智能体行为，支持 always、auto、fileMatch 和 manual 模式，适合项目规范和约定。

Powers 将 MCP 工具与知识和工作流打包在一起，根据上下文动态激活，适合需要工具与指导并用的集成场景。

最佳实践

精准的描述：Kiro 依靠 description 决定何时激活，加入具体关键词。例如，“Review pull requests for security and test coverage"优于"helps with code review”。

SKILL.md 保持精简：详细文档放在 references/ 目录中，SKILL.md 在激活时会被完整加载。

用脚本处理确定性任务：校验、文件生成、API 调用等任务用脚本实现比让 LLM 生成代码更可靠。

选择合适的范围：个人工作流用全局 Skills（如你的代码审查清单），团队流程用工作区 Skills（如项目部署步骤）。

相关文档

常见问题

Q：Skill 会自动激活，但我不想让它在某次对话中生效，怎么办？

Skills 采用描述匹配激活。如果你不希望某个 Skill 介入，可以在提问时避免使用触发关键词，或者通过 Kiro 面板临时禁用该 Skill。

Q：全局 Skill 和工作区 Skill 同名时，哪个优先？

工作区 Skill 优先级更高。这让你可以在全局定义通用规范，同时针对特定项目进行覆盖，互不干扰。

Q：SKILL.md 中的 references/ 目录有什么用？

references/ 中的文件不会在 Skill 激活时自动加载，只有在 Kiro 执行具体步骤时按需引用。这样可以让 SKILL.md 本身保持精简，同时允许附带大量参考资料。