creating-data-lake-table – 数据湖表创建 Skill

3周前更新 8 0 0 0

creating-data-lake-table 是指导 AI Agent 在 AWS 上创建数据湖表的工作流 Skill,适合需要将原始数据组织为可查询表结构、供分析引擎直接读取的数据工程场景。

Skill 安装

多 Agent 安装
npx skills add https://github.com/aws/agent-toolkit-for-aws --skill creating-data-lake-table

使用 npx skills 快速安装,支持将 Skill 添加到多个兼容的 AI Agent。

Skill 调研报告

Skill 详细介绍

aws/agent-toolkit-for-aws#creating-data-lake-table 是 AWS 官方 agent-toolkit-for-aws 仓库中一个专注于创建数据湖表的 Agent Skill。它把 AWS 数据湖建表这一常见但步骤较多的操作,整理成 Agent 可以遵循的指令与流程,让 AI Agent 在对话中直接协助用户完成从存储规划到表结构定义的工作。

它是什么

  • 一个面向 AWS 数据湖场景的 Agent Skill,作者 / 组织为 AWS 官方。
  • 核心任务围绕“建表”展开:在数据湖中创建可供查询分析使用的表(例如基于 S3 数据、配合 AWS Glue Data Catalog 的表定义)。
  • 工作方式属于指令集 / 工作流型 Skill:它向 Agent 注入 AWS 数据湖建表相关的领域知识、步骤和规范,由 Agent 结合上下文执行。
  • 安装后,Agent 在与数据湖、建表相关的问题上会更有针对性,而不是给出泛泛的通用回答。

它不是什么

  • 它不是一个能独立运行的程序或服务,本身不提供存储、查询或计算能力。
  • 它不替代 AWS 控制台、AWS CLI、Glue、Athena、Lake Formation 等实际执行层面。
  • 它不是通用数据处理 Skill,功能范围聚焦在“数据湖建表”这一环节。

主要解决什么问题

  • 数据湖建表涉及存储位置、格式、分区、Schema、Catalog 归属等多个决策点,步骤繁琐、容易遗漏。
  • 把上述经验沉淀成 Skill 后,Agent 能按相对规范的路径引导用户完成建表,减少反复查文档的成本。

典型使用场景

  • 在 S3 数据湖上规划并创建新的表结构。
  • 为 Parquet、CSV、JSON 等格式的数据设计表 Schema 与分区方案。
  • 梳理 AWS Glue Data Catalog 中的表定义。
  • 让 Agent 协助生成建表相关的配置、DDL 或操作步骤说明。

适合哪些用户

  • 正在 AWS 上搭建或维护数据湖的数据工程师、数据分析师。
  • 使用 Claude Code 等 Agent 处理 AWS 相关任务的开发者。
  • 希望把数据湖建表经验标准化、流程化的团队。

不适合哪些需求

  • 需要真正执行建表、跑批、查询的任务——这仍需通过 AWS 实际服务完成。
  • 与 AWS 无关的其他云或本地数据湖场景。
  • 与建表无关的通用数据清洗、可视化、建模需求。

由于该 Skill 的实际能力、支持的建表类型和底层服务依赖,以 AWS 官方仓库当前说明为准,本文不对其内部具体字段、默认参数做无依据的细化描述。

Skill 安全评估

总体判断:该 Skill 来自 AWS 官方仓库 agent-toolkit-for-aws,来源可信度较高。以下评估基于“指令集型 Skill”的通用特征,具体行为请以该 Skill 当前官方说明为准。

来源可信度

  • 由 AWS 官方维护,属于一手来源,供应链风险相对较低。
  • 仍建议安装前确认来源,避免使用来源不明的 Fork 或第三方镜像。

文件读取 / 写入

  • 数据湖建表往往需要 Agent 读取本地或项目中的配置文件、Schema 定义、数据样本。
  • 若 Agent 具备文件写入权限,它可能生成建表脚本、DDL 或配置文件。建议在执行前先审阅生成内容,再决定是否落地。

Shell / 命令执行

  • 如果 Skill 引导用户使用 AWS CLI 或类似命令操作,Agent 可能需要 Shell 权限。
  • 这类权限本身符合建表场景的正常用途,但建议:需要生成命令时可以让 Agent 只输出命令文本,由用户手动执行和确认,而不让 Agent 直接自动执行。

网络访问

  • 与 AWS 服务交互通常需要网络访问。
  • 网络权限属于该 Skill 的正常依赖,重点在于确认连接目标是可信的 AWS 端点。

账号 / 凭证 / 权限

  • 实际创建表通常依赖 AWS 账号、凭证以及对应 IAM 权限(如 Glue、S3、Lake Formation 相关权限)。
  • Skill 本身是否要求凭证,取决于其指令内容,请以官方说明为准。
  • 风险点主要在于凭证泄露和权限过大:建议遵循最小权限原则,避免使用高权限根账号凭证。
  • 不要把长期有效的 AWS Access Key 明文写入配置文件或提交到代码仓库。

降低风险的建议

  • 只从 AWS 官方仓库获取该 Skill。
  • 关闭 Agent 自动执行 Shell 的权限,改为人工确认后执行。
  • 审阅 Agent 生成的建表脚本 / DDL,再应用到真实环境。
  • 先用测试账号或隔离环境验证,再用于生产。

Skill 使用要求

