amazon-opensearch-service

Amazon OpenSearch Service — 统一技能

此技能涵盖六种能力，可回答有关 Amazon OpenSearch Service 或 Serverless 的任何问题。下方的步骤 0 会将问题路由到其中一种能力，并指向该能力的入口参考文档。其他所有内容——何时分派、子参考文档、特定能力的事实以及跨能力链接——都位于该能力的入口参考文档中。

建议使用 AWS MCP 服务，但并非必需。 能力参考文档以标准 AWS CLI 命令作为主要语法（例如，aws opensearch describe-domain、aws opensearchserverless create-collection）。如果有 AWS MCP 服务可用，其 call_aws 工具提供了更精简的替代方式；但此技能中的所有操作都必须仅通过 AWS CLI 实现。针对 AOS / AOSS 的数据面 HTTP 调用使用 awscurl 发送 SigV4 签名请求；此方式在两种情况下都适用。

步骤 0：识别能力——首先执行

从以下六种能力中选择一种。在第一句话中说明识别出的能力（例如，“识别出的能力：SEARCH — 使用 Bedrock 嵌入进行语义搜索设置。”）。然后加载入口参考文档；该文件会说明何时分派、索引该能力的其他文件，并引导你进入下一步。

能力	入口参考文档
migration — 将 Solr / Elasticsearch / 自托管 OpenSearch 迁移到 AOS 或 AOSS。架构/查询转换、容量规划、切换。	references/assessment-workflow.md
provisioning — 配置和管理 AOS 域及 AOSS 集合。生命周期、升级、存储层、FGAC、监控。	references/provisioning-reference.md
search — 向量 / 语义 / 混合 / 稀疏 / 稠密 / RAG 检索。Bedrock 连接器、FAISS HNSW 与 Lucene。	references/search-semantic-search-guide.md
log-analytics — 日志搜索、可观测性、PPL、OSI 数据摄取、异常检测、OpenSearch Dashboards。Splunk/Datadog/ELK 替代方案。	references/log-analytics-guide.md
trace-analytics — 使用 OpenTelemetry 处理分布式跟踪。Span 查询、服务映射、Data Prepper。	references/trace-analytics-trace-queries.md
ai-assistant — Agentic AI 助手：自动发现索引、生成优化的 PPL/DSL 查询、总结结果，并端到端调查事件。无需手动编写查询。	references/ai-assistant.md

如果提示词涉及多种能力（例如，“从 Solr 迁移，并在新域上设置 RAG”），请选择对回答最主要的能力，并在结尾用一行引导用户查看另一种能力的入口参考文档。

通用规则（适用于所有能力）

这些规则适用于每种能力的所有回复。特定能力规则（容量计算、形状检测、Amazon OpenSearch Service 迁移助手能力矩阵、k-NN 引擎选择）位于入口参考文档中，不在此处。

• 报告标题（每个多部分回复）。 每个多部分回复都必须以单个围栏元数据块开头：> Generated: <ISO 8601 timestamp> | Skill: amazon-opensearch-service v<N>。通过调用 current_time 工具获取时间（返回 UTC 格式的 ISO 8601 时间）。从此文件的 frontmatter version: 字段读取技能版本。对于单行答复（简短的 FOCUSED_OPERATIONAL 回复、拒绝反模式请求），标题可选；对于任何多部分交付内容，标题都是必需的。将其放在报告标题之后、首个 ## 标题之前。
• 不得估算美元金额（硬性约束）。绝不输出 $X/month、~$1,500 或任何美元金额。将所有成本问题转至 https://calculator.aws，然后停止。如果子参考文档包含美元金额，只能将其视为背景信息，不得将其转述给用户。
• 不得泄露凭证（硬性约束）。生成的输出中绝不包含主用户名、KMS 密钥 ARN、VPC 端点 URL、实例 IP 或账户 ID。
• 每个 A 与 B 的选择都必须明确选一个。 用一句话给出首选建议，并用一句话说明理由。可以在首选建议之后补充 “如果……，则选择 B” 的注意事项；绝不能只给出条件式指导。
• 复述来源信息。 前 2–3 句话必须在已知时复述来源（引擎 + 版本 + 规模），否则具体复述客户的问题。用户看到的第一段文字不得是工具调用说明、元评论、报告标题，或只是逐字复述问题。
• 不得使用营销语气。 不得使用 “无缝”、“稳健”、“同类最佳”、“经过生产环境加固”、“企业级”、“世界一流”、“简洁地”、“优雅”。单条建议中不得堆叠 3 个或更多含糊的限定词（如 “通常”、“一般来说”、“大多数情况下”）；应具体说明适用与不适用的情况。
• 跨能力交接。 当用户的提示涉及多项能力（例如 “从 Solr 迁移 AND 在新域上设置 RAG”）时，选择最主要的能力来作答，然后以一行交接说明结尾：“关于 <other capability>，请参阅 references/<other-capability>-<entry>.md。”

跨领域参考文档（供多项能力使用）

这些参考文档不带能力前缀，因为它们适用于多项能力。能力入口参考文档会在相关时加载这些文档；SKILL.md 不会直接加载它们。

• references/sizing.md — 容量计算、实例系列详情、OR1 权衡、watermark、JVM 堆规则。
• references/vector-knn.md — k-NN 引擎、内存计算、RAG 摄取模式、ELSER 替代方案。
• references/observability.md — 日志分析模式、ISM、UltraWarm/Cold 分层、Splunk/Datadog 迁移指南。
• references/security.md — FGAC、加密、VPC 模式、审计日志、合规态势。
• references/personas.md — 各类角色的沟通风格。
• references/assessment-gotchas.md — 生产环境问题目录（在迁移详情或风险/阻碍表中按编号引用；每个问题都带有一个决定其类别的 Category: 标签）。
• references/assessment-knowledge-retrieval.md — 主题 → 工具 → URL 的批量验证流程。

资源（assets/）：用于 FULL_ASSESSMENT 输出的报告模板（Solr 来源、ES 来源、执行摘要）。

此技能不会做什么

• 估算美元成本。 定价每月都会变化，且特定账户的折扣计算（RI、Savings Plan、EDP）超出此技能可靠处理的范围。请使用 https://calculator.aws。
• 迁移数据。 请使用 Amazon OpenSearch Service Migration Assistant（Historical Data Migration 用于回填，Live Traffic Migration 用于实时切换）。
• 构建嵌入模型。 请使用 Amazon Bedrock 或 SageMaker。
• 一比一替代 Splunk SPL 或 Datadog APM。 部分查询、检测器和仪表板需要重写。
• 针对特定目录调整相关性。 请使用 OpenSearch Benchmark big5 工作负载，并结合你自己的判断列表。

防护措施 — 此技能自身文件的位置（MCP 与本地安装）

此技能可以通过两种方式加载，且这两种方式会从不同位置解析技能自带的 文件。读取参考资料或运行脚本前，请先确定技能是如何加载的：

• 通过 AWS MCP 服务的 retrieve_skill 工具加载： 此技能未安装在本地文件系统中。你必须 使用带有 file 参数的 retrieve_skill 获取每个参考资料或脚本 （例如 file="references/architecture.md" 或 file="scripts/deploy.py"），并运行返回内容中的脚本。不要在本地对这些路径使用 file_read —— 这些文件不在磁盘上。
• 在本地安装（例如 .kiro/skills/your-skill/ 或 ~/.claude/skills/your-skill/）：使用相对路径从本地技能 目录读取和运行文件。

此区别仅适用于技能自身打包的文件。用户数据和会话产物始终从用户的工作 目录读取并写入。切勿通过 retrieve_skill 获取或写入客户数据。