用途：为 Kiro 创建领域专用 AI 智能体，配置其工具、权限与系统提示词。适用时机包括用户要求创建 Kiro 智能体、为特定工作流构建专用助手、开发领域型开发工具，或配置智能体的工具与权限。不适用于通用 AI 提示词、项目文档（应使用 steering 文件）或一次性助手交互。
主要能力：通过 JSON 文件声明智能体，最小结构包含 name、description、prompt 和 tools 字段。文件可放在项目目录 .kiro/agents/<name>.json 或全局 ~/.kiro/agents/<name>.json。常见工具有 fs_read（读文件）、fs_write（写文件，需 allowedPaths）、execute_bash（运行命令，需 allowedCommands）以及依服务器而异的 MCP 工具。支持 toolsSettings 做最小权限控制、resources 加载 steering 文件、mcpServers 接入外部服务、hooks 在 agentSpawn 与 userPromptSubmit 时执行命令。
使用方式：先明确领域任务、所需工具、文件路径与遵循规范，选择合适模式（如后端、代码审查、测试编写、前端），设置工具限制并编写结构化提示词，再创建文件。测试可运行 kiro agent use my-agent 后用 kiro 提问。提示词应以 Markdown 标题列出关注领域与标准，避免“helpful coding assistant”这类模糊表述。命名建议用 kebab-case，如 react-testing-expert。
限制与注意：必须遵循最小权限，仅授予必要工具，用 allowedPaths 限制写入路径，用 allowedCommands 白名单命令，并校验配置。常见错误包括授予全部工具、提示词模糊、缺少路径限制、命名泛化、缺 description、单智能体覆盖多领域。排查时确认文件位置、.json 扩展名与 JSON 语法，核对工具名拼写、allowedPaths 限制、MCP 服务器是否安装。可与 PRPM 集成：prpm install @username/agent-name --as kiro --subtype agent 安装，prpm init my-agent --subtype agent 初始化后 prpm publish 发布。其他细节暂未提供。