一、Agent / 客户端

  • 该 Skill 属于 AWS agent-toolkit-for-aws,主要面向支持 Skills 机制的 AI Agent(常见如 Claude Code)。
  • 官方没有提供完整的第三方 Agent 兼容列表。从 Agent Skill 的通用工作方式看,在支持 Skills、自定义 Skill 或类似指令加载机制的 Codex、Cursor、Trae、OpenClaw、WorkBuddy 等环境中,通常也可以尝试使用。
  • 不同 Agent 的 Skill 加载方式和兼容程度可能不同,具体以对应 Agent 当前版本为准。

二、运行环境 / 依赖

项目 要求
Agent 支持 Skills 机制的 AI Agent,Claude Code 等优先
Node.js / Python 以 Skill 官方说明为准;若需调用 AWS CLI / SDK 则按官方要求准备
AWS 环境 使用其建表能力时通常需要 AWS 账号与对应服务(如 S3、Glue 等)
网络 与 AWS 服务交互时需要

官方没有明确版本要求的部分,本文不做推测。

三、权限

  • 文件读取:可选,视是否需要读取本地 Schema / 配置。
  • 文件写入:可选,用于生成建表脚本或配置。
  • Shell:可选,用于执行 AWS CLI 等命令。
  • 网络:使用 AWS 服务时需要。

四、账号 / API Key

  • Skill 本身是否需要账号 / 凭证,以官方说明为准。
  • Skill 后续生成或操作的 AWS 项目,通常需要 AWS 账号及对应 IAM 权限;这与 Skill 本身是两回事,请分开看待。

最小使用条件

  • 一个可加载 Skill 的 AI Agent。
  • (如需真实建表)一个 AWS 账号及相应的最小权限凭证。
  • (如需执行命令)可用的 AWS CLI 或等价工具。

Skill 安装、使用与卸载教程

一、安装

可以直接复制本页面提供的 Skill 安装指令,粘贴到对应 Agent 或终端中执行。

如果不清楚自己的 Agent 如何安装,可以直接询问当前 AI Agent:

如何安装 aws/agent-toolkit-for-aws#creating-data-lake-table?

如何在 Claude Code 中安装 aws/agent-toolkit-for-aws#creating-data-lake-table?

如何在 Cursor 中安装 aws/agent-toolkit-for-aws#creating-data-lake-table?

让当前 Agent 根据自身 Skill 加载 / 管理机制给出安装指引。若该 Skill 存在特殊官方安装要求,请以官方仓库说明为准。

二、安装后如何使用

安装后,当你提出与 AWS 数据湖建表相关的问题或任务时,Agent 会调用该 Skill 提供的知识来辅助回答。适合交给它的任务包括:设计表结构、规划分区、生成建表相关配置或步骤说明。

用自然语言描述需求即可,例如:

使用 creating-data-lake-table,帮我在 S3 数据湖上设计一张分析用的表结构。

使用 creating-data-lake-table,根据这份 CSV 样本,帮我规划表的 Schema 和分区方案。

使用 creating-data-lake-table,说明在 AWS Glue Data Catalog 中创建这张表的步骤。

三、卸载

不同 Agent 的 Skill 安装位置和管理方式不同。通常可以:

  • 使用对应 Agent / Skill 管理器提供的删除方式移除该 Skill。
  • 直接询问当前 Agent,让它给出移除方式。

如何卸载 aws/agent-toolkit-for-aws#creating-data-lake-table?

如果没有统一的卸载命令,直接询问当前 Agent 通常更稳妥。

常见问题

安装后 Agent 没识别到这个 Skill怎么办?
先确认 Skill 是否放在该 Agent 约定的 Skill 目录,并确认 Agent 版本支持 Skills 机制。可以让 Agent 自我检查已加载的 Skill 列表,或重新加载 / 重启 Agent。仍不行时,询问 Agent 具体的加载规则。

可以同时安装到多个 Agent 吗?
通常可以,多个 Agent 之间互不影响,只要各自按自己的机制加载即可。注意保持版本一致,避免行为和输出不统一。

Skill 更新后需要重新安装吗?
取决于 Agent 的 Skill 管理方式。有些会跟随源更新,有些需要手动重新拉取。建议查看该 Skill 的更新说明,或直接询问当前 Agent 如何更新。

它会不会直接修改或创建真实的 AWS 资源?
Skill 本身只是指令集,不会自行改动资源。是否会实际操作,取决于你给 Agent 的权限,以及你是否让它执行命令。若不希望自动改动,可只让它生成方案和脚本,由你手动执行。

可以关闭 Shell 权限吗?
可以。关闭后仍可让 Agent 生成建表脚本、DDL 和步骤,由你手动执行和验证。这通常是更稳妥的方式。

中国大陆使用有网络要求吗?
如果涉及与 AWS 服务的实际交互,需要能够访问对应 AWS 端点,网络体验可能受当地网络环境影响。仅使用 Skill 生成方案时,对网络要求相对较低。

适合直接用于生产环境吗?
建议先把 Agent 生成的内容在测试环境验证,确认无误后再用于生产。生产环境请遵循最小权限原则,并保留人工审核环节。

Skill 更新日志

版本列表
无版本号
fix(aws-startup-advisor): recommend AgentCore over classic Bedrock Agents (#340) Ported from awslabs/startups#263. The architect-for-startups Strands decision guide still recommended classic Bedrock Agents for managed multi-agent orchestration; that service entered maintenance mode and closed to new customers on 2026-07-30. Point the guide at Strands multi-agent primitives on AgentCore Runtime instead, and replace the outdated TypeScript container-only claim with the direct-code vs container deployment choice. Co-authored-by: Logan Kleier
无版本号
docs(payments): document WorkloadIdentity name lowercasing IAM mismatch + CloudTrail debug fallback (#338) Co-authored-by: Khusbu Mishra
无版本号
feat(aws-startup-advisor): add AWS Startup Advisor plugin (#329) * feat(aws-startup-advisor): add AWS Startup Advisor plugin Ports the AWS Startup Advisor plugin from its upstream source repository into this repo as a native, first-class plugin at plugins/aws-startup-advisor. Contents (893 new files): - 10 skills: agent-advisor, architect-for-startups, contextual-offers-for-startups, gcp-to-aws, heroku-to-aws, llm-to-bedrock, knowledge-base-for-startups, prompt-library, start-building-for-startups, startup-advisor - 7 agents, 4 scripts, 126 fixture files - Multi-host manifests: .claude-plugin/, .codex-plugin/, .cursor-plugin/ - Plugin README Re-homed to destination conventions: - Declares exactly one MCP server (the unified AWS MCP server); prose describing capabilities outside that server's 10 aws___* tools was brought in line with what it can actually do. - whitelist -> allowlist across 10 files, matching repo house style. - Stale cross-plugin path references rewritten to resolve at the new location. Schema $id URNs that use "migration-to-aws" as a stable namespace identity are deliberately unchanged. Repo-level registration: - Registered in .claude-plugin/, .agents/plugins/, and .cursor-plugin/ marketplace.json, and listed in README.md. Shared-config fix (.markdownlint-cli2.yaml): - The frontMatter regex "^---\s*$[\s\S]*?^---\s*$" never matched, because \s consumes newlines so \s*$ runs past the line end and the closing fence anchor never lands. markdownlint therefore linted YAML frontmatter as body content. Anchored it on explicit newlines instead. Without the fix the repo reports 549 errors across 442 locations, all inside frontmatter; with it, 0. The 1619 pre-existing files lint at 0 errors under both the old and new regex, so this is not a behavior change for existing content. * ci: exempt typing-extensions from the licence allowlist The dependency-review gate fails on plugins/aws-startup-advisor because typing-extensions 4.15.0 publishes the composite licence expression "Python-2.0 AND GPL-1.0-or-later AND Python-2.0 AND BSD-3-Clause AND Python-2.0 AND BSD-3-Clause AND 0BSD". The shared Amazon OSPO config is an allowlist, and every term in a composite expression must match, so the single unlisted GPL-1.0-or-later term fails the whole package. That term is an artifact of the historical Python licence text bundled in the package's LICENSE file, not an actual GPL grant -- typing-extensions is PSF-licensed. The package reaches this repo only transitively: jsonschema -> referencing, openai -> pydantic/anyio, and exceptiongroup. Scoped as narrowly as the action allows: - Licence-only. Vulnerability checks still apply to this package. - One named package, by purl. - Applied as an inline input, which the action merges per key over the config file, so the shared allow-licenses list is untouched and the config-file SHA pin is unchanged. The alternative was dropping the two uv.lock files that surface the transitive closure, which would have cost 918 pinned file hashes across the two script environments to work around a metadata false positive. * fix(aws-startup-advisor): drop unsupported "agents" key from plugin.json Claude Code 2.1.278 rejects `"agents": "./agents/"` in .claude-plugin/plugin.json, and an unknown key invalidates the whole manifest, so the plugin fails to load entirely. The key was introduced during the port and is not present anywhere else: not in the upstream manifest, and not in this plugin's .codex-plugin or .cursor-plugin manifests. No sibling plugin in this repo declares it either -- aws-agents uses `skills`/`mcpServers`, aws-core uses `hooks`. Nothing is lost by removing it: Claude Code auto-discovers the default agents/ directory, and all 7 agent files remain in place. Reported by Gen Li during migration testing. Note for follow-up: `mise run validate` passes both with and without this key -- lint:manifests and lint:spec (Agent Plugins v1.0.0) both accept a key that Claude Code rejects, so the loading failure was invisible to the repo's own gates. * feat(aws-startup-advisor): port upstream azure-to-aws skill and cache-only pricing Brings the plugin up to date with upstream changes that postdate the original port snapshot. New capability: - azure-to-aws (skill #4) — seven-phase Microsoft Azure to AWS migration over canonical Microsoft.* ARM resource types, with an opt-in generate gate and a what-if repricing workshop. Includes the azure-iac-terraform fixture corpus and its five deterministic asserters (Discover, Design, Clarify x2, Estimate). - skills/shared/ai/ and skills/shared/clarify/ canonical fragments (AI migration guardrails, design-ref harness, clarify assembly), mirrored byte-identical into each consuming skill's references/vendored/ tree. - heroku-to-aws/scripts/ — the Heroku report validator moves in beside the skill that uses it, out of the plugin-level scripts/ directory. - tf-best-practices — three ElastiCache policy fixtures plus the matching validator and security-posture rules. Cache-only pricing, applied consistently across every skill: - Documentation and regional-availability lookups go through the unified AWS MCP Server (aws___* tools). The plugin still declares exactly one MCP server. - No live pricing lookup. A service absent from the pricing cache resolves to "estimated" (a formula constant carrying a published rate, stated verbatim) or "unavailable" (excluded from totals with a warning) — never a guess. - No AWS Pricing Calculator integration; calculator_url is always null. The upstream azure-to-aws skill was authored on a branch predating the cache-only consolidation and merged after it, so it arrived still referencing the removed pricing and knowledge MCP servers. Every substitution here follows upstream's own gcp-to-aws conversion rather than a local invention; the three azure-only files with no gcp counterpart got the same mapping by hand. Two cross-references that the mismatch had left dangling are removed: the workshop calculator-link procedure and an MCP retry ladder that no longer exists. Registration and docs: - Azure added to the plugin README skill table and prose, the root README, and the Claude/Cursor marketplace descriptions and keyword lists (75 keywords, consistent across all four plugin manifests). - Skill descriptions re-trimmed under the 1024-character limit (azure-to-aws 1020, gcp-to-aws 989, heroku-to-aws 1000). Verified: mise run validate (manifests, skill parity, Agent Plugins v1.0.0) — pass; mise run lint:md over 2385 files — clean; gitleaks over both history and the working tree — no leaks; all five azure fixture asserters — pass; 44 vendored files byte-identical to their canonical sources. * feat(aws-startup-advisor): add report cost-figure crosscheck and harden prompt library Ports two upstream changes into the vendored plugin. Cost-figure crosscheck: the report validator now verifies that the dollar figures rendered in a migration or decision report match the estimate they came from, via data-cost-key HTML anchors. Adds the anchor spec to the gcp-to-aws and heroku-to-aws report templates, tags the golden fixtures, and makes the gcp decision-gate asserter pass --estimation-infra so the gate is actually exercised rather than skipped. Prompt library hardening: scopes servicequotas:RequestServiceQuotaIncrease to EC2 and SageMaker quota ARNs instead of "*", drops "curl -k" in favour of a verified TLS call, and reframes the security baseline kit as a starting point that needs review before production. Also extends the anchor requirement to azure-to-aws, which invokes the same shared validator but shipped no anchor guidance. Azure records current spend under current_costs.azure_monthly, which the validator does not map, so only the aws_monthly_balanced anchor applies there. * docs(aws-startup-advisor): tighten AWS terminology in reference content Ports the upstream terminology pass over the knowledge-base and architect reference material. Replaces collective descriptions of AWS ("the AWS ecosystem", "the AWS platform") with what is actually meant -- AWS services, the AWS community, the AWS Partner Network, or a specific named service -- and softens overclaimed outcomes ("ensures" -> "helps" / "is designed to", "guaranteed response times" -> "target response times"). Where the original wording sat inside a direct quotation, the quote is left intact and the surrounding sentence is reshaped instead, so no one is quoted saying something they did not say. Third-party product names, the startup ecosystem, and partner ecosystems are unchanged. Also switches the heroku-live-capture fixtures to RFC 2606 reserved example addresses. Heading markers differ from upstream in 14 of these files: this repo enforces markdownlint MD036, so emphasis-as-heading lines are real headings here. Prose content is identical to upstream. * docs(aws-startup-advisor): sync upstream docs refresh through 604df6f Ports five upstream source-repository PRs that landed after the previous sync at cd8fc31: - #301 advisor docs refresh: azure-to-aws corrects its phase count to 6 and states that Bicep, ARM, live `az` capture, and RDfA are planned follow-ups rather than supported today. - #333 uses an RFC 2606 reserved domain in the Provider invitation example instead of a live one. - #334 adds template-verification guidance before the CloudFormation Launch Stack shortcuts in the budgets article. - #335 replaces a named third party's personal email address with the Merge offer page and Help Center. - #336 adds a safety note to the AI-analytics article: credit and lending model output must support a qualified human reviewer and cannot be the sole basis for approval or denial. Upstream's `setup.md`, `advisor/README.md`, and `advisor/AGENTS.md` changes are out of scope for this port. Three files could not be taken byte-verbatim: this repo enforces markdownlint MD059 (descriptive link text) and MD036 (no emphasis as heading), which upstream does not, and faq.md documents installation from this repo rather than from the upstream source. Upstream's changed lines were applied into them individually; the residual divergence is unchanged at 26 lines, all of it those two lint rules plus that one re-homing. * fix(aws-startup-advisor): stop instructing a pricing-calculator link that is never produced Under cache-only pricing there is no AWS Pricing Calculator integration and `estimation_summary.calculator_url` is always `null`. Two files in each of gcp-to-aws and azure-to-aws still told the agent to render a link "per non-null calculator_url" and justified it with "AWS computes regional prices server-side there", which contradicts cache-only pricing outright: - references/phases/workshop/workshop-compare.md - references/shared/report-decision-core.md The non-null condition means a literal reading already emits nothing, so output is unaffected. The risk is the standing suggestion that a shareable calculator estimate exists and is expected here, which invites a fabricated calculator.aws URL or a claim that prices were computed server-side when they came from the bundled cache. Both now state that the field is always `null` and that no link is rendered, matching heroku-to-aws, which was already correct. This diverges from upstream deliberately. * docs: point AWS Startup Advisor install instructions at this repository Addresses both review comments on #329. The `aws-startup-advisor` entry in `claude-plugins-official` is a git-subdir source pinned to a different repository and subdirectory, so `/plugin install aws-startup-advisor@claude-plugins-official` installs that distribution rather than this one. Merging this PR updates this repository's marketplace but cannot change that external entry. The root README now gives this repository's marketplace route and notes what the official-marketplace name currently resolves to; the same correction is applied to the FAQ reference the skill serves to users. The plugin README previously deferred all installation to the root README's Quick start, whose standalone-skills command targets `aws/agent-toolkit-for-aws/skills`. None of these 11 skills live in that tree, so Kiro and fx users following it got no Startup Advisor. It now carries a plugin-specific command, verified to resolve all 11 skills and 852 files: npx skills add aws/agent-toolkit-for-aws/plugins/aws-startup-advisor/skills --skill '*' It also notes that the skills must be installed together, since `agent-advisor` delegates to `gcp-to-aws`, and that a standalone install does not configure the `aws-mcp` server from `.mcp.json`. * fix(aws-startup-advisor): stop naming the wrong skills in the generic phase workers Both generic phase workers opened by scoping themselves to "a DSL-driven migration skill (`gcp-to-aws` or `heroku-to-aws`)". That list is wrong in both directions: `gcp-to-aws` ships no `references/vendored/dsl/INTERPRETER.md` and never dispatches these workers, while `agent-advisor` and `azure-to-aws` do and went unnamed. The list was introduced by this port. Upstream reads "(migration-to-aws)" — the old plugin name — and re-homing it to this repo's skill names picked the wrong two. Dropping the list entirely rather than correcting it: the very next line says the worker is phase-agnostic and takes its phase from the dispatch context, so enumerating callers in the prompt is both inaccurate and pointless. --------- Co-authored-by: Bear Zietz
无版本号
fix(eventbridge): rename the new-bus CLI command to aws eventsv2 (#336) * fix(eventbridge): rename the new-bus CLI command to aws eventsv2 The CLI command for the new custom event buses is aws eventsv2. The skill wrote aws eventbridgev2 in every CLI example and in the prose that states the service's names, so an agent following it would run a command that does not exist. Renames all 25 CLI invocations and updates the naming prose: the CLI command and the endpoint host are eventsv2, the SDK clients remain eventbridgev2, and the IAM namespace remains events. The wrong-namespace warnings now name eventsv2: as the likelier mistake, since a reader copies it from the command they just ran. Also drops events:SystemMetadata/EventGroupId from the condition-key table in references/authorization.md. The service does not populate it, and a documented key that is never populated fails closed without a signal: a StringEquals Allow can never be satisfied and a StringNotEquals Deny always fires, neither raising an error. * bump event bus skill to version 3 * Updating skill version to 2
无版本号
docs(msk): Add ZooKeeper-to-KRaft guidance (#316) Document in-place migration availability and require agents to use the current Amazon MSK Developer Guide as the source of truth. Co-authored-by: a-lmillette Co-authored-by: anasstahr
无版本号
feat(aws-marketplace-skills): add aws-marketplace-metering skill (#333) Add a skill for AWS Marketplace usage-based (PAYG) metering: deploying a serverless metering integration (ResolveCustomer, BatchMeterUsage, EventBridge via SAM), and querying and debugging metering records, statuses, failures, and billing discrepancies. Covers Concurrent Agreements, multi-product routing, CloudTrail Event History, Seller Reports, per-Region metering, and IAM setup. Co-authored-by: geojomon Co-authored-by: anasstahr
无版本号
feat(eventbridge): add amazon-eventbridge-event-bus skill (#334) * feat(eventbridge): add amazon-eventbridge-event-bus skill * style(eventbridge): fix markdown lint violations Align the two dash list markers in SKILL.md with the file's asterisk style (MD004/ul-style), and promote three bold pseudo-headings in references/target-contract.md to level-3 headings (MD036). Content unchanged.
无版本号
docs(cloudwatch): update aws-observability to v6 and setting-up-cloudwatch-observability (#332) * docs(cloudwatch): update aws-observability to v6 and setting-up-cloudwatch-observability to v2 Mirrors CR-307493010 from AWSMCPSOPs (commit 69f5bd3) to public toolkit: - aws-observability: v5 → v6, updated description for router disambiguation, expanded routing guidance (scope guard, service-health step 0.5, must-state callouts), cloudwatchomni CLI/SDK rename throughout - setting-up-cloudwatch-observability: v1 → v2, sharpened description, expanded routing rules including GitHub-not-supported clarification - Removes references/azure-ingestion/ (top-level) and github-integration.md from setting-up-cloudwatch-observability (no longer in source) - Updates 21 reference files with cloudwatchomni CLI/SDK rename and content sync * fix(lint): fix markdown lint errors in cloudwatch skill files * fix(plugin): sync aws-core plugin aws-observability with core-skills * fix(spec): use metadata.version format for plugin-synced skill * fix(security): replace base64 pagination token example with placeholder
无版本号
feat(resilience-skills): add aws-fault-injection-service skill (#323) Adds a specialized skill for AWS Fault Injection Service (AWS FIS) covering experiment design, the actions catalog, the scenario library, experiment lifecycle and monitoring, multi-account experiments, the experiment IAM role, and blast-radius safety. Contents: - SKILL.md with request routing and a safety-first workflow - references/fis-concepts.md: templates, actions, targets, stop conditions - references/fis-workflow.md: end-to-end authoring and run procedure - references/fis-actions-reference.md: action catalog and selection guidance - references/fis-api-reference.md: CLI and API surface - references/fis-security.md: experiment IAM role and least-privilege patterns Placed under resilience-skills alongside aws-resilience-lifecycle and recovery-controller-setup, which the skill description cross-references. Co-authored-by: Giuseppe Randazzo Co-authored-by: anasstahr
无版本号
feat(cloudwatch): update aws-observability to v5 and add setting-up-cloudwatch-observability skill (#326) * feat(cloudwatch): update aws-observability skill to v5 Updates the aws-observability skill to v5. Extends coverage to include CloudWatch Omni (Application Observability): SQL over logs/traces, PromQL over metrics, views, dashboards, alerts, context graph, programmatic access (API/SDK/CLI/CFN), and agent-quality evaluation on OTel traces. Restructures references and scripts into cloudwatch/ and cloudwatch-omni/ subdirectories. Tested with: Claude Code, Kiro, Q CLI. * feat(cloudwatch): add setting-up-cloudwatch-observability skill Adds the setting-up-cloudwatch-observability skill (v1). Covers first-time setup of a CloudWatch Application Observability (Omni) Space or Domain: access grants and profiles, ingestion endpoint provisioning, ADOT SDK instrumentation for Python, Node.js, Java, .NET on EC2/ECS/EKS/Lambda and AI agents (Strands, LangChain, LangGraph, CrewAI, OpenAI Agents, Vercel AI), Azure telemetry ingestion via the CloudWatch agent, and DevOps Agent / Slack integration. Text-only skill (no executable code); security-reviewed: Guardian PASS. Tested with: Claude Code, Kiro, Q CLI. * fix(lint): fix markdown lint errors in cloudwatch skill files * fix(lint): fix remaining markdown lint errors * fix(plugin): sync aws-core plugin aws-observability with core-skills * fix(security): replace base64 pagination token example with placeholder
无版本号
docs(aws-serverless): document SnapStart container image support (#324) SnapStart now supports the container image deployment format (in addition to ZIP) for Java 11+, Python 3.12+, and .NET 8+, including AWS Lambda base images and custom base images. Adds a Container images note linking the runtime-hooks and SnapStart uniqueness docs. Bumps skill version 2 -> 3.
无版本号
chore: update CODEOWNERS (#322)
无版本号
docs(payments): Coinbase Marketplace subscription, connector statuses, and authorizationUrl open guidance (#320) - Marketplace subscription (Coinbase-wide): why it's required, the consolidated-billing + SubscriptionRequiredException (403) statement, and the subscribe steps (logged-in AWS Console -> View purchase options -> review terms -> Subscribe). - Step 4 recovery for a SubscriptionRequiredException at deploy: the CLI provisions manager+connector in one CloudFormation stack, so the failure rolls back and deletes the PaymentManager; recheck via GetPaymentManager and, if ResourceNotFoundException, restart from Step 3a -> 3b -> deploy. - Connector status handling: add PROVISIONING (transient) and AWS_MARKETPLACE_SUBSCRIPTION_REQUIRED (terminal -> subscribe then recreate) to the poll loop and the debugging entry, alongside READY / AUTHENTICATION_EXPIRED / AUTHENTICATION_FAILED. - authorizationUrl handling: correct that the AgentCore CLI does NOT auto-open the URL today. The agent drives it: on the developer's machine open via the OS opener (open/xdg-open/start = navigate, not a fetch); headless/remote/CI -> print the URL for the developer. Never curl/HEAD/WebFetch/preview it (open != fetch). Co-authored-by: Khusbu Mishra
无版本号
feat(aws-core): add aws-well-architected-review skill (#319) Adds a Well-Architected Framework review skill under skills/core-skills/ and bundles it with the aws-core plugin. The skill reviews a workload across all six pillars. It discovers the framework question and best-practice inventory from the live AWS documentation rather than embedding a snapshot, then analyzes code, IaC, and configuration to produce evidence-backed findings with best-practice ID citations and Eisenhower-prioritized remediation. It supports full, quick, pillar-scoped, score, and lens-specific review modes. - Add the skill under skills/core-skills/aws-well-architected-review/ (9 files, text-only) and a byte-identical bundled copy under plugins/aws-core/skills/. - Add a row to the aws-core plugin README skills table. - Expand the aws-core description and keywords in the four plugin manifests and the two marketplace indexes so Well-Architected queries surface the plugin.
无版本号
feat(aws-cloudformation): Add dedicated CloudFormation validation tool guides (#318) * feat(aws-cloudformation): Add dedicated CloudFormation validation tool guides * Remove deprecated scripts * Remove unneded metadata * Set version as string * fix lint issues
无版本号
docs(agents-build): document Tempo/MPP networks, funding, and debugging (#317) The payments.md MPP section covered the wire protocol but the Supported Networks table and funding steps were x402-only (Base Sepolia + Circle). Agents wiring "add MPP payments" were pointed at the wrong network/asset to fund a Tempo endpoint. Adds, grounded in the AgentCore Payments ProcessPayment 4XX/5XX runbooks: - MPP networks/providers/funding subsection: Tempo mainnet (eip155:4217) and Moderato testnet (eip155:42431), StripePrivy-only (Coinbase cannot pay Tempo), auto-detected from the MPP 402, canonical stablecoin pathUSD - Step 7 funding branch for Tempo Moderato via the Tempo faucet - MPP debugging rows: MPP_ACCESS_NOT_ALLOWLISTED, MPP_EVM_NON_CANONICAL_USDC, TEMPO_INSUFFICIENT_BALANCE/memo, Coinbase-Tempo-unsupported - Clarifying note that the x402 Chains table excludes Tempo (MPP-only) Co-authored-by: Raju Ansari
无版本号
feat(aws-ai-ml): add inference optimization to model-deployment (#315) * feat(aws-ai-ml): add inference optimization to model-deployment Adds a new capability to the aws-ai-ml skill and brings the rest of its reference content up to date, applied identically to both copies. ## Inference optimization model-deployment could generate deployment code but had nothing to say about what to deploy onto. The agent either asked the user for an instance type or picked one from its own priors, with no way to check the choice against measured behaviour. A new optimization reference covers three workflows: benchmark measure latency and throughput on an existing endpoint, including replaying captured production traffic rather than synthetic load recommend run a recommendation job and read back the published hosting configurations, instead of naming an instance type from memory compare put candidate configurations side by side on the same workload references/model-deployment/references/optimization/benchmark-workflow.md references/model-deployment/references/optimization/benchmarking-guidance.md references/model-deployment/references/optimization/recommendation-workflow.md references/model-deployment/references/optimization/recommendation-options.md references/model-deployment/references/optimization/recommendation-deploy.md references/model-deployment/references/optimization/interpreting-results.md references/model-deployment/references/optimization/huggingface-to-s3.md with three matching notebook templates: references/model-deployment/code_templates/optimize-benchmark.py references/model-deployment/code_templates/optimize-recommendation.py references/model-deployment/code_templates/optimize-huggingface-to-s3.py The templates comment out their `%pip install` setup line and carry it as `# NOTEBOOK_ONLY`, matching the five existing deploy-*.py templates. A bare cell magic is not valid Python, so an uncommented one cannot be parsed by any tool that reads the template as source; the marker is what carries the notebook-only meaning, per code_output_guide.md. ## Region availability references/planning/references/region-availability.md is new. Serverless model customization and inference optimization are not available in every region, and planning previously discovered that only by failing partway through. The reference lets planning fast-fail on an unsupported region before any resource is created. ## Reference content sync The remaining files are accumulated updates to existing references — model-selection determinism (deterministic ordering of model lists, and a soft-term to exact-value mapping so "small" resolves predictably), a finetuning region gate, and updated deployment guidance. No workflow was removed. metadata.version is bumped to "4" to cover the content changes. Text-only content plus notebook templates; no new executable scripts are added. Co-authored-by: Jicheng Wang * fix(aws-ai-ml): resolve markdownlint errors and sync canonical copy for plugin parity --------- Co-authored-by: aws-sssjwang Co-authored-by: Roman Shevchuk
无版本号
feat(skills): add amazon-neptune skill (#219) * feat(skills): add amazon-neptune skill Adds guidance for Amazon Neptune Database and Neptune Analytics covering graph and knowledge-graph workloads: engine selection (Database vs Analytics), fraud rings, identity resolution, recommendations, agentic memory, GraphRAG, Gremlin / openCypher / SPARQL, Neo4j migration, connectivity, performance, and troubleshooting. Mutating operations require explicit user confirmation; destructive operations (delete, reset-graph, failover, major upgrade) are refused and redirected to change control. * chore(amazon-neptune): bump skill version to 3 for production release * chore(amazon-neptune): set skill version to 1 for production release --------- Co-authored-by: Victor Servin Co-authored-by: Victor Servin Co-authored-by: Arne Wouters
无版本号
fix(aws-agents): correct payment manager name rule in payments reference (#312) The payments reference stated that payment manager names allow underscores. They do not: manager names must be alphanumeric only. Co-authored-by: Tushar Kapoor
无版本号
fix(aws-starter-rules): refine wording for cross-region resource creation (#308) Co-authored-by: Mingda Ma
无版本号
fix(aws-agents-for-devsecops): missing S3 bucket ownership verification (#305) * Merge commit from fork The Security Agent skills derive a deterministic scan bucket name (security-agent-scans--) from the non-secret caller account ID. Because S3's namespace is global, a third party can pre-register the predictable name; the skills validated the bucket by existence only, so source archives (containing .env, *.pem, terraform.tfstate) could be uploaded into an attacker-owned bucket. - setup-security-agent: head-bucket now asserts --expected-bucket-owner and a 403 on a foreign-owned bucket is fatal; create-bucket treats BucketAlreadyExists as fatal (distinct from BucketAlreadyOwnedByYou) and re-asserts ownership after creation before any use. - scanning / diff-scanning / threat-modeling: every 'aws s3 cp' upload now passes --expected-bucket-owner so writes fail closed if the bucket is not owned by the caller. - Added ownership Rules and troubleshooting notes. Mirrors awslabs/mcp#4490 (MCP server path) for the Claude plugin skills. * Bump plugin version --------- Co-authored-by: Arne Wouters Co-authored-by: Arne Wouters
无版本号
docs: add fx setup to the quick start and skills guides (#306)
无版本号
feat(aws-containers): add ECS Action Logs guidance (#304) Co-authored-by: Matthew Goodman
无版本号
feat: updated cdk skill with new info about faster deployment methods (#303) Co-authored-by: Shadowcat567
无版本号
feat(managing-amazon-msk): add custom domain name to Amazon MSK skill (#302) * feat(managing-amazon-msk): add custom domain name skill * fix linting issue * Fixing all reported linting errors
无版本号
docs(setup-instructions): split troubleshooting from onboarding runbook and streamline (#301) * docs(setup-instructions): split troubleshooting from onboarding runbook and streamline Behavior-preserving refactor of the agent onboarding runbook. No install or configuration command changes; same steps, order, and end state. - Move per-step error tables into a new setup-troubleshooting.md, linked from each step in setup.md. - Consolidate Parameters and Dependencies into a single 'Before you start' block and add a 'How to run this file' note stating one autonomy mode (gather inputs up front, then run; pause only for the browser aws login and the interactive aws configure agent-toolkit wizard). - Add a note that the piped AWS CLI installer can be downloaded and inspected first, linking the official install page. - De-duplicate the generated aws-mcp MCP entry: describe the env/profile edit the agent must add (AWS_MCP_PROXY_PROFILES) instead of restating the full JSON the wizard writes, reducing drift. setup.md 305 -> 222 lines; error content preserved in setup-troubleshooting.md. * docs(setup-instructions): add back-links from troubleshooting to each step Add a 'Back to Step N' link at the top of each troubleshooting section (and General error handling) pointing to the corresponding step in setup.md, so navigating between a failed step and its resolution is a near-zero-cost round trip. Addresses the one dimension where the single -file layout was easier (0-hop inline lookup). No error content changed. * fix(setup-instructions): stop Step 7 from overwriting project rules files Fixes #282. Step 7 previously told the agent to save the AWS rules to CLAUDE.md / AGENTS.md (and .cursor/rules, .kiro/steering), which overwrites the project's own agent instructions — a quiet, sometimes unrecoverable data loss. Step 7 now creates the file only if absent, otherwise appends the rules under idempotent markers (replacing only the marked block on re-run), and asks the user when it cannot tell whether appending is safe. Also adds a precedence note to rules/aws-agent-rules.md and rules/aws-starter-rules.md: project instructions take precedence where they conflict with the AWS rules. --------- Co-authored-by: Devanshu Bhimwal
无版本号
fix(aws-core): make secret-safety hook interpreter cross-platform (#207) (#284) The PreToolUse hook hardcoded `python3`, which on Windows resolves to the Microsoft Store app-execution-alias stub (python.org installs only `python.exe`). The stub exits non-zero on every Bash call, producing a noisy hook-error banner and — worse — causing the secret-safety guard to silently fail open so plaintext secret fetches are no longer blocked. Replace the hardcoded interpreter in both hook entries with a POSIX fallback chain that tries `python3`, then `python`, then `py -3`, keeping the single-command-string form required for Codex compatibility (#98). stderr on the first two attempts is suppressed so the Store-stub message is not surfaced when a working interpreter is found. Verified locally: guard deny/allow matrix unchanged (9/9), and a stubbed `python3` exiting non-zero now falls through to `python` and still denies. Known limitation: the `sh -c` chain does not cover Windows without Git Bash (PowerShell); the silent fail-open warning is left as a follow-up.
无版本号
fix(asm-exec): resolve secrets via run_script (fixes #293) (#296) * fix(asm-exec): resolve secrets via run_script aws___call_aws was removed on 2026-08-31, so asm-exec resolved no secrets: _resolve_via_mcp called a tool that no longer exists. Port the MCP path to aws___run_script, which runs a short server-side script calling call_boto3('secretsmanager', 'GetSecretValue', ...) and returns the response as the script's return_value. Also fix two defects that made the failure impossible to diagnose: - The transport timeout was hardcoded to 10s, but the run_script boto3 round trip measures ~13s, so every attempt timed out. Default it to 30s and make it configurable via ASM_EXEC_MCP_TIMEOUT. - _resolve_via_mcp collapsed every exception into one "Failed to resolve" string. Report the specific cause (removed/renamed tool, timeout, unreachable endpoint, denied permission, missing secret) on stderr, without ever including the secret value. _extract_secret_string now also traverses the run_script envelope's return_value key (legacy result/output keys kept for back-compat). Embed call_boto3 arguments with repr so secret ids and version stages cannot break out of the generated script. Update SKILL.md to match. Fixes #293 * refactor(asm-exec): drop unused _mcp_post timeout parameter Address review feedback on #296: no caller passes a timeout, so the parameter was dead. _mcp_post reads the module-level MCP_TIMEOUT directly, keeping the timeout configurable via ASM_EXEC_MCP_TIMEOUT. --------- Co-authored-by: Bidesh Thapaliya
无版本号
feat: 90-minute async/ESM timeout guidance for aws-lambda-managed-instances (#300) Documents the 90-minute (5400s) Lambda function timeout for asynchronous and event-source-mapping (SQS, Kinesis, DynamoDB Streams) invocations on Managed Instances: Quick Decision duration signal, Configuration/Limits/Operations updates, long-duration invocation caveats, and a long-running-networking section. Updates the sqs-processor example to illustrate the Timeout and SQS visibility-timeout coupling.
无版本号
feat(sms-voice): add aws-sms-voice skill (#298) Co-authored-by: Daniela Espino

暂无评论

none
暂无评论...